Verktøystartoppgave (kommer Q4-2024)

Hva er en verktøystartoppgave?

En helseaktør benytter verktøystartoppgave for å sende et verktøy til en innbygger/pasient slik at innbygger må ta aktivt stilling til å bruke verktøyet. De fleste verktøy kan innbygger finne og starte selv i verktøyoversikten på Helsenorge, mens noen krever forskriving av behandler. Ved å sende verktøy som oppgave forskriver helseaktør verktøyet til innbygger.

Innbygger får et varsel på Helsenorge om mottatt oppgave og vil finne informasjon om verktøyet gjennom å utføre oppgaven. Ved å takke ja til å ta verktøyet i bruk legger verktøyet seg automatisk i ‘Mine verktøy’ og det vil være enkelt å finne tilbake til og fortsette bruk av verktøyet.

Oppgaven gis med en frist slik at innbygger varsles når fristen nærmer seg.

Hvis innbygger takker nei til bruk av verktøyet og verktøyet krever forskrivning får innbygger beskjed om å kontakte behandler for ny forskrivning.

Hvordan sende en verktøystartoppgave til innbygger?

Bruk av Oppgave - FHIR Task

• En verktøystartoppgave representeres alltid som en oppgave i form av en FHIR-ressurs av typen Task

• Hvordan FHIR Task skal benyttes er beskrevet i detalj her: FHIR Task - Oppgave , se eksempel under

Sending av oppgave til innbygger

En verktøystartoppgave sendes til Helsenorge via Oppgave-API: Oppgave API

Eksempel på innsending av verktøystartoppgave

Meldingsbasert bruk av API - Hodemelding med FHIR Task

Open

Bruk av REST-API

Request

curl -X POST \
-H "Content-Type: application/xml" -H "Authorization: Bearer <access_token>"\
-d 'FHIR Task i xml' \
<BaseUrl/oppgave/v1/task> (For BaseUrl, se: Testmiljøer og endepunkter )

FHIR Task i xml (samme innhold som Document i Hodemelding):

Respons

• HTTP respons:

  • OK: 201 - created. Ved suksessfull opprettelse av ressursen og påfølgende respons vil Location headeren være satt inneholdende logisk id , i tillegg returneres den opprettede ressursen i sin helhet.

  • Feil: 400 - error + FHIR OperationOutcome