Fiks skatte- og inntektsopplysninger tilbyr kommunalt ansatte et grensesnitt for å kunne hente informasjon om skatte- og inntektsopplysninger om innbyggere som søker om kommunale tjenester.
Grensesnitt | Støtte |
---|---|
Web portal | Ja |
Maskin til maskin | [Api spec]](https://editor.swagger.io/?url=https://developers.fiks.ks.no/api/ |
Innbyggertjeneste | Gyldige tjenesteområde for rollen | Rettighetspakke |
---|---|---|
Barnehage SFO - redusert foreldrebetaling | Foreldrebetaling SFO/barnehage | kommuneforeldrebetaling |
Kommunal bolig- og bostøtte | N/A | kommuneboligsosialeformaal |
Personlig assistanse / praktisk bistand | N/A | kommunepersonligassistanse |
Sykehjem langtidsopphold | N/A | N/A |
For å bruke API-ene, både proxy og vårt overbygg, må rollen som opprettes være i rett tjenesteområde. Pr i dag har vi kun støtte for redusert foreldrebetaling barnehage og SFO.
Miljø | URL |
---|---|
Test (Integrasjon) | https://api.fiks.test.ks.no |
Produksjon | https://api.fiks.ks.no |
APIene er tilgjengelig via Fiks-plattformen som proxy-tjeneste eller via vårt overbygg. Hendelseslister er ikke tilgjengelig via vår løsning pr nå.
Det er mulig å bruke Skatteetatens delingstjeneste for skatte og inntektsopplysninger som en proxy-tjeneste i Fiks register og samtidig benytte seg av roller, rettighetsstyring og dataminimering som Fiks register tilbyr. Oppbygging av URL gjøres så likt som mulig Skatteetatens egen URL. Datamodellen forblir uendret.
URL for proxy-api (GET):
<MILJØ_URL>/skatteetaten/formueinntekt/summertskatt/api/v1/{ROLLE_ID}/{STADIE}/{RETTIGHETSPAKKE}/{INNTEKTSAAR}/{PERSONIDENTIFIKATOR}
Skatteetaten har lagt ut dokumentasjon her Summert skattegrunnlag og Swagger
{
"personidentifikator": "03870349520",
"inntektsaar": "2021",
"skjermet": false,
"grunnlag": [
{
"tekniskNavn": "samledeOpptjenteRenterIInnenlandskeBanker",
"beloep": 19015,
"kategori": ["inntekt"]
},
{
"tekniskNavn": "samletPensjonFraFolketrygden",
"beloep": 894828,
"kategori": ["inntekt"]
},
{
"tekniskNavn": "samletAvkastningAvKapitalforsikringsavtale",
"beloep": 286299,
"kategori": ["inntekt"]
}
],
"skatteoppgjoersdato": "2022-02-10",
"stadie": "oppgjoer",
"registreringstidpunkt": "2022-02-10T15:17:37Z"
}
Vi har laget vårt eget overbygg som gir mulighet for å søke på flere personer. Vi søker først om personene har stadie OPPGJØR, dersom de ikke har det søkes det etter UTKAST. Datamodellen inkluderer de samme informasjonelementene (datamodell) som via proxy, i tillegg inkluderer vi visningstekst til hvert teknisk navn, samt henter navn på personene det søkes om, summerer både totalsummer og på poster for inntekt og utgifter.
URL for fiks-api (POST):
<MILJØ_URL>/register/api/v1/{ROLLE_ID}/summertskattegrunnlag
Payload {"personidentifikatorer":["{PERSONIDENTIFIKATOR}"],"inntektsaar":"{INNTEKTSAAR}"}
Swagger dokumentasjon for overbygg finner du her. Bruk også dokumentasjon fra Skatteetaten.
{
"totaltSummertGrunnlag": 1200142,
"tidspunkt": "2022-12-02T08:06:14.799283611Z",
"inntektsaar": 2021,
"stadie": "OPPGJOER",
"summertSkattegrunnlagPersoner": [
{
"personidentifikator": "03870349520",
"personnavn": {
"etternavn": "EKSAMEN",
"fornavn": "VISSEN",
"mellomnavn": null
},
"inntektsaar": 2021,
"skjermet": false,
"grunnlag": [
{
"tekniskNavn": "samledeOpptjenteRenterIInnenlandskeBanker",
"beloep": 19015,
"kategori": ["inntekt"],
"visningstekst": "Renter av bankinnskudd"
},
{
"tekniskNavn": "samletPensjonFraFolketrygden",
"beloep": 894828,
"kategori": ["inntekt"],
"visningstekst": "Alderspensjon fra folketrygden"
},
{
"tekniskNavn": "samletAvkastningAvKapitalforsikringsavtale",
"beloep": 286299,
"kategori": ["inntekt"],
"visningstekst": "Avkastning/gevinst av kapitalforsikring"
}
],
"summertGrunnlag": 1200142,
"skatteoppgjoersdato": "2022-02-10",
"svalbardGrunnlag": [],
"summertSvalbardGrunnlag": 0,
"kildeskattPaaLoennGrunnlag": [],
"summertKildeskattPaaLoennGrunnlag": 0,
"stadie": "OPPGJOER",
"registreringstidpunkt": "2022-02-10T15:17:37Z",
"totaltSummertGrunnlagPerson": 1200142
}
]
}