Skip to main content

Hendelser

Tjenestene leverer løpende varslinger om personer/virksomheter med nye eller endrede opplysninger tilgjengelig.

Hendeleslistene er støttetjenester som gir informasjon om endringer i datasett som leveres av Skatteetatens datatjenester, og henger tett sammen med relatert oppslagstjeneste. Se mer informasjon på egen side.

Hendelseslistene navigeres vha. sekvensnummer og er paginert.

For generell informasjon om tjenestene se egne sider om:

Scope

Man trenger ikke egne scope for hendelseslistene, de benytter samme scope som relaterte oppslagstjenester:

HendelseslisteScope
Arbeidsforhold hendelser APIskatteetaten:arbeidsforhold
Formuesgrunnlag for eiendomsskatt hendelser APIskatteetaten:formuesgrunnlageiendomsskatt
Formuesobjekt fast eiendom hendelser APIskatteetaten:formuesobjektfasteiendom
Inntekt hendelser APIskatteetaten:inntekt
Mva-melding hendelser APIskatteetaten:mvamelding
Mva-register – avgiftssubjekter med skattemeldingsplikt hendelser APIskatteetaten:mvaregisteravgiftssubjekt
Næringsspesifikasjon hendelser APIskatteetaten:naeringsspesifikasjon
Pensjonsgivende inntekt for folketrygden hendelser APIskatteetaten:pensjonsgivendeinntektforfolketrygden
Selskapsmelding hendelser APIskatteetaten:selskapsmelding
Skatteetaten-registrert selskap hendelser APIskatteetaten:skatteetatenregistrertselskap
Skatteoppgjør hendelser APIskatteetaten:spesifisertsummertskattegrunnlag, skatteetaten:summertskattegrunnlag, skatteetaten:beregnetskatt, skatteetaten:avregning, skatteetaten:skatteplikt, skatteetaten:pensjonsgivendeinntekt, skatteetaten:trukketkildeskattpaaloenn
Skatteoppgjør upersonlig hendelser APIskatteetaten:beregnetskattupersonlig, skatteetaten:skatteberegningsgrunnlagupersonlig, skatteetaten:summertskattegrunnlagupersonlig, skatteetaten:skattepliktupersonlig
Skattemelding fastsatt hendelser APIskatteetaten:skattemelding, skatteetaten:summertskattegrunnlag, skatteetaten:spesifisertsummertskattegrunnlag
Skattemelding upersonlig hendelser APIskatteetaten:skattemelding, skatteetaten:summertskattegrunnlag, skatteetaten:spesifisertsummertskattegrunnlag
Skattemelding utkast hendelser APIskatteetaten:skattemelding
Tilleggsskatt hendelser APIskatteetaten:tilleggsskatt
Underenhet fra A-ordningen hendelser APIskatteetaten:underenhetaordningen

Delegering

Delegering i Altinn gjøres pr. scope, så tilgang til hendelseslisterer er håndtert hvis oppslagstjenesten er delegert.

Teknisk spesifikasjon

URL-er til API-ene, beskrivelsen av parameterne, endepunkter og respons ligger i Open API spesifikasjonene til hendelseslistene på SwaggerHub:

Hendelsestyper

De vanligste hendelsestypene er ny, endret og slettet, men det støttes ikke nødvendigvis i alle hendelseslistene. Her er noen eksempler:

Nye data: Summert skattegrunnlag er klart for en skattepliktig for et inntektsår:

  • Hendelseslisten for skatteoppgjør vil inneholde en hendelse for den skattepliktige og inntektsåret.
  • Summert skattegrunnlag API returnerer data hvis man spør på inntektsår og skattepliktig fra hendelsen

Endrede data: 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 inntekt vil inneholde en hendelse for den skattepliktige og den gitte måneden.
  • Inntekt API returnerer oppdaterte inntektsdata for den skattepliktige og den gitte måneden.

Slettede data: 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 410 og en feilmelding som indikerer at data ikke finnes lenger når man spør på skattepliktig og angitt periode.