Summert skattegrunnlag API
For generell informasjon om tjenestene se egne sider om:
- Bruk av tjenestene
- Sikkerhetsmekansimer
- Rettighetspakker
- Feilhåndtering
- Versjonering
- Teknisk spesifikasjon
Summert skattegrunnlag API vil endres når skattereglene endres, altså årlig. Hvilke felt som er tilgjengelig vil kunne variere etter skattereglene som gjelder for det gitte skatteåret det spørres om data om. Dette vil ikke føre til ny versjon av API-et med mindre annen semantikk endres.
Scope
Følgende scope skal benyttes ved autentisering i Maskinporten: skatteetaten:summertskattegrunnlag
I versjon 2 aksepteres også skatteetaten:spesifisertsummertskattegrunnlag
for konsumenter som tidligere
benyttet Spesifisert summert skattegrunnlag API.
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: Summert skattegrunnlag 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
Navn på rettighetspakke | Stadie | Kommentarer |
---|---|---|
fiskeridirektoratetKontrollmanntall | oppgjoer | |
friRettshjelp | oppgjoer | |
husbankenBostoette | oppgjoer | |
husbankenLaanTilskudd | oppgjoer | |
kommuneBoligsosialeFormaal | oppgjoer | |
kommuneForeldrebetaling | oppgjoer og utkast | |
kommuneLangtidsoppholdInstitusjon | oppgjoer | |
kommunePersonligassistanse | oppgjoer | |
kommunePraktiskBistand | oppgjoer | |
laanekassen | oppgjoer | |
ldir | oppgjoer | |
ldirReindriftstilskudd | oppgjoer | |
ldirTotalregnskap | oppgjoer | |
nav | oppgjoer | |
navBidrag | oppgjoer | |
navBilstoenad | oppgjoer | |
navSupplerendeStoenad | oppgjoer og utkast | |
navUfoeretrygd | oppgjoer | |
norgesbank | oppgjoer og utkast | |
saernamsmann | oppgjoer | |
sbl | oppgjoer | Krever samtykke |
sivilrett | oppgjoer, utkast og fastsatt | |
spkBoliglaan | oppgjoer | |
ssb | oppgjoer | |
udi | oppgjoer |
Samtykke
Versjon 2 av API-et kan kreve samtykke. Datakonsumenter med samtykke har kun lov til å spørre om summert skattegrunnlag for siste tilgjengelige inntektsår, og dette kan sjekkes med støttetjenesten Siste tilgjengelige skatteoppgjør API.
Tjenestekode | Formål |
---|---|
4628_210607 | Kreves for rettighetspakke sbl |
For denne tjenesten er det en parameter som må følge med:
Parameter | Forklaring | Eksempelverdi |
---|---|---|
4628_210607_inntektsaar | Parameter for skattegrunnlagets inntektsår | 2022 |
Støttetjenester
Hendelser
For å følge med på endringer tilbyr vi
en støttetjeneste for hendelsesliste: Skatteoppgjør hendelser API
Siste tilgjengelige skatteoppgjør
Virksomheter med samtykke har kun lov til å spørre om summert skattegrunnlag for seneste tilgjengelige inntektsaar. Siste tilgjengelige skatteoppgjør API kan brukes uten samtykke til å sjekke hva som er seneste tilgjengelige inntektsaar for en skattepliktig.
Datakatalog
Datatjenestebeskrivelse i Felles datakatalog.