Hendelser
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:
- Bruk av tjenestene
- Sikkerhetsmekansimer
- Rettighetspakker
- Feilhåndtering
- Versjonering
- Teknisk spesifikasjon
Scope
Man trenger ikke egne scope for hendelseslistene, de benytter samme scope som relaterte oppslagstjenester:
Hendelsesliste | Scope |
---|---|
Arbeidsforhold hendelser API | skatteetaten:arbeidsforhold |
Formuesgrunnlag for eiendomsskatt hendelser API | skatteetaten:formuesgrunnlageiendomsskatt |
Formuesobjekt fast eiendom hendelser API | skatteetaten:formuesobjektfasteiendom |
Inntekt hendelser API | skatteetaten:inntekt |
Mva-melding hendelser API | skatteetaten:mvamelding |
Mva-register – avgiftssubjekter med skattemeldingsplikt hendelser API | skatteetaten:mvaregisteravgiftssubjekt |
Næringsspesifikasjon hendelser API | skatteetaten:naeringsspesifikasjon |
Pensjonsgivende inntekt for folketrygden hendelser API | skatteetaten:pensjonsgivendeinntektforfolketrygden |
Selskapsmelding hendelser API | skatteetaten:selskapsmelding |
Skatteetaten-registrert selskap hendelser API | skatteetaten:skatteetatenregistrertselskap |
Skatteoppgjør hendelser API | skatteetaten:spesifisertsummertskattegrunnlag, skatteetaten:summertskattegrunnlag, skatteetaten:beregnetskatt, skatteetaten:avregning, skatteetaten:skatteplikt, skatteetaten:pensjonsgivendeinntekt, skatteetaten:trukketkildeskattpaaloenn |
Skatteoppgjør upersonlig hendelser API | skatteetaten:beregnetskattupersonlig, skatteetaten:skatteberegningsgrunnlagupersonlig, skatteetaten:summertskattegrunnlagupersonlig, skatteetaten:skattepliktupersonlig |
Skattemelding fastsatt hendelser API | skatteetaten:skattemelding, skatteetaten:summertskattegrunnlag, skatteetaten:spesifisertsummertskattegrunnlag |
Skattemelding upersonlig hendelser API | skatteetaten:skattemelding, skatteetaten:summertskattegrunnlag, skatteetaten:spesifisertsummertskattegrunnlag |
Skattemelding utkast hendelser API | skatteetaten:skattemelding |
Tilleggsskatt hendelser API | skatteetaten:tilleggsskatt |
Underenhet fra A-ordningen hendelser API | skatteetaten: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:
- Arbeidsforhold hendelser API
- Formuesgrunnlag for eiendomsskatt hendelser API
- Formuesobjekt fast eiendom hendelser API
- Inntekt hendelser API
- Mva-melding hendelser API
- Mva-register – avgiftssubjekter med skattemeldingsplikt hendelser API
- Næringsspesifikasjon hendelser API
- Pensjonsgivende inntekt for folketrygden hendelser API
- Selskapsmelding hendelser API
- Skatteetaten-registrert selskap hendelser API
- Skatteoppgjør hendelser API
- Skatteoppgjør upersonlig hendelser API
- Skattemelding fastsatt hendelser API
- Skattemelding upersonlig hendelser API
- Skattemelding utkast hendelser API
- Tilleggsskatt hendelser API
- Underenhet fra A-ordningen hendelser API
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.