AU Core Medication - AU Core Implementation Guide v0.3.0-ballot

AU Core Implementation Guide
0.3.0-ballot - R1 Australia flag

This page is part of the AU Core (v0.3.0-ballot: AU Core R1 Ballot 5) based on FHIR (HL7® FHIR® Standard) R4. . For a full list of available versions, see the Directory of published versions

Resource Profile: AU Core Medication

Official URL: http://hl7.org.au/fhir/core/StructureDefinition/au-core-medication		Version: 0.3.0-ballot
Standards status: Draft	Maturity Level: 0	Computable Name: AUMedication
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License. HL7 Australia© 2022+; Licensed Under Creative Commons No Rights Reserved.

This profile sets minimum expectations for a Medication resource to record, search, and fetch medications associated with a patient. It is based on the AU Base Medication profile and identifies the additional mandatory core elements, extensions, vocabularies and value sets that SHALL be present in the Medication when conforming to this profile. It provides the floor for standards development for specific uses cases in an Australian context.

In AU Core a Medication resource is used within the context of a referencing resource: MedicationAdministration, MedicationDispense, MedicationRequest, or MedicationStatement resource.

Usage scenarios

The following are supported usage scenarios for this profile:

Query medications associated with a patient referenced by another resource
Record or update a medication associated with a patient referenced by another resource
Read medications associated with a patient referenced by another resource

Comparison with other national and international specifications

A resource conforming to this profile is conformant to:

IPA-Medication
and MAY be conformant to
- Medication (IPS) if Data Type Profile: Quantity (IPS) constraints are met
- US Core Medication noting that US Core extensibly binds to RxNorm which is not an AU medicines terminology

Conformance in reverse is not guaranteed, i.e. a resource conforming to International Patient Access, International Patient Summary, or US Core MAY NOT conform to AU Core.

Profile specific implementation guidance

See the Medicine information section for guidance on constructing a resource and the use of medicines terminology
Manufacturer information will commonly be exchanged as a PBS code, this information can be represented as an external resource of by using Medication.manufacturer.identifier to carry the PBS code and Medication.manufacturer.display to carry the name of the manufacturer

Usage:

Refer to this Resource Profile: AU Core Medication, AU Core MedicationRequest and AU Core MedicationStatement
Examples for this Resource Profile: Medication/1active-ingredient, Medication/2active-ingredients and Medication/simvastatin

Formal Views of Profile Content

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

This structure is derived from AUBaseMedication

Name	Flags	Card.	Type	Description & Constraints
Medication		0..*	AUBaseMedication	A medication in an Australian healthcare context
code	S	1..1	CodeableConcept	Coding for the medicine
Slices for coding		0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:pbs	S	0..*	Coding	PBS Item Code
coding:amt	S	0..*	Coding	AMT Medicines
manufacturer	SC	0..1	Reference(AU Core Organization)	Physical product manufacturer organisation
form	S	0..1	CodeableConcept	powder \| tablets \| capsule +
amount	S	0..1	Ratio	Amount of drug in package
ingredient	S	0..*	BackboneElement	Active or inactive ingredient
item[x]	S	1..1		The actual ingredient or content
itemCodeableConcept			CodeableConcept
itemReference			Reference(Substance \| AU Core Medication)
isActive	S	0..1	boolean	Active ingredient indicator
strength	S	0..1	Ratio	Quantity/strength of ingredient present
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints
Medication		0..*	AUBaseMedication	A medication in an Australian healthcare context
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
code	SΣ	1..1	CodeableConcept	Coding for the medicine Binding: SNOMEDCTMedicationCodes (example): A coded concept that defines the type of a medication.
Slices for coding	Σ	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:pbs	SΣ	0..*	Coding	PBS Item Code Binding: PBS Item Codes (preferred)
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://pbs.gov.au/code/item
coding:gtin	Σ	0..*	Coding	Medication Package Global Trade Item Number (GTIN) Binding: GTIN (preferred)
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://www.gs1.org/gtin
coding:amt	SΣ	0..*	Coding	AMT Medicines Binding: Australian Medication (preferred)
medicationClass		0..1	Coding	Medication type URL: http://hl7.org.au/fhir/StructureDefinition/medication-type Binding: Medication Type (required)
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://snomed.info/sct
coding:mimsPackage	Σ	0..1	Coding	MIMS Package Binding: MIMS (preferred)
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://www.mims.com.au/codes
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.
manufacturer	SΣC	0..1	Reference(AU Core Organization)	Physical product manufacturer organisation
form	S	0..1	CodeableConcept	powder \| tablets \| capsule + Binding: Medication Form (preferred)
amount	SΣ	0..1	Ratio	Amount of drug in package
ingredient	S	0..*	BackboneElement	Active or inactive ingredient
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
item[x]	S	1..1		The actual ingredient or content Binding: AMT Medicinal Product and Substances (preferred)
itemCodeableConcept			CodeableConcept
itemReference			Reference(Substance \| AU Core Medication)
isActive	S	0..1	boolean	Active ingredient indicator
strength	S	0..1	Ratio	Quantity/strength of ingredient present
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Medication.code	example	SNOMEDCTMedicationCodes `http://hl7.org/fhir/ValueSet/medication-codes` from the FHIR Standard
Medication.code.coding:pbs	preferred	PBSItemCodes `http://terminology.hl7.org.au/ValueSet/pbs-item`
Medication.code.coding:gtin	preferred	GTIN `http://terminology.hl7.org/ValueSet/v3-GTIN`
Medication.code.coding:amt	preferred	AustralianMedication `https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1` from https://tx.ontoserver.csiro.au/fhir
Medication.code.coding:mimsPackage	preferred	MIMS `http://terminology.hl7.org.au/ValueSet/mims`
Medication.status	required	Medication Status Codes `http://hl7.org/fhir/ValueSet/medication-status\|4.0.1` from the FHIR Standard
Medication.form	preferred	MedicationForm `https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1` from https://tx.ontoserver.csiro.au/fhir
Medication.ingredient.item[x]	preferred	AMTMedicinalProductAndSubstances `http://terminology.hl7.org.au/ValueSet/amt-mp-codes`

Constraints

Id	Grade	Path(s)	Details	Requirements
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 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(canonical) = '#').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()

Description & Constraints

Medication

0..*

AUBaseMedication

A medication in an Australian healthcare context

id

Σ

0..1

id

Logical id of this artifact

Terminology Bindings

Path Conformance ValueSet URI

Medication.language

preferred

CommonLanguages

Additional Bindings

Purpose

AllLanguages

Max Binding

http://hl7.org/fhir/ValueSet/languages

from the FHIR Standard

Medication.code

example

SNOMEDCTMedicationCodes

http://hl7.org/fhir/ValueSet/medication-codes

from the FHIR Standard

Medication.code.coding:pbs

preferred

PBSItemCodes

http://terminology.hl7.org.au/ValueSet/pbs-item

Medication.code.coding:gtin

preferred

GTIN

http://terminology.hl7.org/ValueSet/v3-GTIN

Medication.code.coding:amt

preferred

AustralianMedication

https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1

from https://tx.ontoserver.csiro.au/fhir

Medication.code.coding:mimsPackage

preferred

MIMS

http://terminology.hl7.org.au/ValueSet/mims

Medication.status

required

Medication Status Codes

http://hl7.org/fhir/ValueSet/medication-status|4.0.1

from the FHIR Standard

Medication.form

preferred

MedicationForm

https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1

from https://tx.ontoserver.csiro.au/fhir

Medication.ingredient.item[x]

preferred

AMTMedicinalProductAndSubstances

http://terminology.hl7.org.au/ValueSet/amt-mp-codes

Constraints

Id	Grade	Path(s)	Details	Requirements
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 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(canonical) = '#').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 AUBaseMedication

Summary

Mandatory: 1 element
Must-Support: 10 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

The element Medication.code.coding is sliced based on the value of value:system

Maturity: 0

Differential View

This structure is derived from AUBaseMedication

Name	Flags	Card.	Type	Description & Constraints
Medication		0..*	AUBaseMedication	A medication in an Australian healthcare context
code	S	1..1	CodeableConcept	Coding for the medicine
Slices for coding		0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:pbs	S	0..*	Coding	PBS Item Code
coding:amt	S	0..*	Coding	AMT Medicines
manufacturer	SC	0..1	Reference(AU Core Organization)	Physical product manufacturer organisation
form	S	0..1	CodeableConcept	powder \| tablets \| capsule +
amount	S	0..1	Ratio	Amount of drug in package
ingredient	S	0..*	BackboneElement	Active or inactive ingredient
item[x]	S	1..1		The actual ingredient or content
itemCodeableConcept			CodeableConcept
itemReference			Reference(Substance \| AU Core Medication)
isActive	S	0..1	boolean	Active ingredient indicator
strength	S	0..1	Ratio	Quantity/strength of ingredient present
Documentation for this format

Key Elements View

Name	Flags	Card.	Type	Description & Constraints
Medication		0..*	AUBaseMedication	A medication in an Australian healthcare context
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
code	SΣ	1..1	CodeableConcept	Coding for the medicine Binding: SNOMEDCTMedicationCodes (example): A coded concept that defines the type of a medication.
Slices for coding	Σ	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:pbs	SΣ	0..*	Coding	PBS Item Code Binding: PBS Item Codes (preferred)
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://pbs.gov.au/code/item
coding:gtin	Σ	0..*	Coding	Medication Package Global Trade Item Number (GTIN) Binding: GTIN (preferred)
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://www.gs1.org/gtin
coding:amt	SΣ	0..*	Coding	AMT Medicines Binding: Australian Medication (preferred)
medicationClass		0..1	Coding	Medication type URL: http://hl7.org.au/fhir/StructureDefinition/medication-type Binding: Medication Type (required)
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://snomed.info/sct
coding:mimsPackage	Σ	0..1	Coding	MIMS Package Binding: MIMS (preferred)
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://www.mims.com.au/codes
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.
manufacturer	SΣC	0..1	Reference(AU Core Organization)	Physical product manufacturer organisation
form	S	0..1	CodeableConcept	powder \| tablets \| capsule + Binding: Medication Form (preferred)
amount	SΣ	0..1	Ratio	Amount of drug in package
ingredient	S	0..*	BackboneElement	Active or inactive ingredient
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
item[x]	S	1..1		The actual ingredient or content Binding: AMT Medicinal Product and Substances (preferred)
itemCodeableConcept			CodeableConcept
itemReference			Reference(Substance \| AU Core Medication)
isActive	S	0..1	boolean	Active ingredient indicator
strength	S	0..1	Ratio	Quantity/strength of ingredient present
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Medication.code	example	SNOMEDCTMedicationCodes `http://hl7.org/fhir/ValueSet/medication-codes` from the FHIR Standard
Medication.code.coding:pbs	preferred	PBSItemCodes `http://terminology.hl7.org.au/ValueSet/pbs-item`
Medication.code.coding:gtin	preferred	GTIN `http://terminology.hl7.org/ValueSet/v3-GTIN`
Medication.code.coding:amt	preferred	AustralianMedication `https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1` from https://tx.ontoserver.csiro.au/fhir
Medication.code.coding:mimsPackage	preferred	MIMS `http://terminology.hl7.org.au/ValueSet/mims`
Medication.status	required	Medication Status Codes `http://hl7.org/fhir/ValueSet/medication-status\|4.0.1` from the FHIR Standard
Medication.form	preferred	MedicationForm `https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1` from https://tx.ontoserver.csiro.au/fhir
Medication.ingredient.item[x]	preferred	AMTMedicinalProductAndSubstances `http://terminology.hl7.org.au/ValueSet/amt-mp-codes`

Constraints

Id	Grade	Path(s)	Details	Requirements
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 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(canonical) = '#').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()

Snapshot View

Description & Constraints

Medication

0..*

AUBaseMedication

A medication in an Australian healthcare context

id

Σ

0..1

id

Logical id of this artifact

Terminology Bindings

Path Conformance ValueSet URI

Medication.language

preferred

CommonLanguages

Additional Bindings

Purpose

AllLanguages

Max Binding

http://hl7.org/fhir/ValueSet/languages

from the FHIR Standard

Medication.code

example

SNOMEDCTMedicationCodes

http://hl7.org/fhir/ValueSet/medication-codes

from the FHIR Standard

Medication.code.coding:pbs

preferred

PBSItemCodes

http://terminology.hl7.org.au/ValueSet/pbs-item

Medication.code.coding:gtin

preferred

GTIN

http://terminology.hl7.org/ValueSet/v3-GTIN

Medication.code.coding:amt

preferred

AustralianMedication

https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1

from https://tx.ontoserver.csiro.au/fhir

Medication.code.coding:mimsPackage

preferred

MIMS

http://terminology.hl7.org.au/ValueSet/mims

Medication.status

required

Medication Status Codes

http://hl7.org/fhir/ValueSet/medication-status|4.0.1

from the FHIR Standard

Medication.form

preferred

MedicationForm

https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1

from https://tx.ontoserver.csiro.au/fhir

Medication.ingredient.item[x]

preferred

AMTMedicinalProductAndSubstances

http://terminology.hl7.org.au/ValueSet/amt-mp-codes

Constraints

Id	Grade	Path(s)	Details	Requirements
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 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(canonical) = '#').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 AUBaseMedication

Summary

Mandatory: 1 element
Must-Support: 10 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

The element Medication.code.coding is sliced based on the value of value:system

Maturity: 0

Other representations of profile: CSV, Excel, Schematron

Notes:

Below is an overview of the mandatory and optional search parameters. FHIR search operations and the syntax used to describe the interactions is described here.

Mandatory Search Parameters

No mandatory search parameters for this profile.

Optional Search Parameters

No optional search parameters for this profile.

IG © 2022+ HL7 Australia. Package hl7.fhir.au.core#0.3.0-ballot based on FHIR 4.0.1. Generated 2024-03-10
Links: Table of Contents | QA Report | Version History | | Propose a change