Alle kommuner kan bruke API-ene som er tilrettelagt for kommunene
Skatteetatens API-er er tilgjengelige for alle som har rett til å bruke dem. Alle kommuner har rettslig grunnlag (behandlingsgrunnlag) for å bruke opplysningene i API-ene som Skatteetaten har tilrettelagt for kommunene i sin delingstjeneste. KS og Skatteetaten har inngått en segmentavtale som sikrer at kommunesektoren enkelt kan ta i bruk API-ene.
API-ene har ikke et brukergrensesnitt, men krever maskin-til-maskin-oppkobling via Digitaliseringsdirektoratets digitale fellesløsning Maskinporten.
Hvordan ta i bruk API-ene – trinnvis veileder
For å ta i bruk et API må kommunen gjøre dette:
-
1. Kommunen signerer tilslutningserklæring – men bare én gang
For å få tilgang til Skatteetatens delingstjeneste skal kommunen ha signert en tilslutningserklæring. Denne signeres kun én gang og gir rett til å bruke både eksisterende og framtidige API-er.
Sjekk først om kommunen allerede har sendt oss signert tilslutningserklæring. Oversikten finner du her
Ser du at kommunen allerede har signert tilslutningserklæring, behøves ikke dette å sendes på nytt.
Tilslutningserklæringen (word-fil) lastes ned og signeres av ordfører eller en annen med tildelt myndighet, jf. kommuneloven § 6-1 annet ledd.
Signert erklæring sendes til KS: fiks@ks.no.
-
2. Kommunen sender påkoblingsforespørsel til KS
Kommunen skal sende én påkoblingsforespørsel for hvert API (hver tjeneste) dere ønsker å ta i bruk.
Fyll ut påkoblingsskjema.
-
3. Kommunen delegerer videre tilgang til Programmeringsgrensesnitt-API til leverandør i Altinn (KS Fiks eller annen leverandør)
Gå til Altinn og gi KS Fiks eller en annen leverandør tilgang til Programmeringsgrensesnitt-API for å kunne hente skatte- og inntektsopplysningene på vegne av kommunen. Dette må dere gjøre for hvert API leverandøren skal bruke. Disse API-ene er tilgjengelige for påkobling:
- Redusert foreldrebetaling barnehage og SFO: søk etter Summert Skattegrunnlag API - På vegne av
- Boligsosialt arbeid (kommunal bolig og kommunal bostøtte): søk etter Inntekt API - På vegne av og Summert Skattegrunnlag API - På vegne av
- Egenandel for praktisk bistand og opplæring: søk etter Summert Skattegrunnlag API - På vegne av
- Egenandel for langtidsopphold institusjon: søk etter Summert Skattegrunnlag API – På vegne av, Beregnet Skatt API – På vegne av og Avregning API – På vegne av
- Særnamsmyndigheten (kommunal innkreving): søk etter Inntekt-api – På vegne av og Spesifisert summert skattegrunnlag API – På vegne av
- Formuesgrunnlag for fastsettelse av eiendomsskatt søk etter Formuesgrunnlag for eiendomsskatt API – På vegne av
Les mer om hvordan du delegerer videre tilgang til Programmeringsgrensesnitt-API i Altinn
- Redusert foreldrebetaling barnehage og SFO: søk etter Summert Skattegrunnlag API - På vegne av
-
4. Leverandøren kobler til Maskinporten på vegne av kommunen
Leverandør oppretter en integrasjon i Maskinporten med sitt eget virksomhetssertifikat. Kommuner som ikke benytter en leverandør, kobler selv til Maskinporten med kommunens virksomhetssertifikat. For å opprette en integrasjon i, må dere søke opp riktig scope i Maskinporten for de ulike tjenestene:
- Redusert foreldrebetaling barnehage og SFO:
navn på scope i Maskinporten: skatteetaten:summertskattegrunnlag
(rettighetspakke: kommuneForeldrebetaling)- Boligsosialt arbeid (kommunal bolig og kommunal bostøtte):
navn på scope i Maskinporten: skatteetaten:inntekt og skatteetaten:summertskattegrunnlag
(rettighetspakke: kommuneBoligsosialeFormaal)
- Egenandel praktisk bistand og opplæring:
navn på scope i Maskinporten: skatteetaten:summertskattegrunnlag
(rettighetspakke: kommunePersonligassistanse)
- Egenandel langtidsopphold institusjon:
navn på scope i Maskinporten: skatteetaten:avregning, skatteetaten:summertskattegrunnlag og skatteetaten:beregnetskatt
(rettighetspakke: kommuneLangtidsoppholdInstitusjon)
- Særnamsmyndigheten (kommunal innkreving):
navn på scope i Maskinporten: skatteetaten: inntekt og skatteetaten: spesifisertsummertskattegrunnlag
(rettighetspakke: saernamsmann)
- Formuesgrunnlag for fastsettelse av eiendomsskatt:
navn på scope i Maskinporten: skatteetaten:formuesgrunnlageiendomsskatt
(rettighetspakke: KommuneEiendomsskatt)
Dokumentasjon av Summert skattegrunnlag API
Avtaler som gjelder for bruk av Skatteetatens delingsløsninger
Følgende avtaler og forpliktelser gjelder for alle kommuner som tar i bruk en delingstjeneste fra Skatteetaten, uavhengig av påkoblingsmåte.
-
Tilslutningserklæring
Signert tilslutningserklæring er en bekreftelse på at kommunen aksepterer Skatteetatens bruks- og delingsvilkår, og skal overholde forpliktelsene i tjenestebeskrivelsene for de delingstjenestene de tar i bruk. Se punkt 1 i veilederen over.
-
Tjenestebeskrivelse
For hvert API som Skatteetaten deler, følger det en tjenestebeskrivelse. Denne forklarer på hvilket rettslig grunnlag delingen skjer, hvilke opplysninger Skatteetaten deler, hvilke delingstjenester/rettighetspakker/filtre som benyttes, og til hvilke formål kommunen kan bruke opplysningene.
Kommunen forplikter seg i tjenestebeskrivelsen til å forholde seg til segmentansvarlig (KS og KS DIF) ved behov for samhandling med Skatteetaten.
Last ned: (PDF)- Tjenestebeskrivelsen for redusert foreldrebetaling barnehage og SFO
- Tjenestebeskrivelsen forbehandling av vedtak om tildeling av kommunal boligsosial bistand
- Tjenestebeskrivelsen for beregning av egenandel for praktisk bistand og opplæring
- Tjenestebeskrivelse for beregning av egenandel for langtidsopphold institusjon
- Tjenestebeskrivelse for særnamsmannsmyndighetene (kommunal innkreving)
- Tjenestebeskrivelse for formuesgrunnlag eiendomsskatt
-
Skatteetatens bruks- og delingsvilkår
Alle som skal ta i bruk Skatteetatens delingstjeneste, må godta deres bruks- og delingsvilkår. Vilkårene gjelder mellom Skatteetaten og den enkelte kommune, og omfatter:
- Generelle vilkår for Skatteetatens delingstjenester (delingsvilkår) – deling gjennom segmentsamarbeid. De gjeldende delingsvilkårene finner dere på https://www.skatteetaten.no/deling/tilgang/delingsvilkar
- Bruksvilkår for utlevering av opplysninger om inntekt, skatt og restanser fra Skatteetatens API-er – deling gjennom segmentsamarbeid. De gjeldende bruksvilkårene finner dere på https://www.skatteetaten.no/deling/tilgang/delingstjenester/bruksvilkar-for-delingstjenester
Driftsvarsler
Alle kommuner som har signert tilslutningserklæring og tatt i bruk et av Skatteetatens API-er, forplikter seg til å abonnere på driftsvarsel fra Skatteetatens Delingstjenester. Driftsvarselet gir beskjed om endringer i API, dokumentasjon, feil eller nedetid hos Skatteetaten.
Driftsvarselet publiseres på https://skatteetaten.github.io/api-dokumentasjon/nyheter-og-driftsvarsler
Teknisk dokumentasjon
Det er Skatteetaten som utvikler, forvalter og eier API-ene gjennom Skatteetatens delingstjeneste. Se mer informasjon på deres GitHub: https://skatteetaten.github.io/api-dokumentasjon/
Signere tjenestevedlegg for Fiks skatte- og inntektsopplysninger
Dersom kommunen bruker Fiks skatte- og inntektsopplysninger sin nettsideløsning og/eller et fagsystem som har maskin-til-maskin integrasjon mot Fiks skatte- og inntektsopplysninger, må kommunen signere et tjenestevedlegg. Informasjon og tjenestevedlegget finner du på: https://ksdif.no/avtaler-og-priser/
Informasjon om Fiks skatte- og inntektsopplysninger, finner du her: https://ksdif.no/tjenestene/fiks-register/fiks-skatte-og-inntektsopplysninger/
Har du spørsmål?
Har du spørsmål eller trenger hjelp, ta gjerne kontakt med oss på fiks@ks.no.