AMQP Skjemautfyller

Benyttes kun dersom Helsenorge sin egen skjemautfyller ikke benyttes. En kommunikasjonsprosess der en ekstern skjemautfyller kan formidle et skjema som innbygger har fylt ut til Helsenorge for videre behandling. Videre behandling vil normalt være å lagre kopi av utfylt skjema for inbygger på Helseorge, men kan også innebære at Helsenorge sender utfylt skjema til en eller flere mottagere. Ekstern skjemautfyller skal alltid også sende med en pdf-versjon av utfylt skjema slik at innbygger kan ha en kopi av dette (i «menneskelig lesbart» format).

API-navn	DIALOG_INNBYGGER_SKJEMAUTFYLLER
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_Skjemautfyller	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

Applikasjonskvittering

Skjemautfyller

Skjemadata

Enten:

FHIR Document Reference med PDF versjon av skjemasvar

eller

FHIR Bundle med strukturert skjemasvar samt Document reference med PDF versjon
- Der strukturert skjemasvar enten kan være en QuestionnireResponse eller en Document Reference (hvis skjemautfyller har proprietært format)

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Meldingsstruktur for Skjemautfyller

Tjeneste	Skjemautfyller
Bruksområde	Ekstern skjemautfyller sender ferdig utfylt skjema til innbygger (Helsenorge)
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_SKJEMAUTFYLLER" DN="Dialog med innbygger – skjemautfyller" />` 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
Enten: FHIR DocumentReference eller FHIR Bundle	Enten: http://hl7.org/fhir/documentreference.html alene eller http://hl7.org/fhir/bundle.html Inneholdende: FHIR QuestionnaireResponse eller DocumentReference for skjemasvar FHIR DocumentReference for PDF-kopi av skjemasvar 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 er dokumentert her:

Eksempel på bruk av FHIR Bundle i HodemeldingHer er strukturen på en respons

<?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_SKJEMAUTFYLLER" DN=" Dialog med innbygger – skjemautfyller" />
    <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: