Skip to main content

Inntekt API

Tjenesten leverer informasjon om arbeidsgivers (opplysningspliktiges) innrapporterte inntektsopplysninger for en inntektsmottaker for en gitt periode.

For generell informasjon om tjenestene se egne sider om:

Scope

Følgende scope skal benyttes ved autentisering i Maskinporten: skatteetaten:inntekt

Delegering

Tilgang til dette API-et kan delegeres i Altinn, f.eks. dersom leverandør benyttes for den tekniske oppkoblingen. Søk opp følgende tjeneste i Altinn for å delegere tilgangen: Inntekt API - På vegne av

Teknisk spesifikasjon

URL-er til API-et, beskrivelsen av parameterne, endepunkter og respons ligger i Open API spesifikasjonen på SwaggerHub.

Rettighetspakker

Skatteetaten utleverer ikke alle inntekt typer til alle virksomheter. Virksomhetens rettighetspakke avgjør hvilke inntekter som filtreres vekk før data utleveres. Inntekter som ikke skal utleveres for en rettighetspakke fjernes i sin helhet.

Navn på rettighetspakkeEgenskaper ved rettighetspakke
afpHjemmel
digisosHjemmel
fiskeridirektoratetkontrollmanntallHjemmel
gffHjemmel
husbankenHjemmel
kommuneBoligsosialeFormaalHjemmel
laanekassenHjemmel
ldirHjemmel
ldirReindriftstilskuddHjemmel
navHjemmel
otpHjemmel. Perioden det spørres på må være innenfor virkningsperioden. Se Forutsetning for bruk
pensjonskasseHjemmel
pensjonskasseLivsvarigAfpAnnenInntektHjemmel
pensjonskasseLivsvarigAfpAndreYtelserHjemmel
saernamsmannHjemmel
spkBoliglaanHjemmel
sblKrever samtykke
ssbHjemmel
udiHjemmel

Samtykke

For rettighetspakke sbl kreves samtykke.

TjenestekodeFormålKommentar
4804_210607Samtykke for sblSanert tjenestekode: 4804_170223

For denne tjenesten er det enkelte parametre som må følge med ved bruk av samtykke:

ParameterForklaringEksempelverdi
4804_210607_fraOgMedParameter for Inntekt2018-03
4804_210607_tilOgMedParameter for Inntekt2018-06

Støttetjeneste

For å følge med på endringer tilbyr vi en støttetjeneste for hendelsesliste: Inntekt hendelser API

Datakatalog

Datatjenestebeskrivelse i Felles datakatalog.

Datostyrt spørreperiode

Inntektsdata er et aggregat av innrapporterte data fra forskjellige kilder. Hver dataperiode (måned) bygges opp gradvis i takt med at det rapporteres inn nye data.

Alle data oppdateres månedlig, men kan bli korrigert i ettertid. Fristen for å sende inn a-meldingen er satt til senest den 5. i måneden etter at rapporteringspliktige forhold inntraff. Statistikk viser at data stort sett er komplette den

  1. i måneden etter. Skatteetaten anbefaler at man ikke baserer forretningsbeslutninger på inntektsopplysninger hentet før den 10 i måneden etter. Før dette kan data være ufullstendige.

Eksempel: En virksomhet skal lese inntektdata den 8. november 2017. Virksomheten bør hente data fra september 2017 og tidligere. Det kan hende data for oktober finnes, men de kan være ufullstendige.

Eksempel: En virksomhet skal lese inntektdata den 10. november 2017. Virksomheten bør hente data fra oktober 2017 og tidligere. Data for oktober 2017 er mest sannsynlig ferdig innrapportert.