3.1 Toewijzen door zorgverlener

Zorgaanbieders maken modules met 1 of meer digitale activiteiten 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 opdracht geven voor het uitvoeren van de digitale activiteiten van die module. Hiervoor gebruikt dit Solution Design de FHIR Task en ServiceRequest. Het ServiceRequest representeert de context van de groep digitale activiteiten/taken.

Het toewijzen van een taak door de zorgverlener valt niet onder het MedMij-afsprakenstelsel. Dit proces is echter wel nodig om een taak in een PGO te kunnen verzamelen. Voor de volledigheid is het proces opgenomen in het solution design.

Terminologie

Het woord Taak betekent de digitale activiteit zoals de Persoon of Zorgverlener die ziet in de gebruikersinterface. De woorden Task resource en ServiceRequest resource zijn de technische termen van de FHIR gegevensdienst waarmee de relevante data wordt uitgewisseld. Aanbiedertaken zijn digitale activiteiten, welke alleen op verzoek van een zorgaanbieder door de patient moeten worden uitgevoerd. Het ServiceRequest bevat de context van de taken, een digitale behandeling/plan.

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 aan 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 modules uit een lijst van opties voor een digitale behandeling.
2. Aanmaken aanbiedertaak	Zorgaanbieder genereert de resources voor de Task(s) en ServiceRequest (intent=plan) in FHIR-resourceserver. Sommige zorgaanbieders kiezen voor een FHIR-façade die aan de achterkant communiceert met EPD-systemen. Naast de ServiceRequest (intent=plan) en 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. Wanneer een Zorgaanbieder dit wenst, moet de optie om deze taak via de bestaande route, zoals een clientenportaal te ontvangen, daarnaast blijven bestaan.

Proces sequencediagram

Procesdialoog Voorbeelden

Zorgaanbieder maakt een of meerdere taken. De taak mag verwijzen naar andere taken of naar resources zoals de ActivityDefinition en ServiceRequest. De zorgaanbieder communiceert dit via de DVA met DVP als een FHIR R4 Task resource. Zie Gegevensdienst Verzamelen Aanbiedertaken voor details. Onderstaande zijn slechts voorbeelden, voor de definitieve inhoud van de gegevensdienst en haar FHIR resource, leze men de documentatie en IG van de gegevensdienst.

JSON

2. Taak aanmaken voor patiënt

Authorization: Bearer ...
POST https://dva.example.org/fhir/Task
{
  "resourceType": "Task",
  "id": "vragenlijst1",
  "meta": {
    "profile": [ "http://fhir.example.org/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"
  }
}

JSON

1. ActivityDefinition bij taak aanmaken voor patiënt

Authorization: Bearer ...
POST https://dva.example.org/fhir/ActivityDefinition
{
  "resourceType": "ActivityDefinition",
  "id": "vragenlijst-module-definition",
  "meta": {
    "profile": [
      "http://fhir.example.org/fhir/StructureDefinition/nl-core-experimental-activitydefinition"
    ]
  },
  "extension": [
    {
      "url": "http://example.org/fhir/StructureDefinition/client-id",
      "valueString": "dvamodule"
    },
    {
      "url": "http://example.org/fhir/StructureDefinition/smart-app-launch-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.example.org/fhir/Endpoint
{
  "resourceType": "Endpoint",
  "id": "vragenlijst-module",
  "meta": {
    "profile": [
      "http://fhir.example.org/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.example.org/web/api/smartonfhir/launch"
}

Terminologie

Processtappen

1. Selecteren interventie

2. Aanmaken aanbiedertaak

3. Uitnodigen patiënt

Proces sequencediagram

Procesdialoog Voorbeelden