AMQP Skjemainnsending

En kommunikasjonsprosess der Helsenorge på vegne av innbygger sender et ferdig utfylt skjema til en (eller flere) mottagere. Utfylt skjema vil normalt være en FHIR QuestionnaireResponse. Det sendes også med den skjemadefinisjonen som ble benyttet (FHIR Questionnarie). Videre sendes som regel også med en PDF-versjon av innbyggers svar. Alt dette sendes som en FHIR Bundle.

(Det understøttes også andre formater for ferdig utfylt skjema, men disse må i så fall på forhånd være avtalt mellom den som er mottager av utfylt skjema og den skjemautfyller som benyttes. Helsenorge sin egen skjemautfyller benytter alltid FHIR ressurser.)

API-navn	DIALOG_INNBYGGER_SKJEMAINNSENDING
Funksjonelt område	Dialog
API-versjon og dato publisert	v1.0 Dec 22, 2020
Status	I Drift
API-dokumentasjon sist endret	Feb 11, 2021
Teknologi	AMQP + FHIR

Prosesser og flyt

Her er info om prosesser og flyt

Sekvensdiagram for prosessen er vist i figuren under.

Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_Skjemainnsending	Basisversjon for kommunikasjonsprosess	1.0

Tabellen under viser hvilke roller som inngår i prosessen, hvilken funksjon de ulike rollene kan gjøre og hvilke meldinger som benyttes.

Versjon

Rolle

Funksjon

Meldingsinnhold

1.0

Innbygger

Innsending

FHIR Bundle

Alt 1 (Helsenorge skjemautfyller):

QuestionnaireResponse
Questionnarie
DocumentReference PDF-versjon av respons (opsjonelt)

(Ikke støttet enda) Alt 2 (Ekstern skjemautfyller, med annet format):

DocumentReference Skjemarespons (i proprietært binært format)
DocumentReference PDF-versjon av respons (opsjonelt)

Helsepersonell

Applikasjonskvittering

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Meldingsstruktur for Skjemainnsending

Her er strukturen på meldingen

Tjeneste	Skjemainnsending
Bruksområde	Innbygger sender ferdig utfult skjema til en helseaktør.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1348174397 Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_SKJEMAINNSENDING" DN="Dialog med innbygger – skjemainnsending" />` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Ja" V="J"/>`
Dialogmelding	Ikke aktuelt å bruke for denne tjenesten.
iCalender	Ikke aktuelt å bruke for denne tjenesten
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Ikke aktuelt å bruke for denne tjenesten
FHIR Bundle	FHIR - Bundle (R4) Inneholdende: FHIR QuestionnaireResponse (R4) FHIR Questionnarie (R4) FHIR DocumentReference (R4) - PDF-versjon av innbyggers svar. Profilen for FHIR Bundle og bruk av denne er dokumentert utenfor denne implementasjonsguiden. Dette er fordi profilen også benyttes i API’er (og ikke bare i meldingen Skjemainnsending). Profilene for FHIR ressursene er dokumentert her: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1008369665

Eksempel på bruk av FHIR Bundle i Hodemelding

<?xml version="1.0" encoding="iso-8859-1"?>
<MsgHead 
  xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24">
  <MsgInfo>
    <!-- Meldingens funksjon Volven-kodeverk 8279 -->
    <Type V=" DIALOG_INNBYGGER_SKJEMAINNSENDING" DN=" Dialog med innbygger – skjemainnsending " />
    <MIGversion>v1.2 2006-05-24</MIGversion>
    <GenDate>2019-12-29T11:34:00.0513824+01:00</GenDate>
    <MsgId>d43723fe-a526-4c00-86b2-da3f4ae52cb8</MsgId>	
	<Ack DN="Ja" V="J" />
    
<Sender>
    <Organisation>
      <OrganisationName>Direktoratet for e-helse</OrganisationName>
      <Ident>
        <!-- HERID i TEST: 115851, HERID i Prod: ? -->
        <Id>115851</Id>
        <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="Her-id" />
      </Ident>
      <Organisation>
        <OrganisationName>Digitale innbyggertjenester</OrganisationName>
        <!-- HERID'er i DEV/TEST: TEST01: 8093248, TEST02: 8093247, QA: 8093249, MAS-01: 8093244, MAS-02: 8093239 -->
        <Ident>
          <Id>8093248</Id>
          <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="Her-id" />
        </Ident>
      </Organisation>
    </Organisation>  
  </Sender>
<Receiver>
    <Organisation>
      <OrganisationName>HELSEDIREKTORATET</OrganisationName>
      <Ident>
        <Id>2397</Id>
        <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="Her-id" />
      </Ident>
      <Organisation>
        <OrganisationName>DD.TEST</OrganisationName>
        <Ident>
          <Id>8091467</Id>
          <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="Her-id" />
        </Ident>
      </Organisation>
    </Organisation>
  </Receiver>

  <Patient>
    <!-- Samme informasjon finnes i FHIR objektet, men må være med for å tilfredstille Hodemeldingen (benyttes ikke av Helsenorge) -->
	  <Ident>
		  <Id>13116900216</Id>
			<TypeId V="FNR" DN="Fødselsnummer" S="2.16.578.1.12.4.1.1.8116"/>
		</Ident>
	</Patient>
  </MsgInfo>
  <Document>
    <!-- Dette er et selvstendig objekt som inneholder all informasjon som er ersultat av at innbygger har fylt ut et skjema. 
      Resten av (hode) meldingen er i utgangspunktet KUN transport. -->
    <ContentDescription>FHIR Bundle</ContentDescription>
    <RefDoc>
      <MsgType V="XML" DN="XML-instans" />
      <Content>
        <Bundle>
          …………..

        </Bundle>    
       </Content>
    </RefDoc>
  </Document>
</MsgHead>

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/690913297