Generelt

Ved innsending av oppgaver eller senere oppdatering av oppgaver kan API-kallet/meldingen avvises. Det er tre hovedkategorier feilmeldinger:

Tekniske feil relatert til melding eller syntaks
Helsenorge kan ikke behandle innsendt oppgave/oppdatering da innbygger ikke er tilstrekkelig digitaltaktiv eller har reservert seg mot denne type henvendelser
Innsendt oppgave/oppdatering inneholder logiske feil i henhold til spesifikasjon/profil.

Feilmeldinger fra API har alltid følgende syntaks:

<feilkode>: <Feilbeskrivelse>

Dersom det benyttes meldingsbasert integrasjon (AMQP), returneres feilkode og beskrivelse fra API’et i en negativ APPREC.

Standarden for negativ APPREC definerer enkelte generiske feilkoder (se Volven kodeverk 8221). Når feilmeldingen fra API’et representerer en av de standardiserte “situasjonene” returneres strandard feilkode i henhold til dette kodeverket.
Ved andre feilsituasjoner, f.eks. logiske feil i henhold til spesifikasjon/profil, returneres dette som følger i negativ APPREC:
- Negativ APPREC kan alltid inneholde detaljert informasjon om feilen, og feilkoden fra API’et. Eks: <Error S=‘2.16.578.1.12.4.1.1.8221" V="X99" DN="Annen feil" OT="<feilkode>: <Feilbeskrivelse>"/>
- Eksempel på negativ APPREC:

<Status V="2" DN="Avvist" />
<Error V="X99" DN="Annen feil" OT="002109: Finner ikke Task.focus" S="2.16.578.1.12.4.1.1.8221" />

I tabellen under er definerte feilkoder angitt:

Innsending av oppgave (Task eller Bundle)

Feilkode	Apprec feilkode ved meldingsbasert integrasjon	Forklaring

Feilkode	Apprec feilkode ved meldingsbasert integrasjon	Forklaring
2120	X99	Feil ved håndtering av meldingen. Denne feilmeldinngen gjelder kun meldingsbasert integrasjon og betyr at mottatt XML-melding (via AMQP) ikke validerte i henhold til skjema for Hodemelding.
002122	X99	Forespørsel må inneholde ett Task-objekt
002102	E31	Pasientens fødselsnummer er feil
002108	X99	Finner ikke Task.description
002110	X99	Finner ikke Task.code.text
002104	X99	Feil ved lesing av Task.meta.security
002109	X99	Finner ikke Task.focus
002113	X99	Finner verken Task.instantiatesUri eller Task.focus.identifier
002147	X99	Finner ikke Task.instantiatesUri
002111	X99	Finner ikke Task.focus.identifier
002114	X99	Feil ved lesing av frist (Task.Restriction.Period.End)
002134	X99	Ugyldig verdi for Task.Intent: '{intent}'
002107	X99	Duplikat Task.id: {taskId}
002148	X99	Duplikat Task.identifier: {eksternRef}
002106	X99	Feil ved lesing av Task.identifier
002125	X99	Innbygger har reservert seg mot henvendelser for sekundærbruk.
002129	X99	Den angitte personverninnstillingen {id} refererer ikke til noen aktive personvernsinnstilling. Gjelder for Samtrykkeforespørsel.
002118	E35	Pasienten er ikke digitalt aktiv for tjeneste: {tjenesteId}
002103	E35	Pasienten finnes ikke i mottakersystemet
001012	X99	{propertyName} må ha verdi og kan ikke være lengre enn {size} karakterer lang.
002153	X99	{Task.identifier}: er ikke tillatt for innbygger med adressesperre.

Feilkode	Apprec feilkode ved meldingsbasert integrasjon	Forklaring

Feilkode	Apprec feilkode ved meldingsbasert integrasjon	Forklaring
001002	X99	{name} kan ikke være null eller tom
002146	X99	Type: '{type}' - Path: '{path}' - Name: '{name}' støttes ikke
002135	X99	Finner ikke oppgave med OppgaveGuid: '{oppgaveGuid}'
002122	X99	Forespørsel inneholder ikke referanse til et Task (som skal patches)
002143	X99	Feil ved oppdatering av oppgave.
002139	X99	Oppgavens gyldighet er utløpt
002140	X99	Oppgave kan ikke endres når oppgavestatus er '{status}'
002149	X99	Kan ikke endre oppgaveStatus til '{status}'.
002136	X99	'{property}' må være frem i tid. Verdi: '{value}'
002145	X99	'{value}' må være mindre enn '{guard}'
002142	X99	'{value}' må være større enn '{guard}'
002144	X99	Kan ikke oppdatere Task.statusReason uten en tilhørende oppdatering av Task.status
002141	X99	Feil ved oppdatering av oppgave: '{oppgaveId}'
002104	X99	Feil ved lesing av Task.meta.security