Videreformidling

Owned by kjetill.vassmo.lund
Last updated: Jan 09, 2024 by sven.christiansen
9 min read

Videreformidling er en tjeneste som Helsenorge tilbyr for å kunne hjelpe med å sende informasjon til alle innbyggere, uavhengig av hvilken kanal innbygger skal ha informasjonen i. Helsenorge tar imot meldinger, og formidler de i en kanal innbygger kan nås. Informasjonen formidles enten til Helsenorge, til en av de digitale postkassene eller til fysisk post. Helsenorge står for logikken med å finne hvilken kanal som innbygger kan nås i, lagring av melding til helsenorge, sendingen av informasjon til digital postkasse og fysisk post, samt logging og utsending av status på forsendelsene.

Skjemaet anvendes av kommunikasjonsprosesser som støtter videreformidlingslogikken, og inneholder informasjonen som behøves for at en forsendelse kan kunne videreformidles.

Se også Vedlegg: Videreformidling for visuell representasjon av skjemaene.

  • Kanalvalg / Mottakeravgrensning/HelsenorgeProsessering - En av disse må velges.

    • Kanalvalg gir mulighet for å overstyre kanalvalglogikken ved å angi hvilke kanaler meldingen kan kunne formidles til. Hvis en kanal ikke er valgt, vil meldingen formidles i en annen kanal der det er mulig.

    • Mottakeravgrensning kan settes i stedet for kanalvalg hvis man bare ønsker å nå de innbyggerne som ville mottatt brevet i en spesifikk kanal. Eksempelvis hvis BareTilDPIBrukere er valgt, vil meldingen bare bli levert til de innbyggerne som ikke er aktive på Helsenorge, men har en digital postkasse. Hvis man hadde kun valgt GodkjentForDPI, ville alle innbyggere som har digital postkasse fått meldingen i digital postkasse, også de som er brukere av Helsenorge.

    • HelsenorgeProsessering - NB! Skal ikke benyttes av nye aktører, benytt i stedet API for å finne formidlingskanal)

  • OmfattetAvReservasjonsrett - Angir om meldingen har innhold som dekkes av eForvaltningsforskriften §9, som spesifiserer reservasjon mot å motta følgende elektroniske meddelelser fra forvaltningen.

  • UlestEttersending -   Om meldingen skal ettersendes til fysisk post hvis meldingen er ulest på Helsenorge. Brevet vil ettersendes etter 5 dager. Hvis verdien er true må både GodkjentForHelsenorge, GodkjentForFysiskPost og OmfattetAvReservasjonsrett være true. NB! Denne funksjonen er kun tilgjengelig dersom innholdet er omfattet av Reservasjonsrett (eForvaltningsforskriften §9).

  • InfoFysiskPost – Betinget. Inneholder informasjon nødvendig for å videreformidle meldingen til fysisk post. Elementet er påkrevd hvis Kanalvalg eller Mottakeravgresning har fysisk post som en av kanalene man kan sende til. Hvis InfoFysiskPost.AvsenderTarAnsvarForAdresse er true så er MottakerPostadresse-elementet påkrevd.

    • AvsenderTarAnsvarForAdresse – Brukes hvis avsender ønsker å overstyre adresse registrert i Folkeregisteret. Dersom denne er satt til true må MottakerFysiskPostadresse ha verdier.

    • Returtype – Her kan man angi om brevet skal returneres (DIREKTE_RETUR) eller makuleres hvis det ikke kan leveres (MAKULERING_MED_MELDING)

    • MottakerPostadresse – Valgrfri, men påkrev hvis AvsenderTarAnsvarForAdresse er true. Angir adresse brevet skal sendes til hvis AvsenderTarAnsvarForKontaktinfo er satt. Postnummer og poststed er obligatoriske verdier.

    • ReturmottagerPostadresse – Angir adresse brevet skal returneres til hvis det ikke kan bli levert til mottaker.

    • UtskriftMedFarge – Angir om innholdet skal skrives ut med farge eller ikke.

    • Printinstruksjoner – Valgfri. Støttes ikke lenger av DigDir sin utskriftsleverandør.

    • Adresseark – Valgfri. Forsendelsen får et forsideark fra Helsenorge. Hvis elementet ikke er satt så defaulter den til nei.

  • InfoDPI – Valgfri. Inneholder informasjon for sikkerhetsnivået for meldinger til digital postkasse. Hvis elementet ikke er satt så blir sikkerhetsnivået 4.

    • Sikkerhetsnivå – Meldingens sikkerhetsnivå (3 eller 4).

    • Følgende to elementer skal/kan angis dersom videreformidling inngår i andre kommunikasjonsprosesser enn melding til innbygger (MTI)

      • IkkeSensitivTittel - Må angis for alle andre kommunikasjonsprosesser enn MTI

      • UtsattVisningstidspunkt - Kan angis om ønskelig

  • AvsenderIdentifikator – Valgfri. Eventuell referanse til utskriftsprofil under organisasjonens postkonto hos Digdir, Avtales bilateralt med DigDir. (Kan benyttes dersom flere avsendere innenfor et Organisasjonsnummer).

  • Fakturareferanse - Valgfri. Evt. fakturareferanse for å granulere kostnad for meldingene (detaljering innenfor et Orgnummer), som går mot digital postkasse eller fysisk post.

  • Leveringsrapport - Avsender kan velge å motta Leveringsrapport-meldinger på forsendelsen. Disse vil inneholde informasjon om hviken formidlingskanal som meldingen ble levert i, og statuser på meldingsleveransen.

  • Organisasjonsnummer - Skal angis!. Erstatter tidligere angivelse av organisasjonsnummer i hodemeldingen for MTI. Benyttes for å finne rett “Postkonto” hos DigDir.

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> <UlestEttersending>true</UlestEttersending> <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> <Adresseark>true</Adresseark> </InfoFysiskPost> <InfoDPI> <Sikkerhetsniva>4</Sikkerhetsniva> <IkkeSensitivTittel>Brev fra Hesforetak</IkkeSensitivTittel> </InfoDPI> <AvsenderIdentifikator>ABC</AvsenderIdentifikator> <Fakturarerefanse>DEF</Fakturarerefanse> <Leveringsrapport>true</Leveringsrapport> <Organisasjonsnummer>123456789</Organisasjonsnummer> </Videreformidling>

Ved mottak av videreformidlingsmeldinger til Helsenorge får aktørene tilbake en applikasjonskvittering (Applikasjonskvittering). Positive applikasjonskvitteringer betyr at meldingen ble mottatt og prosessert OK, men den sier ikke noe om hvor meldingen ble levert eller informasjon om eventuelle påfølgende statuser for meldingene som gikk til Digdir (digital post eller fysisk post). For å få en meldingsbasert status på forsendelsen så kan aktørene som anvender videresending velge å få leveringsrapport som en del av meldingsflyten. I videreformidlingsskjemaet kan man definere om man vil ha leveringsrapport (Leveringsrapport true/false).

Leveringsrapport er en egen melding som sendes tilbake til avsender etter at helsenorge mottar og prosesserer en gyldig videreformidlingsmelding. Leveringsrapporten sendes til aktøren via AMQP, og den inneholder informasjon om status på videreformidlingsforsendelsen. Man vil motta en til flere leveringsrapporter avhengig av hvilken kanal meldingen ble levert i.

Versjon 1.0

  • Formidlingskanal – Vil alltid være satt. Angir hvilken "kanal" meldingen ble levert til innbygger i, dvs. om meldingen ble levert til Helsenorge, fysisk post, digipost eller eBoks, eller om man ikke fant en kanal å formidle meldingen til (ingen). Verdien IN betyr at innholdet ikke kunne leveres til innbyggeren i de valgte kanalene og at brevet ikke ble levert (vil også gi negativ Applikasjonskvittering). Anvender verdier fra Volven-kodeverket 7616: IN (Ingen), HN (Helsenorge), FP (Fysisk post), DP (digipost), EB (eBoks).

  • Leveringsstatus.Levert - Bevis på at posten er levert til Mottaker. Statusen følger kanalen som er definert i formidlingskanal. Inneholder verdi for tidspunkt. Vil ikke bli satt hvis formidlingskanal er Ingen. Definisjon av Levert:

    • Formidlingskanal er Helsenorge: kvittering på at meldingen er mottat og tilgjengeliggjort på Helsenorge.

    • Formidlingskanal er eBoks/digipost: kvitteringen sendes fra Postkassleverandør når postforsendelsen er validert og de garanterer for at posten vil bli tilgjengeliggjort.

    • Formidlingskanal er Fysisk post: kvitteringen leveres når brevene er gjort klar for postlegging.

  • Leveringsstatus.Feilmelding - Eventuelle feilmeldinger fra Digdir/Helsenorge på forsendelsen. Inneholder verdier for tidspunkt, feiltype og detaljtekst. Elementet blir kun fylt ut hvis feilmeldinger oppstår. Feilmelding følger feltet Formidlingskanal.

    • Tidspunkt: tidspunktet feilen oppstod

    • Feiltype: vil være KLIENT eller SERVER.
      KLIENT: Feilen kommer pga. feil på input eller andre feil der Avsender må rette opp i årsaken til feilen
      SERVER: Feilen kommer av feil på sentral infrastruktur. Avsender må ta kontakt med Sentralforvalter for å få rettet opp i feilen.

    • Detaljer: detaljer om feilen som oppstod.

  • Leveringsstatus.Varslingfeilet - Eventuelle varslingsfeil fra Digdir/Helsenorge på forsendelsen. Elementet blir kun fylt ut hvis varslingsfeil oppstår.

    • Tidspunkt - Tidspunktet for varslingsfeilen

    • System - Systemet som informerte om varselfeilen

    • Varslingskanal - Hvilken kanal som varslet feilet i (SMS/EPOST)

    • Detaljer - Detaljer om varslingsfeilen

  • Leveringsstatus.Mottattpost - Kun relevant for Formidlingskanal fysisk post. Status for postmeldinger som er overlevert OK til posten, før den er bekreftet levert. Vil settes før en eventuell Levert-status. Inneholder verdi for tidspunkt.

    • Tidspunkt – Tidspunkt for mottat post.

  • Leveringsstatus.Returpost - Kun relevant for Formidlingskanal fysisk post. Status for mottat returpost-kvittering, for postmeldinger sendt til fysisk post med returtype MAKULERING_MED_MELDING, som ikke kan bli levert til mottaksadresse og som har blit makulert av posten.

    • Tidspunkt – Tidspunkt for returpost

      • Tidspunkt – Tidspunkt for returpost.

XML-eksempel Leveringsrapport 1.0:

<Leveringsrapport xmlns="http://ehelse.no/xmlstds/videreformidling/2018-08-14"> <Formidlingskanal V="FP" S="2.16.578.1.12.4.1.1.7616" DN="Fysisk post"/> <Leveringsstatus> <Levert Tidspunkt="2020-01-10T14:30:47Z"/> <Mottattpost Tidspunkt="2020-01-10T11:00:00Z"/> <Returpost Tidspunkt="2020-01-12T14:01:22Z"/> </Leveringsstatus> </Leveringsrapport>

Versjon 1.1

  • Primarkanal

    • Formidlingskanal – Vil alltid være satt. Angir hvilken "kanal" meldingen ble levert til innbygger i, dvs. om meldingen ble levert til Helsenorge, fysisk post, digipost eller eBoks, eller om man ikke fant en kanal å formidle meldingen til (ingen). Verdien IN betyr at innholdet ikke kunne leveres til innbyggeren i de valgte kanalene og at brevet ikke ble levert (vil også gi negativ Applikasjonskvittering). Anvender verdier fra Volven-kodeverket 7616: IN (Ingen), HN (Helsenorge), FP (Fysisk post), DP (digipost), EB (eBoks).

    • HelsenorgeProsessering – Hvis avsender av forsendelsen har valgt HelsenorgeProsessering så vil denne verdien bli satt og få et tidsstempel. Hvis satt: for Formidlingskanal Helsenorge så er meldingen prosessert, og Levert-elementet vil også være utfylt. For Formidlingskanal digital postkasse (digipost/eBoks) eller fysisk post så vil det være avsender ansvar å utføre formidlingen til den kanalen og de andre verdiene for Primarkanal (Levert, Feilmelding etc.) vil ikke bli satt.

      • Tidspunkt – Tidspunktet medlingen ble prosessert

    • Levert – Bevis på at forsendelsen er levert til mottaker. Verdien blir først satt når meldingen er bekreftet levert, og følger verdien som er definert i formidlingskanal. Vil ikke bli satt hvis formidlingskanal er Ingen. Definisjon:

      • Formidlingskanal er Helsenorge: kvittering på at meldingen er mottat og tilgjengeliggjort på Helsenorge.

      • Formidlingskanal er eBoks/digipost: kvitteringen sendes fra Postkassleverandør når postforsendelsen er validert og de garanterer for at posten vil bli tilgjengeliggjort.

      • Formidlingskanal er Fysisk post: kvitteringen leveres når brevene er gjort klar for postlegging.

    • Leveringsstatus.Feilmelding - Eventuelle feilmeldinger fra Digdir/Helsenorge på forsendelsen. Elementet blir kun fylt ut hvis feilmeldinger oppstår. Feilmelding følger feltet Formidlingskanal.

      • Tidspunkt: tidspunktet feilen oppstod

      • Feiltype: vil være KLIENT eller SERVER.
        KLIENT: Feilen kommer pga. feil på input eller andre feil der Avsender må rette opp i årsaken til feilen
        SERVER: Feilen kommer av feil på sentral infrastruktur. Avsender må ta kontakt med Sentralforvalter for å få rettet opp i feilen.

      • Detaljer: detaljer om feilen som oppstod.

    • Varslingfeilet – Status fra Digdir/Helsenorge på at varsling til innbygger om ny melding feilet. Elementet blir kun fylt ut hvis varslingsfeil oppstår.

      • Tidspunkt - Tidspunkt for varselfeil.

      • System - Systemet som informerte om feilen

      • Varslingskanal - Hvilken kanal som varslet feilet i (SMS/EPOST)

      • Detaljer - Detaljer om varslingsfeilen.

    • Mottattpost – Status fra Digdir for postmeldinger som er overlevert OK til posten, og er en status som kan settes før den er bekreftet levert (beskrivelse). Elementet blir kun bli fylt ut hvis vi mottar statusen fra Digdir og kun hvis hovedkanal er "FysiskPost". Vil settes før en eventuell Levert-status.

      • Tidspunkt – Tidspunkt for mottat post.

    • Returpost – Status fra Digdir på mottat returpostkvittering, for postmeldinger som ikke kan bli levert til mottaksaddresse og har blitt makulert av posten. Elementet blir kun bli fylt hvis hovedkanal er "FysiskPost", og posten sender makuleringsmelding tilbake via Digdir (krever at VidereFormidling.InfoFysiskPost.Returtype er satt til MAKULERING_MED_MELDING). Dette elementet vil trolig komme noe tid (dager) etter at Levert-verdien blir satt.

      • Tidspunkt – Tidspunkt for returpost.

  • Sekundarkanal – Primarkanal er kanalen der innbygger nås, men i noen tilfeller kan også en "kopi" kan lagres på Helsenorge.

    • Formidlingskanal – Hvilken kanal brevet ble levert i: IN (Ingen), HN (Helsenorge). Verdien blir alltid satt. For sekunarkanal så er det bare Helsenorge eller Ingen som er gyldige verdier.

    • Levert – Bevis på at forsendelsen er levert til mottaker. Verdien blir satt når meldingen er bekreftet levert, og følger verdien som er definert i formidlingskanal. Vil ikke bli satt hvis formidlingskanal er Ingen. Definisjon:

      • Formidlingskanal er Helsenorge: kvittering på at meldingen er mottat og tilgjengeliggjort på Helsenorge.

  • Ettersending – Sendes når en ettersending er satt opp pga UlestEttersending. (Hvis Ulest ettersending er true i Videreformidlings melding og brevet er ikke lest på Helsenorge etter fristen)

    • Levert – Bevis på at forsendelsen er levert til mottaker. Verdien blir først satt når meldingen er bekreftet levert (når brevene er gjort klar for postlegging).

    • Feilmelding - Eventuelle feilmeldinger fra Digdir/Helsenorge på forsendelsen. Elementet blir kun fylt ut hvis feilmeldinger oppstår. Feilmelding følger feltet Formidlingskanal.

      • Tidspunkt: tidspunktet feilen oppstod

      • Feiltype: vil være KLIENT eller SERVER.
        KLIENT: Feilen kommer pga. feil på input eller andre feil der Avsender må rette opp i årsaken til feilen
        SERVER: Feilen kommer av feil på sentral infrastruktur. Avsender må ta kontakt med Sentralforvalter for å få rettet opp i feilen.

    • Detaljer: detaljer om feilen som oppstod

    • Mottattpost – Status fra Digdir for postmeldinger som er overlevert OK til posten, og er en status som kan settes før den er bekreftet levert (beskrivelse). Elementet blir kun bli fylt ut hvis vi mottar statusen fra Digdir. Vil settes før en eventuell Levert-status.

      • Tidspunkt – Tidspunkt for mottat post.

    • Returpost – Status fra Digdir på mottat returpostkvittering, for postmeldinger som ikke kan bli levert til mottaksaddresse og har blitt makulert av posten. Elementet blir kun bli fylt hvis posten sender makuleringsmelding tilbake via Digdir (krever at VidereFormidling.InfoFysiskPost.Returtype er satt til MAKULERING_MED_MELDING). Dette elementet vil trolig komme noe tid (dager) etter at Levert-verdien blir satt.

    • Tidspunkt – Tidspunkt for returpost

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:

XML-eksempel Ettersending:

Visuell representasjon av videreformidlingsskjemaene

Videreformidling-v1.jpg

 

Viderformidlingsskjema