Notifikasjon Helsekontakt kan benyttes for å sende en helsekontakt til innbygger.
Forutsetninger for å bruke denne prosessen er:
Avsender må kunne markere enkelte tjenester som digitale innbyggertjenester
Avsender må være i stand til å ha en elektronisk meldingsutveksling med Helsenorge.no
API-navn
NOTIFIKASJON_INNBYGGER_HELSEKONTAKT
Funksjonelt område
Helsekontakter
API-versjon og dato publisert
v0.9
Status
Status | ||||
---|---|---|---|---|
|
API-dokumentasjon sist endret
Teknologi
Status | ||||
---|---|---|---|---|
|
Prosesser og flyt
Her er info om prosesser og flyt
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.
Info |
---|
Se ytterligere detaljer i innholdsstandarder for innhold i meldinger |
Hodemelding
Hodemelding vil inneholde informasjon om avsender, mottaker og pasient. Hodemelding vil også inneholde teknisk informasjon som unik id og tidspunkt for generering. Nedenfor beskrives de viktigste delene av standarden som slik den skal brukes for orientering om tjenestetilbud
Expand | ||
---|---|---|
| ||
Den unike id (MsgId) i Hodemeldingen skal være en UUID (Universally Unique Identifier). XML eksempel:
|
title | Krav til elementet «MsgHead/MsgInfo/Type» |
---|
Elementet «MsgHead/MsgInfo/Type» skal angi at meldingen er Tjenesteoversikt. Innholdet skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon:
Kodeverdi
Kodetekst
NOTIFIKASJON_INNBYGGER_HELSEKONTAKT
Notifikasjon til innbygger – Helsekontakt
Expand | ||||
---|---|---|---|---|
| ||||
Informasjon om avsender og mottaker skal være i henhold til beskrivelsen i standarden for tjenestebasert adressering tilgjengelig her: https://www.ehelse.no/standarder/om-standardisering-i-e-helse/tjenestebasert-adressering Avsender: MsgHead/MsgInfo/Sender I avsender av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator. XML eksempel med Oslo kommune som avsender:
Mottaker: MsgHead/MsgInfo/Receiver 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.
|
Expand | ||
---|---|---|
| ||
Elementet <MsgHead/MsgInfo/Ack> skal benyttes til å angi at det skal svares med applikasjonskvittering. Tjenesteoversikt skal alltid ha en applikasjonskvittering. XML eksempel:
|
title | 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.
fornavn
etternavn
fødselsnummer eller d-nummer
XML eksempel for pasient med fødselsnummer:
Notifikasjon Helsekontakt kan benyttes for å sende en ny helsekontakt til innbygger, eller oppdatere en eksisterende helsekontakt
Dersom denne prosessen benyttes for en Helsekontakt som tilbyr Digital Dialog gjelder følgende forutsetninger:
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 | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Prosesser og flyt
Her er info om prosesser og flyt
Expand | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
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.
Sekvensdiagram for prosessen tjenesteoversikt er vist i figuren under. |
Info |
---|
Se ytterligere detaljer i innholdsstandarder for innhold i meldinger |
Hodemelding
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 | ||
---|---|---|
| ||
Den unike id (MsgId) i Hodemeldingen skal være en UUID (Universally Unique Identifier). XML eksempel:
|
Expand | ||||
---|---|---|---|---|
| ||||
Elementet «MsgHead/MsgInfo/Type» skal angi at meldingen er Notifikason - helsekontakt og skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon:
|
Expand | ||
---|---|---|
| ||
Elementet «MsgHead/MsgInfo/Ack» skal angi at det kreves applikasjonskvittering på meldingen.
|
Expand | ||
---|---|---|
| ||
Informasjon om avsender og mottaker av Hodemeldingen skal være i henhold til beskrivelsen i standardene for tjenestebasert adressering tilgjengelig her: Avsender: MsgHead/MsgInfo/Sender 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:
|
Expand | ||
---|---|---|
| ||
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 er det utarbeidet et sett med FHIR-profiler.
EpisodeOfCare
FHIR-profil http://ehelse.no/fhir/StructureDefinition/hn-specialist-EpisodeOfCare, basert på EpisodeOfCare.
title | Anvendte felter |
---|
Elementnavn
Påkrevd
Beskrivelse
Identifier
system: “Idenfitier no-citizenportal-uniquebusinessidentifier”
value: unik identifikator av type GUID
Ja
Unik identifikator for helsekontakt. Eksempel: "3da5258e-2517-48cb-9519-953f1493e297"
Det skal benyttes en GUID som er globalt unik slik at Helsenorge kan benyttes denne for identifisering og alle operasjoner.
status
Ja
Default: "active"
Påkrevd felt i FHIR, men ikke i bruk i helsenorge.
type
Nei
Default: “spesialisthelsetjenesten”
Ny verdi / nytt kodeverkinnslag som definerer aktørtype
(e.g. primærhelsetjenesten, spesialisthelsetjenesten, kommunal helse og omsorg)
patient.identifier
Ja
Innbyggers fødselsnummer eller d-nummer.
managingOrganization.identifier
Ja
Referanse til HerId nivå 2.
Definere hvilken tjenesten dialogen på helsekontakten skal sendes til og anvendes også for å vite om dialog er støttet.
Status | ||||
---|---|---|---|---|
|
managingOrganization.display
Nei
Anvendes for å endre visningsnavnet til noe annet enn organisasjonsnavnet fra HerId 1 (utledet av HerId2 over)
period.start
Ja
Helsekontaktens starttidspunkt
period.end
Nei
Helsekontaktens sluttidspunkt
CareTeam
Ja
Referanse til contained FHIR-ressurs CareTeam (under)
CareTeam
FHIR-profil http://ehelse.no/fhir/StructureDefinition/hn-specialist-EpisodeOfCare_containedCareTeam, basert på CareTeam.
Expand | ||
---|---|---|
| ||
Elementnavn | Påkrevd | Beskrivelse |
Name | Ja | Helsekontaktens navn | telecom
| Nei | Telefonnummeret som vises på helsekontakten
Sender> |
Mottaker: MsgHead/MsgInfo/Receiver
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.
Code Block |
---|
<Receiver>
<Organisation>
<OrganisationName>Direktoratet for e-helse</OrganisationName>
<Ident>
<Id>93580</Id>
<TypeId DN="HER-id" V="HER" S="2.16.578.1.12.4.1.1.9051"/>
</Ident>
<Organisation>
<OrganisationName>Digitale innbyggertjenester</OrganisationName>
<Ident>
<Id>93239</Id>
<TypeId DN="HER-id" V="HER" S="2.16.578.1.12.4.1.1.9051"/>
</Ident>
</Organisation>
</Organisation>
</Receiver> |
Expand | ||
---|---|---|
| ||
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.
XML eksempel for pasient med fødselsnummer:
|
Expand | ||
---|---|---|
| ||
Hodemeldingen skal inneholde en FHIR-ressurs av typen EpisodeOfCare. |
FHIR-innhold
For overføring av helsekontakter benyttes to FHIR ressurser:
EpisodeOfCare
CareTeam (contained ressurs)
Metainformasjon om Helsekontakten
For generell informasjon om tilgjengelige opsjoner som kan gjelde alle FHIR-ressurser se: Meta informasjon som kan benyttes for alle FHIR ressurser
Følgende av disse er relevante for Helsekontakt:
meta.security - Tilgangsbegrensning (betinget)
Denne parameteren skal være med dersom melding/ressurs inneholder informasjon om en innbygger som er fra og med 12 år og opp til og med 15 år. Elementet er altså "conditional" (og ikke obligatorisk i skjemaet). Parameteren skal angi om det ikke er noen tilgangsbegrensning (dvs. at både foreldre og ungdommen selv har tilgang til informasjonen), eller om bare foreldre har tilgang eller bare ungdommen selv. Årsaken til at vi krever denne er satt når pasienten er 12-16 år, er at den indikerer at det er gjort et bevist valg/vurdering om hvem som skal ha tilgang til informasjonen. (Selv om konklusjonen er at både foreldre og ungdom kan få tilgang).
Kodesystem: "http://helsenorge.no/fhir/tilgangsbegrensning
Gyldige verdier:
1 - Ingen begrensning
2 - Kan kun ses av foreldre (ungdom vil ikke kunne se dette informasjonselemnentet selv).
3 - Kan kun ses av ungdommen selv (foreldre vil ikke kunne se dette informasjon selementet),
Code Block <meta> <security> <Tilgangsbegrensning> <system value="http://helsenorge.no/fhir/tilgangsbegrensning"/> <code value="2" /> <display>Kun foreldre</display> </Tilgangsbegrensning> </security> </meta)
EpisodeOfCare
(FHIR-profil http://helsenorge.no/fhir/StructureDefinition/hn-specialist-EpisodeOfCare, basert på EpisodeOfCare.)
Expand | ||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||
|
CareTeam (contained)
(FHIR-profil http://helsenorge.no/fhir/StructureDefinition/hn-specialist-EpisodeOfCare_containedCareTeam, basert på CareTeam.)
Expand | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||
|
Eksempel melding
Expand | ||
---|---|---|
|