Usage scenarios

The following are supported usage scenarios for this profile:

• Query for a patient’s medication usage (current and historical)
• Record or update a record of a medication the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future

Comparison with other national and international specifications

A resource conforming to this profile is conformant to:

• IPA-MedicationStatement
• and MAY be conformant to Medication Statement (IPS) if MedicationStatement.effective[x] is included and patient is supported as MedicationStatement.subject.reference

No equivalent US Core profile.

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

Profile specific implementation guidance

• See the Medicine information section for guidance
• MedicationStatement resources can represent a medication using either a code with MedicationStatement.medicationCodeableConcept, or reference a Medication resource with MedicationStatement.medicationReference.
  • Although both are marked as must support, servers are not required to support both a code and a reference, but they SHALL support at least one of these elements
  • A client application SHALL support both elements
  • When referencing a Medication resource, it is preferred the resource is contained but it may be an external resource
• MedicationStatement resources may record medication use that is derived from other records such as a MedicationRequest or MedicationDispense. In this case source system identifiers SHOULD be included as AU Local Prescription Identifier, AU ETP Prescription Identifier, or AU Local Dispense Identifier to support deduplication across medication resources.
  • See guidance on the construction of an identifier on the relevant Identifier profile page and the section on Business Identifiers in AU Base.

• Differential Table
• Key Elements Table
• Snapshot Table
• Statistics/References
• All

This structure is derived from AUBaseMedicationStatement

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement		0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context
basedOn	S	0..*	Reference(AU Core MedicationRequest | CarePlan | ServiceRequest)	Fulfils plan, proposal or order
status	S	1..1	code	active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
statusReason	S	0..*	CodeableConcept	Reason for current status
category	S	0..1	CodeableConcept	Type of medication usage
Slices for medication[x]	S	1..1	CodeableConcept, Reference(Medication)	Medication Detail Slice: Unordered, Closed by type:$this
medication[x]:medicationCodeableConcept		0..1	CodeableConcept	Coded Medication
Slices for coding		0..*	Coding	Medication Codes Slice: Unordered, Open by value:system
coding:pbs	S	0..*	Coding	PBS Item Code
coding:amt	S	0..*	Coding	AMT Medicines
medication[x]:medicationReference		0..1	Reference(AU Core Medication)	Medication Reference
subject	S	1..1	Reference(AU Core Patient)	Who is/was taking the medication
context	S	0..1	Reference(AU Core Encounter)	Encounter / Episode associated with MedicationStatement
effective[x]	S	0..1	dateTime, Period	The date/time or interval when the medication is/was/will be taken
dateAsserted	S	0..1	dateTime	When the statement was asserted?
informationSource	S	0..1	Reference(AU Core Patient | AU Core Practitioner | AU Core PractitionerRole | RelatedPerson)	Person or organization that provided the information about the taking of this medication
reasonCode	S	0..*	CodeableConcept	Reason for why the medication is being/was taken
note	S	0..*	Annotation	Further information about the statement
dosage	SC	0..*	AUBaseDosage	Dosage information in an Australian healthcare context au-core-mst-03: If present, the dosage shall at least have text or patient instructions
Documentation for this format

Constraints

Id	Grade	Path(s)	Details	Requirements
au-core-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement		0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
longTerm		0..1	boolean	Medication Long Term Indicator URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
basedOn	SΣ	0..*	Reference(AU Core MedicationRequest | CarePlan | ServiceRequest)	Fulfils plan, proposal or order
status	?!SΣ	1..1	code	active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): A coded concept indicating the current status of a MedicationStatement.
statusReason	S	0..*	CodeableConcept	Reason for current status Binding: SNOMEDCTDrugTherapyStatusCodes (example): A coded concept indicating the reason for the status of the statement.
category	SΣ	0..1	CodeableConcept	Type of medication usage Binding: Medication usage category codes (preferred): A coded concept identifying where the medication included in the MedicationStatement is expected to be consumed or administered.
Slices for medication[x]	SΣ	1..1		Medication Detail Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
medicationCodeableConcept			CodeableConcept
medicationReference			Reference(Medication)
medication[x]:medicationCodeableConcept	Σ	0..1	CodeableConcept	Coded Medication Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
Slices for coding	Σ	0..*	Coding	Medication Codes 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
medication[x]:medicationReference	Σ	0..1	Reference(AU Core Medication)	Medication Reference
subject	SΣ	1..1	Reference(AU Core Patient)	Who is/was taking the medication
context	SΣ	0..1	Reference(AU Core Encounter)	Encounter / Episode associated with MedicationStatement
effective[x]	SΣ	0..1		The date/time or interval when the medication is/was/will be taken
effectiveDateTime			dateTime
effectivePeriod			Period
dateAsserted	SΣ	0..1	dateTime	When the statement was asserted?
informationSource	S	0..1	Reference(AU Core Patient | AU Core Practitioner | AU Core PractitionerRole | RelatedPerson)	Person or organization that provided the information about the taking of this medication
reasonCode	S	0..*	CodeableConcept	Reason for why the medication is being/was taken Binding: Medication Reason Taken (preferred)
note	S	0..*	Annotation	Further information about the statement
dosage	SC	0..*	AUBaseDosage	Dosage information in an Australian healthcare context au-core-mst-03: If present, the dosage shall at least have text or patient instructions
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
MedicationStatement.status	required	Medication Status Codes http://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard
MedicationStatement.statusReason	example	SNOMEDCTDrugTherapyStatusCodes http://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard
MedicationStatement.category	preferred	Medication usage category codes http://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard
MedicationStatement.medication[x]	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationStatement.medication[x]:medicationCodeableConcept	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationStatement.medication[x]:medicationCodeableConcept.coding:pbs	preferred	PBSItemCodes http://terminology.hl7.org.au/ValueSet/pbs-item
MedicationStatement.medication[x]:medicationCodeableConcept.coding:gtin	preferred	GTIN http://terminology.hl7.org/ValueSet/v3-GTIN
MedicationStatement.medication[x]:medicationCodeableConcept.coding:amt	preferred	AustralianMedication https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 from https://tx.ontoserver.csiro.au/fhir
MedicationStatement.medication[x]:medicationCodeableConcept.coding:mimsPackage	preferred	MIMS http://terminology.hl7.org.au/ValueSet/mims
MedicationStatement.reasonCode	preferred	MedicationReasonTaken https://healthterminologies.gov.au/fhir/ValueSet/medication-reason-taken-1 from https://tx.ontoserver.csiro.au/fhir

Constraints

Id	Grade	Path(s)	Details	Requirements
au-core-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()
dom-2	error	MedicationStatement	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	MedicationStatement	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	MedicationStatement	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	MedicationStatement	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	MedicationStatement	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()

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement		0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context
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): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
longTerm		0..1	boolean	Medication Long Term Indicator URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	Σ	0..*	Identifier	External identifier
basedOn	SΣ	0..*	Reference(AU Core MedicationRequest | CarePlan | ServiceRequest)	Fulfils plan, proposal or order
partOf	Σ	0..*	Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Observation)	Part of referenced event
status	?!SΣ	1..1	code	active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): A coded concept indicating the current status of a MedicationStatement.
statusReason	S	0..*	CodeableConcept	Reason for current status Binding: SNOMEDCTDrugTherapyStatusCodes (example): A coded concept indicating the reason for the status of the statement.
category	SΣ	0..1	CodeableConcept	Type of medication usage Binding: Medication usage category codes (preferred): A coded concept identifying where the medication included in the MedicationStatement is expected to be consumed or administered.
Slices for medication[x]	SΣ	1..1		Medication Detail Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
medicationCodeableConcept			CodeableConcept
medicationReference			Reference(Medication)
medication[x]:medicationCodeableConcept	Σ	0..1	CodeableConcept	Coded Medication Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
Slices for coding	Σ	0..*	Coding	Medication Codes Slice: Unordered, Open by value:system
coding:pbs	SΣ	0..*	Coding	PBS Item Code Binding: PBS Item Codes (preferred)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://pbs.gov.au/code/item
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
coding:gtin	Σ	0..*	Coding	Medication Package Global Trade Item Number (GTIN) Binding: GTIN (preferred)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://www.gs1.org/gtin
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
coding:amt	SΣ	0..*	Coding	AMT Medicines Binding: Australian Medication (preferred)
id		0..1	string	Unique id for inter-element referencing
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
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
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
coding:mimsPackage	Σ	0..1	Coding	MIMS Package Binding: MIMS (preferred)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://www.mims.com.au/codes
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	0..1	code	Symbol in syntax defined by the system
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	Medication primary text
medication[x]:medicationReference	Σ	0..1	Reference(AU Core Medication)	Medication Reference
subject	SΣ	1..1	Reference(AU Core Patient)	Who is/was taking the medication
context	SΣ	0..1	Reference(AU Core Encounter)	Encounter / Episode associated with MedicationStatement
effective[x]	SΣ	0..1		The date/time or interval when the medication is/was/will be taken
effectiveDateTime			dateTime
effectivePeriod			Period
dateAsserted	SΣ	0..1	dateTime	When the statement was asserted?
informationSource	S	0..1	Reference(AU Core Patient | AU Core Practitioner | AU Core PractitionerRole | RelatedPerson)	Person or organization that provided the information about the taking of this medication
derivedFrom		0..*	Reference(Resource)	Additional supporting information
reasonCode	S	0..*	CodeableConcept	Reason for why the medication is being/was taken Binding: Medication Reason Taken (preferred)
reasonReference		0..*	Reference(Condition | Observation | DiagnosticReport)	Condition or observation that supports why the medication is being/was taken
note	S	0..*	Annotation	Further information about the statement
dosage	SC	0..*	AUBaseDosage	Dosage information in an Australian healthcare context au-core-mst-03: If present, the dosage shall at least have text or patient instructions
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
MedicationStatement.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
MedicationStatement.status	required	Medication Status Codes http://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard
MedicationStatement.statusReason	example	SNOMEDCTDrugTherapyStatusCodes http://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard
MedicationStatement.category	preferred	Medication usage category codes http://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard
MedicationStatement.medication[x]	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationStatement.medication[x]:medicationCodeableConcept	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationStatement.medication[x]:medicationCodeableConcept.coding:pbs	preferred	PBSItemCodes http://terminology.hl7.org.au/ValueSet/pbs-item
MedicationStatement.medication[x]:medicationCodeableConcept.coding:gtin	preferred	GTIN http://terminology.hl7.org/ValueSet/v3-GTIN
MedicationStatement.medication[x]:medicationCodeableConcept.coding:amt	preferred	AustralianMedication https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 from https://tx.ontoserver.csiro.au/fhir
MedicationStatement.medication[x]:medicationCodeableConcept.coding:mimsPackage	preferred	MIMS http://terminology.hl7.org.au/ValueSet/mims
MedicationStatement.reasonCode	preferred	MedicationReasonTaken https://healthterminologies.gov.au/fhir/ValueSet/medication-reason-taken-1 from https://tx.ontoserver.csiro.au/fhir

Constraints

Id	Grade	Path(s)	Details	Requirements
au-core-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()
dom-2	error	MedicationStatement	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	MedicationStatement	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	MedicationStatement	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	MedicationStatement	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	MedicationStatement	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 AUBaseMedicationStatement

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement		0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context
basedOn	S	0..*	Reference(AU Core MedicationRequest | CarePlan | ServiceRequest)	Fulfils plan, proposal or order
status	S	1..1	code	active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
statusReason	S	0..*	CodeableConcept	Reason for current status
category	S	0..1	CodeableConcept	Type of medication usage
Slices for medication[x]	S	1..1	CodeableConcept, Reference(Medication)	Medication Detail Slice: Unordered, Closed by type:$this
medication[x]:medicationCodeableConcept		0..1	CodeableConcept	Coded Medication
Slices for coding		0..*	Coding	Medication Codes Slice: Unordered, Open by value:system
coding:pbs	S	0..*	Coding	PBS Item Code
coding:amt	S	0..*	Coding	AMT Medicines
medication[x]:medicationReference		0..1	Reference(AU Core Medication)	Medication Reference
subject	S	1..1	Reference(AU Core Patient)	Who is/was taking the medication
context	S	0..1	Reference(AU Core Encounter)	Encounter / Episode associated with MedicationStatement
effective[x]	S	0..1	dateTime, Period	The date/time or interval when the medication is/was/will be taken
dateAsserted	S	0..1	dateTime	When the statement was asserted?
informationSource	S	0..1	Reference(AU Core Patient | AU Core Practitioner | AU Core PractitionerRole | RelatedPerson)	Person or organization that provided the information about the taking of this medication
reasonCode	S	0..*	CodeableConcept	Reason for why the medication is being/was taken
note	S	0..*	Annotation	Further information about the statement
dosage	SC	0..*	AUBaseDosage	Dosage information in an Australian healthcare context au-core-mst-03: If present, the dosage shall at least have text or patient instructions
Documentation for this format

Constraints

Id	Grade	Path(s)	Details	Requirements
au-core-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()

Key Elements View

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement		0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
longTerm		0..1	boolean	Medication Long Term Indicator URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
basedOn	SΣ	0..*	Reference(AU Core MedicationRequest | CarePlan | ServiceRequest)	Fulfils plan, proposal or order
status	?!SΣ	1..1	code	active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): A coded concept indicating the current status of a MedicationStatement.
statusReason	S	0..*	CodeableConcept	Reason for current status Binding: SNOMEDCTDrugTherapyStatusCodes (example): A coded concept indicating the reason for the status of the statement.
category	SΣ	0..1	CodeableConcept	Type of medication usage Binding: Medication usage category codes (preferred): A coded concept identifying where the medication included in the MedicationStatement is expected to be consumed or administered.
Slices for medication[x]	SΣ	1..1		Medication Detail Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
medicationCodeableConcept			CodeableConcept
medicationReference			Reference(Medication)
medication[x]:medicationCodeableConcept	Σ	0..1	CodeableConcept	Coded Medication Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
Slices for coding	Σ	0..*	Coding	Medication Codes 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
medication[x]:medicationReference	Σ	0..1	Reference(AU Core Medication)	Medication Reference
subject	SΣ	1..1	Reference(AU Core Patient)	Who is/was taking the medication
context	SΣ	0..1	Reference(AU Core Encounter)	Encounter / Episode associated with MedicationStatement
effective[x]	SΣ	0..1		The date/time or interval when the medication is/was/will be taken
effectiveDateTime			dateTime
effectivePeriod			Period
dateAsserted	SΣ	0..1	dateTime	When the statement was asserted?
informationSource	S	0..1	Reference(AU Core Patient | AU Core Practitioner | AU Core PractitionerRole | RelatedPerson)	Person or organization that provided the information about the taking of this medication
reasonCode	S	0..*	CodeableConcept	Reason for why the medication is being/was taken Binding: Medication Reason Taken (preferred)
note	S	0..*	Annotation	Further information about the statement
dosage	SC	0..*	AUBaseDosage	Dosage information in an Australian healthcare context au-core-mst-03: If present, the dosage shall at least have text or patient instructions
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
MedicationStatement.status	required	Medication Status Codes http://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard
MedicationStatement.statusReason	example	SNOMEDCTDrugTherapyStatusCodes http://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard
MedicationStatement.category	preferred	Medication usage category codes http://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard
MedicationStatement.medication[x]	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationStatement.medication[x]:medicationCodeableConcept	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationStatement.medication[x]:medicationCodeableConcept.coding:pbs	preferred	PBSItemCodes http://terminology.hl7.org.au/ValueSet/pbs-item
MedicationStatement.medication[x]:medicationCodeableConcept.coding:gtin	preferred	GTIN http://terminology.hl7.org/ValueSet/v3-GTIN
MedicationStatement.medication[x]:medicationCodeableConcept.coding:amt	preferred	AustralianMedication https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 from https://tx.ontoserver.csiro.au/fhir
MedicationStatement.medication[x]:medicationCodeableConcept.coding:mimsPackage	preferred	MIMS http://terminology.hl7.org.au/ValueSet/mims
MedicationStatement.reasonCode	preferred	MedicationReasonTaken https://healthterminologies.gov.au/fhir/ValueSet/medication-reason-taken-1 from https://tx.ontoserver.csiro.au/fhir

Constraints

Id	Grade	Path(s)	Details	Requirements
au-core-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()
dom-2	error	MedicationStatement	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	MedicationStatement	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	MedicationStatement	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	MedicationStatement	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	MedicationStatement	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

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement		0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context
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): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
longTerm		0..1	boolean	Medication Long Term Indicator URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	Σ	0..*	Identifier	External identifier
basedOn	SΣ	0..*	Reference(AU Core MedicationRequest | CarePlan | ServiceRequest)	Fulfils plan, proposal or order
partOf	Σ	0..*	Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Observation)	Part of referenced event
status	?!SΣ	1..1	code	active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): A coded concept indicating the current status of a MedicationStatement.
statusReason	S	0..*	CodeableConcept	Reason for current status Binding: SNOMEDCTDrugTherapyStatusCodes (example): A coded concept indicating the reason for the status of the statement.
category	SΣ	0..1	CodeableConcept	Type of medication usage Binding: Medication usage category codes (preferred): A coded concept identifying where the medication included in the MedicationStatement is expected to be consumed or administered.
Slices for medication[x]	SΣ	1..1		Medication Detail Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
medicationCodeableConcept			CodeableConcept
medicationReference			Reference(Medication)
medication[x]:medicationCodeableConcept	Σ	0..1	CodeableConcept	Coded Medication Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
Slices for coding	Σ	0..*	Coding	Medication Codes Slice: Unordered, Open by value:system
coding:pbs	SΣ	0..*	Coding	PBS Item Code Binding: PBS Item Codes (preferred)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://pbs.gov.au/code/item
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
coding:gtin	Σ	0..*	Coding	Medication Package Global Trade Item Number (GTIN) Binding: GTIN (preferred)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://www.gs1.org/gtin
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
coding:amt	SΣ	0..*	Coding	AMT Medicines Binding: Australian Medication (preferred)
id		0..1	string	Unique id for inter-element referencing
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
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
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	0..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
coding:mimsPackage	Σ	0..1	Coding	MIMS Package Binding: MIMS (preferred)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://www.mims.com.au/codes
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	0..1	code	Symbol in syntax defined by the system
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	Medication primary text
medication[x]:medicationReference	Σ	0..1	Reference(AU Core Medication)	Medication Reference
subject	SΣ	1..1	Reference(AU Core Patient)	Who is/was taking the medication
context	SΣ	0..1	Reference(AU Core Encounter)	Encounter / Episode associated with MedicationStatement
effective[x]	SΣ	0..1		The date/time or interval when the medication is/was/will be taken
effectiveDateTime			dateTime
effectivePeriod			Period
dateAsserted	SΣ	0..1	dateTime	When the statement was asserted?
informationSource	S	0..1	Reference(AU Core Patient | AU Core Practitioner | AU Core PractitionerRole | RelatedPerson)	Person or organization that provided the information about the taking of this medication
derivedFrom		0..*	Reference(Resource)	Additional supporting information
reasonCode	S	0..*	CodeableConcept	Reason for why the medication is being/was taken Binding: Medication Reason Taken (preferred)
reasonReference		0..*	Reference(Condition | Observation | DiagnosticReport)	Condition or observation that supports why the medication is being/was taken
note	S	0..*	Annotation	Further information about the statement
dosage	SC	0..*	AUBaseDosage	Dosage information in an Australian healthcare context au-core-mst-03: If present, the dosage shall at least have text or patient instructions
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
MedicationStatement.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
MedicationStatement.status	required	Medication Status Codes http://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard
MedicationStatement.statusReason	example	SNOMEDCTDrugTherapyStatusCodes http://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard
MedicationStatement.category	preferred	Medication usage category codes http://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard
MedicationStatement.medication[x]	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationStatement.medication[x]:medicationCodeableConcept	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationStatement.medication[x]:medicationCodeableConcept.coding:pbs	preferred	PBSItemCodes http://terminology.hl7.org.au/ValueSet/pbs-item
MedicationStatement.medication[x]:medicationCodeableConcept.coding:gtin	preferred	GTIN http://terminology.hl7.org/ValueSet/v3-GTIN
MedicationStatement.medication[x]:medicationCodeableConcept.coding:amt	preferred	AustralianMedication https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 from https://tx.ontoserver.csiro.au/fhir
MedicationStatement.medication[x]:medicationCodeableConcept.coding:mimsPackage	preferred	MIMS http://terminology.hl7.org.au/ValueSet/mims
MedicationStatement.reasonCode	preferred	MedicationReasonTaken https://healthterminologies.gov.au/fhir/ValueSet/medication-reason-taken-1 from https://tx.ontoserver.csiro.au/fhir

Constraints

Id	Grade	Path(s)	Details	Requirements
au-core-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()
dom-2	error	MedicationStatement	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	MedicationStatement	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	MedicationStatement	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	MedicationStatement	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	MedicationStatement	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 AUBaseMedicationStatement

Summary

Must-Support: 15 elements

Structures

This structure refers to these other structures:

• AU Core MedicationRequest (http://hl7.org.au/fhir/core/StructureDefinition/au-core-medicationrequest)
• AU Core Medication (http://hl7.org.au/fhir/core/StructureDefinition/au-core-medication)
• AU Core Patient (http://hl7.org.au/fhir/core/StructureDefinition/au-core-patient)
• AU Core Encounter (http://hl7.org.au/fhir/core/StructureDefinition/au-core-encounter)
• AU Core Practitioner (http://hl7.org.au/fhir/core/StructureDefinition/au-core-practitioner)
• AU Core PractitionerRole (http://hl7.org.au/fhir/core/StructureDefinition/au-core-practitionerrole)

Slices

This structure defines the following Slices:

• The element MedicationStatement.medication[x] is sliced based on the value of type:$this (Closed)
• The element MedicationStatement.medication[x].coding is sliced based on the value of value:system

Maturity: 0

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

Any search parameter defined in FHIR may be ‘allowed’ by the system unless explicitly marked as “SHALL NOT”. A few items are marked as MAY in this implementation guide to highlight their potential relevance.

Mandatory Search Parameters

The following search parameters and search parameter combinations SHALL be supported:

1. SHALL support searching using the patient search parameter:
   • SHOULD support these _include parameters: MedicationStatement:medication
   • SHALL support these _revinclude parameters: Provenance:target
   • SHOULD support chained searching of patient canonical identifier patient.identifier (e.g. patient.identifier=[system|][code])

   GET [base]/MedicationStatement?patient={Type/}[id] or optionallyGET [base]/MedicationStatement?patient.identifier=[system|][code]

   Example:

   1. GET [base]/MedicationStatement?patient=5678
   2. GET [base]/MedicationStatement?patient=5678&_include=MedicationStatement:medication
   3. GET [base]/MedicationStatement?patient.identifier=http://ns.electronichealth.net.au/id/medicare-number|32788511952
   4. GET [base]/MedicationStatement?patient.identifier=http://ns.electronichealth.net.au/id/hi/ihi/1.0|8003608833357361

   Implementation Notes: Fetches a bundle of all MedicationStatement resources for the specified patient (how to search by reference and how to search by token)

2. SHALL support searching using the combination of the patient and status search parameters:
   • SHOULD support these _include parameters: MedicationStatement:medication
   • SHOULD support chained searching of patient canonical identifier patient.identifier (e.g. patient.identifier=[system|][code])
   • SHALL support multipleOr search on status (e.g.status={system|}[code],{system|}[code],...)

   GET [base]/MedicationStatement?patient={Type/}[id]&status={system|}[code]{,{system|}[code],...}

   Example:

   1. GET [base]/MedicationStatement?patient=5678&status=active
   2. GET [base]/MedicationStatement?patient=5678&status=active&_include=MedicationStatement:medication

   Implementation Notes: Fetches a bundle of all MedicationStatement resources for the specified patient and status (how to search by reference and how to search by token)

Optional Search Parameters

The following search parameters and search parameter combinations SHOULD be supported:

1. SHOULD support searching using the combination of the patient and effective search parameters:
   • SHOULD support these _include parameters: MedicationStatement:medication
   • SHOULD support chained searching of patient canonical identifier patient.identifier (e.g. patient.identifier=[system|][code])
   • SHALL support these effective comparators: gt,lt,ge,le
   • SHOULD support multipleAnd search on effective (e.g.effective=[date]&effective=[date]]&...)

   GET [base]/MedicationStatement?patient={Type/}[id]&effective={gt|lt|ge|le}[date]{&effective={gt|lt|ge|le}[date]&...}

   Example:

   1. GET [base]/MedicationStatement?patient=5678&effective=ge2020-01-01T00:00:00Z
   2. GET [base]/MedicationStatement?patient.identifier=http://example.org/fhir/mrn|12345&effective=ge2020-01-01T00:00:00Z
   3. GET [base]/MedicationStatement?patient.identifier=http://example.org/fhir/mrn|12345&effective=ge2020-01-01T00:00:00Z&_include=MedicationStatement:medication

   Implementation Notes: Fetches a bundle of all MedicationStatement resources for the specified patient and date (how to search by reference and how to search by date)