AMQP eKontakt

Med «eKontakt» kan innbygger gjøre en administrativ henvendelse til en tjeneste. Tilsvarende kan en kommunikasjonspart kontakte innbygger for administrative henvendelser.

API-navn	DIALOG_INNBYGGER_EKONTAKT
Funksjonelt område	Dialog
API-versjon og dato publisert	v1.2 Nov 23, 2015
Status	I Drift
API-dokumentasjon sist endret	Dec 8, 2021
Teknologi	AMQP

Prosesser og flyt

Her er info om prosesser og flyt

Sekvensdiagram for henvendelse fra innbygger er vist i figuren under

Sekvensdiagram for eKontakt startet av behandler er vist i figuren under

Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_Ekontakt	Håndtering av pasientrelasjon. Helsenorge.no sender melding på vegne av annen person.	1.2

Tabellen under viser hvilke roller som inngår i prosessen, hvilke funksjoner de ulike rollene kan gjøre og hvilke meldinger som benyttes for de ulike versjonene.

Versjon

Rolle

Funksjon

Meldingsinnhold

1.2

Innbygger

Foresporsel

Svar

Dialogmelding 1.1

Pasientrelasjon

Helsepersonell

Foresporsel

Svar

Dialogmelding 1.1

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Forespørsel fra innbygger

Tjeneste	Forespørsel om eKontakt, asynkron tjeneste
Bruksområde	Brukes når innbygger sender en administrativ henvendelse.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt"/>` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Ja" V="J"/>` Dersom det sendes varsel om ulest svar eller henvendelse er det obligatorisk å referere til svar/henvendelse i elementet MsgHead/MsgInfo/ConversationRef.
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Foresporsel/TypeForesp Lovlige kodeverdier som kan brukes i TypeForesp: HE Henvendelse Valgfrie elementer (klasse/element): Dialogmelding/Foresporsel/EmneSporsmal Dialogmelding/Foresporsel/Sporsmal Dialogmelding/Sakstype i henhold til beskrivelse i avsnitt 2.4.6 XML eksempel: `<Foresporsel> <TypeForesp V="HE" DN="Henvendelse" S="2.16.578.1.12.4.1.1. 7601"/> <EmneSporsmal>Åpningstider?</EmneSporsmal> <Sporsmal>Stemmer åpningstidene på nettsiden?</Sporsmal> </Foresporsel>` RollerRelatertNotat Ikke aktuelt å bruke for denne tjenesten.
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Obligatorisk informasjon når en annen person enn utfører timereservasjon på vegne av pasient. Se Pasientrelasjon for korrekt bruk.
Vedlegg	Valgfri informasjon som kan være med. Se Vedlegg for korrekt bruk.

Svar fra helsekontakt

Tjeneste	Svar på forespørsel om eKontakt, asynkron tjeneste
Bruksområde	Svar når innbygger sender en administrativ henvendelse til en helsekontakt
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Notat/Temakodet Dialogmelding/Notat/TekstNotatInnhold Dialogmelding/Notat/Foresporsel Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 13 Dialog avsluttet 19 Svar på henvendelse Avvisning av henvendelse/forespørsel: dersom system/behandler ikke kan svare på mottatt henvendelse/forespørsel kan følgende kodeverdier fra kodeverk 7602 benyttes i elementet <Dialogmelding/Notat/Temakodet>: 26 Forespørsel avvist 30 Ikke tilgang Valgfrie elementer (klasse/element): Dialogmelding/Sakstype, benyttes i henhold til beskrivelse i Dialogmelding under Referanse til helsekontakt - Sakstype XML eksempel: RollerRelatertNotat Denne kan benyttes til å angi hvem som besvarer, og fornavn og etternavn på den som har besvart legges ved i meldingen. Dette gjør at denne informasjonen kan oversendes på strukturert form og også kan vises til innbygger på http://helsenorge.no
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Valgfri informasjon som kan være med dersom lege sender informasjon til pasient. Se Vedlegg for korrekt bruk.

Forespørsel fra helsekontakt

Med denne funksjonen kan en helsekontakt sende en melding til innbygger uten at det er initiert dialog i form av en forespørsel fra innbygger i forkant. Innbygger kan svare på forespørsel dersom dette angis.

Tjeneste	eKontakt, melding til innbygger, asynkron tjeneste
Bruksområde	Brukes når helseaktør ønsker å initiere dialog og sende en melding til innbygger uten at det foreligger en forespørsel fra innbyggeren.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Foresporsel/TypeForesp Dialogmelding/Foresporsel/EmneSporsmal Dialogmelding/Foresporsel/Sporsmal Lovlige kodeverdier som kan brukes i TypeForesp: DI Dialog med innbygger EKI Engangskontakt med innbygger Bruk av kodeverdiene: «Dialog med innbygger»: benyttes når innbygger skal gis anledning til å svare på dialogen med behandler. «Engangskontakt med innbygger»: betyr at innbygger ikke skal kunne svar på meldingen fra legekontor. Dette kan benyttes når legekontor kun ønsker å informere innbygger om noe. Valgfrie elementer (klasse/element): Dialogmelding/Sakstype, benyttes i henhold til beskrivelse i Dialogmelding under Referanse til helsekontakt - Sakstype XML eksempel: RollerRelatertNotat Ikke aktuelt å bruke for denne tjenesten.
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Valgfri informasjon som kan være med. Se Vedlegg for korrekt bruk.

Svar fra innbygger

Tjeneste	«eKontakt, svar fra innbygger», asynkron tjeneste
Bruksområde	Brukes når innbygger svarer på en henvendelse fra helsekontakt
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Notat/Temakodet Dialogmelding/Notat/TekstNotatInnhold Dialogmelding/Notat/Foresporsel Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 22 Svar fra innbygger Valgfrie elementer (klasse/element): Dialogmelding/Sakstype, benyttes i henhold til beskrivelse i Dialogmelding under Referanse til helsekontakt - Sakstype XML eksempel: RollerRelatertNotat Ikke aktuelt å bruke for denne tjenesten.
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Obligatorisk informasjon når en annen person enn utfører timereservasjon på vegne av pasient. Se Pasientrelasjon for korrekt bruk.
Vedlegg	Valgfri informasjon som kan være med. Se Vedlegg for korrekt bruk.

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Eksempelmeldinger

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: https://helsenorge.atlassian.net/wiki/pages/createpage.action?spaceKey=HELSENORGE&title=Meldingsutveksling%20med%20Helsenorge