Notifikasjon Helsekontakt kan benyttes for å sende en ny helsekontakt til innbygger, eller oppdatere en eksisterende helsekontakt
Forutsetninger for å bruke denne prosessen er:
Avsender må være registrert i Adresseregisteret med en Nivå 2 HerId som representerer
Notifikasjon Helsekontakt kan benyttes for å sende en ny helsekontakt til innbygger, eller oppdatere en eksisterende helsekontakt
Forutsetninger for å bruke denne prosessen er:
Avsender må være registrert i Adresseregisteret med en Nivå 2 HerId som representerer Helsekontakten
Avsender måvære i stand til å ha en elektronisk meldingsutveksling med Helsenorge i henhold til kommunikasjonsprosessen AMQP Dialog helsepersonell
Page Properties
API-navn
NOTIFIKASJON_INNBYGGER_HELSEKONTAKT
Funksjonelt område
Helsekontakter
API-versjon og dato publisert
v1.0
Status
Status
colour
Green
title
I DRIFT
API-dokumentasjon sist endret
(Lagt til referanse til henvisning)
Teknologi
Status
colour
Purple
title
AMQP
+
Status
colour
Red
title
FHIR
Prosesser og flyt
Her er info om prosesser og flyt
Expand
title
Overordnet flyt og sekvensdiagram
Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
Prosess
Funksjonalitet
Versjon
Notifikasjon_Innbygger_Helsekontakt
Avsender kan sende en helsekontakt til innbygger på Helsenorge.
1.0
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.0
Helsepersonell
Helsekontakt
FHIR
Innbygger
Apprec
Applikasjonskvittering
Sekvensdiagram for prosessen tjenesteoversikt er vist i figuren under.
Hodemelding er å betrakte som transport for selve Helsekontakten og inneholder informasjon om avsender, mottakende systrem samt pasient for notifikasjonen om en ny- eller endret helsekontakt. Selve Helsekontyakten er i sin helhet bekrevet i Document-delen av hodemelingen i form av FHIR-ressurs.
Expand
title
Krav til elementet «MsgHead/MsgInfo/MsgId»
Den unike id (MsgId) i Hodemeldingen skal være en UUID (Universally Unique Identifier).
Elementet «MsgHead/MsgInfo/Type» skal angi at meldingen er Notifikason - helsekontakt og skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon:
Kodeverdi
Kodetekst
NOTIFIKASJON_INNBYGGER_HELSEKONTAKT
Notifikasjon til innbygger – Helsekontakt
Expand
title
Krav til elementet «MsgHead/MsgInfo/Ack»
Elementet «MsgHead/MsgInfo/Ack» skal angi at det kreves applikasjonskvittering på meldingen.
Verdi og kode
<Ack DN="Ja" V="J" />
Expand
title
Krav til informasjonsinnhold for avsender og mottaker
Informasjon om avsender og mottaker av Hodemeldingen skal være i henhold til beskrivelsen i standardene for tjenestebasert adressering tilgjengelig her:
I avsender av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator. Dette er altså avsender av notifikasjonen, og er ikke relatert til selve helsekontakten.
XML eksempel med “Universitetssykehuset i Nord-Norge HF” som avsender:
I mottager av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator, et XML eksempel er vist under.
Krav til informasjonsinnhold for MsgHead/MsgInfo/Patient
For identifikasjon av en pasient benyttes kodeverket «ID-type for personer» 8116, se http://www.volven.no . Skjemaet støtter flere identifikatorer, men for digital dialog benyttes bare en identifikator og det er bare støtte for fødselsnummer eller D-nummer
Følgende informasjon er obligatorisk å oppgi for pasient.
Hodemeldingen har struktur for å ha null til mange forekomster av MsgHead/Document. Under «Document» vil faginnholdet i en melding være plassert, og faginnholdet er definert i egne xml skjema med FHIR-innhold.
FHIR-innhold
For overføring av helsekontakter benyttes to FHIR ressurser:
EpisodeOfCare
CareTeam (contained ressurs)
EpisodeOfCare
NB! Formell profil ikke oppdatert. Implementasjonsguiden angitt her på Confluence gjelder
Unik forretningsidentifikator for denne EpisodeOfCare. Tilordnes av den som oppretter helseko takten. All senere dialog og andre type hendelser vil refere til denne identifikatoren. Skal være en GUID.
Code Block
<identifier>
<!-- GUID satt av den som har generert ressursen -->
<system value="urn:ietf:rfc:3986"/>
<value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier>
status
Ja
Påkrevd felt. HJelsenorge tar enda ikke hensyn til verdien her, men forutsetter "active". Mer foretningslogikk kan bli definert senere. Se under "period.end" for hvordan en helskontakt "avsluttes".
Innbyggers fødselsnummer eller d-nummer. managingOrganization.identifier
Ja
Må være med og skal peke til en unik HERID i Adresseregisteret.
Adressen vil senere kunne benyttes for digital dialog mellom innbygger og helsekontakten.
Skal være HERID til tjenesteadressen (dvs. HERID nivå 2 i Adresseregistret). NB! Det er ikke krav om at dette er samme HERID som nivå 2 i hodemeldingen, dersom Helsekontakten sendes via AMQP.
Må være med og skal peke til en unik HERID i Adresseregisteret.
Adressen vil senere kunne benyttes for digital dialog mellom innbygger og helsekontakten.
Skal være HERID til tjenesteadressen (dvs. HERID nivå 2 i Adresseregistret). NB! Det er ikke krav om at dette er samme HERID som nivå 2 i hodemeldingen, dersom Helsekontakten sendes via AMQP.
Dersom denne er med vil helsekontakten flyttes til "tidligere helsekontakter" når period.end er nådd, og det er ikke lenger mulig å ha dialog med helsekontakten.
referralRequest (Nytt element i versjon 1.1)
Betinget
Dersom helsekontakten er opprettet som resultat av en henvisning skal dette elementet være med. Det kreves at EPJ genererer en ekstern unik business “identifier” (GUID) som entydig identifiserere henvisning.
Eks:
Code Block
<referralRequest>
<identifier>
<!-- GUID generert som identifiserer den aktuelle henvisning unikt --><systemvalue="urn:oid:2.16.578.1.12.4.1.2"/><value<system value="8137991" urn:ietf:rfc:3986"/>
</identifier>
</managingOrganization>
Dersom denne er med vil helsekontakten flyttes til "tidligere helsekontakter" når period.end er nådd, og det er ikke lenger mulig å ha dialog med helsekontakten.
Navnet på CareTeam. Altså et fellesnavn for hele teamet (alle deltagere). Merk! Det er dette navnet som blir benyttet som navn på helsekontakten i dialogmeldingene.
Eks.
Code Block
<name value="UNN - Alderspsykiatrisk avdeling" />
telecom
Nei
Telefonnummeret om man ønsker at det skal synes på helsekontakten.