Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
InfoHusk å 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
colourGreen
titleI Drift

API-dokumentasjon sist endret

Teknologi

Status
colourPurple
titleAMQP

Prosesser og flyt

Her er info om prosesser og flyt

Expand
titleOverordnet flyt og sekvensdiagram

Sekvensdiagram for henvendelse fra innbygger er vist i figuren under

Sekvensdiagram for eKontakt startet av behandler er vist i figuren under

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
titleStruktur 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

 

XML eksempel:

Code Block
<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å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
titleStruktur 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
titleStruktur 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 " 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>

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
titleStruktur 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.

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

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Expand
titleBenytter av følgende komponenter

Navn

Type

Beskrivelse