Skip to main content

Sammenslåing av Summert skattegrunnlag API og Spesifisert summert skattegrunnlag API

Skatteetaten slår sammen Summert skattegrunnlag API og Spesifisert summert skattegrunnlag API, og alle konsumenter av begge API-ene må gå over på versjon 2 av Summert skattegrunnlag API.

Summert skattegrunnlag API versjon 2 er tilgjengelig på ny URL i Test, og er om få dager også tilgjengelig i Prod:

Open API spesifikasjonen er oppdatert- Dokumentasjon på Github er oppdatert

Vi anbefaler at endringen testes først. For konsumenter som ikke har testet på en stund, så minner vi om å bruke TEST for token mot Maskinporten, ikke VER2.

For konsumenter som i dag benytter Summert skattegrunnlag API

  • Endringene i modellen har en breaking-change for de som har brukt Summert skattegrunnlag API siden feltet "kategori" er endret fra liste til enkeltverdi.
  • Feltet "registreringstidpunkt" har byttet navn til "ajourholdstidspunkt".
  • Modellen utvides med nye felter som gjøres tilgjengelig for konsumenter som har behandlingsgrunnlag for disse opplysningene: andelSkattefritt, andelOverfoertFraBarn, skjønnsfastsatt, svalbardSkjønnsfastsatt
  • Inntektsår 2016 er ikke lengre støttet.
  • {stadie} er nå en obligatorisk del av URL. Konsumenter som hittil ikke har oppgitt stadie skal benytte stadie "oppgjoer". Eksempel på sti i Prod blir da: https://summertskattegrunnlag.api.skatteetaten.no/v2/oppgjoer/{rettighetspakke}/{inntektsaar}/{personidentifikator}

For konsumenter som i dag benytter Spesifisert summert skattegrunnlag API

  • Endringene i modellen er non-breaking-change og bakoverkompatibel for de som har brukt Spesifisert summert skattegrunnlag API med JSON.
  • Konsumenter som har benyttet XML vil få et nytt namespace: summertskattegrunnlag
  • Scopet skatteetaten:spesifisertsummertskattegrunnlag kan fremdeles benyttes, men man kan også ta i bruk skatteetaten:summertskattegrunnlag.
  • Feltet "registreringstidpunkt" har byttet navn til "ajourholdstidspunkt".
  • Modellen utvides med nye felter som gjøres tilgjengelig for konsumenter som har behandlingsgrunnlag for disse opplysningene: andelSkattefritt, andelOverfoertFraBarn
  • {stadie} er nå en obligatorisk del av URL. Konsumenter som hittil ikke har oppgitt stadie skal benytte stadie "oppgjoer". Eksempel på sti i Prod blir da: https://summertskattegrunnlag.api.skatteetaten.no/v2/oppgjoer/{rettighetspakke}/{inntektsaar}/{personidentifikator}

Sanering av eksisterende tjenester

Saneringen av Summert skattegrunnlag API V1 og Spesifisert summert skattegrunnlag API vil sammenfalle med sanering av de gamle URL-ene, og frist vil varsles snart.

Kontakt Skatteetaten på vanlig måte dersom du har spørsmål til endringen. Konsumenter som er omfattet av et segmentsamarbeid bes kontakte egen segmentansvarlig.