IKNL PZP STU3
1.0.0-rc1 - consultation International flag

IKNL PZP STU3, published by IKNL. This guide is not an authorized publication; it is the continuous build for version 1.0.0-rc1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IKNL/PZP-FHIR-STU3/ and changes regularly. See the Directory of published versions

Resource Profile: ACP Medical Policy Goal

Official URL: https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ACPMedicalPolicyGoal Version: 1.0.0-rc1
Draft as of 2026-02-17 Computable Name: ACPMedicalPolicyGoal

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.

The primary, agreed-upon goal of a patient's medical treatment policy. Based on Goal resource.

Usages:

  • This Profile is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Goal 0..* Goal Describes the intended objective(s) for a patient, group or organization
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!Σ 1..1 code proposed | accepted | planned | in-progress | on-target | ahead-of-target | behind-target | sustaining | achieved | on-hold | cancelled | entered-in-error | rejected
Binding: GoalStatus (required): Indicates whether the goal has been met and is still being targeted
.... id 0..1 string xml:id (or equivalent in JSON)
.... extension 0..* Extension Additional Content defined by implementations
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... id 0..1 string xml:id (or equivalent in JSON)
..... extension 0..* Extension Additional Content defined by implementations
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://snomed.info/sct
..... version 0..1 string Version of the system - if relevant
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 713603004
..... display 0..1 string Representation defined by the system
..... userSelected 0..1 boolean If this coding was chosen directly by the user
.... text 0..1 string Plain text representation of the concept
... description Σ 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-rc1) (required)
... subject Σ 0..1 Reference(ACP Patient(1.0.0-rc1)) Who this goal is intended for
... Slices for start[x] Σ 0..1 When goal pursuit begins
Slice: Unordered, Open by type:$this
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal
.... startDate date
.... startCodeableConcept CodeableConcept
.... start[x]:startDate Σ 0..1 date When goal pursuit begins

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Goal.status Base required GoalStatus 📍3.0.2 FHIR Std.
Goal.category Base example GoalCategory 📍3.0.2 FHIR Std.
Goal.description Base required ACP Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-rc1 This IG
Goal.start[x] Base example GoalStartEvent 📍3.0.2 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-1 error Goal If the resource is contained in another resource, it SHALL NOT contain any narrative contained.text.empty()
dom-2 error Goal If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Goal If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource contained.where(('#'+id in %resource.descendants().reference).not()).empty()
dom-4 error Goal If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()

This structure is derived from Goal

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Goal 0..* Goal Describes the intended objective(s) for a patient, group or organization
... category 1..* CodeableConcept E.g. Treatment, dietary, behavioral, etc.
Required Pattern: At least the following
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://snomed.info/sct
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 713603004
... description 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-rc1) (required)
... subject 0..1 Reference(ACP Patient(1.0.0-rc1)) Who this goal is intended for
.... start[x]:startDate 0..1 date When goal pursuit begins
... note
.... text 1..1 string The annotation - text content

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Goal.description Base required ACP Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-rc1 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Goal 0..* Goal Describes the intended objective(s) for a patient, group or organization
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional Content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier External Ids for this goal
... status ?!Σ 1..1 code proposed | accepted | planned | in-progress | on-target | ahead-of-target | behind-target | sustaining | achieved | on-hold | cancelled | entered-in-error | rejected
Binding: GoalStatus (required): Indicates whether the goal has been met and is still being targeted
... category Σ 1..* CodeableConcept E.g. Treatment, dietary, behavioral, etc.
Binding: GoalCategory (example): Codes for grouping and sorting goals

Required Pattern: At least the following
.... id 0..1 string xml:id (or equivalent in JSON)
.... extension 0..* Extension Additional Content defined by implementations
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... id 0..1 string xml:id (or equivalent in JSON)
..... extension 0..* Extension Additional Content defined by implementations
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://snomed.info/sct
..... version 0..1 string Version of the system - if relevant
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 713603004
..... display 0..1 string Representation defined by the system
..... userSelected 0..1 boolean If this coding was chosen directly by the user
.... text 0..1 string Plain text representation of the concept
... priority Σ 0..1 CodeableConcept high-priority | medium-priority | low-priority
Binding: GoalPriority (preferred): The level of importance associated with a goal
... description Σ 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-rc1) (required)
... subject Σ 0..1 Reference(ACP Patient(1.0.0-rc1)) Who this goal is intended for
... Slices for start[x] Σ 0..1 When goal pursuit begins
Slice: Unordered, Open by type:$this
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal
.... startDate date
.... startCodeableConcept CodeableConcept
.... start[x]:startDate Σ 0..1 date When goal pursuit begins
... target C 0..1 BackboneElement Target outcome for the goal
Constraints: gol-1
.... id 0..1 string xml:id (or equivalent in JSON)
.... extension 0..* Extension Additional Content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
.... measure ΣC 0..1 CodeableConcept The parameter whose value is being tracked
Binding: LOINC Codes (example): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level.
.... detail[x] ΣC 0..1 The target value to be achieved
Binding Description: (example): Codes to identify the target value of the focus to be achieved to signify the fulfillment of the goal.
..... detailQuantity Quantity
..... detailRange Range
..... detailCodeableConcept CodeableConcept
.... due[x] Σ 0..1 Reach goal on or before
..... dueDate date
..... dueDuration Duration
... statusDate Σ 0..1 date When goal status took effect
... statusReason 0..1 string Reason for current status
... expressedBy Σ 0..1 Reference(Patient | Practitioner | RelatedPerson) Who's responsible for creating Goal?
... addresses 0..* Reference(Condition | Observation | MedicationStatement | NutritionOrder | ProcedureRequest | RiskAssessment) Issues addressed by this goal
... note 0..* Annotation Comments about the goal
.... id 0..1 string xml:id (or equivalent in JSON)
.... extension 0..* Extension Additional Content defined by implementations
Slice: Unordered, Open by value:url
.... author[x] Σ 0..1 Individual responsible for the annotation
..... authorReference Reference(Practitioner | Patient | RelatedPerson)
..... authorString string
.... time Σ 0..1 dateTime When the annotation was made
.... text 1..1 string The annotation - text content
... outcomeCode 0..* CodeableConcept What result was achieved regarding the goal?
Binding: SNOMED CT Clinical Findings (example): The result of the goal; e.g. "25% increase in shoulder mobility", "Anxiety reduced to moderate levels". "15 kg weight loss sustained over 6 months"
... outcomeReference 0..* Reference(Observation) Observation that resulted from goal

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Goal.language Base extensible Common Languages 📍3.0.2 FHIR Std.
Goal.status Base required GoalStatus 📍3.0.2 FHIR Std.
Goal.category Base example GoalCategory 📍3.0.2 FHIR Std.
Goal.priority Base preferred GoalPriority 📍3.0.2 FHIR Std.
Goal.description Base required ACP Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-rc1 This IG
Goal.start[x] Base example GoalStartEvent 📍3.0.2 FHIR Std.
Goal.target.measure Base example LOINC Codes 📍3.0.2 FHIR Std.
Goal.target.detail[x] Base example Not State Unknown
Goal.outcomeCode Base example SNOMED CT Clinical Findings 📍3.0.2 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-1 error Goal If the resource is contained in another resource, it SHALL NOT contain any narrative contained.text.empty()
dom-2 error Goal If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Goal If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource contained.where(('#'+id in %resource.descendants().reference).not()).empty()
dom-4 error Goal If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() | (children().count() > id.count())
gol-1 error Goal.target Goal.target.measure is required if Goal.target.detail is populated (detail.exists() and measure.exists()) or detail.exists().not()

This structure is derived from Goal

Summary

Mandatory: 1 element

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of Goal.start[x]

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Goal 0..* Goal Describes the intended objective(s) for a patient, group or organization
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!Σ 1..1 code proposed | accepted | planned | in-progress | on-target | ahead-of-target | behind-target | sustaining | achieved | on-hold | cancelled | entered-in-error | rejected
Binding: GoalStatus (required): Indicates whether the goal has been met and is still being targeted
.... id 0..1 string xml:id (or equivalent in JSON)
.... extension 0..* Extension Additional Content defined by implementations
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... id 0..1 string xml:id (or equivalent in JSON)
..... extension 0..* Extension Additional Content defined by implementations
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://snomed.info/sct
..... version 0..1 string Version of the system - if relevant
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 713603004
..... display 0..1 string Representation defined by the system
..... userSelected 0..1 boolean If this coding was chosen directly by the user
.... text 0..1 string Plain text representation of the concept
... description Σ 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-rc1) (required)
... subject Σ 0..1 Reference(ACP Patient(1.0.0-rc1)) Who this goal is intended for
... Slices for start[x] Σ 0..1 When goal pursuit begins
Slice: Unordered, Open by type:$this
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal
.... startDate date
.... startCodeableConcept CodeableConcept
.... start[x]:startDate Σ 0..1 date When goal pursuit begins

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Goal.status Base required GoalStatus 📍3.0.2 FHIR Std.
Goal.category Base example GoalCategory 📍3.0.2 FHIR Std.
Goal.description Base required ACP Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-rc1 This IG
Goal.start[x] Base example GoalStartEvent 📍3.0.2 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-1 error Goal If the resource is contained in another resource, it SHALL NOT contain any narrative contained.text.empty()
dom-2 error Goal If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Goal If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource contained.where(('#'+id in %resource.descendants().reference).not()).empty()
dom-4 error Goal If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()

Differential View

This structure is derived from Goal

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Goal 0..* Goal Describes the intended objective(s) for a patient, group or organization
... category 1..* CodeableConcept E.g. Treatment, dietary, behavioral, etc.
Required Pattern: At least the following
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://snomed.info/sct
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 713603004
... description 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-rc1) (required)
... subject 0..1 Reference(ACP Patient(1.0.0-rc1)) Who this goal is intended for
.... start[x]:startDate 0..1 date When goal pursuit begins
... note
.... text 1..1 string The annotation - text content

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Goal.description Base required ACP Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-rc1 This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Goal 0..* Goal Describes the intended objective(s) for a patient, group or organization
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional Content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier External Ids for this goal
... status ?!Σ 1..1 code proposed | accepted | planned | in-progress | on-target | ahead-of-target | behind-target | sustaining | achieved | on-hold | cancelled | entered-in-error | rejected
Binding: GoalStatus (required): Indicates whether the goal has been met and is still being targeted
... category Σ 1..* CodeableConcept E.g. Treatment, dietary, behavioral, etc.
Binding: GoalCategory (example): Codes for grouping and sorting goals

Required Pattern: At least the following
.... id 0..1 string xml:id (or equivalent in JSON)
.... extension 0..* Extension Additional Content defined by implementations
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... id 0..1 string xml:id (or equivalent in JSON)
..... extension 0..* Extension Additional Content defined by implementations
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://snomed.info/sct
..... version 0..1 string Version of the system - if relevant
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 713603004
..... display 0..1 string Representation defined by the system
..... userSelected 0..1 boolean If this coding was chosen directly by the user
.... text 0..1 string Plain text representation of the concept
... priority Σ 0..1 CodeableConcept high-priority | medium-priority | low-priority
Binding: GoalPriority (preferred): The level of importance associated with a goal
... description Σ 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-rc1) (required)
... subject Σ 0..1 Reference(ACP Patient(1.0.0-rc1)) Who this goal is intended for
... Slices for start[x] Σ 0..1 When goal pursuit begins
Slice: Unordered, Open by type:$this
Binding: GoalStartEvent (example): Codes describing events that can trigger the initiation of a goal
.... startDate date
.... startCodeableConcept CodeableConcept
.... start[x]:startDate Σ 0..1 date When goal pursuit begins
... target C 0..1 BackboneElement Target outcome for the goal
Constraints: gol-1
.... id 0..1 string xml:id (or equivalent in JSON)
.... extension 0..* Extension Additional Content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
.... measure ΣC 0..1 CodeableConcept The parameter whose value is being tracked
Binding: LOINC Codes (example): Codes to identify the value being tracked, e.g. body weight, blood pressure, or hemoglobin A1c level.
.... detail[x] ΣC 0..1 The target value to be achieved
Binding Description: (example): Codes to identify the target value of the focus to be achieved to signify the fulfillment of the goal.
..... detailQuantity Quantity
..... detailRange Range
..... detailCodeableConcept CodeableConcept
.... due[x] Σ 0..1 Reach goal on or before
..... dueDate date
..... dueDuration Duration
... statusDate Σ 0..1 date When goal status took effect
... statusReason 0..1 string Reason for current status
... expressedBy Σ 0..1 Reference(Patient | Practitioner | RelatedPerson) Who's responsible for creating Goal?
... addresses 0..* Reference(Condition | Observation | MedicationStatement | NutritionOrder | ProcedureRequest | RiskAssessment) Issues addressed by this goal
... note 0..* Annotation Comments about the goal
.... id 0..1 string xml:id (or equivalent in JSON)
.... extension 0..* Extension Additional Content defined by implementations
Slice: Unordered, Open by value:url
.... author[x] Σ 0..1 Individual responsible for the annotation
..... authorReference Reference(Practitioner | Patient | RelatedPerson)
..... authorString string
.... time Σ 0..1 dateTime When the annotation was made
.... text 1..1 string The annotation - text content
... outcomeCode 0..* CodeableConcept What result was achieved regarding the goal?
Binding: SNOMED CT Clinical Findings (example): The result of the goal; e.g. "25% increase in shoulder mobility", "Anxiety reduced to moderate levels". "15 kg weight loss sustained over 6 months"
... outcomeReference 0..* Reference(Observation) Observation that resulted from goal

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Goal.language Base extensible Common Languages 📍3.0.2 FHIR Std.
Goal.status Base required GoalStatus 📍3.0.2 FHIR Std.
Goal.category Base example GoalCategory 📍3.0.2 FHIR Std.
Goal.priority Base preferred GoalPriority 📍3.0.2 FHIR Std.
Goal.description Base required ACP Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-rc1 This IG
Goal.start[x] Base example GoalStartEvent 📍3.0.2 FHIR Std.
Goal.target.measure Base example LOINC Codes 📍3.0.2 FHIR Std.
Goal.target.detail[x] Base example Not State Unknown
Goal.outcomeCode Base example SNOMED CT Clinical Findings 📍3.0.2 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-1 error Goal If the resource is contained in another resource, it SHALL NOT contain any narrative contained.text.empty()
dom-2 error Goal If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Goal If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource contained.where(('#'+id in %resource.descendants().reference).not()).empty()
dom-4 error Goal If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() | (children().count() > id.count())
gol-1 error Goal.target Goal.target.measure is required if Goal.target.detail is populated (detail.exists() and measure.exists()) or detail.exists().not()

This structure is derived from Goal

Summary

Mandatory: 1 element

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of Goal.start[x]

 

Other representations of profile: CSV, Excel, Schematron