# ACP AdvanceDirective - Advance Care Planning (PZP) v1.0.0-rc2

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **ACP AdvanceDirective**

## Resource Profile: ACP AdvanceDirective 

| | |
| :--- | :--- |
| *Official URL*:https://api.iknl.nl/docs/pzp/r4/StructureDefinition/ACP-AdvanceDirective | *Version*:1.0.0-rc2 |
| Draft as of 2026-03-03 | *Computable Name*:ACPAdvanceDirective |
| **Copyright/Legal**: Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise. | |

 
A verbal or written description of the patient’s wishes with regard to future medical action or end of their life. A living will is mainly used for situations in which the patient is no longer able to speak about these decisions with their healthcare provider. Based on nl-core-AdvanceDirective and HCIM AdvanceDirective. 

### Changes compared to nl-core

This profile adds ACP-specific mappings to the ART-DECOR dataset and obligation extensions for Provider and Consulter actors. Profile references are constrained to ACP profiles where available. **No changes have been made that affect implementation beyond the base nl-core profile.**

**Usages:**

* Refer to this Profile: [ACP TreatmentDirective](StructureDefinition-ACP-TreatmentDirective.md)
* Examples for this Profile: [Consent/ACP-AdvanceDirective-DNR-Pat1](Consent-ACP-AdvanceDirective-DNR-Pat1.md) and [Consent/ACP-AdvanceDirective-DNR-Pat2](Consent-ACP-AdvanceDirective-DNR-Pat2.md)
* CapabilityStatements using this Profile: [ACP CapabilityStatement Consulter](CapabilityStatement-ACP-CapabilityStatementConsulter.md) and [ACP CapabilityStatement Provider](CapabilityStatement-ACP-CapabilityStatementProvider.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/iknl.fhir.r4.pzp|current/StructureDefinition/ACP-AdvanceDirective)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-ACP-AdvanceDirective.csv), [Excel](StructureDefinition-ACP-AdvanceDirective.xlsx), [Schematron](StructureDefinition-ACP-AdvanceDirective.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "ACP-AdvanceDirective",
  "url" : "https://api.iknl.nl/docs/pzp/r4/StructureDefinition/ACP-AdvanceDirective",
  "version" : "1.0.0-rc2",
  "name" : "ACPAdvanceDirective",
  "title" : "ACP AdvanceDirective",
  "status" : "draft",
  "experimental" : false,
  "date" : "2026-03-03T12:29:58+01:00",
  "publisher" : "IKNL",
  "contact" : [{
    "name" : "IKNL",
    "telecom" : [{
      "system" : "url",
      "value" : "https://iknl.nl/"
    },
    {
      "system" : "email",
      "value" : "info@iknl.nl"
    }]
  }],
  "description" : "A verbal or written description of the patient’s wishes with regard to future medical action or end of their life. A living will is mainly used for situations in which the patient is no longer able to speak about these decisions with their healthcare provider. Based on nl-core-AdvanceDirective and HCIM AdvanceDirective.",
  "copyright" : "Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise.",
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "pall-izppz-zib2020v2026-02-24",
    "uri" : "https://decor.nictiz.nl/exist/apps/api/dataset/2.16.840.1.113883.2.4.3.11.60.117.1.1/2020-07-29T10%3A37%3A48/$view?language=nl-NL&ui=nl-NL&format=html&hidecolumns=3456gh&release=2026-02-24T09:29:59",
    "name" : "ACP dataset"
  },
  {
    "identity" : "zib-advancedirective-v3.1.1-2020EN",
    "uri" : "https://zibs.nl/wiki/AdvanceDirective-v3.1.1(2020EN)",
    "name" : "zib AdvanceDirective-v3.1.1(2020EN)"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Consent",
  "baseDefinition" : "http://nictiz.nl/fhir/StructureDefinition/nl-core-AdvanceDirective",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Consent",
      "path" : "Consent",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "690",
        "comment" : "Euthanasieverklaring (Wilsverklaring)"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "700",
        "comment" : "Keuze orgaandonatie vastgelegd (Wilsverklaring)"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "721",
        "comment" : "Eerder vastgelegde behandelafspraken (Wilsverklaring)"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "610",
        "comment" : "Wilsverklaring"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "645",
        "comment" : "Wilsverklaring"
      }]
    },
    {
      "id" : "Consent.extension:disorder",
      "extension" : [{
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:populate-if-known"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorProvider|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      },
      {
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:no-error"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorConsulter|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      }],
      "path" : "Consent.extension",
      "sliceName" : "disorder",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "693",
        "comment" : "Aandoening"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "703",
        "comment" : "Aandoening"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "724",
        "comment" : "Aandoening"
      }]
    },
    {
      "id" : "Consent.extension:comment",
      "extension" : [{
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:populate-if-known"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorProvider|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      },
      {
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:no-error"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorConsulter|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      }],
      "path" : "Consent.extension",
      "sliceName" : "comment",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "698",
        "comment" : "Toelichting"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "708",
        "comment" : "Toelichting"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "729",
        "comment" : "Toelichting"
      }]
    },
    {
      "id" : "Consent.patient",
      "extension" : [{
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:populate-if-known"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorProvider|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      },
      {
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:no-error"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorConsulter|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      }],
      "path" : "Consent.patient",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["https://api.iknl.nl/docs/pzp/r4/StructureDefinition/ACP-Patient|1.0.0-rc2"]
      }]
    },
    {
      "id" : "Consent.dateTime",
      "extension" : [{
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:populate-if-known"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorProvider|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      },
      {
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:no-error"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorConsulter|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      }],
      "path" : "Consent.dateTime",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "692",
        "comment" : "WilsverklaringDatum"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "702",
        "comment" : "WilsverklaringDatum"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "723",
        "comment" : "WilsverklaringDatum"
      }]
    },
    {
      "id" : "Consent.source[x]:sourceAttachment",
      "extension" : [{
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:populate-if-known"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorProvider|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      },
      {
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:no-error"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorConsulter|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      }],
      "path" : "Consent.source[x]",
      "sliceName" : "sourceAttachment",
      "type" : [{
        "code" : "Attachment"
      }],
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "697",
        "comment" : "WilsverklaringDocument"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "707",
        "comment" : "WilsverklaringDocument"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "728",
        "comment" : "WilsverklaringDocument"
      }]
    },
    {
      "id" : "Consent.provision.actor:representative",
      "path" : "Consent.provision.actor",
      "sliceName" : "representative"
    },
    {
      "id" : "Consent.provision.actor:representative.reference",
      "extension" : [{
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:populate-if-known"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorProvider|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      },
      {
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:no-error"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorConsulter|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      }],
      "path" : "Consent.provision.actor.reference",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "695",
        "comment" : "Vertegenwoordiger"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "705",
        "comment" : "Vertegenwoordiger"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "726",
        "comment" : "Vertegenwoordiger"
      }]
    },
    {
      "id" : "Consent.provision.code",
      "extension" : [{
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:populate-if-known"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorProvider|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      },
      {
        "extension" : [{
          "url" : "code",
          "valueCode" : "SHALL:no-error"
        },
        {
          "url" : "actor",
          "valueCanonical" : "https://api.iknl.nl/docs/pzp/r4/ActorDefinition/ACPActorConsulter|1.0.0-rc2"
        }],
        "url" : "http://hl7.org/fhir/StructureDefinition/obligation"
      }],
      "path" : "Consent.provision.code",
      "definition" : " The following codes are in scope of this profile:\r\n- For Euthanasia, codes _EU_ (Euthanasieverzoek) or _EUD_ (Euthanasieverzoek met aanvulling Dementie).\r\n- For Organ Donation, code _DO_ (Verklaring donorschap).",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "691",
        "comment" : "Euthanasieverklaring (WilsverklaringType)"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "701",
        "comment" : "Orgaandonatie (WilsverklaringType)"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "722",
        "comment" : "WilsverklaringType"
      }]
    }]
  }
}

```
