Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device.
Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
Med meldingsformidling til innbygger kan aktører i helsesektoren sende meldinger og brev til innbygger. Løsningen har støtte for videreformidling av meldingen til fysisk post, slik at det er mulig å kommunisere med innbyggeren uavhengig av om innbygger har tatt i bruk Helsenorge eller ikke. Det er støtte for vedlegg, slik at man kan sende med dokumenter som for eksempel innkallingsbrev. Det er lagt inn støtte for å få vite status på forsendelsen via en egen leveringsrapport.
API-navn
DIALOG_INNBYGGER_MELDINGSFORMIDLING
Funksjonelt område
Dialog
API-versjon og dato publisert
v1.1 Feb 10, 2020
Status
I Drift
API-dokumentasjon sist endret
Apr 1, 2025
Teknologi
AMQP
Endringer januar 2024:
Avsenders angivelse av Innholdstype er gjort obligatorisk i MTI-skjema.
Videreformidling skjema 1.0 støttes ikke lenger, og organisasjonsnummer til den virksomhet som har inngått avtale med DigDir om utskrift skal angis i videreformidlingsskjema 1.1.
Sekvensdiagram for prosessen er vist i figuren under:
Nyeste versjon av prosessen skal utvikles og aktiveres i adresseregisteret for nye aktører.
Prosess
Funksjonalitet
Versjon
Dialog_Innbygger_Meldingsformidling
Basisversjon for kommunikasjonsprosess.
1.0
Dialog_Innbygger_Meldingsformidling
Oppdaterte skjema for videreformidling og leveringsrapport
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 for de ulike versjonene.
Versjon
Rolle
Funksjon
Meldingsinnhold
1.0
Helsepersonell
Melding
Dialogmelding 1.0
MeldingInnbygger 1.0
Vedlegg
Videreformidling 1.0 (“conditional”- må være med dersom videreformidling ønskes til innbyggere som ikke er digital aktive på Helsenorge)
Innbygger
Leveringsrapport
Dialogmelding 1.0
Leveringsrapport 1.0
1.1
Helsepersonell
Melding
Dialogmelding 1.0
MeldingInnbygger 1.0
Vedlegg
Videreformidling 1.1 (“conditional”- må være med dersom videreformidling ønskes til innbyggere som ikke er digital aktive på Helsenorge)
Innbygger
Leveringsrapport
Dialogmelding 1.0
Leveringsrapport 1.1
Meldingsformidling til innbygger
Meldingformidlimng til innbygger kan inneholde to skjema; MeldingInnbygger og Videreformidling (valgfritt) i tillegg til vedlegg.
Tjeneste
Melding til innbygger, asynkron tjeneste
Bruksområde
Brukes når en ekstern aktør skal sende melding/post til innbygger
Hodemelding
Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding
Obligatorisk verdi i «MsgHead/MsgInfo/Type» er:
<Type V="DIALOG_INNBYGGER_MELDINGSFORMIDLING " DN="Melding eller varsel til innbygger"/>
Obligatorisk verdi «MsgHead/MsgInfo/Ack» er:
<Ack V="J" DN="Ja"/>
Dialogmelding
Obligatorisk, og benyttes i henhold til beskrivelse iDialogmelding
Obligatoriske elementer (klasse/element):
Dialogmelding/Foresporsel/TypeForesp
Lovlige kodeverdier som kan brukes i TypeForesp:
MTI – Melding til innbygger
XML-eksempel:
<Foresporsel>
<TypeForesp V="MTI" S="2.16.578.1.12.4.1.1.7601" DN="Melding til innbygger"/>
</Foresporsel>
MeldingInnbygger
Obligatorisk, og benyttes i henhold til beskrivelsen nedenfor under Ytterligere Informasjon.
Obligatoriske elementer:
Innholdstype
Emne
Meldingsavsender
Meldingstekst
SvarTillatt: Merk at for at Innbygger skal kunne svare på meldingen må kommunikasjonsprossessen Dialog_Innbygger_Helsepersonell, være slått på i adresseregisteret for gitt Her-id
Valgfrie elementer:
UtsattVisningstidspunkt
DelInnholdMedHelsepersonell
Lenkereferanse
Se detaljert beskrivelse av denne innholdsstandearden her: MeldingInnbygger
XML-eksempel:
<MeldingInnbygger xmlns="http://ehelse.no/xmlstds/MeldingInnbygger/2018-09-25">
<Innholdstype V="IB" S="2.16.578.1.12.4.1.1.7613" DN="Innkallingsbrev"/>
<Emne>Innkallingsbrev fra STHF</Emne>
<Meldingsavsender>Sykehuset Telemark - Radiologiavdelingen</Meldingsavsender>
<Meldingstekst>Innkalling til innbygger hos foretak ABC</Meldingstekst>
<SvarTillatt>false</SvarTillatt>
<UtsattVisningstidspunkt>2018-10-28T09:30:00Z</UtsattVisningstidspunkt>
<DelInnholdMedHelsepersonell V="6" S="2.16.578.1.12.4.1.1.9246" DN="Fastlege"/>
<SensitivAvsender>false</SensitivAvsender>
</MeldingInnbygger>
Vedlegg
Valgfritt element, og benyttes i henhold tilVedlegg
Dersom brev skal til print skal ett av dokumentene settes som hoveddokument og er dokumentet som printes først. Dersom ingen dokument er markert som hoveddokument, så vil HElsenorge sette første dokument til hoveddokument.
XML-eksempel som inneholder Document-delen fra hodemeldingen:
Valgfritt element, og benyttes i henhold til Videreformidling under Videreformidling. Versjon 1.0 og 1.1 har nært identisk innhold, så eksemplet er for versjon 1.1.
Obligatoriske elementer:
Kanalvalg / Mottakeravgrensning
OmfattetAvReservasjonsrett
Leveringsrapport
Organisasjonsnummer (konto hos DigDir)
Betingede elementer:
InfoFysiskPost (må med dersom Kanalvalg.GodkjentForFysiskPost = true)
InfoDPI (må med dersom Kanalvalg.GodkjentForDPI = true)
Valgfrie elementer:
AvsenderIdentifikator
Fakturareferanse
Se detaljert beskrivelse av denne innholdsstandarden her: Videreformidling
<Leveringsrapport xmlns="http://ehelse.no/xmlstds/videreformidling/2020-01-10">
<Primarkanal>
<Formidlingskanal V="FP" S="2.16.578.1.12.4.1.1.7616" DN="Fysisk post"/>
<!-- Avsender valgte HelsenorgeProsessering og er selv ansvarlig for forsendelsen hvis Formidlingskanal er fysisk post eller digital postkasse (eBoks/digipost) -->
<HelsenorgeProsessering Tidspunkt="2020-01-10T09:30:47Z"/>
</Primarkanal>
<Sekundarkanal>
<Formidlingskanal V="HN" S="2.16.578.1.12.4.1.1.7616" DN="Helsenorge"/>
<Levert Tidspunkt="2020-01-10T09:30:47Z"/>
</Sekundarkanal>
</Leveringsrapport>
I enkelte tilfeller er det ønskelig å koble et innkallingsbrev sendt med Meldingsformidling til et innkallingsbrev sendt som vedlegg til en timeavtale. Dersom innbygger åpner innkallingsbrevet på timeavtalen, skal innkallingsbrevet som er sendt med Meldingsformidling ikke ettersendes selv om brevet ikke er åpnet innen 5 dager.
For å støtte dette kan det legges inn en referanse til timeavtalen i meldingen til Meldingsformidling. Referansen legges i en egen Document-node med FileReference under RefDoc. FileReference må være den samme referansen som sendes inn på timeavtalen.
Merk: Det er viktig å være oppmerksom på rekkefølgen meldingene sendes i. Dersom timeavtalen sendes før innkallingsbrevet, kan innbygger åpne innkallingsbrevet på timeavtalen før innkallingsbrevet sendt med Meldingsformidling finnes i løsningen. Når innkallingsbrevet senere mottas, finnes det ikke grunnlag for å registrere at den tilknyttede timeavtalen allerede er åpnet. Innkallingsbrevet vil derfor kunne bli ettersendt dersom innbygger ikke åpner timeavtalen eller vedlegget på nytt.