Sende inn skjemaoppgave og motta skjemasvar
Innledning
Gjennom bruk av FHIR-ressurser i skjemaløsningen har vi lagt til rette for at flere av grensesnittene som er beskrevet i den overordnede beskrivelse kan benytte forskjellig teknologi for integrasjon. Aktøren velger om man ønsker å benytte meldingsbasert integrasjon eller integrasjon via API’er. For noen av grensesnittene støttes kun en av integrasjonsmetodene. Dette vil framgå av beskrivelsen av hvert enkelt grensesnitt under.
Detaljert teknisk dokumentasjon finnes på denne siden (med undersider): https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1758756904
Innsending av skjemaoppgave
Payload
En skjemaoppgave er alltid representert ved en FHIR Task: Detaljert beskrivelse: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/742948883
I noen tilfeller kan en ekstern aktør ha behov for å sende med skjemadefinisjonen som skal benyttes. I slikt tilfelle skal det benyttes en FHIR Bundle med FHIR Task og Skjemadefinisjon: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1008369665/Benyttede+FHIR+Ressurser+i+Skjemal+sningen#Innsending-av-Oppgave-til-Innbygger-(Helsenorge)-der-skjemadefinisjonen-er-med
API
Her benyttes Oppgave API (som understøtter både Meldingsbasert- og REST integrasjon):
Sending av ferdig utfylt skjemasvar fra Helsenorge til aktør
Dette grensesnittet er så langt kun relevant dersom Helsenorge sin egen skjemautfyller benyttes. Hvis annen skjemautfyller benyttes, må svaret distribueres direkte fra ekstern skjemautfyller til Helseforetaket.
Payload
Helsenorge sender alltid mer enn en FHIR ressurs i et skjemasvar. Dette benyttes derfor alltid en FHIR Bundle. Det finnes to varianter, der kun det første så langt er implementert (se Bruksscenarier):
Skjemasvar der Helsenorge sin skjemautfyller benyttes:
MERK! Ikke implementert enda: Skjemasvar der det er benyttet proprietære skjemasvar (ekstern skjemautfyller):
Dette er et bruksscenarie som ikke er support for enda (høst 2023), implementeres avhengig av behov fra sektoren.
REST API
Foreløpig støtter Helsenorge ikke å “poste” skjemasvar til en FHIR-server hos mottager. Kun meldingsbasert integrasjon støttes for formidling av skjemasvar.
Meldingsbasert integrasjon (AMQP)
Innsending av skjemasvar som Hodemelding med FHIR Bundle er beskrevet her: