Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleLeveringsrapport

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:

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

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

...