added measurements and residence access.

.gitbook/assets/ANWSequence_V3.puml

@@ -25,7 +25,7 @@ VVTB -> ANWSystem ++: Haalt Task op
 ANWSystem --> VVTB: Task
 ANWSystem --
 VVTB -> VVTB: Creëert benodige credentials \nvoor ANW-Zorgverlener uit Task
-VVTB --> ANWSystem --: Update de Task met VC-ID en status "ready"
+VVTB --> ANWSystem --: Update de Task met VC-ID, location reference en status "ready"
 ANWSystem -> VVTA ++: Notificatie dat er een Task klaar staat voor zorgverlener
 VVTA --> ANWSystem: Accepted
 VVTA -> ANWSystem ++: Haalt Task op

anw/TD-ANWv2024.1.md

@@ -32,6 +32,10 @@
     * [ANW-Regisseur](#anw-regisseur)
     * [ANW-Bronhouder](#anw-bronhouder)
     * [ANW-Zorgverlener](#anw-zorgverlener)
+* [Uitbreidingen](#uitbreidingen)
+  * [Registeren van metingen](#registeren-van-metingen)
+  * [Foutafhandeling van registraties naar het brondossier](#foutafhandeling-van-registraties-naar-het-brondossier)
+  * [Woningtoegang](#woningtoegang)
     * [TODO](#todo)
 <!-- TOC -->
 
@@ -62,8 +66,9 @@
 ### NUTS-adresboek
 
 De regisseur heeft toegang tot het NUTS-adresboek, hierin kunnen de leveranciers voor elke organisatie die onderdeel uit
- maken het ANW-netwerk aanduiden dat de betreffende organisatie de service “ANW-Zorgverlener”
-en “ANW-Bronhouder” aanbiedt. De regisseur is zelf ook te vinden in het adresboek voor de bronhouder en zorgverlener om toegang
+maken het ANW-netwerk aanduiden dat de betreffende organisatie de service “ANW-Zorgverlener”
+en “ANW-Bronhouder” aanbiedt. De regisseur is zelf ook te vinden in het adresboek voor de bronhouder en zorgverlener om
+toegang
 te geven tot deze regisseur met als service “ANW-Regisseur”.
 
 ### Regisseur vraagt de cliënt / medewerker gegevens op in alle ECD’s
@@ -91,7 +96,7 @@ Op basis van het ontvangen access token kan de zorgaanbieder bepalen tot welke e
 zijn voor deze usecase de volgende twee: [Endpoints voor data regisseur](#endpoints-voor-data-regisseur)
 
 Als query wordt de query “ANW-zorg” meegegeven. Hiermee kan de zorgaanbieder bepalen welke
-cliënten/medewerkers teruggestuurd moeten worden. 
+cliënten/medewerkers teruggestuurd moeten worden.
 
 Elke leverancier maakt het mogelijk voor organisaties om cliënten als "ANW" cliënt te kenmerken in hun ECD. Afspraak
 is dat alleen “In zorg” zijnde cliënten teruggegeven worden voor de ANW-usecase en ook alleen “In dienst (actief
@@ -653,7 +658,7 @@ met een parameter zoals een include extra gegevens meekomen.
 | ZIB                                                           | Method | Sort      | Count | Endpoint                                                                                                                               | Profiel                                                                                                                                                              |
 |:--------------------------------------------------------------|--------|-----------|-------|:---------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Patiënt, Contactpersoon, Behandelaar(huisarts), Zorgaanbieder | GET    |           |       | /fhir/Patient?\_id={patientId}&\_include=Patient:general-practitioner&\_include:iterate=PractitionerRole:organization                  | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954638](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954638) |
-| Bloeddruk                                                     | GET    | Date DESC | 5     | /fhir/Observation?patient={patientId}&\_profile=http://nictiz.nl/fhir/StructureDefinition/zib-PulseRate&\_sort=-date&\_count=5         | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954945](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954945) |
+| Bloeddruk                                                     | GET    | Date DESC | 5     | /fhir/Observation?patient={patientId}&\_profile=http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure&\_sort=-date&\_count=5         | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.3.1/files/2980633](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.3.1/files/2980633) |
 | Lichaamstemperatuur                                           | GET    | Date DESC | 5     | /fhir/Observation?patient={patientId}&\_profile=http://nictiz.nl/fhir/StructureDefinition/zib-BodyTemperature&\_sort=-date&\_count=5   | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954748](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954748) |
 | Lichaamslengte                                                | GET    | Date DESC | 5     | /fhir/Observation?patient={patientId}&\_profile=http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight&\_sort=-date&\_count=5        | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954746](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954746) |
 | Lichaamsgewicht                                               | GET    | Date DESC | 5     | /fhir/Observation?patient={patientId}&\_profile=http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight&\_sort=-date&\_count=5        | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954750](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954750) |
@@ -692,6 +697,7 @@ Hier staan de verschillende nutsservices die de verschillende partijen moeten re
 ze beschikbaar moeten stellen.
 
 ### ANW-Regisseur
+
 - Service: **ANW-Regisseur**
 
 | Endpoint | Beschrijving                                                                  |
@@ -700,6 +706,7 @@ ze beschikbaar moeten stellen.
 | oauth    | Volledige URL van de n2n/auth/v1/accesstoken van de nutsnode van de regisseur |
 
 ### ANW-Bronhouder
+
 - Service: **ANW-Bronhouder**
 
 | Endpoint     | Beschrijving                                                                                                                            |
@@ -709,6 +716,7 @@ ze beschikbaar moeten stellen.
 | notification | Endpoint waar de notificatie naar toe gestuurd kan worden voor het verzoek om een autorisatie aan te maken voor een “ANW-Zorgverlener”  |
 
 ### ANW-Zorgverlener
+
 - Service: **ANW-Zorgverlener**
 
 | Endpoint     | Beschrijving                                                                                                                              |
@@ -717,11 +725,84 @@ ze beschikbaar moeten stellen.
 | oauth        | Volledige URL van de n2n/auth/v1/accesstoken van de nutsnode van de inzage applicatie                                                     |
 | notification | Endpoint waar de notificatie naar toe gestuurd kan worden om mee te delen dat er een authorisatie door een “ANW-Bronhouder” is aangemaakt |
 
+# Uitbreidingen
+
+## Registeren van metingen
+
+Eerste uitbreiding op ANW is het registreren van metingen richting het brondossier. Om te registreren is geen
+uitbreiding nodig op de bestaande authorization credentials. Vanwege de tekstrapportage is de POST voor observation
+toegestaan. Het is aan de
+leverancier welke registraties beschikbaar zijn richting het brondossier voor de zorgverlener. Het brondossier
+**accepteert te allen tijde** een valide meting volgens de onderstaande Nictiz-profielen. Hoe het brondossier dit
+vervolgens
+verder verwerkt is aan de leverancier. De registratie zijn losse create requests per meting. Dit gebeurt in dezelfde
+stap als het registreren van de tekstrapportage. Voor de onderstaande drie metingen is gekozen vanwege wat er nu
+mogelijk is aan de ontvangende kant.
+
+| ZIB                 | Fhir-profiel                                                                                                                                                         |
+|:--------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Bloeddruk           | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.3.1/files/2980633](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.3.1/files/2980633) |
+| Lichaamstemperatuur | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954748](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954748) |
+| Lichaamslengte      | [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954746](https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/2.2.10/files/1954746) |
+
+## Foutafhandeling van registraties naar het brondossier
+
+In het geval van een fout bij de registratie antwoord het bronsysteem met een OperationOutcome.
+Zie [Fout afhandeling/Handling Errors](https://informatiestandaarden.nictiz.nl/wiki/FHIR:V1.0_FHIR_IG_STU3#Handling_errors)
+in de implementatiegids van Nictiz. De [operation outcome](https://hl7.org/fhir/STU3/operationoutcome.html) kan door een
+systeem gebruikt worden om aan te geven richting de
+zorgverlener wat er fout is gegaan. In het geval van inhoudelijke fouten die niet zijn toegestaan volgens de
+Nictiz-profielen geeft de operationoutcome aan welke fout dit betreft. Zodat de zorgverlener de nodige aanpassing kan
+doen.
+
+## Woningtoegang
+
+Als er woningtoegang informatie beschikbaar is in het bronsysteem van de cliënt, dan is dit zeer nuttig om te delen met
+de zorgverlener. De location resource is hiervoor geschikt. De overweging is gemaakt dit niet in het adres van de cliënt
+te stoppen. Het patient.address veld is hier minder voor geschikt, omdat een nieuw profiel nodig zou zijn om te
+voorkomen dat
+woningtoegang mee kan komen met alle patiënten volgens het profiel nl-core-patients. Vooral een probleem buiten de
+usecase van ANW.
+
+De location resource relateert niet direct met de cliënt. Het bronsysteem voegt de referentie naar die resource toe aan
+de inputs voor de task. Dit gebeurt in stap 12 van [het sequentiediagram](#sequentie-diagram-1) voordat de PUT-actie
+richting de regisseur is gedaan.
+
+Het is belangrijk voor het zorgverlenersysteem dat de regisseur de inputs ook overneemt in de task. Dit betreft een
+absolute referentie. Zie hieronder een voorbeeld van input met de woningtoegang die binnen een task valt.
+
+```json
+{
+  "...": "...",
+  "input": [
+    {
+      "type": {
+        "text": "woningtoegang"
+      },
+      "valueReference": {
+        "reference": "{FHIR-SERVER}/Location/101"
+      }
+    }
+  ]
+}
+```
+
+In de location resource moet de description gevuld zijn met de informatie om toegang tot de woning te verkrijgen. Zie
+het onderstaande voorbeeld met de relevante informatie.
+
+```json
+{
+  "resourceType": "Location",
+  "id": "101",
+  "description": "Sleutel onder de tuinkabouter"
+}
+```
+
 ### TODO
 
 * `userContext` voor het opvragen van de lijst van Patient/Practitioner voor ANW-zorg moet duidelijk gemaakt worden:
   `true` of `false`? Mogelijk moet dit om data protection redenen op `true` (immers grote lijst van namen). Voordat dit
   duidelijk werd is bij een eerder technisch overleg overeengekomen voorlopig te gaan voor `false`, om (pre-)caching
   makkelijker te maken. Bij moment van schrijven op 24 juli 2024 worden de VCs bij alle partijen nog aangemaakt voor
   `false`, en vanuit Nedap worden de requests alvast altijd uitgevoerd met een aanwezige user context (in andere
-  woorden, Nuts-elevatie is verplicht alvorens het regisseursscherm geopend kan worden) en gecached per user.
+  woorden, Nuts-elevatie is verplicht alvorens het regisseursscherm geopend kan worden) en gecached per user.