Generelt om de tekniske grensesnittene

Forretningsinnhold

  • Alt forretningsinnhold i grensesnittene i HN-skjemaløsning er representert ved FHIR ressurser

  • Nåværende versjoner av grensesnittene støtter kun FHIR R4

  • Følgende FHIR ressurser benyttes:

    • Questionnaire: Skjema definisjon. Denne har noen extensions for utvidet funksjonalitet i HN-skjemautfyller.

    • QuestionnaireResponse: Skjema svar (i strukturert format).

    • Task: (Skjema)oppgave – benytte også for andre oppgavetyper

    • DocumentReference:

      • PDF-versjon av skjemasvar

      • Skjemasvar i proprietære formater.

    • Bundle: Benyttes der mer enn en av ressursene over finnes i samme paylolad

      • Task + Questionnaire: Dersom ekstern aktør sender skjemadefinisjon sammen med Oppgave

      • QuestionnaireResponse + Questionnaire + DocumentReference(PDF): Skjemasvar fra Helsenorge til aktør

(Detaljer finnes her: Benyttede FHIR Ressurser i Skjemaløsningen )

Tekniske grensesnitt

  • Vi støtter to tekniske integrasjonsmetoder for innsending- og endring av skjemaoppgave fra Aktør:

    • AMQP og KITH-hodemelding som transportmekanisme (hodemeldingen  har kun ett «Document» som er FHIR ressursen)

    • HTTP REST-kall

  • For levering av skjemasvar fra Helsenorge til Aktør, støttes pr. nå kun AMQP

  • Integrasjon med ekstern skjemautfyller:

    • Mellomlagring av kladd på Helsenorge og etterfølgende uthenting av kladd: Kun REST

      • Denne funksjonaliteten skal kun benyttes i samråd med Helsenorge i tilfeller der mellomlagring er hensiktsmessig

    • Levering av innbyggers kopi (PDF) av skjemasvar til HN: Både AMQP og REST

  • Det er alltid samme payload i AMQP-meldingen («Document» i Hodemeldingen) som body i REST-kall.

  • Positiv respons:

    • AMQP: Positiv APPREC

    • REST: HTTP 200 eller 201

  • Negativ respons:

    • AMQP: Negativ APPREC med detaljert feilinformasjon (samme feilinformasjon som returneres ved REST)

    • REST: HTTP feilkode, med detaljert feilinformasjon (Lenke til feilkoder)

Oppsummering

Funksjon

Retning

AMQP-meldingstype

REST-operasjon

Payload

Funksjon

Retning

AMQP-meldingstype

REST-operasjon

Payload

Sende inn skjemaoppgave

Fra aktør til Helsenorge

DIALOG_INNBYGGER_OPPGAVEFORESPØRSEL

POST

FHIR: Task eller Bundle

Endre allerede innsendt oppgave

Fra aktør til Helsenorge

DIALOG_INNBYGGER_OPPGAVEFORESPØRSEL

PATCH

FHIRPath Patch

Motta skjemasvar

Fra Helsenorge til aktør

DIALOG_INNBYGGER_SKJEMAINNSENDING

Ikke støttet

FHIR; Bundle

Grensesnitt dersom ekstern skjemautfyller benyttes (dvs. annen skjemautfyller enn den som er integrert i Helsenorge)

Ekstern skjemautfyller: Lever innbyggers kopi av skjemasvar

Fra ekstern skjemautfyller til Helsenorge

DIALOG_INNBYGGER_SKJEMAUTFYLLER

POST

FHIR: DocumentReference

Ekstern skjemautfyller: Lagre kladd på HN

Fra ekstern skjemautfyller til Helsenorge

Ikke støttet via AMQP

POST

FHIR: DocumentReference

Ekstern skjemautfyller: Hente kladd på HN (for videre utfylling)

Fra ekstern skjemautfyller til Helsenorge

Ikke støttet via AMQP

POST _search

Retur fra Helsenorge: FHIR: DocumentReference