Generelt
Ved innsending av oppgaver eller senere oppdatering av oppgaver kan API-kallet/meldingen avvises. Det er tre hovedkategorier feilmeldinger:
Tekniske feil relatert til med 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 beksrivelse 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 strandardisert 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>"/>
I tabellen under er definerte feilkoder angitt:
Innsending av oppgave (Task eller Bundle)
Feilkode | Feilbeskrivelse | Apprec feilkode ved meldingsbasert integrasjon | Forklaring |
|---|---|---|---|
002122 | ForesporselInneholderIkkeEnTask | X99 | Forespørsel må inneholde ett Task-objekt |
002102 | ForesporselUgyldigFnr | E31 | Pasientens fødselsnummer er feil |
002108 | ForesporselDescriptionMangler | X99 | Finner ikke Task.description |
002110 | ForesporselTittelMangler | X99 | Finner ikke Task.code.text |
002104 | ForesporselUgyldigMetaSecurity | X99 | Feil ved lesing av Task.meta.security |
002109 | ForesporselFocusMangler | X99 | Finner ikke Task.focus |
002113 | ForesporselInstantiatesUriOgIdentifierMangler | X99 | Finner verken Task.instantiatesUri eller Task.focus.identifier |
002147 | ForesporselInstantiatesUriMangler | X99 | Finner ikke Task.instantiatesUri |
002111 | ForesporselIdentifierMangler | X99 | Finner ikke Task.focus.identifier |
002114 | ForesporselUgyldigFrist | X99 | Feil ved lesing av frist (Task.Restriction.Period.End) |
002134 | ForesporselUgyldigIntent | X99 | Ugyldig verdi for Task.Intent: '{intent}' |
002107 | ForesporselDuplikatTaskId | X99 | Duplikat Task.id: {taskId} |
002148 | ForesporselDuplikatEksternRef | X99 | Duplikat Task.identifier: {eksternRef} |
002106 | ForesporselUgyldigTaskId | X99 | Feil ved lesing av Task.identifier |
002125 | InnbyggerHarReservasjonMotForesporselen | X99 | Innbygger har reservert seg mot henvendelser for sekundærbruk. |
002129 | PersonverninnstillingErIkkeAktiv | X99 | Den angitte personverninnstillingen {id} refererer ikke til noen aktive personvernsinnstilling. Gjelder for Samtrykkeforespørsel. |
002118 | ForesporselIkkeDigitaltAktiv | E35 | Pasienten er ikke digitalt aktiv for tjeneste: {tjenesteId} |
002103 | ForesporselPasientenFinnesIkke | E35 | Pasienten finnes ikke i mottakersystemet |
001012 | CharacterCountException | X99 | {propertyName} må ha verdi og kan ikke være lengere enn {size} karakterer lang. |
Oppdatering av allerede innsendt oppgave (FHIR PATCH)
Feilkode | Feilbeskrivelse | Apprec feilkode ved meldingsbasert integrasjon | Forklaring |
|---|---|---|---|
001002 | GuidNullOrEmpty | X99 | {name} kan ikke være null eller tom |
002146 | ForesporselPatchStottesIkke | X99 | Type: '{type}' - Path: '{path}' - Name: '{name}' støttes ikke |
002135 | ForesporselFinnerIkkeOppgave | X99 | Finner ikke oppgave med OppgaveGuid: '{oppgaveGuid}' |
002122 | ForesporselInneholderIkkeEnTask | X99 | Forespørsel inneholder ikke referanse til et Task (som skal patches) |
002143 | ForesporselFeilVedPatchingAvOppgave | X99 | Feil ved oppdatering av oppgave. |
002139 | ForesporselGyldighetUtlopt | X99 | Oppgavens gyldighet er utløpt |
002140 | ForesporselOppgaveKanIkkeEndresNarStatusEr | X99 | Oppgave kan ikke endres når oppgavestatus er '{status}' |
002149 | ForesporselUgyldigStatus | X99 | Kan ikke endre oppgaveStatus til '{status}'. |
002136 | ForesporselDateTimeFremITid | X99 | '{property}' må være frem i tid. Verdi: '{value}' |
002145 | ForesporselLessThan | X99 | '{value}' må være mindre enn '{guard}' |
002142 | ForesporselGreaterThan | X99 | '{value}' må være større enn '{guard}' |
002144 | ForesporselOppdatereStatusReasonUtenStatusOppdatering | X99 | Kan ikke oppdatere Task.statusReason uten en tilhørende oppdatering av Task.status |
002141 | ForesporselFeilVedOppdateringAvOppgave | X99 | Feil ved oppdatering av oppgave: '{oppgaveId}' |
002104 | ForesporselUgyldigMetaSecurity | X99 | Feil ved lesing av Task.meta.security |