AMQP Behandleroversikt

 

Prosessen behandleroversikt kan benyttes for å vise tilgjengelige behandlere fra en kommunikasjonspart til innbygger. Dersom det finnes aktuelle behandlere skal EPJ-systemet svare tilbake med en liste med disse, alternativt svare med en kode som angir at det ikke fantes noen behandlere.

I versjon 1.0 av meldingstypen og når denne benyttes for fastleger, skal fastlegen ikke være en del av listen over behandlere i responsen fra EPJ-systemet. Designvalget her var at fastlegen alltid en tilgjengelig behandler for innbygger og kan hentes fra fastlegeregisteret. Dette er uheldig for håndtering av fravær av fastlegen.

Det blir derfor innført en versjon 1.1 av meldingstypen der alle behandlere som er tilgjengelig skal sendes i responsen. Formatet på meldingene er ellers uforandret.

Sekvensdiagram for meldingstypen er vist i figuren under:

API-navn

DIALOG_INNBYGGER_BEHANDLEROVERSIKT

Funksjonelt område

Dialog

API-versjon og dato publisert

v1.1 Nov 13, 2023

Status

I Drift

API-dokumentasjon sist endret

Nov 13, 2023

Teknologi

AMQP

Versjon 1.1 er ikke tilgjengelig i produksjon og det er versjon 1.0 som skal benyttes i prod.

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

Prosess

Funksjonalitet

Versjon

Dialog_Innbygger_BehandlerOversikt

Basisversjon for kommunikasjonsprosess

1.0

Oppdatert versjon der fastlegen også sendes i respons og ikke blir lagt til default av Helsenorge. En ny versjon er nødvendig slik at Helsenorge vet om fastlege skal legges til eller ikke.

1.1

 

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

Versjon

Rolle

Funksjon

Meldingsinnhold

1.0

Innbygger

Hent

Dialogmelding 1.1

Pasientrelasjon

Helsepersonell

Svar

Dialogmelding 1.1

Helsepersonell

1.1

Innbygger

Hent

Dialogmelding 1.1

Pasientrelasjon

Helsepersonell

Svar

Dialogmelding 1.1

Helsepersonell

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Forespørsel om Behandleroversikt

Tjeneste

Forespørsel om behandleroversikt, synkron tjeneste

Bruksområde

Forespørsel fra helsenorge.no for å hente aktuelle behandlere for en innbygger.

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding

Obligatorisk verdi i MsgHead/MsgInfo/Type er:

<Type V="DIALOG_INNBYGGER_BEHANDLEROVERSIKT" DN="Dialog med innbygger – behandleroversikt />

Obligatorisk verdi i MsgHead/MsgInfo/Ack er:

<Ack DN="Nei" V="N"/>

Dialogmelding

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Foresporsel/TypeForesp

Lovlige kodeverdier som kan brukes i TypeForesp:

  • HB Hent behandler

XML eksempel:

<Foresporsel>       <TypeForesp V="HB" DN="Hent behandlere"  ="2.16.578.1.12.4.1.1.7601"/> </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 henter behandlere på vegne av pasient.

Se Pasientrelasjon for korrekt bruk.

Vedlegg

Ikke aktuelt å bruke for denne tjenesten

 

Svar på Behandleroversikt

Tjeneste

Svar på forespørsel om hent behandlere, synkron tjeneste

Bruksområde

Svar fra kommunikasjonspart med aktuelle behandlere som finnes for en innbygger for tjenesten angitt i hodemeldingen.

Dersom ingen behandlere finnes skal kode for dette returneres. Dersom det returneres behandlere skal også fastlegen returneres som del av listen.

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

Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding.

  • Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet:

  • 20 Behandlere      

  • 21 Behandlere ikke funnet

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

  • 30 Ikke tilgang

  • 31 Generell feil

XML eksempel:

 

RollerRelatertNotat

Ikke aktuelt å bruke for denne tjenesten

iCalender

Ikke aktuelt å bruke for denne tjenesten

Helsepersonell

Obligatorisk informasjon dersom koden «20   Behandler» returneres:

Obligatoriske elementer (klasse/element):

  • FamiliyName

  • GivenName

  • Ident

Valgfrie elementer (klasse/element):

  • Kan benyttes til å sende fritekstinformasjon som vises til innbygger

  • Angis med kodeverk 9060 og vises i brukerflaten i helsenorge

  • Angis med kodeverk 9034 og vises i brukerflaten i helsenorge

 

XML eksempel:

Pasientrelasjon

Ikke aktuelt å bruke for denne tjenesten

Vedlegg

Ikke aktuelt å bruke for denne tjenesten

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Eksempelmeldinger

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: Meldingsutveksling med Helsenorge