3.1 Toewijzen door zorgverlener

Zorgaanbieders maken modules beschikbaar ter ondersteuning of voorbereiding van een behandeling. De zorgverlener kan in overleg met de patiënt, een module voorschrijven aan de patiënt. En de patiënt een digitale opdracht geven voor het uitvoeren van de module. Binnen afsprakenstelsels als Koppeltaal en MedMij hanteren we hiervoor een FHIR-task.

Processtappen

Aanbiedertaken vatten informatie samen over welke patiënt is uitgenodigd door welke zorgverlener om een module te starten. Deze administratieve eenheid is geschikt om te verzamelen en gebruikers te tonen in PGO’s. De gegevensdienst op het verzamelen hanteert hiervoor een FHIR Task met specifieke kenmerken. Het bevat voldoende informatie om een gebruiker de aanbiedermodule te laten starten en bij te houden of een taak is afgerond.

Processtap	Toelichting
1. Selecteren interventie	Zorgverlener opent zorgaanbiederportaal en selecteert passende module uit een lijst van opties bij behandelplan.
2. Aanmaken aanbiedertaak	Zorgaanbieder genereert een Task-resource in FHIR-resourceserver. Sommige zorgaanbieders kiezen voor een FHIR-façade die aan de achterkant communiceert met EPD-systemen. Naast de Task-resource maakt zorgaanbieder via MedMij DVA een set met gekoppelde resources beschikbaar waarin onder andere `Patient`, `ActivityDefinition` en `Endpoint` uitleesbaar zijn.
3. Uitnodigen patiënt	Zorgverlener vertelt dat een taak klaarstaat voor PGO. Patiënt gebruikt deze taak in de PGO om een aanbiedermodule-applicatie te starten. De optie om deze taak via de bestaande route, zoals een clientenportaal te ontvangen, moet blijven bestaan.

Procesdiagram

Procesdialoog

Zorgaanbieder maakt een taak. De taak mag verwijzen naar andere taken (of in het Koppeltaalstelsel naar resources zoals ActivityDefinition). Een zorgaanbieder communiceert dit met DVP als een FHIR R4 Task-resource. Zie Gegevensdienst Verzamelen Aanbiedertaken voor details. De taak verwijst naar Patient, ActivityDefinition en Endpoint-resources die DVA ook aanbiedt.

JSON

2. Taak aanmaken voor patiënt

Authorization: Bearer ...
POST https://dva/fhir/Task
{
  "resourceType": "Task",
  "id": "vragenlijst1",
  "meta": {
    "profile": [ "http://fhir.nl/fhir/StructureDefinition/nl-core-experimental-task" ]
  },
  "extension": [
    {
      "url": "http://example.org/fhir/StructureDefinition/module-definition",
      "valueReference": {
        "reference": "ActivityDefinition/vragenlijst-module-definition",
        "type": "ActivityDefinition"
      }
    }
  ],
  "status": "requested",
  "intent": "order",
  "priority": "routine",
  "code": {
    "coding": [
      {
        "system": "todo",
        "code" : "todo",
        "display": "todo"
      }
    ],
    "text": "Invullen vragenlijst voor afspraak psycholoog"
  },
  "description": "vragenlijst",
  "for": {
    "reference": "Patient/XXX_Patient"
  },
  "executionPeriod": {
    "start": "2025-08-01T12:00:00.000Z",
    "end": "2025-10-01T12:00:00.000Z"
  },
  "requester": {
    "reference": "Practitioner/XXX_Zorgverlener"
  },
  "owner": {
    "reference": "Organization/XXX_Zorgaanbieder"
  }
}

Toewijzing Task.code.codingen extension.url volgt. Uitwerking FHIR-profielen volgt.

JSON

1. ActivityDefinition bij taak aanmaken voor patiënt

Authorization: Bearer ...
POST https://dva/fhir/ActivityDefinition
{
  "resourceType": "ActivityDefinition",
  "id": "vragenlijst-module-definition",
  "meta": {
    "profile": [
      "http://fhir.nl/fhir/StructureDefinition/nl-core-experimental-activitydefinition"
    ]
  },
  "extension": [
    {
      "url": "http://example.org/fhir/StructureDefinition/client-id",
      "valueString": "dvamodule"
    },
    {
      "url": "http://example.org/fhir/StructureDefinition/module-url",
      "valueReference": {
        "reference": "Endpoint/vragenlijst-module",
        "type": "Endpoint"
      }
    }
  ],
  "version": "1.0.0",
  "name": "Vragenlijst",
  "title": "Vragenlijst klachten",
  "status": "active",
  "description": "Vul de vragenlijst in."
}

JSON

1. Endpoint aanmaken bij activiteit bij taak aanmaken voor patiënt

Authorization: Bearer ...
POST https://dva/fhir/Endpoint
{
  "resourceType": "Endpoint",
  "id": "vragenlijst-module",
  "meta": {
    "profile": [
      "http://fhir.nl/fhir/StructureDefinition/nl-core-experimental-endpoint"
    ]
  },
  "status": "active",
  "connectionType": {
    "system": "http://terminology.hl7.org/CodeSystem/endpoint-connection-type",
    "code": "other"
  },
  "payloadType": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/endpoint-payload-type",
          "code": "any"
        }
      ]
    }
  ],
  "address": "https://aanbiedermodule/web/api/smartonfhir/launch"
}

Parameters

Taak aanmaken voor patiënt:

Parameter	Waarde
meta.profile	http://fhir.nl/fhir/StructureDefinition/nl-core-experimental-task
status	requested
intent	startmodule
for.reference	Patient/XXX_Patient
requester.reference	Practitioner/XXX_Zorgverlener
owner.reference	Organization/XXX_Zorgaanbieder

ActivityDefinition bij taak aanmaken voor patiënt.

Parameter	Waarde
meta.profile	http://fhir.nl/fhir/StructureDefinition/nl-core-experimental-activitydefinition
extension[].url	Merk op dat de extensions voor moduleaanbieders nog vastgelegd worden. In het voorbeeld hierboven gebruiken we client-id en endpoint. Deze verwijzen naar de client-id van module. Deze is gedefiniëerd in DVA-authorisatieserver. Endpoint verwijst naar resource met SMART App Launch-adres voor aanbiedermodule.

Endpoint aanmaken bij activiteitbij taak aanmaken voor patiënt.

Parameter	Waarde
meta.profile	http://fhir.nl/fhir/StructureDefinition/nl-core-experimental-endpoint
address	URI naar aanbiedermodule. Voorbeeld: https://aanbiedermodule/web/api/smartonfhir/launch

Processtappen

1. Selecteren interventie

2. Aanmaken aanbiedertaak

3. Uitnodigen patiënt

Procesdiagram

Procesdialoog

Parameters