HL7 FHIR Implementation Guide - New Zealand Formulary/NZULM IG, published by New Zealand Medicines Formulary LP. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7NZ/nzf/ and changes regularly. See the Directory of published versions
Resource Profile: Medication resource for NZ Formulary
| Official URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-medication | Version: 1.0.0 | |||
| Active as of 2025-11-10 | Computable Name: NzfMedication | |||
Medication resource for NZ Formulary
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.
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| Medication.code | Base | preferred | http://nzmt.org.nz/vs | Not State | Unknown |
| Medication.status | Base | required | Medication Status Codes | 📍4.3.0 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Medication | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Medication | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Medication | 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()
|
| dom-5 | error | Medication | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Medication | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (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 Medication
Terminology Bindings (Differential)
| Path | Status | Usage | ValueSet | Version | Source |
| Medication.code | Base | preferred | http://nzmt.org.nz/vs | Not State | Unknown |
| Name | Flags | Card. | Type | Description & Constraints Filter:   | ||||
|---|---|---|---|---|---|---|---|---|
  Medication |
0..* | Medication | Definition of a Medication | |||||
  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 | ||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): IETF language tag
| |||||
| 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 Constraints: dom-r4b | |||||
  Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
   extension:nzmtType |
0..1 | CodeableConcept | The NZ Medicines Terminology (NZMT) Data Class – MP (Medicinal Product), MPUU (Medicinal Product Unit of Use), MPP (Medicinal Product Pack), TP (Trade Product), TPUU (Trade Product Unit of Use), TPP (Trade Product Pack) or CTPP (Containered Trade Product Pack) – that the Medication is a member of. URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-nzmt-type Binding: Nzmt type (required) | |||||
| extension:atc |
0..* | CodeableConcept | Anatomical Therapeutic Chemical (ATC) Classification URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-atc Binding: ATC codes (required) | |||||
| extension:link |
0..* | Reference(DocumentReference) | Links to other information about this medication URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-link | |||||
| extension:cal |
0..* | (Complex) | Cautionary and Advisory Label URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-cal | |||||
| extension:funding |
0..* | (Complex) | General Funding details URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-funding | |||||
| extension:fundingRule |
0..* | (Complex) | Funding constraints and requirements URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-funding-rule | |||||
| extension:description |
0..* | (Complex) | NZMT descriptions for the medicine URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-description | |||||
| extension:unapproved |
0..1 | boolean | Whether the medication can be used under section29 URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-unapproved | |||||
| extension:legalclass |
0..* | (Complex) | Legal classification of the medication URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-legalclass | |||||
| extension:medsafe |
0..1 | (Complex) | Medsafe details of the medication URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-medsafe | |||||
| extension:prescribebybrand |
0..1 | boolean | True if can be prescribed by brand URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-prescribe-by-brand | |||||
| extension:supplyinformation |
0..* | (Complex) | Supply information URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-supply-information | |||||
| extension:nzfpack |
0..1 | (Complex) | NZF Pack details URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-pack | |||||
 extension:relatedmedication |
0..* | (Complex) | Related medication URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-related-medication | |||||
 modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||
| identifier |
Σ | 0..* | Identifier | Business identifier for this medication | ||||
| code |
Σ | 0..1 | CodeableConcept | Codes that identify this medication Binding: http://nzmt.org.nz/vs (preferred) | ||||
| status |
?!Σ | 0..1 | code | active | inactive | entered-in-error Binding: Medication Status Codes (required): A coded concept defining if the medication is in active use. | ||||
| form |
0..1 | CodeableConcept | powder | tablets | capsule + Binding: SNOMEDCTFormCodes (example): A coded concept defining the form of a medication. | |||||
 ingredient |
0..* | BackboneElement | Active or inactive ingredient | |||||
 id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
 item[x] |
1..1 | The actual ingredient or content | ||||||
| itemCodeableConcept |
CodeableConcept | |||||||
  itemReference |
Reference(Substance | Medication) | |||||||
| isActive |
0..1 | boolean | Active ingredient indicator | |||||
| strength |
0..1 | Ratio | Quantity of ingredient present | |||||
| Documentation for this format | ||||||||
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| Medication.language | Base | preferred | Common Languages | 📍4.3.0 | FHIR Std. |
| Medication.code | Base | preferred | http://nzmt.org.nz/vs | Not State | Unknown |
| Medication.status | Base | required | Medication Status Codes | 📍4.3.0 | FHIR Std. |
| Medication.form | Base | example | SNOMED CT Form Codes | 📍4.3.0 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Medication | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Medication | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Medication | 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()
|
| dom-5 | error | Medication | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Medication | A resource should have narrative for robust management |
text.`div`.exists()
|
| dom-r4b | warning | Medication.contained | Containing new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems |
($this is Citation or $this is Evidence or $this is EvidenceReport or $this is EvidenceVariable or $this is MedicinalProductDefinition or $this is PackagedProductDefinition or $this is AdministrableProductDefinition or $this is Ingredient or $this is ClinicalUseDefinition or $this is RegulatedAuthorization or $this is SubstanceDefinition or $this is SubscriptionStatus or $this is SubscriptionTopic) implies (%resource is Citation or %resource is Evidence or %resource is EvidenceReport or %resource is EvidenceVariable or %resource is MedicinalProductDefinition or %resource is PackagedProductDefinition or %resource is AdministrableProductDefinition or %resource is Ingredient or %resource is ClinicalUseDefinition or %resource is RegulatedAuthorization or %resource is SubstanceDefinition or %resource is SubscriptionStatus or %resource is SubscriptionTopic)
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (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 Medication
Summary
Prohibited: 3 elements
Extensions
This structure refers to these extensions:
- http://hl7.org.nz/fhir/StructureDefinition/nzf-nzmt-type
- http://hl7.org.nz/fhir/StructureDefinition/nzf-atc
- http://hl7.org.nz/fhir/StructureDefinition/nzf-link
- http://hl7.org.nz/fhir/StructureDefinition/nzf-cal
- http://hl7.org.nz/fhir/StructureDefinition/nzf-funding
- http://hl7.org.nz/fhir/StructureDefinition/nzf-funding-rule
- http://hl7.org.nz/fhir/StructureDefinition/nzf-description
- http://hl7.org.nz/fhir/StructureDefinition/nzf-unapproved
- http://hl7.org.nz/fhir/StructureDefinition/nzf-legalclass
- http://hl7.org.nz/fhir/StructureDefinition/nzf-medsafe
- http://hl7.org.nz/fhir/StructureDefinition/nzf-prescribe-by-brand
- http://hl7.org.nz/fhir/StructureDefinition/nzf-supply-information
- http://hl7.org.nz/fhir/StructureDefinition/nzf-pack
- http://hl7.org.nz/fhir/StructureDefinition/nzf-related-medication
Key Elements View
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| Medication.code | Base | preferred | http://nzmt.org.nz/vs | Not State | Unknown |
| Medication.status | Base | required | Medication Status Codes | 📍4.3.0 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Medication | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Medication | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Medication | 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()
|
| dom-5 | error | Medication | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Medication | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (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 Medication
Terminology Bindings (Differential)
| Path | Status | Usage | ValueSet | Version | Source |
| Medication.code | Base | preferred | http://nzmt.org.nz/vs | Not State | Unknown |
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: | ||||
|---|---|---|---|---|---|---|---|---|
| Medication |
0..* | Medication | Definition of a Medication | |||||
| 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 | ||||
| language |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): IETF language tag
| |||||
| 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 Constraints: dom-r4b | |||||
| Slices for extension |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
| extension:nzmtType |
0..1 | CodeableConcept | The NZ Medicines Terminology (NZMT) Data Class – MP (Medicinal Product), MPUU (Medicinal Product Unit of Use), MPP (Medicinal Product Pack), TP (Trade Product), TPUU (Trade Product Unit of Use), TPP (Trade Product Pack) or CTPP (Containered Trade Product Pack) – that the Medication is a member of. URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-nzmt-type Binding: Nzmt type (required) | |||||
| extension:atc |
0..* | CodeableConcept | Anatomical Therapeutic Chemical (ATC) Classification URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-atc Binding: ATC codes (required) | |||||
| extension:link |
0..* | Reference(DocumentReference) | Links to other information about this medication URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-link | |||||
| extension:cal |
0..* | (Complex) | Cautionary and Advisory Label URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-cal | |||||
| extension:funding |
0..* | (Complex) | General Funding details URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-funding | |||||
| extension:fundingRule |
0..* | (Complex) | Funding constraints and requirements URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-funding-rule | |||||
| extension:description |
0..* | (Complex) | NZMT descriptions for the medicine URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-description | |||||
| extension:unapproved |
0..1 | boolean | Whether the medication can be used under section29 URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-unapproved | |||||
| extension:legalclass |
0..* | (Complex) | Legal classification of the medication URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-legalclass | |||||
| extension:medsafe |
0..1 | (Complex) | Medsafe details of the medication URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-medsafe | |||||
| extension:prescribebybrand |
0..1 | boolean | True if can be prescribed by brand URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-prescribe-by-brand | |||||
| extension:supplyinformation |
0..* | (Complex) | Supply information URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-supply-information | |||||
| extension:nzfpack |
0..1 | (Complex) | NZF Pack details URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-pack | |||||
| extension:relatedmedication |
0..* | (Complex) | Related medication URL: http://hl7.org.nz/fhir/StructureDefinition/nzf-related-medication | |||||
| modifierExtension |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||
| identifier |
Σ | 0..* | Identifier | Business identifier for this medication | ||||
| code |
Σ | 0..1 | CodeableConcept | Codes that identify this medication Binding: http://nzmt.org.nz/vs (preferred) | ||||
| status |
?!Σ | 0..1 | code | active | inactive | entered-in-error Binding: Medication Status Codes (required): A coded concept defining if the medication is in active use. | ||||
| form |
0..1 | CodeableConcept | powder | tablets | capsule + Binding: SNOMEDCTFormCodes (example): A coded concept defining the form of a medication. | |||||
| ingredient |
0..* | BackboneElement | Active or inactive ingredient | |||||
| id |
0..1 | string | Unique id for inter-element referencing | |||||
| extension |
0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
| item[x] |
1..1 | The actual ingredient or content | ||||||
| itemCodeableConcept |
CodeableConcept | |||||||
| itemReference |
Reference(Substance | Medication) | |||||||
| isActive |
0..1 | boolean | Active ingredient indicator | |||||
| strength |
0..1 | Ratio | Quantity of ingredient present | |||||
| Documentation for this format | ||||||||
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| Medication.language | Base | preferred | Common Languages | 📍4.3.0 | FHIR Std. |
| Medication.code | Base | preferred | http://nzmt.org.nz/vs | Not State | Unknown |
| Medication.status | Base | required | Medication Status Codes | 📍4.3.0 | FHIR Std. |
| Medication.form | Base | example | SNOMED CT Form Codes | 📍4.3.0 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | Medication | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | Medication | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | Medication | 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()
|
| dom-5 | error | Medication | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | Medication | A resource should have narrative for robust management |
text.`div`.exists()
|
| dom-r4b | warning | Medication.contained | Containing new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems |
($this is Citation or $this is Evidence or $this is EvidenceReport or $this is EvidenceVariable or $this is MedicinalProductDefinition or $this is PackagedProductDefinition or $this is AdministrableProductDefinition or $this is Ingredient or $this is ClinicalUseDefinition or $this is RegulatedAuthorization or $this is SubstanceDefinition or $this is SubscriptionStatus or $this is SubscriptionTopic) implies (%resource is Citation or %resource is Evidence or %resource is EvidenceReport or %resource is EvidenceVariable or %resource is MedicinalProductDefinition or %resource is PackagedProductDefinition or %resource is AdministrableProductDefinition or %resource is Ingredient or %resource is ClinicalUseDefinition or %resource is RegulatedAuthorization or %resource is SubstanceDefinition or %resource is SubscriptionStatus or %resource is SubscriptionTopic)
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (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 Medication
Summary
Prohibited: 3 elements
Extensions
This structure refers to these extensions:
- http://hl7.org.nz/fhir/StructureDefinition/nzf-nzmt-type
- http://hl7.org.nz/fhir/StructureDefinition/nzf-atc
- http://hl7.org.nz/fhir/StructureDefinition/nzf-link
- http://hl7.org.nz/fhir/StructureDefinition/nzf-cal
- http://hl7.org.nz/fhir/StructureDefinition/nzf-funding
- http://hl7.org.nz/fhir/StructureDefinition/nzf-funding-rule
- http://hl7.org.nz/fhir/StructureDefinition/nzf-description
- http://hl7.org.nz/fhir/StructureDefinition/nzf-unapproved
- http://hl7.org.nz/fhir/StructureDefinition/nzf-legalclass
- http://hl7.org.nz/fhir/StructureDefinition/nzf-medsafe
- http://hl7.org.nz/fhir/StructureDefinition/nzf-prescribe-by-brand
- http://hl7.org.nz/fhir/StructureDefinition/nzf-supply-information
- http://hl7.org.nz/fhir/StructureDefinition/nzf-pack
- http://hl7.org.nz/fhir/StructureDefinition/nzf-related-medication
Other representations of profile: CSV, Excel, Schematron