Husk å legg til etiketten “api-dokumentasjon” når denne malen benyttes, samt å slette denne notisen
Med «eKontakt» menes her at innbygger kan gjøre en administrativ henvendelse til en tjeneste. Tilsvarende kan en kommunikasjonspart kontakte innbygger for administrative henvendelser.
Page Properties
API-navn
DIALOG_INNBYGGER_EKONTAKT
Funksjonelt område
Dialog
API-versjon og dato publisert
v1.2
Status
Status
colour
Green
title
I Drift
API-dokumentasjon sist endret
Teknologi
Status
colour
Purple
title
AMQP
Prosesser og flyt
Her er info om prosesser og flyt
Expand
title
Overordnet flyt og sekvensdiagram
Sekvensdiagram for henvendelse fra innbygger er vist i figuren under
Image Removed
Sekvensdiagram for eKontakt startet av behandler er vist i figuren under
Image Removed
En av følgende prosesser skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
Prosess
Funksjonalitet
Versjon
Dialog_Innbygger_Ekontakt
Første versjon av kommunikasjonsprosess. Skal ikke tas i bruk av nye aktører.
1.1
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.1
Innbygger
Foresporsel
Svar
Dialogmelding 1.1
Helsepersonell
Foresporsel
Svar
Dialogmelding 1.1
1.2
Innbygger
Foresporsel
Svar
Dialogmelding 1.1
Pasientrelasjon
Helsepersonell
Foresporsel
Svar
Dialogmelding 1.1
Forespørsel fra innbygger om eKontakt
Her er strukturen på query
Expand
title
Struktur på query
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 kapittel 2.3
Obligatorisk verdi i MsgHead/MsgInfo/Type er:
Code Block
<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt"/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Code Block
<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
Obligatorisk informasjonnåren annen person enn utfører timereservasjon på vegne av pasient.
Se kapittel 2.4.6 for korrekt bruk.
Vedlegg
Valgfri informasjon som kanvære med.
Se kapittel 2.10 for korrekt bruk.
Svar på forespørsel om eKontakt fra innbygger
Her er strukturen på en respons
Expand
title
Struktur på response
Tjeneste
Svar på forespørsel om eKontakt, asynkron tjeneste
Bruksområde
Svar når innbygger sender en administrativ henvendelse til sin fastlege (eller annen behandler).
Hodemelding
Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.3
Obligatorisk verdi i MsgHead/MsgInfo/Type er:
Code Block
<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt "/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Code Block
<Ack DN="Ja" V="J"/>
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 i henhold til beskrivelse i avsnitt 2.4.6
XML eksempel:
Code Block
<Notat>
<TemaKodet DN=" Svar på henvendelse " V="19" S="2.16.578.1.12.4.1.1. 7602"/>
<TekstNotatInnhold>Takk for melding, Vi ser på dette på planlagt besøk i morgen.</TekstNotatInnhold>
<RollerRelatertNotat>
<RolleNotat V="1" DN="Forfatter" S="2.16.578.1.12.4.1.1.9057"/>
<:Person>
<FamilyName>Olsen</FamilyName>
<GivenName>Tove</GivenName>
</Person>
</RollerRelatertNotat>
</Notat>
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 kanvære med dersom lege sender informasjon til pasient.
Se kapittel 2.10 for korrekt bruk.
Forespørsel fra tjeneste om eKontakt
Med denne funksjonen kan en aktør 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.
Expand
title
Struktur på query
Tjeneste
eKontakt, melding til innbygger, asynkron tjeneste
Bruksområde
Brukes når legekontor ø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 kapittel 2.3
Obligatorisk verdi i MsgHead/MsgInfo/Type er:
Code Block
<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt"/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Code Block
<Ack DN="Ja" V="J"/>
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 i henhold til beskrivelse i avsnitt 2.4.6
XML eksempel:
Code Block
<Foresporsel>
<TypeForesp V="EKI" DN="Engangskontakt med innbygger
Med «eKontakt» kan innbygger gjøre en administrativ henvendelse til en tjeneste. Tilsvarende kan en kommunikasjonspart kontakte innbygger for administrative henvendelser.
Page Properties
API-navn
DIALOG_INNBYGGER_EKONTAKT
Funksjonelt område
Dialog
API-versjon og dato publisert
v1.2
Status
Status
colour
Green
title
I Drift
API-dokumentasjon sist endret
Teknologi
Status
colour
Purple
title
AMQP
Prosesser og flyt
Her er info om prosesser og flyt
Expand
title
Overordnet flyt og sekvensdiagram
Sekvensdiagram for henvendelse fra innbygger er vist i figuren under
Image Added
Sekvensdiagram for eKontakt startet av behandler er vist i figuren under
Image Added
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.
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:
Code Block
<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt"/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Code Block
<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
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:
Code Block
<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt "/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Code Block
<Ack DN="Ja" V="J"/>
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:
Code Block
<Notat>
<TemaKodet DN=" Svar på henvendelse " V="19" S="2.16.578.1.12.4.1.1. 7602"/>
<TekstNotatInnhold>Takk for melding, Vi ser på dette på planlagt besøk i morgen.</TekstNotatInnhold>
<RollerRelatertNotat>
<RolleNotat V="1" DN="Forfatter" S="2.16.578.1.12.4.1.1.9057"/>
<:Person>
<FamilyName>Olsen</FamilyName>
<GivenName>Tove</GivenName>
</Person>
</RollerRelatertNotat>
</Notat>
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 kanvære med dersom lege sender informasjon til pasient.
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.
Expand
title
Struktur på forespørsel
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:
Code Block
<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt"/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Code Block
<Ack DN="Ja" V="J"/>
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:
Code Block
<Foresporsel>
<TypeForesp V="EKI" DN="Engangskontakt med innbygger " S="2.16.578.1.12.4.1.1.7601"/>
<EmneSporsmal>Vaksinen ankommet</EmneSporsmal>
<Sporsmal><div xmlns="http://www.w3.org/1999/xhtml">
<h1>Vaksine klar</h1>
<p>Vaksinen du har etterspurt er nå ankommet vårt legekontor. Vennligst bestill time hos din lege for å få satt vaksinen<br/>
<br/>
<br/>Med vennlig hilsen <br/>Nanset Legekontor</p>
</div>
.</Sporsmal>
</Foresporsel>
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:
Code Block
<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt"/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Code Block
<Ack DN="Ja" V="J"/>
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:
Code Block
<Notat>
<TemaKodet DN="Svar fra innbygger" V="22" S="2.16.578.1.12.4.1.1. 7602"/>
<Tema>Timen den 2. juli</Tema>
<TekstNotatInnhold>Det stemmer at jeg har endret fastlege, men jeg har glemt å avbestille denne timen. Dere kan bare fjerne timen jeg har hos dere 2. juli</TekstNotatInnhold>
</Notat>
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åren annen person enn utfører timereservasjon på vegne av pasient.
<h1>Vaksine klar</h1>
<p>Vaksinen du har etterspurt er nå ankommet vårt legekontor. Vennligst bestill time hos din lege for å få satt vaksinen<br/>
<br/>
<br/>Med vennlig hilsen <br/>Nanset Legekontor</p>
</div>
.</Sporsmal>
</Foresporsel>
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 kanvære med.
Se kapittel 2.10 for korrekt bruk.
Svar fra innbygger på forespørsel om eKontakt fra tjeneste
Her er strukturen på en respons
Expand
title
Struktur på response
Tjeneste
«eKontakt, svar fra innbygger», asynkron tjeneste
Bruksområde
Brukes når innbygger svarer på en henvendelse fra legekontor.
Hodemelding
Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.3
Obligatorisk verdi i MsgHead/MsgInfo/Type er:
Code Block
<Type V="DIALOG_INNBYGGER_EKONTAKT" DN="Dialog med innbygger - eKontakt"/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Code Block
<Ack DN="Ja" V="J"/>
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 i henhold til beskrivelse i avsnitt 2.4.6
XML eksempel:
Code Block
<Notat>
<TemaKodet DN="Svar fra innbygger" V="22" S="2.16.578.1.12.4.1.1. 7602"/>
<Tema>Timen den 2. juli</Tema>
<TekstNotatInnhold>Det stemmer at jeg har endret fastlege, men jeg har glemt å avbestille denne timen. Dere kan bare fjerne timen jeg har hos dere 2. juli</TekstNotatInnhold>
</Notat>
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åren annen person enn utfører timereservasjon på vegne av pasient.
Se kapittel 2.4.6 for korrekt bruk.
Vedlegg
Valgfri informasjon som kanvære med.Se kapittel 2.10 for korrekt bruk.
</Ident>
<Organisation>
<OrganisationName>Digitale innbyggertjenester</OrganisationName>
<Ident>
<Id>8130047</Id>
<TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/>
</Ident>
</Organisation>
</Organisation>
</Receiver>
<Patient>
<FamilyName>Danser</FamilyName>
<GivenName>Line</GivenName>
<Ident>
<Id>13116900216</Id>
<TypeId V="FNR" S="2.16.578.1.12.4.1.1.8116" DN="Fødselsnummer"/>
</Ident>
</Patient>
</MsgInfo>
<Document>
<ContentDescription>Bestille attest svar</ContentDescription>
<RefDoc>
<IssueDate V="2019-05-21T07:21:43.0Z"/>
<MsgType V="XML" DN="XML-instans"/>
<Content>
<Dialogmelding xmlns="http://www.kith.no/xmlstds/dialog/2013-01-23" xmlns:xsd="http://www.w3.org/2001/XMLSchema.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.kith.no/xmlstds/dialog/2013-01-23 ../../../sarepta/skjema/dialogmelding/2013-01-23/dialogmelding-v1.1.xsd">
<Notat>
<TemaKodet V="19" S="2.16.578.1.12.4.1.1.7602" DN="Svar på henvendelse"/>
<TekstNotatInnhold>Takk for melding, Vi ser på dette på planlagt besøk i morgen.</TekstNotatInnhold>
</Notat>
</Dialogmelding>
</Content>
</RefDoc>
</Document>
</MsgHead>
Generell info om meldingsutveksling med Helsenorge