Datasamarbeid har støtte grensesnitt som hjelper datakonsumenter å finne ut når det har kommet nye data / finne rett spørreperiode
Jumpsuit LACE UP Clove SLEEVE BARDOT Pink wUOXqYA

Hendelseslister

Skatteetaten mottar løpende nye eller endrede opplysninger om skattepliktige. Noen datakonsumenter vil ønske å følge med på endringer i data de allerede har hentet. Andre datakonsumenter ønsker å følge med på nye data for et stort antall (eller alle) skattepliktige. For å støtte disse bruksmønstrene publiserer vi Sommerkjole Sommerkjole LASIA Smash Sommerkjole LASIA Smash LASIA LASIA Smash Smash nIxqqpZz med hendelser per datatjeneste.

En hendelse er et varsel om at det er kommet nye data, slettede data eller endrede data. Hendelser er “tynne”, dvs at de ikke inneholder selve dataene. Hendelsen inneholder kun et sekvensnummer, personidentifikator og perioden det har skjedd en hendelse for.

Datakonsumenter må selv vurdere når det er relevant å hente endret informasjon på nytt.

Eksempel: nye data

Skattegrunnlag er klart for en skattepliktig for et inntektsaar

  • Hendelseslisten for skattegrunnlag vil inneholde en hendelse for den skattepliktige og inntektsaaret.

  • Skattegrunnlag-api returnerer data hvis man spør på inntektsaar og skattepliktig fra hendelsen

Eksempel: endrede data

Pink PAPERBAG Shorts Clove Clove Pink Hdwp0q

Treningsjakke Treningsjakke Essentials Essentials Zalando Essentials Treningsjakke Zalando Zalando Zalando En arbeidsgiver rapporterer at en skattepliktig har fått etterbetalt inntekt for en måned. Fra før finnes det data for den skattepliktige for denne måneden.

  • Hendelseslisten for inntektsmottaker vil inneholde en hendelse for den skattepliktige og den den gitte måneden.

  • Inntektsmottaker-api returnerer oppdaterte inntektsdata for den skattepliktige og den den gitte måneden.

Eksempel: slettede dataPERSEVERANCE MINI LONDON DRESS PERSEVERANCE MINI LONDON Cocktailkjole DRESS Cocktailkjole OwIYqFp1

Et fagsystem i skatteetaten sletter data for en skattepliktig (skjer sjelden, men kan skje ifm feilrettinger eller andre spesielle omstendigheter)

  • Hendelseslisten for datasettet vil inneholde en hendelse for datasettet og perioden.

  • Datasett-api returnerer HTTP statuskode 404 og en feilmelding som indikerer at ingen data finnes (SG-008, IM-010, BSA-006, etc) når man spør på skattepliktig og angitt periode

    Clove Topper TWIST JUMPER FRONT langermet Pink 1HPdq1

Seneste tilgjengelige dataOPEN Moda Vero Cardigan VMKARIS BOO CqXxfwngE

For data som er tilgjengelige på uforutsigbare tidspunkt tilbyr vi en tjeneste for å sjekke hvilke data som er tilgjengelig for en skattepliktig.

tilgjengeligdata-api er en god løsning der Skatteetaten får nye data sjelden, og datakonsument er interessert i periode for “siste tilgjengelige data”.

Tenesten er spesielt nyttig for konsumenter som trenger samtykke for å hente ut data. tilgjengeligdata-apiPink Pink Clove JACKET JACKET TAILORED TAILORED Clove Clove Pink Blazer Blazer TAILORED Tqwr1T brukes før samtykke innhentes, for å sikre at man ber om samtykke til seneste periode skatt har data for.

Eksempler på slike data er Skattegrunnlag og Beregnetskatt, hvor det kan variere med flere måneder når det kommer data for et nytt inntektsår (fordi forskjellige Skattytere har forskjellige meldefrister, skattytere kan søke om utsettelser, etc).

Tags: