Australian Digital Health Agency FHIR Implementation Guide

This profile identifies the additional constraints, extensions, and value sets that build on and extend MedicationStatement that are supported.

This profile is designed to set a core MedicationStatement standard in the context of:

• Querying a patient's medications (current and historical)
• Recording or updating 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

This profile may be referred to by APIs, which will be listed here when available.

Profile specific guidance

• See the Medicine information section for guidance.
• MedicationStatement resources can represent a medication using either a code, or reference a Medication resource.
  • When referencing a Medication resource, it is preferred the resource is contained but it may be an external resource.

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

This structure is derived from AUBaseMedicationStatement

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement	C	0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context inv-dh-mst-01: If present, an information source shall at least have a reference, an identifier or a display
basedOn	S	0..*	Reference(ADHA Core MedicationRequest | CarePlan | ADHA Core 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	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:pbs	S	0..*	Coding	Code defined by a terminology system
coding:amt	S	0..*	Coding	Code defined by a terminology system
medication[x]:medicationReference		0..1	Reference(ADHA Core Medication)	Medication Reference
subject	SC	1..1	Reference(ADHA Core Patient)	Who is/was taking the medication inv-dh-mst-02: At least reference or a valid identifier shall be present
context	S	0..1	Reference(ADHA 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	SC	0..1	Reference(ADHA Core Patient | ADHA Core PractitionerRole | ADHA Core 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 inv-dh-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
inv-dh-mst-01	error	MedicationStatement	If present, an information source shall at least have a reference, an identifier or a display : informationSource.exists() implies informationSource.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())
inv-dh-mst-02	error	MedicationStatement.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-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	C	0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources dom-3: 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 dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated dom-5: If a resource is contained in another resource, it SHALL NOT have a security label dom-6: A resource should have narrative for robust management inv-dh-mst-01: If present, an information source shall at least have a reference, an identifier or a display
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created ele-1: All FHIR elements must have a @value or children
Slices for extension				Content/Rules for all slices
longTerm		0..1	boolean	Medication Long Term Indicator URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
basedOn	SΣ	0..*	Reference(ADHA Core MedicationRequest | CarePlan | ADHA Core ServiceRequest)	Fulfils plan, proposal or order ele-1: All FHIR elements must have a @value or children
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. ele-1: All FHIR elements must have a @value or children
statusReason	S	0..*	CodeableConcept	Reason for current status Binding: SNOMEDCTDrugTherapyStatusCodes (example): A coded concept indicating the reason for the status of the statement. ele-1: All FHIR elements must have a @value or children
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. ele-1: All FHIR elements must have a @value or children
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. ele-1: All FHIR elements must have a @value or children
medicationCodeableConcept			CodeableConcept
medicationReference			Reference(Medication)
medication[x]:medicationCodeableConcept	Σ	0..1	CodeableConcept	Coded Medication Binding: SNOMEDCTMedicationCodes (example) Additional Bindings Purpose Australian Medication Preferred PBS Item Codes Preferred MIMS Preferred GTIN Preferred ele-1: All FHIR elements must have a @value or children
Slices for coding	Σ	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system ele-1: All FHIR elements must have a @value or children
coding:All Slices				Content/Rules for all slices
Slices for extension				Content/Rules for all slices
medicationClass		0..1	Coding	Medication type URL: http://hl7.org.au/fhir/StructureDefinition/medication-type Binding: Medication Type (required) ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
coding:pbs	SΣ	0..*	Coding	Code defined by a terminology system ele-1: All FHIR elements must have a @value or children
Slices for extension				Content/Rules for all slices
medicationClass		0..1	Coding	Medication type URL: http://hl7.org.au/fhir/StructureDefinition/medication-type Binding: Medication Type (required) ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
coding:amt	SΣ	0..*	Coding	Code defined by a terminology system ele-1: All FHIR elements must have a @value or children
Slices for extension				Content/Rules for all slices
medicationClass		0..1	Coding	Medication type URL: http://hl7.org.au/fhir/StructureDefinition/medication-type Binding: Medication Type (required) ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
medication[x]:medicationReference	Σ	0..1	Reference(ADHA Core Medication)	Medication Reference ele-1: All FHIR elements must have a @value or children
subject	SΣC	1..1	Reference(ADHA Core Patient)	Who is/was taking the medication ele-1: All FHIR elements must have a @value or children inv-dh-mst-02: At least reference or a valid identifier shall be present
context	SΣ	0..1	Reference(ADHA Core Encounter)	Encounter / Episode associated with MedicationStatement ele-1: All FHIR elements must have a @value or children
effective[x]	SΣ	0..1		The date/time or interval when the medication is/was/will be taken ele-1: All FHIR elements must have a @value or children
effectiveDateTime			dateTime
effectivePeriod			Period
dateAsserted	SΣ	0..1	dateTime	When the statement was asserted? ele-1: All FHIR elements must have a @value or children
informationSource	SC	0..1	Reference(ADHA Core Patient | ADHA Core PractitionerRole | ADHA Core RelatedPerson)	Person or organization that provided the information about the taking of this medication ele-1: All FHIR elements must have a @value or children
reasonCode	S	0..*	CodeableConcept	Reason for why the medication is being/was taken Binding: Medication Reason Taken (preferred) ele-1: All FHIR elements must have a @value or children
note	S	0..*	Annotation	Further information about the statement ele-1: All FHIR elements must have a @value or children
dosage	SC	0..*	AUBaseDosage	Dosage information in an Australian healthcare context ele-1: All FHIR elements must have a @value or children inv-dh-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.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
inv-dh-mst-01	error	MedicationStatement	If present, an information source shall at least have a reference, an identifier or a display : informationSource.exists() implies informationSource.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())
inv-dh-mst-02	error	MedicationStatement.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-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	C	0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context inv-dh-mst-01: If present, an information source shall at least have a reference, an identifier or a display
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(ADHA Core MedicationRequest | CarePlan | ADHA Core 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) Additional Bindings Purpose Australian Medication Preferred PBS Item Codes Preferred MIMS Preferred 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
Slices for coding	Σ	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:All Slices				Content/Rules for all slices
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	Σ	0..1	uri	Identity of the terminology system
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:pbs	SΣ	0..*	Coding	Code defined by a terminology system
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	Σ	0..1	uri	Identity of the terminology system
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	Code defined by a terminology system
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	Σ	0..1	uri	Identity of the terminology system
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(ADHA Core Medication)	Medication Reference
subject	SΣC	1..1	Reference(ADHA Core Patient)	Who is/was taking the medication inv-dh-mst-02: At least reference or a valid identifier shall be present
context	SΣ	0..1	Reference(ADHA 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	SC	0..1	Reference(ADHA Core Patient | ADHA Core PractitionerRole | ADHA Core 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 inv-dh-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 http://hl7.org/fhir/ValueSet/languages from the FHIR Standard Additional Bindings Purpose AllLanguages Max Binding
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.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
inv-dh-mst-01	error	MedicationStatement	If present, an information source shall at least have a reference, an identifier or a display : informationSource.exists() implies informationSource.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())
inv-dh-mst-02	error	MedicationStatement.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()

Differential View

This structure is derived from AUBaseMedicationStatement

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement	C	0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context inv-dh-mst-01: If present, an information source shall at least have a reference, an identifier or a display
basedOn	S	0..*	Reference(ADHA Core MedicationRequest | CarePlan | ADHA Core 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	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:pbs	S	0..*	Coding	Code defined by a terminology system
coding:amt	S	0..*	Coding	Code defined by a terminology system
medication[x]:medicationReference		0..1	Reference(ADHA Core Medication)	Medication Reference
subject	SC	1..1	Reference(ADHA Core Patient)	Who is/was taking the medication inv-dh-mst-02: At least reference or a valid identifier shall be present
context	S	0..1	Reference(ADHA 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	SC	0..1	Reference(ADHA Core Patient | ADHA Core PractitionerRole | ADHA Core 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 inv-dh-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
inv-dh-mst-01	error	MedicationStatement	If present, an information source shall at least have a reference, an identifier or a display : informationSource.exists() implies informationSource.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())
inv-dh-mst-02	error	MedicationStatement.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-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	C	0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources dom-3: 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 dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated dom-5: If a resource is contained in another resource, it SHALL NOT have a security label dom-6: A resource should have narrative for robust management inv-dh-mst-01: If present, an information source shall at least have a reference, an identifier or a display
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created ele-1: All FHIR elements must have a @value or children
Slices for extension				Content/Rules for all slices
longTerm		0..1	boolean	Medication Long Term Indicator URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
basedOn	SΣ	0..*	Reference(ADHA Core MedicationRequest | CarePlan | ADHA Core ServiceRequest)	Fulfils plan, proposal or order ele-1: All FHIR elements must have a @value or children
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. ele-1: All FHIR elements must have a @value or children
statusReason	S	0..*	CodeableConcept	Reason for current status Binding: SNOMEDCTDrugTherapyStatusCodes (example): A coded concept indicating the reason for the status of the statement. ele-1: All FHIR elements must have a @value or children
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. ele-1: All FHIR elements must have a @value or children
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. ele-1: All FHIR elements must have a @value or children
medicationCodeableConcept			CodeableConcept
medicationReference			Reference(Medication)
medication[x]:medicationCodeableConcept	Σ	0..1	CodeableConcept	Coded Medication Binding: SNOMEDCTMedicationCodes (example) Additional Bindings Purpose Australian Medication Preferred PBS Item Codes Preferred MIMS Preferred GTIN Preferred ele-1: All FHIR elements must have a @value or children
Slices for coding	Σ	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system ele-1: All FHIR elements must have a @value or children
coding:All Slices				Content/Rules for all slices
Slices for extension				Content/Rules for all slices
medicationClass		0..1	Coding	Medication type URL: http://hl7.org.au/fhir/StructureDefinition/medication-type Binding: Medication Type (required) ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
coding:pbs	SΣ	0..*	Coding	Code defined by a terminology system ele-1: All FHIR elements must have a @value or children
Slices for extension				Content/Rules for all slices
medicationClass		0..1	Coding	Medication type URL: http://hl7.org.au/fhir/StructureDefinition/medication-type Binding: Medication Type (required) ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
coding:amt	SΣ	0..*	Coding	Code defined by a terminology system ele-1: All FHIR elements must have a @value or children
Slices for extension				Content/Rules for all slices
medicationClass		0..1	Coding	Medication type URL: http://hl7.org.au/fhir/StructureDefinition/medication-type Binding: Medication Type (required) ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
medication[x]:medicationReference	Σ	0..1	Reference(ADHA Core Medication)	Medication Reference ele-1: All FHIR elements must have a @value or children
subject	SΣC	1..1	Reference(ADHA Core Patient)	Who is/was taking the medication ele-1: All FHIR elements must have a @value or children inv-dh-mst-02: At least reference or a valid identifier shall be present
context	SΣ	0..1	Reference(ADHA Core Encounter)	Encounter / Episode associated with MedicationStatement ele-1: All FHIR elements must have a @value or children
effective[x]	SΣ	0..1		The date/time or interval when the medication is/was/will be taken ele-1: All FHIR elements must have a @value or children
effectiveDateTime			dateTime
effectivePeriod			Period
dateAsserted	SΣ	0..1	dateTime	When the statement was asserted? ele-1: All FHIR elements must have a @value or children
informationSource	SC	0..1	Reference(ADHA Core Patient | ADHA Core PractitionerRole | ADHA Core RelatedPerson)	Person or organization that provided the information about the taking of this medication ele-1: All FHIR elements must have a @value or children
reasonCode	S	0..*	CodeableConcept	Reason for why the medication is being/was taken Binding: Medication Reason Taken (preferred) ele-1: All FHIR elements must have a @value or children
note	S	0..*	Annotation	Further information about the statement ele-1: All FHIR elements must have a @value or children
dosage	SC	0..*	AUBaseDosage	Dosage information in an Australian healthcare context ele-1: All FHIR elements must have a @value or children inv-dh-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.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
inv-dh-mst-01	error	MedicationStatement	If present, an information source shall at least have a reference, an identifier or a display : informationSource.exists() implies informationSource.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())
inv-dh-mst-02	error	MedicationStatement.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
MedicationStatement	C	0..*	AUBaseMedicationStatement	A record of medication being taken by a patient in an Australian healthcare context inv-dh-mst-01: If present, an information source shall at least have a reference, an identifier or a display
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(ADHA Core MedicationRequest | CarePlan | ADHA Core 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) Additional Bindings Purpose Australian Medication Preferred PBS Item Codes Preferred MIMS Preferred 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
Slices for coding	Σ	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:All Slices				Content/Rules for all slices
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	Σ	0..1	uri	Identity of the terminology system
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:pbs	SΣ	0..*	Coding	Code defined by a terminology system
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	Σ	0..1	uri	Identity of the terminology system
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	Code defined by a terminology system
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	Σ	0..1	uri	Identity of the terminology system
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(ADHA Core Medication)	Medication Reference
subject	SΣC	1..1	Reference(ADHA Core Patient)	Who is/was taking the medication inv-dh-mst-02: At least reference or a valid identifier shall be present
context	SΣ	0..1	Reference(ADHA 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	SC	0..1	Reference(ADHA Core Patient | ADHA Core PractitionerRole | ADHA Core 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 inv-dh-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 http://hl7.org/fhir/ValueSet/languages from the FHIR Standard Additional Bindings Purpose AllLanguages Max Binding
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.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
inv-dh-mst-01	error	MedicationStatement	If present, an information source shall at least have a reference, an identifier or a display : informationSource.exists() implies informationSource.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())
inv-dh-mst-02	error	MedicationStatement.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mst-03	error	MedicationStatement.dosage	If present, the dosage shall at least have text or patient instructions : text.exists() or patientInstruction.exists()

This structure is derived from AUBaseMedicationStatement

Summary

Must-Support: 15 elements

Structures

This structure refers to these other structures:

• ADHA Core MedicationRequest (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-medicationrequest-core-1)
• ADHA Core ServiceRequest (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-servicerequest-core-1)
• ADHA Core Medication (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-medication-core-1)
• ADHA Core Patient (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-patient-core-1)
• ADHA Core Encounter (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-encounter-core-1)
• ADHA Core PractitionerRole (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-practitionerrole-core-1)
• ADHA Core RelatedPerson (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-relatedperson-core-1)

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the value of MedicationStatement.medication[x] (Closed)
• The element 1 is sliced based on the value of MedicationStatement.medication[x].coding

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

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

1. SHALL support searching for all medication usage statements for a patient using the combination of the subject:identifier:
   • including support for OR search on intent (e.g.intent={system|}[code],{system|}[code],...)

   GET [base]/MedicationStatement?subject:identifier={system|}[code]&intent=order,plan

   Example:

    GET [base]/MedicationStatement?subject:identifier=http://ns.electronichealth.net.au/id/hi/ihi/1.0|8003608000228437
   

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

2. SHALL support searching using the combination of the subject:identifier and status search parameters:
   • including support for OR search on status (e.g.status={system|}[code],{system|}[code],...)

   GET [base]/MedicationStatement?subject:identifier={system|}[code]&intent=order,plan&status={system|}[code]{,{system|}[code],...}

   Example:

    GET [base]/MedicationStatement?subject:identifier=http://ns.electronichealth.net.au/id/hi/ihi/1.0|8003608000228437&status=active
   

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

3. SHALL support searching using the combination of the subject:identifier and effective search parameters:
   • including support for OR search on intent (e.g.intent={system|}[code],{system|}[code],...)

   GET [base]/MedicationStatement?subject:identifier={system|}[code]&effective=[date]

   Example:

    GET [base]/MedicationStatement?subject:identifier=http://ns.electronichealth.net.au/id/hi/ihi/1.0|8003608000228437&effective=ge2013-03-14
   

   Implementation Notes: Fetches a bundle of all MedicationStatement resources for the specified patient that have a date greater than or equal to 21st Jan 2013. (how to search by :identifier and how to search by date)