Page Comparison

InfoHusk å legg til etiketten “api-dokumentasjon” når denne malen benyttes, samt å slette denne notisen

Med meldingsformidling til innbygger kan aktører i helsesektoren sende meldinger til innbygger. Løsningen har støtte for videreformidling av meldingen til digital postkasse og/eller fysisk post, slik at det er mulig å kommunisere med innbyggeren uavhengig av om innbygger har tatt i bruk helsenorge.no 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 meldingstype kalt leveringsrapport.

Page Properties

API-navn

DIALOG_INNBYGGER_MELDINGSFORMIDLING

Funksjonelt område

Dialog

API-versjon og dato publisert

v1.1 10 Mar 1900

Status

Status

colour	Green
title	I Drift

API-dokumentasjon sist endret

01 Feb 1900

Teknologi

Status

colour	Purple
title	AMQP

Prosesser og flyt

Her er info om prosesser og flyt

Expand

title	Overordnet flyt og sekvensdiagram

Sekvensdiagram for prosessen er vist i figuren under:

Versjon 1.0 av prosessen skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_Meldingsformidling	Gammel versjon med begrenset utbredelse. Videreføres ikke og dokument videreformidles ikke til andre, dvs sendes kun til innbyggere på Helsenorge.	0.8
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
0.8	Helsepersonell	Melding	Dialogmelding 1.1 MeldingTilIInnbygger 0.8 Vedlegg
1.0	Helsepersonell	Melding	Dialogmelding 1.0 MeldingInnbygger 1.0 Vedlegg Videreformidling 1.0
1.0	Innbygger	Leveringsrapport	Dialogmelding 1.0 Leveringsrapport 1.0
1.1	Helsepersonell	Melding	Dialogmelding 1.0 MeldingInnbygger 1.0 Vedlegg Videreformidling 1.1
1.1	Innbygger	Leveringsrapport	Dialogmelding 1.0 Leveringsrapport 1.1

Melding til innbygger (MTI)

Expand

title	Struktur på melding

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 kapittel 2.3

Obligatorisk verdi i tillegg til adressering i «MsgHead/Sender» er organisasjonsnummeret:

Code Block
<Ident> <Id>915933149</Id> <TypeId V="ENH" S="2.16.578.1.12.4.1.1.9051" DN="Organisasjonsnummeret i Enhetsregister"/> </Ident>

Organisasjonsnummeret anvendes til å finne rett avsenderpostkasse hos Digdir. Denne vil endres til kun å gjelde hvis man har med videreformidlings-skjemaet, men per nå er feltet påkrevd for begge scenarioene.

Obligatorisk verdi i «MsgHead/MsgInfo/Type» er:

Code Block
<Type V="DIALOG_INNBYGGER_MELDINGSFORMIDLING " DN="Melding eller varsel til innbygger"/>

Obligatorisk verdi «MsgHead/MsgInfo/Ack» er:

Code Block
<Ack V="J" DN="Ja"/>

Dialogmelding

Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.4

Obligatoriske elementer (klasse/element):

Dialogmelding/Foresporsel/TypeForesp

Lovlige kodeverdier som kan brukes i TypeForesp:

MTI – Melding til innbygger

XML-eksempel:

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

Emne
Meldingsavsender
Meldingstekst
SvarTillatt

Valgfrie elementer:

Innholdstype
UtsattVisningstidspunkt
DelInnholdMedHelsepersonell

XML-eksempel:

Code Block

<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 til kapittel 2.10

XML-eksempel som inneholder Document-delen fra hodemeldingen:

Code Block

<Document>
	<DocumentConnection V="H" DN="Hoveddokument"/>
	<ContentDescription>Innkallingsbrev</ContentDescription>
	<RefDoc>
		<MsgType V="A" DN="Vedlegg"/>
		<MimeType>application/pdf</MimeType>
		<Description>Innkallingsbrev.pdf</Description>
		<Content>
			<Base64Container xmlns="http://www.kith.no/xmlstds/base64container">VGVrc3Q=</Base64Container> <!-- forkortet eksempelinnhold -->
		</Content>
	</RefDoc>
</Document>

Videreformidling

Valgfritt element, og benyttes i henhold til kapittel 2.12.1: 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

Betingede elementer:

InfoFysiskPost

Valgfrie elementer:

InfoDPI
AvsenderIdentifikator
Fakturareferanse

XML-eksempel Videreformidling 1.1:

Code Block

<Videreformidling xmlns="http://ehelse.no/xmlstds/Videreformidling/2020-01-10">
	<Kanalvalg>
		<GodkjentForHelsenorge>true</GodkjentForHelsenorge>
		<GodkjentForDPI>true</GodkjentForDPI>
		<GodkjentForFysiskPost>true</GodkjentForFysiskPost>
	</Kanalvalg>
	<OmfattetAvReservasjonsrett>true</OmfattetAvReservasjonsrett>
	<InfoFysiskPost>
		<AvsenderTarAnsvarForAdresse>true</AvsenderTarAnsvarForAdresse>
		<Returtype>DIREKTE_RETUR</Returtype>
		<MottakerPostadresse>
			<Navn>Line Danser</Navn>
			<norskAdresse>
				<adresselinje1>Postveien 1A</adresselinje1>
				<postnummer>0450</postnummer>
				<poststed>Oslo</poststed>
			</norskAdresse>
		</MottakerPostadresse>
		<ReturmottakerPostadresse>
			<Navn>Sykehuset Telemark</Navn>
			<norskAdresse>
				<adresselinje1>Postboks 2900</adresselinje1>
				<adresselinje2>Kjørbekk</adresselinje2>
				<postnummer>3710</postnummer>
				<poststed>Skien</poststed>
			</norskAdresse>
		</ReturmottakerPostadresse>
		<UtskriftMedFarge>true</UtskriftMedFarge>
		<Adreseark>true</Adreseark>
	</InfoFysiskPost>
	<InfoDPI>
		<Sikkerhetsniva>4</Sikkerhetsniva>
	</InfoDPI>
	<AvsenderIdentifikator>ABC</AvsenderIdentifikator>
	<Fakturarerefanse>DEF</Fakturarerefanse>
	<Leveringsrapport>true</Leveringsrapport>
</Videreformidling>

Leveringsrapport på videreformidlet melding (LRP)

Expand

title	Struktur på melding versjon 1.0

Tjeneste

Leveringsrapport, svar - asynkron tjeneste

Bruksområde

Melding med status på forsendelser som anvender videreformidling, sendt fra Helsenorge til Avsender.

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_ MELDINGSFORMIDLING " DN=" Melding eller varsel til innbygger "/>

Obligatorisk verdi «MsgHead/MsgInfo/Ack» er:

Code Block
<Ack DN="Ja" V="J"/>

Dialogmelding

Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.4

Obligatoriske elementer (klasse/element):

Dialogmelding/Foresporsel/TypeForesp

Lovlige kodeverdier som kan brukes i TypeForesp:
LRP – Leveringsrapport på videreformidlet melding

XML-eksempel:

Code Block
<Foresporsel> <TypeForesp V="LRP" S="2.16.578.1.12.4.1.1.7602" DN="Leveringsrapport på videreformidlet melding"/> </Foresporsel>

Leveringsrapport

Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.12.2: Leveringsrapport.

Obligatoriske elementer:

Formidlingskanal

Betingede elementer:

Leveringsstatus.Levert
Leveringsstatus.Feilmelding
Leveringsstatus.Varslingfeilet
Leveringsstatus.Mottattpost
Leveringsstatus.Returpost

XML-eksempel:

Code Block

<Leveringsrapport xmlns="http://ehelse.no/xmlstds/leveringsrapport/2018-08-14">
    <Formidlingskanal V="FP" S="2.16.578.1.12.4.1.1.7616" DN="Fysisk post"/>
    <Leveringsstatus>
         <Levert Tidspunkt="2018-05-24T16:19:20.0000000"/>
         <Mottattpost Tidspunkt="2018-05-24T12:45:30.0900000"/>
         <Returpost Tidspunkt="2018-05-26T08:06:01.1500000"/>
     </Leveringsstatus>
</Leveringsrapport>

Expand

title	Struktur på melding versjon 1.1

Tjeneste

Leveringsrapport, svar - asynkron tjeneste

Bruksområde

Melding med status på forsendelser som anvender videreformidling, sendt fra Helsenorge til Avsender.

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_ MELDINGSFORMIDLING " DN=" Melding eller varsel til innbygger "/>

Obligatorisk verdi «MsgHead/MsgInfo/Ack» er:

Code Block
<Ack DN="Ja" V="J"/>

Dialogmelding

Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.4

Obligatoriske elementer (klasse/element):

Dialogmelding/Foresporsel/TypeForesp

Lovlige kodeverdier som kan brukes i TypeForesp:
LRP – Leveringsrapport på videreformidlet melding

XML-eksempel:

Code Block
<Foresporsel> <TypeForesp V="LRP" S="2.16.578.1.12.4.1.1.7602" DN="Leveringsrapport på videreformidlet melding"/> </Foresporsel>

Leveringsrapport

Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.12.2: Leveringsrapport.

Obligatoriske elementer:

Primarkanal
- Formidlingskanal
Sekundarkanal
- Formidlingskanal

Betingede elementer:

Primarkanal
- HelsenorgeProsessering
- Levert
- Feilmelding
- Varslingfeilet
- Mottattpost
- Returpost
Sekundarkanal
- Levert
Ettersending
- Levert
- Feilmelding
- Mottattpost
- Returpost

XML-eksempel kanalvalg:

Code Block

<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"/>
		   <Levert Tidspunkt="2020-01-10T14:30:47Z"/>
		   <Mottattpost Tidspunkt="2020-01-10T11:00:00Z"/>
		   <Returpost Tidspunkt="2020-01-12T14:01:22Z"/>
	</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>

XML-eksempel HelsenorgeProsessering:

Code Block

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

XML-eksempel Ettersending:

Code Block

<Leveringsrapport xmlns="http://ehelse.no/xmlstds/videreformidling/2020-01-10">
	<Primarkanal>
		   <Formidlingskanal V="HN" S="2.16.578.1.12.4.1.1.7616" DN="Helsenorge"/>
		   <Levert Tidspunkt="2020-01-10T09:30:47Z>"/>
	</Primarkanal>
	<Ettersending>
		   <Levert Tidspunkt="2020-01-15T09:30:47Z"/>
		   <Mottattpost Tidspunkt="2020-01-15T11:00:00Z"/>
	</Ettersending>
</Leveringsrapport>

Generell info om meldingsutveksling med Helsenorge

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

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Innholdsstandarder for Meldingsformidling

For meldingsformidling benyttes tre spesifikke meldingsformater (skjema), samt Vedlegg.

Expand

title	MeldingInnbygger

Innholdstype – Valgfri. Definere verdi fra Volven-kodeverket 7613 som kan gi eget varsel og/eller definerer tilgangsstyring på innholdet.
Emne - Emnetekst/overskrift på meldingen i Helsenorge og digital postkasse.
Meldingsavsender - Angir navn på meldingsavsender som vises på Helsenorge.
Meldingstekst - Meldingstekst som i Helsenorge vil vises på som egen tekst på meldingen i tillegg til vedlegg.
SvarTillatt - Angir om innbygger kan svare på meldingen eller ikke. Gjelder Helsenorge, svarmeldingen vil komme som meldingstypen Dialog_helsepersonell og i samme meldingstråd som tilsendt melding.
UtsattVisningstidspunkt – Valgri. Dato og tidspunkt for når en melding tidligst kan gjøres tilgjengelig for innbygger. Gjelder Helsenorge og digital postkasse.
DelInnholdMedHelsepersonell – Valgfri. Angir oppfordring til innbygger om å dele meldingens innhold med helsepersonell. Deling skjer aldri automatisk, men skal være et eksplisitt valg innbygger gjør. Helsenorge legger til rette for at dette kan gjøres på en effektiv måte for innbygger. Kun fastlege støttes i dag.
SensitivAvsender - Valgfri. Angir om Meldingsavsender kan legges til i sms og epost varslene. Det kan bare legges til hvis verdien er false. Default verdien er true.

Skjemaet definerer ikke makslengder eller innhold i felter. For Digital dialog med innbygger er det innført begrensninger i brukergrensesnitt for feltlengder. Begrensninger er vist i tabellen er vist under.

Felt

Feltlengde

Kommentar

Emne

50

Emne begrenses til 50 tegn i brukergrensesnitt

Meldingsavsender

255

Makslengde på felt er 255 tegn, innhold utover dette vil ikke vises på Helsenorge.

Videreformidling

Se beskrivelse i kapittel 2.12.1: Videreformidling

Leveringsrapport

Se beskrivelse i kapittel 2.12.2: Leveringsrapport

Expand

title	Benytter av følgende komponenter

Navn	Type	Beskrivelse

Versions Compared

Old Version 1

New Version 2

Key

Prosesser og flyt

Melding til innbygger (MTI)

Leveringsrapport på videreformidlet melding (LRP)

Generell info om meldingsutveksling med Helsenorge

Ytterligere informasjon

Innholdsstandarder for Meldingsformidling

Videreformidling

Leveringsrapport