IKNL PZP STU3
1.0.0-alpha1 - 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-alpha1 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: Medical Policy Goal

Official URL: https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ACP-Medical-Policy-Goal Version: 1.0.0-alpha1
Draft as of 2025-10-23 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:

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
... Slices for extension Content/Rules for all slices
.... extension:encounter 0..1 (Complex) ext Encounter Reference
URL: https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference
..... extension 0..0
..... url 1..1 uri "https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference"
..... value[x] 0..1 Reference(Encounter(1.0.0-alpha1)) Encounter
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... description Σ 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-alpha1) (required)
... subject Σ 0..1 Reference(Patient(1.0.0-alpha1)) 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.description Base required Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-alpha1 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()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() | (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

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
... Slices for extension Content/Rules for all slices
.... extension:encounter 0..1 (Complex) ext Encounter Reference
URL: https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference
..... value[x] 0..1 Reference(Encounter(1.0.0-alpha1)) Encounter
... description 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-alpha1) (required)
... subject 0..1 Reference(Patient(1.0.0-alpha1)) 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 Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-alpha1 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
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:encounter 0..1 (Complex) ext Encounter Reference
URL: https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference
..... id 0..1 string xml:id (or equivalent in JSON)
..... extension 0..0
..... url 1..1 uri "https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference"
..... value[x] 0..1 Reference(Encounter(1.0.0-alpha1)) Encounter
... 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 Σ 0..* CodeableConcept E.g. Treatment, dietary, behavioral, etc.
Binding: GoalCategory (example): Codes for grouping and sorting goals
... 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-alpha1) (required)
... subject Σ 0..1 Reference(Patient(1.0.0-alpha1)) 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 Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-alpha1 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 Stated 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())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
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

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

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
... Slices for extension Content/Rules for all slices
.... extension:encounter 0..1 (Complex) ext Encounter Reference
URL: https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference
..... extension 0..0
..... url 1..1 uri "https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference"
..... value[x] 0..1 Reference(Encounter(1.0.0-alpha1)) Encounter
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... description Σ 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-alpha1) (required)
... subject Σ 0..1 Reference(Patient(1.0.0-alpha1)) 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.description Base required Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-alpha1 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()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() | (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

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
... Slices for extension Content/Rules for all slices
.... extension:encounter 0..1 (Complex) ext Encounter Reference
URL: https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference
..... value[x] 0..1 Reference(Encounter(1.0.0-alpha1)) Encounter
... description 1..1 CodeableConcept Code or text describing goal
Binding: MedicalPolicyGoalVS (1.0.0-alpha1) (required)
... subject 0..1 Reference(Patient(1.0.0-alpha1)) 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 Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-alpha1 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
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:encounter 0..1 (Complex) ext Encounter Reference
URL: https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference
..... id 0..1 string xml:id (or equivalent in JSON)
..... extension 0..0
..... url 1..1 uri "https://api.iknl.nl/docs/pzp/stu3/StructureDefinition/ext-EncounterReference"
..... value[x] 0..1 Reference(Encounter(1.0.0-alpha1)) Encounter
... 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 Σ 0..* CodeableConcept E.g. Treatment, dietary, behavioral, etc.
Binding: GoalCategory (example): Codes for grouping and sorting goals
... 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-alpha1) (required)
... subject Σ 0..1 Reference(Patient(1.0.0-alpha1)) 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 Most Important Agreed-upon Goal of Medical Policy 📍1.0.0-alpha1 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 Stated 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())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
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

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

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