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 med kode X99 (annen feil), og feilkoden fra API’et: <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)
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. |
Innsending av skjemaoppgave der Questionnaire også sendes med (Bundle)
Feilkode | Feilbeskrivelse | Apprec feilkode ved meldingsbasert integrasjon | Forklaring |
|---|---|---|---|
002122 | ForesporselInneholderIkkeEnTask | X99 | Forespørsel inneholder ikke 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}' |
002106 | ForesporselUgyldigTaskId | X99 | Feil ved lesing av Task.identifier |
002107 | ForesporselDuplikatTaskId | X99 | Duplikat Task.id: {taskId} |
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. |
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. |
002124 | ForesporselFinnerIkkeDialogMelding | X99 | Finner ikke dialogmelding |
002123 | IkkeStottetMeldingsformat | T10 | Støtter ikke typeforespørsel: '{typeforesporsel}' |
002136 | ForesporselDateTimeFremITid | X99 | '{property}' må være frem i tid. Verdi: '{value}' |
002137 | InneholderIkkeTaskEllerPatch | X99 | Forespørsel må enten være en Task eller Patch. |
002138 | InvalidTaskUrl | X99 | URL til task ('{fullUrl}') har ugyldig format. Må være på formen Task/<guid> |
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}'. |
Innsending av skjemaoppgave der Questionnaire også sendes med (Bundle)
Tjeneste | Feilkode | Feilbeskrivelse | Apprec feilkode ved meldingsbasert integrasjon | Forklaring |
|---|---|---|---|---|
POST v1/Bundle (skjemaoppgave inneholdende Task + Questionnaire) | ||||
002122 | ForesporselInneholderIkkeEnTask | X99 | Forespørsel inneholde kun 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}' | |
002106 | ForesporselUgyldigTaskId | X99 | Feil ved lesing av Task.identifier | |
002107 | ForesporselDuplikatTaskId | X99 | Duplikat Task.id: {taskId} | |
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. | |
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. | |
002124 | ForesporselFinnerIkkeDialogMelding | X99 | Finner ikke dialogmelding | |
002123 | IkkeStottetMeldingsformat | T10 | Støtter ikke typeforespørsel: '{typeforesporsel}' | |
002136 | ForesporselDateTimeFremITid | X99 | '{property}' må være frem i tid. Verdi: '{value}' | |
002137 | InneholderIkkeTaskEllerPatch | X99 | Forespørsel må enten være en Task eller Patch. | |
002138 | InvalidTaskUrl | X99 | URL til task ('{fullUrl}') har ugyldig format. Må være på formen Task/<guid> | |
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}'. | |
POST v1/Task | ||||
002122 | ForesporselInneholderIkkeEnTask | X99 | Forespørsel inneholde kun 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. | |
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. | |
PATCH v1/Task | ||||
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}' | |
002101 | FhirTaskParsingFailed | Feil ved lesing av FHIR Task element | ||
002122 | ForesporselInneholderIkkeEnTask | X99 | Forespørsel inneholde kun ett Task-objekt | |
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 |