Feil

Feilhåndtering i Skatteetatens delingstjenester.

HTTP statuskoder

HTTP kode	Beskrivelse
200 OK	Henting av data gikk bra, og man får data i JSON eller XML format
400 Bad request	Feil i spørring. Applikasjonen vil gi en detaljert feilmelding på norsk for hva som er feil med spørring
401 Unauthorized	Autorisasjoner som trengs for å bruke tjenesten mangler
403 Forbidden	Ikke Autentisert
404 Not Found	Applikasjonen vil gi en detaljert feilmelding på norsk for hva som ikke ble funnet. Kan også bety at man bruker feil adresse for tjenesten (i så fall vil man få en standard '404 NOT FOUND' og ikke et svar fra applikasjonen)
500 Internal Server Error	Feil på server side, for eksempel at en underliggende datakilde ikke svarer. Kontakt Skatteetatens kundeservice hvis feilen vedvarer

Feilmeldinger

Som hovedregel vil feilmeldinger fra tjenestene være på følgende format i JSON:

  {
  "kode": "BSA-006",
  "melding": "Fant ikke beregnet skatt for gitt inntektsår og identifikator",
  "korrelasjonsid": "13a865f5-28f9-47db-9abd-ab78977c79fe"
  }

Dersom Accept-header er satt til application/xml vil en eventuell feilmelding være i XML:

<feil xmlns="urn:no:skatteetaten:datasamarbeid:feil:v1">
   <kode>ARBEIDSFORHOLD-003</kode>
   <melding>Fant ingen aktivt arbeidsforhold mellom angitt arbeidstaker og angitt arbeidsgiver</melding>
   <korrelasjonsid>a621a996-315d-4b8a-ac6c-6239e67f03e7</korrelasjonsid>
</feil>

Ved feilrapportering er spesielt korrelasjonsid nyttig, men rapporter gjerne hele feilmeldingen for å forenkle feilsøking. Korrelasjonsid skal være unik pr. kall, og ikke gjenbrukes på tvers av kall mot Skatteetaten, selv om de er del av samme løsning hos konsumenten.

Felles feilkoder

Applikasjonene har noen feilkoder som er felles. De fleste av disse (alle som har HTTP status 500) skal i en normalsituasjon ikke forekomme for brukere av tjenestene. Feilmeldingen vil kunne variere selv om samme feilkode returneres. Dette er for å kunne gi en så presis beskrivelse av feilen som mulig.

HTTP status	Feilkode	Feilmelding
500	DAS-001	Det var en uventet feil på tjenesten. Vennligst ta kontakt med brukerstøtte, med applikasjon og korrelasjonsid fra denne meldingen!
404	DAS-002	Den forespurte URLen svarer ikke til et gyldig endepunkt
500	DAS-003	Den forespurte informasjonen er for øyeblikket utilgjengelig, vennligst prøv igjen senere! Dersom problemet vedvarer, ta kontakt med brukerstøtte!
500	DAS-004	Det skjedde en feil i forbindelse med intern autentisering i Skatteetaten
500	DAS-005	Det skjedde en feil i forbindelse med intern autentisering i Skatteetaten
500	DAS-006	Det skjedde en feil i forbindelse med intern autentisering i Skatteetaten
500	DAS-007	Det skjedde en feil i forbindelse med intern autentisering i Skatteetaten
403	DAS-008	Du er ikke autorisert for tilgang til den forespurte ressursen.

Andre generelle feil

I noen tilfeller, for eksempel dersom forespørselen ikke når frem til tjenesten, vil ikke feilmeldingen ha formatet over. I tabellen under har vi listet opp noen vanlige feilsituasjoner der dette kan oppstå.

Feil	Tolkning
fatal alert: handshake_failure (eller annen TLS feilmelding)	Feil i klientsertifikat autentisering. Se .
Unknown instance. ID=8ac2...	Forespørselen er gjort mot en ugyldig URL som ikke svarer til noen tjeneste.

Melde feil

hvis du opplever vedvarende feil med tjenestene våre.