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

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

## Resource Profile: ACP Encounter 

| | |
| :--- | :--- |
| *Official URL*:https://api.iknl.nl/docs/pzp/r4/StructureDefinition/ACP-Encounter | *Version*:1.0.0-rc2 |
| Draft as of 2026-06-02 | *Computable Name*:ACPEncounter |
| **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. | |

 
Any interaction, regardless of the situation, between a patient and the healthcare provider, in which the healthcare provider has primary responsibility for diagnosing, evaluating and treating the patient’s condition and informing the patient. These can be visits, appointments or non face-to-face interactions. Based on nl-core-Encounter and HCIM Encounter. 

### 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 Request to Inform Relatives](StructureDefinition-ACP-InformRelativesRequest.md), [ACP Organ Donation Choice Registration in Donor Register](StructureDefinition-ACP-OrganDonationChoiceRegistration.md), [ACP Position Regarding Euthanasia](StructureDefinition-ACP-PositionRegardingEuthanasia.md), [ACP Preferred Place of Death](StructureDefinition-ACP-PreferredPlaceOfDeath.md)... Show 3 more, [ACP Procedure](StructureDefinition-ACP-Procedure.md), [ACP Sense of Purpose](StructureDefinition-ACP-SenseOfPurpose.md) and [ACP Specific Care Wishes](StructureDefinition-ACP-SpecificCareWishes.md)
* Examples for this Profile: [Encounter/ACP-Encounter-1-Pat2](Encounter-ACP-Encounter-1-Pat2.md), [Encounter/ACP-Encounter-2-Pat2](Encounter-ACP-Encounter-2-Pat2.md) and [Encounter/ACP-Encounter-Pat1](Encounter-ACP-Encounter-Pat1.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/resource/iknl.fhir.r4.pzp|current/StructureDefinition/StructureDefinition-ACP-Encounter.json)

### 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-Encounter.csv), [Excel](StructureDefinition-ACP-Encounter.xlsx), [Schematron](StructureDefinition-ACP-Encounter.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "ACP-Encounter",
  "url" : "https://api.iknl.nl/docs/pzp/r4/StructureDefinition/ACP-Encounter",
  "version" : "1.0.0-rc2",
  "name" : "ACPEncounter",
  "title" : "ACP Encounter",
  "status" : "draft",
  "experimental" : false,
  "date" : "2026-06-02T12:44:46+00:00",
  "publisher" : "IKNL",
  "contact" : [{
    "name" : "IKNL",
    "telecom" : [{
      "system" : "url",
      "value" : "https://iknl.nl/"
    },
    {
      "system" : "email",
      "value" : "info@iknl.nl"
    }]
  }],
  "description" : "Any interaction, regardless of the situation, between a patient and the healthcare provider, in which the healthcare provider has primary responsibility for diagnosing, evaluating and treating the patient’s condition and informing the patient. These can be visits, appointments or non face-to-face interactions. Based on nl-core-Encounter and HCIM Encounter.",
  "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-encounter-v4.0.1-2020EN",
    "uri" : "https://zibs.nl/wiki/Encounter-v4.0.1(2020EN)",
    "name" : "zib Encounter-v4.0.1(2020EN)"
  },
  {
    "identity" : "zib-healthprofessional-v3.5-2020EN",
    "uri" : "https://zibs.nl/wiki/HealthProfessional-v3.5(2020EN)",
    "name" : "zib HealthProfessional-v3.5(2020EN)"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Encounter",
  "baseDefinition" : "http://nictiz.nl/fhir/StructureDefinition/nl-core-Encounter",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Encounter",
      "path" : "Encounter",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "808",
        "comment" : "Contact"
      }]
    },
    {
      "id" : "Encounter.class",
      "path" : "Encounter.class",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "809",
        "comment" : "ContactType"
      }]
    },
    {
      "id" : "Encounter.subject",
      "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" : "Encounter.subject",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["https://api.iknl.nl/docs/pzp/r4/StructureDefinition/ACP-Patient|1.0.0-rc2"]
      }],
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "514",
        "comment" : "Gesprek gevoerd in bijzijn van (Patient)"
      }]
    },
    {
      "id" : "Encounter.participant",
      "path" : "Encounter.participant",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "810",
        "comment" : "ContactMet"
      }]
    },
    {
      "id" : "Encounter.participant:healthProfessional",
      "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" : "Encounter.participant",
      "sliceName" : "healthProfessional"
    },
    {
      "id" : "Encounter.participant:healthProfessional.individual",
      "path" : "Encounter.participant.individual",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["https://api.iknl.nl/docs/pzp/r4/StructureDefinition/ACP-HealthProfessional-PractitionerRole|1.0.0-rc2"]
      }],
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "842",
        "comment" : "Gesprek gevoerd door (Zorgverlener)"
      }]
    },
    {
      "id" : "Encounter.participant:contactPerson",
      "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" : "Encounter.participant",
      "sliceName" : "contactPerson",
      "min" : 0,
      "max" : "*"
    },
    {
      "id" : "Encounter.participant:contactPerson.individual",
      "path" : "Encounter.participant.individual",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["https://api.iknl.nl/docs/pzp/r4/StructureDefinition/ACP-ContactPerson|1.0.0-rc2"]
      }],
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "554",
        "comment" : "Gesprek gevoerd in bijzijn van (Contactpersoon)"
      }]
    },
    {
      "id" : "Encounter.period.start",
      "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" : "Encounter.period.start",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "814",
        "comment" : "BeginDatumTijd"
      },
      {
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "736",
        "comment" : "Datum van invullen"
      }]
    },
    {
      "id" : "Encounter.reasonCode:deviatingResult",
      "path" : "Encounter.reasonCode",
      "sliceName" : "deviatingResult"
    },
    {
      "id" : "Encounter.reasonCode:deviatingResult.extension:commentContactReason",
      "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" : "Encounter.reasonCode.extension",
      "sliceName" : "commentContactReason",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "822",
        "comment" : "ToelichtingRedenContact"
      }]
    },
    {
      "id" : "Encounter.reasonReference",
      "path" : "Encounter.reasonReference"
    },
    {
      "id" : "Encounter.reasonReference.extension:commentContactReason",
      "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" : "Encounter.reasonReference.extension",
      "sliceName" : "commentContactReason",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "822",
        "comment" : "ToelichtingRedenContact"
      }]
    },
    {
      "id" : "Encounter.reasonReference:procedure",
      "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" : "Encounter.reasonReference",
      "sliceName" : "procedure",
      "mapping" : [{
        "identity" : "pall-izppz-zib2020v2026-02-24",
        "map" : "819",
        "comment" : "Verrichting"
      }]
    }]
  }
}

```
