# PZP

# PZP Volume 1 - Functioneel overzicht

**WIP!**

*BZ: moeten we de drie verschillende momenten los uitwerken? Dus 1) **inzage** (bij spoed/ambu/OHCA bijv), 2) **overdracht** (bij veranderen van zorgorganisatie of lijn, bijv thuiszorg naar Hospice of oncoloog naar huisarts en wijkverpleging) of 3) **samenwerking** (bijvoorbeeld tussen huisarts of specialist in het ziekenhuis en wijkverpleging)*

## Doel en relevantie

Het doel van deze usecase is om behandelgrenzen en -wensen van zorgvragers — zoals afgesproken in het kader van proactieve zorgplanning (PZP) — digitaal beschikbaar te maken voor geautoriseerde zorgverleners binnen het netwerk van de zorgvrager. De gegevens worden eenduidig vastgelegd, (mede) ontsloten via de Nuts-infrastructuur, en zijn snel en veilig te raadplegen bij spoed, overdracht of reguliere zorgmomenten.

Hierdoor wordt gewaarborgd dat behandelwensen bekend zijn en gerespecteerd worden, onafhankelijk van tijd, locatie of zorgaanbieder.

## Bedrijfsrollen

<table id="bkmrk-rol-toelichting-vast"><thead><tr><th>**Rol**</th><th>**Toelichting**</th></tr></thead><tbody><tr><td>Vastleggende zorgverlener</td><td>De zorgprofessional die het PZP gesprek gevoerd heeft met de zorgvrager en de informatie vastlegt.</td></tr><tr><td>Raadplegende zorgverlener</td><td>De zorgprofessional die PZP gegevens wil opvragen bij een andere zorgorganisatie.</td></tr><tr><td>Bronhouder\*</td><td>De zorgorganisatie waar de zorgvrager (eerder) zorg ontvangen heeft, en die het PZP deelt met bij de zorg betrokken professionals bij een andere zorgorganisatie.</td></tr></tbody></table>

\*Om consistentie te bewaren binnen de usecases die over Nuts gaan, gebruiken we hier de term Bronhouder.

## Proces en context

Patient Journey:

*TODO*

# PZP Volume 2a - Technical Agreements

This volume describes the technical side of the agreements to realize data availability for the use case Advance Care Planning. This volume provides the technical agreement needed for transmitting the data between parties. Technical agreements are made on

- `identifying health organizations`
- `identifying vendors`
- `identifying professionals`
- `authenticating vendors & health organizations`
- `authenticating professionals`
- `localization`
- `addressing`
- `data request`

## Exchange pattern: indexed pull

Due to the nature of the use case, the exchange pattern is indexed pull. In short this means that fetching data globally consists of two steps: `Localization`: Localising the data holders (via one or more indices) and then `Data request`: actually reuqesting the data at each known data holder.

## Identifying health organizations

The use case Advance Care Planning makes use of the generic technical agreement [Identifying health organisations](https://wiki.nuts.nl/books/generic-technical-agreements-generieke-bouwblokken/page/identifying-health-organizations).

## Identifying vendor organizations

The use case Advance Care Planning makes use of the generic technical agreement [Identifying vendor organisations](https://wiki.nuts.nl/books/generic-technical-agreements-generieke-bouwblokken/page/identifying-vendor-organizations).

## Identifying professionals

The use case Advance Care Planning makes use of the generic technical agreement [Identifying professionals](https://wiki.nuts.nl/books/generic-technical-agreements-generieke-bouwblokken/page/identifying-professionals).

## Authenticating health organisations

The use case Advance Care Planning makes use of the generic technical agreement [Authenticating health organisations](https://wiki.nuts.nl/books/generic-technical-agreements-generieke-bouwblokken/page/authenticating-health-organizations).

## Authenticating vendor organizations

The use case Advance Care Planning makes use of the generic technical agreement [Authenticating vendor organizations](https://wiki.nuts.nl/books/generic-technical-agreements-generieke-bouwblokken/page/authenticating-vendor-organisations).

## Authenticating professionals

The use case Advance Care Planning makes use of the generic technical agreement [Authenticating professionals](https://wiki.nuts.nl/books/generic-technical-agreements-generieke-bouwblokken/page/authenticating-professionals).

## Localization

The use case Advance Care Planning does not make use of a generic technical agreement. The use case Advance Care Planning uses the following technical agreements:

### Make data localisable:

- MUST: Every healthcare organisation maintains a CareTeam-resource per patient that contains all known involved relevant healthcare organizations
- MUST: For testing purposes the facilitators of the test make sure that the NVI is filled
- SHOULD: Vendor that wish to do so can register the CareTeams with the NVI (specifications)

### Localise:

- MUST: Get URA’s from data holders from local CareTeam
- SHOULD: 
    - Send bsn to NVI
    - receice 1 or more URA's from data holders that host a CareTeam
    - fetch at least 1 CareTeam-resource

## Addressing

The use case Advance Care Planning does not make use of a generic technical agreement. The use case Advance Care Planning uses the following technical agreements:

### Publish addresses

- SHOULD: Register at NutsDiscoveryService with X509Credential and DiscoveryRegistrationCredential containing a fhirBaseUrl-elemement.
- MUST: Parties that choose not to register at the NutsDiscoveryService themselves are registered at the NutsDiscoveryService via a hack
- MUST: make sure you know the fhir base urls of other parties in some way (this can also be done via a local list)

### Retrieve addresses

- MUST: make sure you know the fhir base urls of other parties in some way (this can also be done via a local list)

## Authorization

The use case Advance Care Planning makes use of the generic technical agreement [Authorizing incoming requests](https://wiki.nuts.nl/books/generic-technical-agreements-generieke-bouwblokken/page/authorizing-incoming-requests).

The following access policies are used in ACP:

```
Rego script here
to do

```

## Legal basis: local explicit consent

The use case Advance Care Planning uses an explicit consent that is stored locally in a system of the data holder a legal basis for the processing of data. The use case Advance Care Planning makes use of the generic technical agreement [Local explicit consent](https://wiki.nuts.nl/books/generic-technical-agreements-generieke-bouwblokken/page/local-explicit-consent).

## Data request

In some contexts this is referred to as `Pull`. TO DO jorrit

# PZP Volume 2b - Transactions

Within this volume the transactions that are used for the use case Advance Care Planing are described.

## Publish ACP data source to NVI

## Search ACP data source at NVI

## Token request

## Search ACP resources

# PZP Volume 3 - Content

De zorgtoepassing PZP gebruikt als content onderstaande zibs, FHIR-profielen en EHR-archetypen.

## Zorginformatiebouwstenen

to do

## FHIR resources en queries

Hieronder staan de endpoints die beschikbaar gesteld moeten worden door de partijen die optreden als bronhouder in de use case PZP. Ter verheldering zijn de kolommen Sort en Count toegevoegd om aan te tonen hoeveel resultaten er geretourneerd worden en op welke manier deze worden gesorteerd. Het is van belang dat bij een aanroep alle parameters worden gebruikt die in de tabel staan en ook geen extra. Dit heeft te maken met de controle die de systemen doen op de verifiable credentials. Die controle wordt op die manier gedaan om te voorkomen dat met een parameter zoals een include extra gegevens meekomen.

<table id="bkmrk-zib-method-sort-coun"><thead><tr><th align="left">ZIB</th><th>Method</th><th>Sort</th><th>Count</th><th align="left">Endpoint</th><th align="left">Profiel</th></tr></thead><tbody><tr><td align="left">Patiënt</td><td>POST</td><td></td><td></td><td align="left">Zie onder de tabel</td><td align="left">[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)</td></tr></tbody></table>

### Patient

Voor het ophalen van de Patiënt geldt:

```
POST /fhir/Patient/_search`
Header: Content-Type = x-www-form-urlencoded (zie https://www.hl7.org/fhir/http.html#search-post)
Body: identifier=http://fhir.nl/fhir/NamingSystem/bsn|{bsn}

```

## openEHR

Er kan gewerkt worden met opslag o.b.v. het openEHR template uit de informatiestandaard, een alfa versie is [hier](https://github.com/openehr-nl/ACP) te vinden. Als er met openEHR wordt opgeslagen kan de FHIR-Connect mapping uit de informatiestandaard gebuikt worden om met FHIR uit te wisselen, een alfa versie is [hier](https://github.com/openehr-nl/ACP/blob/main/Advance_Intervention_Decision_to_DirectiveTreatment2_model) te vinden.
Rol	Toelichting
Vastleggende zorgverlener	De zorgprofessional die het PZP gesprek gevoerd heeft met de zorgvrager en de informatie vastlegt.
Raadplegende zorgverlener	De zorgprofessional die PZP gegevens wil opvragen bij een andere zorgorganisatie.
Bronhouder\*	De zorgorganisatie waar de zorgvrager (eerder) zorg ontvangen heeft, en die het PZP deelt met bij de zorg betrokken professionals bij een andere zorgorganisatie.