Husk å legg til etiketten “api-dokumentasjon” når denne malen benyttes, samt å slette denne notisen
Med eKonsultasjon menes her at innbygger kan kontakte valgt behandler, eller at behandler kan kontakte innbygger for en konsultasjon. Begge parter kan svare på en forespørsel og dialogen kan bestå av mange meldinger i en samtaletråd.
Page Properties
API-navn
DIALOG_INNBYGGER_EKONSULTASJON
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 en henvendelse fra innbygger er vist under. Figuren viser bare et enkelt svar, men dialogprosessen støtter flere meldinger knyttet til en henvendelse.
Image Removed
Tilsvarende er sekvensdiagram der behandler starter en forespørsel vist i figuren under.
Image Removed
En av følgende prosesser skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
Prosess
Funksjonalitet
Versjon
Dialog_Innbygger_Ekonsultasjon
Første versjon av kommunikasjonsprosess. Skal ikke tas i bruk av nye aktører og vil fases ut.
1.1
Dialog_Innbygger_Ekonsultasjon
Håndtering av pasientrelasjon. Helsenorge.no kan sende meldinger 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 eKonsultasjon
Her er strukturen på query
Expand
title
Struktur på query
Tjeneste
Forespørsel om e-konsultasjon, asynkron tjeneste
Bruksområde
Brukes når innbygger sender spørsmål 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_EKONSULTASJON " DN="Dialog med innbygger - eKonsultasjon"/>
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:
SB Spørsmål til behandler
XML eksempel:
Code Block
<Foresporsel>
<TypeForesp V="SB" DN="Spørsmål til behandler
Med eKonsultasjon menes her at innbygger kan kontakte valgt behandler, eller at behandler kan kontakte innbygger for en konsultasjon. Begge parter kan svare på en forespørsel og dialogen kan bestå av mange meldinger i en samtaletråd.
Page Properties
API-navn
DIALOG_INNBYGGER_EKONSULTASJON
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 en henvendelse fra innbygger er vist under. Figuren viser bare et enkelt svar, men dialogprosessen støtter flere meldinger knyttet til en henvendelse.
Image Added
Tilsvarende er sekvensdiagram der behandler starter en forespørsel vist i figuren under.
Image Added
Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
Prosess
Funksjonalitet
Versjon
Dialog_Innbygger_Ekonsultasjon
Håndtering av pasientrelasjon. Helsenorge.no kan sende meldinger på vegne av annen person.
1.2
Oppdatert versjon som støtter
Mulighet for Helsepersonell til å markere ekonsultasjon som viktig og Helsenorge å sende oppdatering om ulest ekonsultasjon
Mulighet til innbygger å trekke ekonsultasjon
1.3
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 spørsmål til sin fastlege (eller annen behandler).
Hodemelding
Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding
Obligatorisk verdi i MsgHead/MsgInfo/Type er:
Code Block
<Type V="DIALOG_INNBYGGER_EKONSULTASJON " DN="Dialog med innbygger - eKonsultasjon"/>
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:
SB Spørsmål til behandler
XML eksempel:
Code Block
<Foresporsel>
<TypeForesp V="SB" DN="Spørsmål til behandler" S="2.16.578.1.12.4.1.1.7601"/>
<EmneSporsmal>Vorte under fot</EmneSporsmal>
<Sporsmal>Hei. Jeg har en vorte under foten som har vært litt hoven og vond de to siste dagene. Hva bør jeg gjøre med dette? Se på vedlagte bilde av vorten</Sporsmal>
</Foresporsel>
RollerRelatertNotat
Valgfritt, benyttes i henhold til Dialogmelding under RollerRelatertNotat
Angir helsepersonellet det ønskes at dialogen rutes til. Bruk av denne forutsetter at prosessen AMQP Behandleroversikt er støttet og Helsenorge.no kan hente behandlere fra EPJ
Svar på forespørsel om e-konsultasjon, asynkron tjeneste
Bruksområde
Brukes når fastlege eller annen behandler svarer på spørsmål fra innbygger.
Hodemelding
Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding
Obligatorisk verdi i MsgHead/MsgInfo/Type er:
Code Block
<Type V="DIALOG_INNBYGGER_EKONSULTASJON " DN="Dialog med innbygger - eKonsultasjon"/>
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:
12 Svar fra behandler
13 Dialog avsluttet
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
XML eksempel:
Code Block
<Notat>
<TemaKodet DN="Svar på spørsmål fra behandler" V="12" S="2.16.578.1.12.4.1.1. 7602"/>
<TekstNotatInnhold>Du kan prøve å ha foten i grønnsåpevann daglig i 2x15 min. Dersom du ikke blir bedre i løpet av en 2-3 dager så bør du bestille en time</TekstNotatInnhold>
</Notat>
RollerRelatertNotat
Valgfritt, benyttes i henhold til Dialogmelding under RollerRelatertNotat
RollerRelatertNotat angir helsepersonellet som besvarte meldingen og gir mulighet til å skille hvem meldingen er adressert fra (hodemelding) og hvem som besvarer
<EmneSporsmal>Vorte under fot</EmneSporsmal>
<Sporsmal>Hei. Jeg har en vorte under foten som har vært litt hoven og vond de to siste dagene. Hva bør jeg gjøre med dette? Se på vedlagte bilde av vorten</Sporsmal>
</Foresporsel>
RollerRelatertNotat
Valgfritt, benyttes i henhold til kapittel 2.3.5.
Angir helsepersonellet det ønskes at dialogen rutes til. Bruk av denne forutsetter at prosessen 3.12 Behandler er støttet og Helsenorge.no kan hente behandlere fra EPJ
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 dersom f.eks. innbygger legger et bilde ved timebestillingen.
Se kapittel 2.10 for korrekt bruk.
Svar fra helsepersonell på forespørsel om eKonsultasjon
Her er strukturen på en respons
Expand
title
Struktur på response
Tjeneste
Svar på forespørsel om e-konsultasjon, asynkron tjeneste
Bruksområde
Brukes når fastlege (eller annen behandler) svarer på spørsmål fra innbygger.
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_EKONSULTASJON " DN="Dialog med innbygger - eKonsultasjon"/>
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:
12 Svar fra behandler
13 Dialog avsluttet
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
XML eksempel:
Code Block
<Notat>
<TemaKodet DN="Svar på spørsmål fra behandler" V="12
Behandler kan 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å henvendelsen fra behandler dersom dette er angitt.
Expand
title
Struktur på forespørsel
Tjeneste
eKonsultasjon, asynkron tjeneste
Bruksområde
Brukes når behandler ø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_EKONSULTASJON " DN="Dialog med innbygger - eKonsultasjon"/>
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 behandler. Dette kan benyttes når behandler kun ønsker å informere innbygger om et tema.
«Dialog avsluttet»: benyttes når legen anser dialogen for avsuttet. Helsenorge.no vil vise denne informasjonen til innbygger, men innbygger kan fortsette dialogen.
XML eksempel:
Code Block
<Foresporsel>
<TypeForesp V="DI" DN="Dialog med innbygger " S="2.16.578.1.12.4.1.1.7601"/>
<EmneSporsmal> Prøveresultat </EmneSporsmal>
<Sporsmal><div xmlns="http://www.w3.org/1999/xhtml">
<h1>Prøveresultater på blodprøve</h1>
<p>Vedlagt er svarene på blodprøvene angående allergi som ble tatt forrige uke. Ta kontakt dersom du har spørsmål til dette.<br/>
<br/>
<br/>Med vennlig hilsen din fastlege<br/>August September</p>
</div>
.</Sporsmal>
</Foresporsel>
RollerRelatertNotat
Valgfritt, benyttes i henhold til Dialogmelding under RollerRelatertNotat.
RollerRelatertNotat angir helsepersonellet som skrev meldingen og gir mulighet til å skille hvem meldingen er adressert fra (hodemelding) og hvem som besvarer.
<TekstNotatInnhold>Du kan prøve å ha foten i grønnsåpevann daglig i 2x15 min. Dersom du ikke blir bedre i løpet av en 2-3 dager så bør du bestille en time</TekstNotatInnhold>
</Notat>
RollerRelatertNotat
Valgfritt, benyttes i henhold til kapittel 2.4.5.
RollerRelatertNotat angir helsepersonellet som besvarte meldingen og gir mulighet til å skille hvem meldingen er adressert fra (hodemelding) og hvem som besvarer
Valgfri informasjon som kanvære med dersom lege ønsker å sende informasjon til pasient.
Se kapittel 2.10 for korrekt bruk.
Forespørsel fra helsepersonell om eKonsultasjon
Med «ekonsultasjon, forespørsel fra helsepersonell» menes det at behandler kan sende en melding til innbygger uten at det er initiert noe dialog i form av en forespørsel fra innbygger i forkant. Innbygger kan svare på henvendelsen fra behandler dersom dette er angitt.
Expand
title
Struktur på response
Tjeneste
eKonsultasjon, asynkron tjeneste
Bruksområde
Brukes når behandler ø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_EKONSULTASJON " DN="Dialog med innbygger - eKonsultasjon"/>
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 behandler. Dette kan benyttes når behandler kun ønsker å informere innbygger om et tema.
«Dialog avsluttet»: benyttes når legen anser dialogen for avsuttet. Helsenorge.no vil vise denne informasjonen til innbygger, men innbygger kan fortsette dialogen.
«eKonsultasjon, svar fra innbygger», asynkron tjeneste
Bruksområde
Brukes når innbygger svarer på en henvendelse fra behandler.
Hodemelding
Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding
Obligatorisk verdi i MsgHead/MsgInfo/Type er:
Code Block
<Type V="DIALOG_INNBYGGER_EKONSULTASJON " DN="Dialog med innbygger - eKonsultasjon"/>
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
41 Varsel om ulest melding (krever versjon 1.3, sendes av Helsenorge som system)
42 Forespørsel trukket (krever versjon 1.3)
XML eksempel:
Code Block
<Notat>
<TemaKodet DN="Svar fra innbygger" V="22" S="2.16.578.1.12.4.1.1.7602"/>
<Tema>Prøveresultat</Tema>
<TekstNotatInnhold>Hei. Jeg lurer på hvor alvorlig resultatet for nøtteallergi er. Kan jeg spise ting som inneholder spor av nøtter?</TekstNotatInnhold>
</Notat>
RollerRelatertNotat
Benyttes ikke når innbygger svarer på en melding.
iCalender
Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell
Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon
Obligatorisk informasjon nåren annen person enn innbygger sender melding på vegne av pasient.
>
<h1>Prøveresultater på blodprøve</h1>
<p>Vedlagt er svarene på blodprøvene angående allergi som ble tatt forrige uke. Ta kontakt dersom du har spørsmål til dette.<br/>
<br/>
<br/>Med vennlig hilsen din fastlege<br/>August September</p>
</div>
.</Sporsmal>
</Foresporsel>
RollerRelatertNotat
Valgfritt, benyttes i henhold til kapittel 2.3.5.
RollerRelatertNotat angir helsepersonellet som skrev meldingen og gir mulighet til å skille hvem meldingen er adressert fra (hodemelding) og hvem som besvarer.
<Tema>Prøveresultat</Tema>
<TekstNotatInnhold>Hei. Jeg lurer på hvor alvorlig resultatet for nøtteallergi er. Kan jeg spise ting som inneholder spor av nøtter?</TekstNotatInnhold>
</Notat>
RollerRelatertNotat
Valgfritt, benyttes i henhold til kapittel 2.3.5.
Angir helsepersonellet det ønskes at dialogen rutes til. Bruk av denne forutsetter at prosessen 3.12 Behandler er støttet og Helsenorge.no kan hente behandlere fra EPJ