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.

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
Krever representasjon	Ja

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

QuestionnaireResponse
Questionnarie
DocumentReference PDF-versjon av respons

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 Hodemelding 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: Benyttede FHIR Ressurser i Skjemaløsningen

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 er med for å enkelt kunne sjekke i meldingsmottak om 
         pasieneten finnes i det system som mottar meldingen. -->
	  <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 resultat 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: Meldingsutveksling med Helsenorge