Advance Care Planning (PZP)
0.1.3-beta3 - consultation

Advance Care Planning (PZP) - Local Development build (v0.1.3-beta3) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Home

Official URL: https://fhir.iknl.nl/fhir/ImplementationGuide/iknl.fhir.r4.pzp Version: 0.1.3-beta3
Active as of 2025-08-28 Computable Name: PZP

Project Description and Scope

This Implementation Guide (IG) supports the Advance Care Planning (ACP) information standard (Dutch: Proactieve Zorgplanning) and is intended for use within the palliative care domain in the Netherlands. This domain involves care for patients with an incurable illness or condition from which they are expected to die.

Developed by the Netherlands Comprehensive Cancer Organisation (Dutch: Integraal kankercentrum Nederland (IKNL)), this guide provides technical direction for using FHIR to exchange ACP data. It is based on HL7 FHIR R4 and builds on top of the Dutch Core R4 profiles.

This guide assumes that readers are familiar with the functional specifications of ACP and the R4 version of FHIR.

Call for Feedback

This implementation guide is a work in progress, and its quality and usefulness depend on community input. We welcome feedback on all aspects of this guide, and we are particularly interested in your thoughts on the following decisions and sections:

  1. The EncounterReference extension is an optional extension that enables linking the Consent, Goal, and DeviceUseStatement resources to a relevant Encounter. We invite feedback on whether this extension is truly necessary.

  2. The Communication profile has been developed to capture all communication events related to advance care planning. It specifically documents whether the patient has been informed about their responsibility discuss treatment agreements with relatives. As this profile is newly created rather than derived from zib/nl-core profiles, we welcome input on its structure and modeling approach.

  3. The TreatmentDirective profile is reused for directives regarding deactivation of Implantable Cardioverter Defibrillators (ICD). However, this does not fully align with the zib TreatmentDirective2 for two reasons:
    • First, ICD codes cannot be added to Consent.provision.code due to binding constraints, so the mapping is placed in Consent.provision.code.text with OTH as the code. A zib ticket (ZIB-2796) has been created to address this issue.
    • Second, for Consent.provision.type, only the permit code should be used; the other two nullflavor codes (ASKU and NASK) from the dataset valueset are not appropriate here. The profile describes using Consent.modifierExtension.specificationOther to capture information about these choices, which is somewhat questionable. Alternatively, a specialized profile for ICDs could be created, not based on the nl-core profile but following the same structure where possible.
  4. The ACP Questionnaire has been developed based on the ACP form dataset and aims to preserve the zib structure as much as possible. We welcome any feedback on its design and implementation.

Dependencies

IGPackageFHIRComment
.. Advance Care Planning (PZP)iknl.fhir.r4.pzp#0.1.3-beta3R4
... HL7 Terminology (THO)hl7.terminology.r4#6.5.0R4Automatically added as a dependency - all IGs depend on HL7 Terminology
.... FHIR Extensions Packhl7.fhir.uv.extensions.r4#5.2.0R4
... FHIR implementation of zibs 2020nictiz.fhir.nl.r4.nl-core#0.12.0-beta.1R4
.... FHIR implementation of zibs 2020nictiz.fhir.nl.r4.zib2020#0.12.0-beta.1R4

Package hl7.fhir.uv.extensions.r4#5.2.0

This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package nictiz.fhir.nl.r4.zib2020#0.12.0-beta.1

NL package of FHIR R4 conformance resources for zib (Zorginformatiebouwstenen, Clinical Information Models) release 2020.

Package nictiz.fhir.nl.r4.nl-core#0.12.0-beta.1

NL package of FHIR R4 conformance resources for zib (Zorginformatiebouwstenen, Clinical Information Models) release 2020.