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. Hiervoor hanteren we een FHIR-task. Het Koppeltaal-afsprakenstelsel maakt hier ook gebruik van.

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. Daarnaast omdat dit een gezamenlijk solution design van MedMij en Koppeltaal is.

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. Wanneer een Zorgaanbieder dit wenst, moet de optie om deze taak via de bestaande route, zoals een clientenportaal te ontvangen, daarnaast blijven bestaan.

Procesdiagram

Procesdialoog

Zorgaanbieder maakt een taak. De taak mag verwijzen naar andere taken of 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/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/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://module.example.org/web/api/smartonfhir/launch"
}

Parameters

De onderstaande tabel beschrijft de minimale parameters die momenteel bekend zijn voor het aanmaken van een Task voor een patiënt.
Deze set is nog onderhevig aan wijzigingen — in afstemming met de gegevensdienst wordt gevalideerd welke parameters minimaal verplicht zijn en of aanvullende velden nodig zijn.

Let op: Nog onderhevig aan mogelijke wijzigingen.

De parameter intent is bedoeld om de intentie aan te geven. Deze lijkt op de FHIR intent parameters met andere waardes, de bedoeling is om alvast een vaste waarde te geven in het begin zodat het duidelijk is voor de module wat er moet gebeuren.

Parameter	Waarde
meta.profile	http://fhir.nl/fhir/StructureDefinition/nl-core-experimental-task
status	requested
intent	startmodule, niet de waarde plan, definitieve waarde komt later, in overleg met ontwikkelpartner.
for.reference	Patient/XXX_Patient
requester.reference	Practitioner/XXX_Zorgverlener
owner.reference	Organization/XXX_Zorgaanbieder

De onderstaande tabel beschrijft de minimale parameters die momenteel bekend zijn voor het aanmaken van een ActivityDefinition voor een Task. Ook deze parameters zijn nog onderhevig aan wijzigingen en worden afgestemd met de gegevensdienst.

Let op: Nog onderhevig aan mogelijke wijzigingen.

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
connectionType	code: hl7-fhir-rest system: http://terminology.hl7.org/CodeSystem/endpoint-connection-type
address	URI naar aanbiedermodule. Voorbeeld: https://aanbiedermodule.example.org/web/api/smartonfhir/launch

Processtappen

1. Selecteren interventie

2. Aanmaken aanbiedertaak

3. Uitnodigen patiënt

Procesdiagram

Procesdialoog

Parameters