Applikasjonskvittering
Applikasjonskvittering skal benyttes for asynkrone dialogtjenester. Dette for å bekrefte at melding er mottatt og kan behandles av systemet. For tjenester som besvares i sanntid med en fagmelding skal applikasjonskvittering ikke benyttes.
Applikasjonskvittering skal benyttes slik det er beskrevet i standarden for Applikasjonskvittering v1.1. Det er beskrevet at følgende hovedprinsipp gjelder for når det skal sendes positiv eller negativ kvittering.:
Type Applikasjonskvittering | Tolkning |
Positiv applikasjonskvittering | Fagmeldingen er mottatt og at den kan tolkes korrekt. Fageldingen vil da være klar for videre behandling i det aktuelle fagsystem og ansvarlig personell kan lese innholdet i mottatt fagmelding (dokument). |
Negativ applikasjonskvittering | Mottakende applikasjon kan ikke tolke opplysningene i mottatt fagmelding. Ingen videre oppfølging kan ventes av mottaker ved negativ applikasjonskvittering. |
En negativ applikasjonskvittering betyr i hovedsak at det var noe feil med mottatt melding slik at denne ikke kunne behandles av mottaker. Når det sendes en negativ kvittering forventes det at mottaker følger opp denne i henhold til feilkoder og sender en ny (og feilfri) melding.
Kodeverk 8221 «Feilmeldinger for applikasjonskvittering» skal brukes ved negativ applikasjonskvittering for å angi type feilmelding.
Ved mottak av en melding gjøres det i hovedsak to ulike valideringer
Validering på transportnivå. Beskrevet i AMQP profil
Validering av fagmelding. Ved feil her benyttes negative applikasjonskvitteringer.
Tabellen under viser negative applikasjonskvitteringer som kan forventes mottatt ved digital dialog
Kode | Bruk |
T01 – Ikke XML / ikke 'well formed' / uleselig | Mottatt XML kan ikke tolkes. |
T02 – XML validerer ikke | XSD-validering |
E10 Ugyldig meldingsidentifikator | Ikke samsvar AMQP Avsender HER-Id <-> fagmelding Avsender HER-Id eller Ikke samsvar AMQP mottager HER-Id <-> fagmelding mottager HER-Id |
E35 Pasienten finnes ikke i mottakersystemet | Innbygger er ikke digitalt aktiv og melding kan ikke behandles. Mottager av kvittering skal markere innbygger som ikke aktiv og melding skal ikke resendes. |
I noen tilfeller er melding korrekt og sendt til riktig innbygger, men meldingen kan likevel ikke behandles. Dette skjer dersom en aktør sender melding til en person som ikke har en innbyggerprofil på helsenorge.no og samtykke til digital helsetjeneste. Helsenorge.no har i dette tilfellet ikke lov til å lagre eller behandle meldingen.
I dette tilfellet sendes negativ kvittering med feilkoden «E35 - Pasienten finnes ikke i mottakersystemet». Mottager av kvittering skal markere innbygger som ikke aktiv og melding skal ikke resendes.
I noen tilfeller kan det oppstå feilsituasjoner, til tross for at mottatt melding var korrekt og ble lagret/tatt inn i mottakersystemet hos mottaker, slik at mottaker ikke kan behandle meldingen og svare med forventet svarmelding.
I slike tilfeller er det sendt positiv Applikasjonskvittering og det er behov for å gi beskjed om feilsituasjon slik at avsender av opprinnelig melding får opplysninger om dette. I slike tilfeller skal feilkoder beskrevet i https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1348174412 under Feilkoder brukt i Type forespørsel benyttes.
Kodene er tilgjengelig i kodeverk 7602 «Svar til bruk i digital dialog mellom pasient og behandler» på www.volven.no Feilkodene/temakodene skal ikke brukes i Applikasjonskvittering, men i Dialogmeldingen og feilkodene er generelle for alle dialogtjenestene. XML eksempel for bruk av feilkode er vist under.
<Dialogmelding >
<Notat>
<TemaKodet DN="Ikke tilgang" V="30" S="2.16.578.1.12.4.1.1.7602"/>
</Notat>
</Dialogmelding >De enkelte dialogtjenester beskriver når disse feilkodene/temakodene kan brukes.