IKNL PZP STU3
0.1.3-beta3 - consultation International flag

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

Data Model

This page provides an overview of the FHIR resources used to represent the ACP dataset, many of which are based on nl-core profiles.

ACP Questionnaire

A patient's ACP preferences can be documented using a structured form, such as the one developed by IKNL. This implementation guide provides a corresponding FHIR Questionnaire resource to ensure standardized and interoperable data capture.

The Questionnaire's primary function is to specify its identity and question identifiers required to capture answers in a QuestionnaireResponse. The Questionnaire is based on the ACP form dataset and aims to preserve the zib structure as much as possible. To ensure the intended meaning is preserved in both the Questionnaire and QuestionnaireResponse, some questions correspond to zib concepts with preset answer codes that are marked as readOnly. This approach tightly couples the Questionnaire and QuestionnaireResponse to the underlying zib data model. The Questionnaire is not specifically designed for direct use in a user interface, though this is possible. For optimal user interaction, the questionnaire may need customization, for example, hiding preselected and read-only questions.

Two example QuestionnaireResponse resources, based on this Questionnaire, are included:

Associating ACP dataset to FHIR

The FHIR profiles in this guide are directly linked to the ACP dataset elements published in ART-DECOR.

Each StructureDefinition includes a StructureDefinition.mapping.uri that points to the specific version of the ACP dataset used. Additionally, every element within a profile is individually mapped to its corresponding dataset element using the ElementDefinition.mapping property. A user-friendly rendering of these mappings is available on the "Mappings" tab of each profile page.

These mappings provide a straightforward way to highlight the elements that are especially relevant for the ACP use case, without the need to set or define mustSupport flags. As a result, the profile's differential table now shows all elements marked as relevant.

Note on referenced zibs

The ACP dataset is built from reusable components known as Zorginformatiebouwstenen (zibs). A zib can reference other zibs to create a comprehensive clinical picture. The ACP dataset, however, only includes the first level of these references. If a nested zib (i.e., a zib referenced by another) was not deemed essential for the primary ACP use case, it was not added to the dataset and is therefore not profiled or mapped in this guide.

Nevertheless, the FHIR profiles in this guide are based on the nl-core (zib) profiles and remain open by design. If a system contains deeper information that is not explicitly profiled in this ACP guide, it is encouraged to include it.

For example, the zib AdvanceDirective can reference the zib Problem to which the directive applies. While this guide does not define a specific ACP profile for the target Problem, this data provides important context. When including such information, systems should make it available by conforming to the general-purpose nl-core profiles for those resources.

Mappings by dataset ID

This table provides an overview of all zib2017 dataset elements that are mapped to STU3 FHIR profiles in this implementation guide.

ID Dataset name Resource FHIR element
764 Contact Encounter (ACPEncounter) Encounter
765  ContactType Encounter (ACPEncounter) Encounter.class
766  ContactMet Encounter (ACPEncounter) Encounter.participant
807   Gesprek gevoerd door (Zorgverlener) Encounter (ACPEncounter) Encounter.participant.individual
770  BeginDatumTijd Encounter (ACPEncounter) Encounter.period.start
772  RedenContact Encounter (ACPEncounter) Encounter.diagnosis.condition
775   Verrichting Encounter (ACPEncounter) Encounter.diagnosis.condition
776    Verrichting Procedure (ACPProcedure) Procedure
797     PZP gesprek (VerrichtingType) Procedure (ACPProcedure) Procedure.code
304  Datum van invullen (DatumTijd) Encounter (ACPEncounter) Encounter.period.start
11 Patient Patient (ACPPatient) Patient
12  Naamgegevens Patient (ACPPatient) Patient.name
13   Naamgegevens Patient (ACPPatient) Patient.name
219    Voornamen Patient (ACPPatient) Patient.name.given
220    Initialen Patient (ACPPatient) Patient.name.given
221    Roepnaam Patient (ACPPatient) Patient.name.given
222    Naamgebruik Patient (ACPPatient) Patient.name.use
224     Voorvoegsels Patient (ACPPatient) Patient.name.family.extension:humannameOwnPrefix
225     Achternaam Patient (ACPPatient) Patient.name.family.extension:humannameOwnName
227     VoorvoegselsPartner Patient (ACPPatient) Patient.name.family.extension:humannamePartnerPrefix
228     AchternaamPartner Patient (ACPPatient) Patient.name.family.extension:humannamePartnerName
14  Adresgegevens Patient (ACPPatient) Patient.address
15   Adresgegevens Patient (ACPPatient) Patient.address
16  Contactgegevens Patient (ACPPatient) Patient.telecom
17   Contactgegevens Patient (ACPPatient) Patient.telecom
18  Identificatienummer Patient (ACPPatient) Patient.identifier
19  Geboortedatum Patient (ACPPatient) Patient.birthDate
20  Geslacht Patient (ACPPatient) Patient.gender
24 Gesprek gevoerd door (Zorgverlener) Practitioner (ACPHealthProfessionalPractitioner) Practitioner
24 Gesprek gevoerd door (Zorgverlener) PractitionerRole (ACPHealthProfessionalPractitionerRole) PractitionerRole
25  ZorgverlenerIdentificatienummer Practitioner (ACPHealthProfessionalPractitioner) Practitioner.identifier
26  Naamgegevens Practitioner (ACPHealthProfessionalPractitioner) Practitioner.name
27   Naamgegevens Practitioner (ACPHealthProfessionalPractitioner) Practitioner.name
229    Voornamen Practitioner (ACPHealthProfessionalPractitioner) Practitioner.name.given
234     Voorvoegsels Practitioner (ACPHealthProfessionalPractitioner) Practitioner.name.family.extension:humannameOwnPrefix
235     Achternaam Practitioner (ACPHealthProfessionalPractitioner) Practitioner.name.family.extension:humannameOwnName
28  Functie (Specialisme) PractitionerRole (ACPHealthProfessionalPractitionerRole) PractitionerRole.specialty
758 Wilsbekwaamheid m.b.t. medische behandelbeslissingen Patient (ACPPatient) Patient.extension:legallyCapableMedicalTreatmentDecisions
759  Wilsbekwaamheid m.b.t. medische behandelbeslissingen Patient (ACPPatient) Patient.extension:legallyCapableMedicalTreatmentDecisions.extension:legallyCapable
760  Toelichting Patient (ACPPatient) Patient.extension:legallyCapableMedicalTreatmentDecisions.extension:legallyCapableComment
36 Wettelijk vertegenwoordiger (Contactpersoon) RelatedPerson (ACPContactPerson) RelatedPerson
37  Naam wettelijk vertegenwoordiger (Naamgegevens) RelatedPerson (ACPContactPerson) RelatedPerson.name
38   Naamgegevens RelatedPerson (ACPContactPerson) RelatedPerson.name
239    Voornamen RelatedPerson (ACPContactPerson) RelatedPerson.name.given
240    Initialen RelatedPerson (ACPContactPerson) RelatedPerson.name.given
241    Roepnaam RelatedPerson (ACPContactPerson) RelatedPerson.name.given
242    Naamgebruik RelatedPerson (ACPContactPerson) RelatedPerson.name.use
244     Voorvoegsels RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannameOwnPrefix
245     Achternaam RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannameOwnName
247     VoorvoegselsPartner RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannamePartnerPrefix
248     AchternaamPartner RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannamePartnerName
39  Contactgegevens wettelijk vertegenwoordiger (Contactgegevens) RelatedPerson (ACPContactPerson) RelatedPerson.telecom
40   Contactgegevens RelatedPerson (ACPContactPerson) RelatedPerson.telecom
43  Rol RelatedPerson (ACPContactPerson) RelatedPerson.extension:role
44  Relatie tot patient (Relatie) RelatedPerson (ACPContactPerson) RelatedPerson.relationship
1 Vertegenwoordiger is contactpersoon RelatedPerson (ACPContactPerson) RelatedPerson.extension:role
45 Eerste contactpersoon (Contactpersoon) RelatedPerson (ACPContactPerson) RelatedPerson
67  Naamgegevens RelatedPerson (ACPContactPerson) RelatedPerson.name
68   Naamgegevens RelatedPerson (ACPContactPerson) RelatedPerson.name
256    Voornamen RelatedPerson (ACPContactPerson) RelatedPerson.name.given
257    Initialen RelatedPerson (ACPContactPerson) RelatedPerson.name.given
258    Roepnaam RelatedPerson (ACPContactPerson) RelatedPerson.name.given
259    Naamgebruik RelatedPerson (ACPContactPerson) RelatedPerson.name.use
261     Voorvoegsels RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannameOwnPrefix
262     Achternaam RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannameOwnName
264     VoorvoegselsPartner RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannamePartnerPrefix
265     AchternaamPartner RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannamePartnerName
69  Contactgegevens RelatedPerson (ACPContactPerson) RelatedPerson.telecom
70   Contactgegevens RelatedPerson (ACPContactPerson) RelatedPerson.telecom
267     Telefoonnummer RelatedPerson (ACPContactPerson) RelatedPerson.telecom.value
268     TelecomType RelatedPerson (ACPContactPerson) RelatedPerson.telecom.extension:TelecomType
268     TelecomType RelatedPerson (ACPContactPerson) RelatedPerson.telecom.system
269     NummerSoort RelatedPerson (ACPContactPerson) RelatedPerson.telecom.use
271     EmailAdres RelatedPerson (ACPContactPerson) RelatedPerson.telecom.value
272     EmailSoort RelatedPerson (ACPContactPerson) RelatedPerson.telecom.system
71  Adresgegevens RelatedPerson (ACPContactPerson) RelatedPerson.address
72   Adresgegevens RelatedPerson (ACPContactPerson) RelatedPerson.address
73  Rol RelatedPerson (ACPContactPerson) RelatedPerson.extension:role
74  Relatie tot patient (Relatie) RelatedPerson (ACPContactPerson) RelatedPerson.relationship
305 Gesprek gevoerd in bijzijn van (Patient) Patient (ACPPatient) Patient
328  Naamgegevens Patient (ACPPatient) Patient.name
329   Naamgegevens Patient (ACPPatient) Patient.name
330    Voornamen Patient (ACPPatient) Patient.name.given
331    Initialen Patient (ACPPatient) Patient.name.given
332    Roepnaam Patient (ACPPatient) Patient.name.given
333    Naamgebruik Patient (ACPPatient) Patient.name.use
335     Voorvoegsels Patient (ACPPatient) Patient.name.family.extension:humannameOwnPrefix
336     Achternaam Patient (ACPPatient) Patient.name.family.extension:humannameOwnName
338     VoorvoegselsPartner Patient (ACPPatient) Patient.name.family.extension:humannamePartnerPrefix
339     AchternaamPartner Patient (ACPPatient) Patient.name.family.extension:humannamePartnerName
148 Gesprek gevoerd in bijzijn van (Contactpersoon) RelatedPerson (ACPContactPerson) RelatedPerson
148 Gesprek gevoerd in bijzijn van (Contactpersoon) Encounter (ACPEncounter) Encounter.participant.individual
149  Naamgegevens RelatedPerson (ACPContactPerson) RelatedPerson.name
150   Naamgegevens RelatedPerson (ACPContactPerson) RelatedPerson.name
273    Voornamen RelatedPerson (ACPContactPerson) RelatedPerson.name.given
274    Initialen RelatedPerson (ACPContactPerson) RelatedPerson.name.given
275    Roepnaam RelatedPerson (ACPContactPerson) RelatedPerson.name.given
276    Naamgebruik RelatedPerson (ACPContactPerson) RelatedPerson.name.use
278     Voorvoegsels RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannameOwnPrefix
279     Achternaam RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannameOwnName
281     VoorvoegselsPartner RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannamePartnerPrefix
282     AchternaamPartner RelatedPerson (ACPContactPerson) RelatedPerson.name.family.extension:humannamePartnerName
155  Rol RelatedPerson (ACPContactPerson) RelatedPerson.extension:role
156  Relatie tot patient (Relatie) RelatedPerson (ACPContactPerson) RelatedPerson.relationship
157 Belangrijkste doel van behandeling (AlgemeneMeting) Goal (ACPMedicalPolicyGoal) Goal
160  Toelichting Goal (ACPMedicalPolicyGoal) Goal.note.text
162   MetingNaam voor Belangrijkste doel van behandeling Goal (ACPMedicalPolicyGoal) Goal
163   Doel (UitslagWaarde) Goal (ACPMedicalPolicyGoal) Goal.description
165   UitslagDatumTijd Goal (ACPMedicalPolicyGoal) Goal.start[x]:startDate
54 Behandelgrens (BehandelAanwijzing) Consent (ACPTreatmentDirective) Consent
55  Verificatie Consent (ACPTreatmentDirective) Consent.extension:verification
56   Geverifieerd Consent (ACPTreatmentDirective) Consent.extension:verification.extension:Verified
57   GeverifieerdBij Consent (ACPTreatmentDirective) Consent.extension:verification.extension:VerifiedWith
58   VerificatieDatum Consent (ACPTreatmentDirective) Consent.extension:verification.extension:VerificationDate
59  Behandeling Consent (ACPTreatmentDirective) Consent.extension:treatment
60  BehandelingToegestaan Consent (ACPTreatmentDirective) Consent.modifierExtension:treatmentPermitted
61  Beperkingen Consent (ACPTreatmentDirective) Consent.except.extension:restrictions
62  BeginDatum Consent (ACPTreatmentDirective) Consent.period.start
63  EindDatum Consent (ACPTreatmentDirective) Consent.period.end
64  Toelichting Consent (ACPTreatmentDirective) Consent.extension:comment
65  Wilsverklaring Consent (ACPTreatmentDirective) Consent.extension:additionalSources
65  Wilsverklaring Consent (ACPTreatmentDirective) Consent.source[x]:sourceReference
66   Wilsverklaring Consent (ACPAdvanceDirective) Consent
218 Heeft de patient een ICD? DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement
75 ICD (MedischHulpmiddel) DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement
76  Product Device (ACPMedicalDeviceProductICD) Device
76  Product DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement.device
77   ProductID Device (ACPMedicalDeviceProductICD) Device.identifier:gs1ProductID
77   ProductID Device (ACPMedicalDeviceProductICD) Device.identifier:hibcProductID
77   ProductID Device (ACPMedicalDeviceProductICD) Device.udi.carrierHRF
78   ProductType van ICD Device (ACPMedicalDeviceProductICD) Device.type
79  ProductOmschrijving Device (ACPMedicalDeviceProductICD) Device.note.text
80  BeginDatum DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement.whenUsed.start
81  Indicatie DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement.indication.extension:indication_Problem
83  Toelichting DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement.note.text
84  AnatomischeLocatie DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement.bodySite
85  Lateraliteit DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement.bodySite.extension:Laterality
86  Locatie DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement.extension:HealthcareProvider
88  Zorgverlener DeviceUseStatement (ACPMedicalDevice) DeviceUseStatement.extension:HealthProfessional
89   Zorgverlener Practitioner (ACPHealthProfessionalPractitioner) Practitioner
89   Zorgverlener PractitionerRole (ACPHealthProfessionalPractitionerRole) PractitionerRole
90 Afspraak uitzetten ICD (BehandelAanwijzing) Consent (ACPTreatmentDirective) Consent
91  Verificatie Consent (ACPTreatmentDirective) Consent.extension:verification
92   Geverifieerd Consent (ACPTreatmentDirective) Consent.extension:verification.extension:Verified
93   GeverifieerdBij Consent (ACPTreatmentDirective) Consent.extension:verification.extension:VerifiedWith
94   VerificatieDatum Consent (ACPTreatmentDirective) Consent.extension:verification.extension:VerificationDate
95  Behandeling van uitzetten ICD Consent (ACPTreatmentDirective) Consent.extension:treatment
96  Afspraak uitzetten ICD (BehandelingToegestaan) Consent (ACPTreatmentDirective) Consent.modifierExtension:treatmentPermitted
98  BeginDatum Consent (ACPTreatmentDirective) Consent.period.start
99  EindDatum Consent (ACPTreatmentDirective) Consent.period.end
100  Toelichting Consent (ACPTreatmentDirective) Consent.extension:comment
101  Wilsverklaring Consent (ACPTreatmentDirective) Consent.source[x]:sourceReference
102   Wilsverklaring Consent (ACPAdvanceDirective) Consent
190 Specifieke wensen (AlgemeneMeting) Observation (ACPSpecificCareWishes) Observation
203   Wens en verwachting patient (MetingNaam) Observation (ACPSpecificCareWishes) Observation.code
204   Wens en verwachting patient (UitslagWaarde) Observation (ACPSpecificCareWishes) Observation.value[x]
204   Wens en verwachting patient (UitslagWaarde) Observation (ACPSpecificCareWishes) Observation.dataAbsentReason
205   Vaststellen wens en verwachting patiënt (Meetmethode) Observation (ACPSpecificCareWishes) Observation.method
206   UitslagDatumTijd Observation (ACPSpecificCareWishes) Observation.effective[x]
105 Gewenste plek van overlijden (AlgemeneMeting) Observation (ACPPreferredPlaceOfDeath) Observation
108  Toelichting Observation (ACPPreferredPlaceOfDeath) Observation.comment
110   MetingNaam voor Gewenste plek van overlijden Observation (ACPPreferredPlaceOfDeath) Observation.code
111   Voorkeursplek (UitslagWaarde) Observation (ACPPreferredPlaceOfDeath) Observation.value[x]
111   Voorkeursplek (UitslagWaarde) Observation (ACPPreferredPlaceOfDeath) Observation.dataAbsentReason
113   UitslagDatumTijd Observation (ACPPreferredPlaceOfDeath) Observation.effective[x]
114 Euthanasie standpunt (AlgemeneMeting) Observation (ACPPositionRegardingEuthanasia) Observation
117  Toelichting Observation (ACPPositionRegardingEuthanasia) Observation.comment
119   MetingNaam voor Euthanasie standpunt Observation (ACPPositionRegardingEuthanasia) Observation.code
120   Standpunt (UitslagWaarde) Observation (ACPPositionRegardingEuthanasia) Observation.value[x]
120   Standpunt (UitslagWaarde) Observation (ACPPositionRegardingEuthanasia) Observation.dataAbsentReason
122   UitslagDatumTijd Observation (ACPPositionRegardingEuthanasia) Observation.effective[x]
166 Euthanasieverklaring (Wilsverklaring) Consent (ACPAdvanceDirective) Consent
175  Euthanasieverklaring (WilsverklaringType) Consent (ACPAdvanceDirective) Consent.category:typeOfLivingWill
176  WilsverklaringDatum Consent (ACPAdvanceDirective) Consent.dateTime
181  WilsverklaringDocument Consent (ACPAdvanceDirective) Consent.source[x]:sourceAttachment
737 Keuze orgaandonatie vastgelegd in donorregister? (AlgemeneMeting) Observation (ACPOrganDonationChoiceRegistration) Observation
742   MetingNaam voor Keuze orgaandonatie vastgelegd in donorregister? Observation (ACPOrganDonationChoiceRegistration) Observation.code
743   Keuze orgaandonatie in donorregister (UitslagWaarde) Observation (ACPOrganDonationChoiceRegistration) Observation.value[x]
743   Keuze orgaandonatie in donorregister (UitslagWaarde) Observation (ACPOrganDonationChoiceRegistration) Observation.dataAbsentReason
123 Keuze orgaandonatie vastgelegd (Wilsverklaring) Consent (ACPAdvanceDirective) Consent
124  Orgaandonatie (WilsverklaringType) Consent (ACPAdvanceDirective) Consent.category:typeOfLivingWill
125  WilsverklaringDatum Consent (ACPAdvanceDirective) Consent.dateTime
126  Aandoening Consent (ACPAdvanceDirective) Consent.extension:disorder
128  Vertegenwoordiger Consent (ACPAdvanceDirective) Consent.consentingParty
130  WilsverklaringDocument Consent (ACPAdvanceDirective) Consent.source[x]:sourceAttachment
131  Toelichting Consent (ACPAdvanceDirective) Consent.extension:comment
132 Wat verder nog belangrijk is (AlgemeneMeting) Observation (ACPOtherImportantInformation) Observation
212   MetingNaam voor Wat verder nog belangrijk is Observation (ACPOtherImportantInformation) Observation.code
213   Wat verder nog belangrijk is (UitslagWaarde) Observation (ACPOtherImportantInformation) Observation.value[x]
213   Wat verder nog belangrijk is (UitslagWaarde) Observation (ACPOtherImportantInformation) Observation.dataAbsentReason
215   UitslagDatumTijd Observation (ACPOtherImportantInformation) Observation.effective[x]
139 Eerder vastgelegde behandelafspraken (Wilsverklaring) Consent (ACPAdvanceDirective) Consent
140  WilsverklaringType Consent (ACPAdvanceDirective) Consent.category:typeOfLivingWill
141  WilsverklaringDatum Consent (ACPAdvanceDirective) Consent.dateTime
142  Aandoening Consent (ACPAdvanceDirective) Consent.extension:disorder
144  Vertegenwoordiger Consent (ACPAdvanceDirective) Consent.consentingParty
146  WilsverklaringDocument Consent (ACPAdvanceDirective) Consent.source[x]:sourceAttachment
147  Toelichting Consent (ACPAdvanceDirective) Consent.extension:comment
187 Heeft u patient geïnformeerd over eigen verantwoordelijkheid om deze behandelafspraken met naasten te bespreken? Communication (ACPCommunication) Communication