- Created by Levin Løssfelt, last modified on Jun 16, 2021
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 3 Next »
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.
API-navn | DIALOG_INNBYGGER_MELDINGSFORMIDLING |
---|---|
Funksjonelt område | Dialog |
API-versjon og dato publisert | v1.1 |
Status | I DRIFT |
API-dokumentasjon sist endret |
|
Teknologi | AMQP |
Prosesser og flyt
Her er info om prosesser og flyt
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 |
Innbygger | Leveringsrapport | Dialogmelding 1.0 Leveringsrapport 1.0 | |
1.1 | Helsepersonell | Melding | Dialogmelding 1.0 MeldingInnbygger 1.0 Vedlegg Videreformidling 1.1 |
Innbygger | Leveringsrapport | Dialogmelding 1.0 Leveringsrapport 1.1 |
Melding til innbygger (MTI)
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 tillegg til adressering i «MsgHead/Sender» er organisasjonsnummeret: <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: <Type V="DIALOG_INNBYGGER_MELDINGSFORMIDLING " DN="Melding eller varsel til innbygger"/>
<Ack V="J" DN="Ja"/> |
Dialogmelding | Obligatorisk, og benyttes i henhold til beskrivelse i Dialogmelding Obligatoriske elementer (klasse/element):
Lovlige kodeverdier som kan brukes i TypeForesp:
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:
Valgfrie elementer:
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 til Vedlegg
<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 Videreformidling under Videreformidling. Obligatoriske elementer:
Betingede elementer:
Valgfrie elementer:
XML-eksempel Videreformidling 1.1: <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)
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 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 DN="Ja" V="J"/> |
Dialogmelding | Obligatorisk, og benyttes i henhold til beskrivelse i Dialogmelding
XML-eksempel: <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 Videreformidling under Leveringsrapport. Obligatoriske elementer:
Betingede elementer:
XML-eksempel: <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> |
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 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 DN="Ja" V="J"/> |
Dialogmelding | Obligatorisk, og benyttes i henhold til beskrivelse i Dialogmelding
Lovlige kodeverdier som kan brukes i TypeForesp: XML-eksempel: <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 Videreformidling under Leveringsrapport. Obligatoriske elementer:
Betingede elementer:
XML-eksempel kanalvalg: <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: <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: <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.
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 Videreformidling under Videreformidling
Leveringsrapport
Se beskrivelse i Videreformidling under Leveringsrapport
Navn | Type | Beskrivelse |
---|---|---|
- No labels