Inntekt API
For generell informasjon om tjenestene se egne sider om:
- Bruk av tjenestene
- Sikkerhetsmekansimer
- Rettighetspakker
- Feilhåndtering
- Versjonering
- Teknisk spesifikasjon
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å rettighetspakke | Egenskaper ved rettighetspakke |
---|---|
afp | Hjemmel |
digisos | Hjemmel |
fiskeridirektoratetkontrollmanntall | Hjemmel |
gff | Hjemmel |
husbanken | Hjemmel |
kommuneBoligsosialeFormaal | Hjemmel |
laanekassen | Hjemmel |
ldir | Hjemmel |
ldirReindriftstilskudd | Hjemmel |
nav | Hjemmel |
otp | Hjemmel. Perioden det spørres på må være innenfor virkningsperioden. Se Forutsetning for bruk |
pensjonskasse | Hjemmel |
pensjonskasseLivsvarigAfpAnnenInntekt | Hjemmel |
pensjonskasseLivsvarigAfpAndreYtelser | Hjemmel |
saernamsmann | Hjemmel |
spkBoliglaan | Hjemmel |
sbl | Krever samtykke |
ssb | Hjemmel |
udi | Hjemmel |
Samtykke
For rettighetspakke sbl
kreves samtykke.
Tjenestekode | Formål | Kommentar |
---|---|---|
4804_210607 | Samtykke for sbl | Sanert tjenestekode: 4804_170223 |
For denne tjenesten er det enkelte parametre som må følge med ved bruk av samtykke:
Parameter | Forklaring | Eksempelverdi |
---|---|---|
4804_210607_fraOgMed | Parameter for Inntekt | 2018-03 |
4804_210607_tilOgMed | Parameter for Inntekt | 2018-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
- 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.