Australian Digital Health Agency FHIR Implementation Guide

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

This profile is designed to set a core MedicationAdministration standard for:

• Query medications administered for a patient (current and historical)
• Record or update a medication administration record for a patient

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.
• MedicationAdministration 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 AUBaseMedicationAdministration

Name	Flags	Card.	Type	Description & Constraints
MedicationAdministration		0..*	AUBaseMedicationAdministration	A record of medication administered to a patient in an Australian healthcare context
status	S	1..1	code	in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown
statusReason	S	0..*	CodeableConcept	Reason administration not performed
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	Medication Codes
coding:amt	S	0..*	Coding	Medication Codes
medication[x]:medicationReference		0..1	Reference(ADHA Core Medication)	Medication Reference
subject	SC	1..1	Reference(ADHA Core Patient)	Who received medication inv-dh-mad-01: At least reference or a valid identifier shall be present
context	S	0..1	Reference(ADHA Core Encounter)	Encounter or Episode of Care administered as part of
effective[x]	S	1..1	dateTime, Period	Start and end time of administration
performer	SC	0..*	BackboneElement	Who performed the medication administration and what they did inv-dh-mad-02: If present, an actor shall at least have a reference, an identifier or a display
function	S	0..1	CodeableConcept	Type of performance
actor	SC	1..1	Reference(ADHA Authoring PractitionerRole | ADHA Authoring RelatedPerson | ADHA Core Patient)	Who performed the medication administration
reasonCode	S	0..*	CodeableConcept	Reason administration performed
reasonReference	S	0..*	Reference(Condition | Observation | DiagnosticReport)	Condition or observation that supports why the medication was administered
note	S	0..*	Annotation	Information about the administration
dosage	S	0..1	BackboneElement	Details of how medication was taken
text	S	0..1	string	Free text dosage instructions e.g. SIG
site	S	0..1	CodeableConcept	Body site administered to
route	S	0..1	CodeableConcept	Path of substance into body
method	S	0..1	CodeableConcept	How drug was administered
dose	S	0..1	SimpleQuantity	Amount of medication per dose
rate[x]	S	0..1	Ratio, SimpleQuantity	Dose quantity per unit of time
Documentation for this format

Constraints

Id	Grade	Path(s)	Details	Requirements
inv-dh-mad-01	error	MedicationAdministration.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mad-02	error	MedicationAdministration.performer	If present, an actor shall at least have a reference, an identifier or a display : actor.exists() implies actor.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())

Name	Flags	Card.	Type	Description & Constraints
MedicationAdministration		0..*	AUBaseMedicationAdministration	A record of medication administered to 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
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
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
status	?!SΣ	1..1	code	in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown Binding: MedicationAdministration Status Codes (required): A set of codes indicating the current status of a MedicationAdministration. ele-1: All FHIR elements must have a @value or children
statusReason	S	0..*	CodeableConcept	Reason administration not performed Binding: SNOMEDCTReasonMedicationNotGivenCodes (example): A set of codes indicating the reason why the MedicationAdministration is negated. ele-1: All FHIR elements must have a @value or children
category	S	0..1	CodeableConcept	Type of medication usage Binding: MedicationAdministration Category Codes (preferred): A coded concept describing where the medication administered is expected to occur. 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): Codes identifying substance or product that can be administered. 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	Medication Codes Slice: Unordered, Open by value:system ele-1: All FHIR elements must have a @value or children
coding:pbs	SΣ	0..*	Coding	Medication Codes ele-1: All FHIR elements must have a @value or children
coding:amt	SΣ	0..*	Coding	Medication Codes 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 received medication ele-1: All FHIR elements must have a @value or children inv-dh-mad-01: At least reference or a valid identifier shall be present
context	S	0..1	Reference(ADHA Core Encounter)	Encounter or Episode of Care administered as part of ele-1: All FHIR elements must have a @value or children
effective[x]	SΣ	1..1		Start and end time of administration ele-1: All FHIR elements must have a @value or children
effectiveDateTime			dateTime
effectivePeriod			Period
performer	SΣC	0..*	BackboneElement	Who performed the medication administration and what they did ele-1: All FHIR elements must have a @value or children inv-dh-mad-02: If present, an actor shall at least have a reference, an identifier or a display
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
function	S	0..1	CodeableConcept	Type of performance Binding: MedicationAdministration Performer Function Codes (example): A code describing the role an individual played in administering the medication. ele-1: All FHIR elements must have a @value or children
actor	SΣC	1..1	Reference(ADHA Authoring PractitionerRole | ADHA Authoring RelatedPerson | ADHA Core Patient)	Who performed the medication administration ele-1: All FHIR elements must have a @value or children
reasonCode	S	0..*	CodeableConcept	Reason administration performed Binding: ReasonMedicationGivenCodes (example): A set of codes indicating the reason why the MedicationAdministration was made. ele-1: All FHIR elements must have a @value or children
reasonReference	S	0..*	Reference(Condition | Observation | DiagnosticReport)	Condition or observation that supports why the medication was administered ele-1: All FHIR elements must have a @value or children
note	S	0..*	Annotation	Information about the administration ele-1: All FHIR elements must have a @value or children
dosage	SC	0..1	BackboneElement	Details of how medication was taken ele-1: All FHIR elements must have a @value or children mad-1: SHALL have at least one of dosage.dose or dosage.rate[x]
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
text	S	0..1	string	Free text dosage instructions e.g. SIG ele-1: All FHIR elements must have a @value or children
site	S	0..1	CodeableConcept	Body site administered to Binding: Body Site (preferred) ele-1: All FHIR elements must have a @value or children
route	S	0..1	CodeableConcept	Path of substance into body Binding: Route of Administration (preferred) ele-1: All FHIR elements must have a @value or children
method	S	0..1	CodeableConcept	How drug was administered Binding: SNOMEDCTAdministrationMethodCodes (preferred) ele-1: All FHIR elements must have a @value or children
dose	S	0..1	SimpleQuantity	Amount of medication per dose ele-1: All FHIR elements must have a @value or children
rate[x]	S	0..1		Dose quantity per unit of time ele-1: All FHIR elements must have a @value or children
rateRatio			Ratio
rateQuantity			Quantity(SimpleQuantity)
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
MedicationAdministration.status	required	MedicationAdministration Status Codes http://hl7.org/fhir/ValueSet/medication-admin-status|4.0.1 from the FHIR Standard
MedicationAdministration.statusReason	example	SNOMEDCTReasonMedicationNotGivenCodes http://hl7.org/fhir/ValueSet/reason-medication-not-given-codes from the FHIR Standard
MedicationAdministration.category	preferred	MedicationAdministration Category Codes http://hl7.org/fhir/ValueSet/medication-admin-category from the FHIR Standard
MedicationAdministration.medication[x]	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationAdministration.medication[x]:medicationCodeableConcept	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationAdministration.performer.function	example	MedicationAdministration Performer Function Codes http://hl7.org/fhir/ValueSet/med-admin-perform-function from the FHIR Standard
MedicationAdministration.reasonCode	example	ReasonMedicationGivenCodes http://hl7.org/fhir/ValueSet/reason-medication-given-codes from the FHIR Standard
MedicationAdministration.dosage.site	preferred	BodySite https://healthterminologies.gov.au/fhir/ValueSet/body-site-1 from https://tx.ontoserver.csiro.au/fhir
MedicationAdministration.dosage.route	preferred	RouteOfAdministration https://healthterminologies.gov.au/fhir/ValueSet/route-of-administration-1 from https://tx.ontoserver.csiro.au/fhir
MedicationAdministration.dosage.method	preferred	SNOMEDCTAdministrationMethodCodes http://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
inv-dh-mad-01	error	MedicationAdministration.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mad-02	error	MedicationAdministration.performer	If present, an actor shall at least have a reference, an identifier or a display : actor.exists() implies actor.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())

Name	Flags	Card.	Type	Description & Constraints
MedicationAdministration		0..*	AUBaseMedicationAdministration	A record of medication administered to 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
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	External identifier
instantiates	Σ	0..*	uri	Instantiates protocol or definition
partOf	Σ	0..*	Reference(MedicationAdministration | Procedure)	Part of referenced event
status	?!SΣ	1..1	code	in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown Binding: MedicationAdministration Status Codes (required): A set of codes indicating the current status of a MedicationAdministration.
statusReason	S	0..*	CodeableConcept	Reason administration not performed Binding: SNOMEDCTReasonMedicationNotGivenCodes (example): A set of codes indicating the reason why the MedicationAdministration is negated.
category	S	0..1	CodeableConcept	Type of medication usage Binding: MedicationAdministration Category Codes (preferred): A coded concept describing where the medication administered is expected to occur.
Slices for medication[x]	SΣ	1..1		Medication Detail Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): Codes identifying substance or product that can be administered.
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	Medication Codes Slice: Unordered, Open by value:system
coding:pbs	SΣ	0..*	Coding	Medication Codes
coding:amt	SΣ	0..*	Coding	Medication Codes
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 received medication inv-dh-mad-01: At least reference or a valid identifier shall be present
context	S	0..1	Reference(ADHA Core Encounter)	Encounter or Episode of Care administered as part of
supportingInformation		0..*	Reference(Resource)	Additional information to support administration
effective[x]	SΣ	1..1		Start and end time of administration
effectiveDateTime			dateTime
effectivePeriod			Period
performer	SΣC	0..*	BackboneElement	Who performed the medication administration and what they did inv-dh-mad-02: If present, an actor shall at least have a reference, an identifier or a display
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
function	S	0..1	CodeableConcept	Type of performance Binding: MedicationAdministration Performer Function Codes (example): A code describing the role an individual played in administering the medication.
actor	SΣC	1..1	Reference(ADHA Authoring PractitionerRole | ADHA Authoring RelatedPerson | ADHA Core Patient)	Who performed the medication administration
reasonCode	S	0..*	CodeableConcept	Reason administration performed Binding: ReasonMedicationGivenCodes (example): A set of codes indicating the reason why the MedicationAdministration was made.
reasonReference	S	0..*	Reference(Condition | Observation | DiagnosticReport)	Condition or observation that supports why the medication was administered
request		0..1	Reference(MedicationRequest)	Request administration performed against
device		0..*	Reference(Device)	Device used to administer
note	S	0..*	Annotation	Information about the administration
dosage	SC	0..1	BackboneElement	Details of how medication was taken mad-1: SHALL have at least one of dosage.dose or dosage.rate[x]
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
text	S	0..1	string	Free text dosage instructions e.g. SIG
site	S	0..1	CodeableConcept	Body site administered to Binding: Body Site (preferred)
route	S	0..1	CodeableConcept	Path of substance into body Binding: Route of Administration (preferred)
method	S	0..1	CodeableConcept	How drug was administered Binding: SNOMEDCTAdministrationMethodCodes (preferred)
dose	S	0..1	SimpleQuantity	Amount of medication per dose
rate[x]	S	0..1		Dose quantity per unit of time
rateRatio			Ratio
rateQuantity			Quantity(SimpleQuantity)
eventHistory		0..*	Reference(Provenance)	A list of events of interest in the lifecycle
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
MedicationAdministration.language	preferred	CommonLanguages http://hl7.org/fhir/ValueSet/languages from the FHIR Standard Additional Bindings Purpose AllLanguages Max Binding
MedicationAdministration.status	required	MedicationAdministration Status Codes http://hl7.org/fhir/ValueSet/medication-admin-status|4.0.1 from the FHIR Standard
MedicationAdministration.statusReason	example	SNOMEDCTReasonMedicationNotGivenCodes http://hl7.org/fhir/ValueSet/reason-medication-not-given-codes from the FHIR Standard
MedicationAdministration.category	preferred	MedicationAdministration Category Codes http://hl7.org/fhir/ValueSet/medication-admin-category from the FHIR Standard
MedicationAdministration.medication[x]	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationAdministration.medication[x]:medicationCodeableConcept	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationAdministration.performer.function	example	MedicationAdministration Performer Function Codes http://hl7.org/fhir/ValueSet/med-admin-perform-function from the FHIR Standard
MedicationAdministration.reasonCode	example	ReasonMedicationGivenCodes http://hl7.org/fhir/ValueSet/reason-medication-given-codes from the FHIR Standard
MedicationAdministration.dosage.site	preferred	BodySite https://healthterminologies.gov.au/fhir/ValueSet/body-site-1 from https://tx.ontoserver.csiro.au/fhir
MedicationAdministration.dosage.route	preferred	RouteOfAdministration https://healthterminologies.gov.au/fhir/ValueSet/route-of-administration-1 from https://tx.ontoserver.csiro.au/fhir
MedicationAdministration.dosage.method	preferred	SNOMEDCTAdministrationMethodCodes http://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
inv-dh-mad-01	error	MedicationAdministration.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mad-02	error	MedicationAdministration.performer	If present, an actor shall at least have a reference, an identifier or a display : actor.exists() implies actor.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())

Differential View

This structure is derived from AUBaseMedicationAdministration

Name	Flags	Card.	Type	Description & Constraints
MedicationAdministration		0..*	AUBaseMedicationAdministration	A record of medication administered to a patient in an Australian healthcare context
status	S	1..1	code	in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown
statusReason	S	0..*	CodeableConcept	Reason administration not performed
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	Medication Codes
coding:amt	S	0..*	Coding	Medication Codes
medication[x]:medicationReference		0..1	Reference(ADHA Core Medication)	Medication Reference
subject	SC	1..1	Reference(ADHA Core Patient)	Who received medication inv-dh-mad-01: At least reference or a valid identifier shall be present
context	S	0..1	Reference(ADHA Core Encounter)	Encounter or Episode of Care administered as part of
effective[x]	S	1..1	dateTime, Period	Start and end time of administration
performer	SC	0..*	BackboneElement	Who performed the medication administration and what they did inv-dh-mad-02: If present, an actor shall at least have a reference, an identifier or a display
function	S	0..1	CodeableConcept	Type of performance
actor	SC	1..1	Reference(ADHA Authoring PractitionerRole | ADHA Authoring RelatedPerson | ADHA Core Patient)	Who performed the medication administration
reasonCode	S	0..*	CodeableConcept	Reason administration performed
reasonReference	S	0..*	Reference(Condition | Observation | DiagnosticReport)	Condition or observation that supports why the medication was administered
note	S	0..*	Annotation	Information about the administration
dosage	S	0..1	BackboneElement	Details of how medication was taken
text	S	0..1	string	Free text dosage instructions e.g. SIG
site	S	0..1	CodeableConcept	Body site administered to
route	S	0..1	CodeableConcept	Path of substance into body
method	S	0..1	CodeableConcept	How drug was administered
dose	S	0..1	SimpleQuantity	Amount of medication per dose
rate[x]	S	0..1	Ratio, SimpleQuantity	Dose quantity per unit of time
Documentation for this format

Constraints

Id	Grade	Path(s)	Details	Requirements
inv-dh-mad-01	error	MedicationAdministration.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mad-02	error	MedicationAdministration.performer	If present, an actor shall at least have a reference, an identifier or a display : actor.exists() implies actor.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())

Key Elements View

Name	Flags	Card.	Type	Description & Constraints
MedicationAdministration		0..*	AUBaseMedicationAdministration	A record of medication administered to 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
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
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
status	?!SΣ	1..1	code	in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown Binding: MedicationAdministration Status Codes (required): A set of codes indicating the current status of a MedicationAdministration. ele-1: All FHIR elements must have a @value or children
statusReason	S	0..*	CodeableConcept	Reason administration not performed Binding: SNOMEDCTReasonMedicationNotGivenCodes (example): A set of codes indicating the reason why the MedicationAdministration is negated. ele-1: All FHIR elements must have a @value or children
category	S	0..1	CodeableConcept	Type of medication usage Binding: MedicationAdministration Category Codes (preferred): A coded concept describing where the medication administered is expected to occur. 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): Codes identifying substance or product that can be administered. 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	Medication Codes Slice: Unordered, Open by value:system ele-1: All FHIR elements must have a @value or children
coding:pbs	SΣ	0..*	Coding	Medication Codes ele-1: All FHIR elements must have a @value or children
coding:amt	SΣ	0..*	Coding	Medication Codes 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 received medication ele-1: All FHIR elements must have a @value or children inv-dh-mad-01: At least reference or a valid identifier shall be present
context	S	0..1	Reference(ADHA Core Encounter)	Encounter or Episode of Care administered as part of ele-1: All FHIR elements must have a @value or children
effective[x]	SΣ	1..1		Start and end time of administration ele-1: All FHIR elements must have a @value or children
effectiveDateTime			dateTime
effectivePeriod			Period
performer	SΣC	0..*	BackboneElement	Who performed the medication administration and what they did ele-1: All FHIR elements must have a @value or children inv-dh-mad-02: If present, an actor shall at least have a reference, an identifier or a display
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
function	S	0..1	CodeableConcept	Type of performance Binding: MedicationAdministration Performer Function Codes (example): A code describing the role an individual played in administering the medication. ele-1: All FHIR elements must have a @value or children
actor	SΣC	1..1	Reference(ADHA Authoring PractitionerRole | ADHA Authoring RelatedPerson | ADHA Core Patient)	Who performed the medication administration ele-1: All FHIR elements must have a @value or children
reasonCode	S	0..*	CodeableConcept	Reason administration performed Binding: ReasonMedicationGivenCodes (example): A set of codes indicating the reason why the MedicationAdministration was made. ele-1: All FHIR elements must have a @value or children
reasonReference	S	0..*	Reference(Condition | Observation | DiagnosticReport)	Condition or observation that supports why the medication was administered ele-1: All FHIR elements must have a @value or children
note	S	0..*	Annotation	Information about the administration ele-1: All FHIR elements must have a @value or children
dosage	SC	0..1	BackboneElement	Details of how medication was taken ele-1: All FHIR elements must have a @value or children mad-1: SHALL have at least one of dosage.dose or dosage.rate[x]
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
text	S	0..1	string	Free text dosage instructions e.g. SIG ele-1: All FHIR elements must have a @value or children
site	S	0..1	CodeableConcept	Body site administered to Binding: Body Site (preferred) ele-1: All FHIR elements must have a @value or children
route	S	0..1	CodeableConcept	Path of substance into body Binding: Route of Administration (preferred) ele-1: All FHIR elements must have a @value or children
method	S	0..1	CodeableConcept	How drug was administered Binding: SNOMEDCTAdministrationMethodCodes (preferred) ele-1: All FHIR elements must have a @value or children
dose	S	0..1	SimpleQuantity	Amount of medication per dose ele-1: All FHIR elements must have a @value or children
rate[x]	S	0..1		Dose quantity per unit of time ele-1: All FHIR elements must have a @value or children
rateRatio			Ratio
rateQuantity			Quantity(SimpleQuantity)
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
MedicationAdministration.status	required	MedicationAdministration Status Codes http://hl7.org/fhir/ValueSet/medication-admin-status|4.0.1 from the FHIR Standard
MedicationAdministration.statusReason	example	SNOMEDCTReasonMedicationNotGivenCodes http://hl7.org/fhir/ValueSet/reason-medication-not-given-codes from the FHIR Standard
MedicationAdministration.category	preferred	MedicationAdministration Category Codes http://hl7.org/fhir/ValueSet/medication-admin-category from the FHIR Standard
MedicationAdministration.medication[x]	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationAdministration.medication[x]:medicationCodeableConcept	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationAdministration.performer.function	example	MedicationAdministration Performer Function Codes http://hl7.org/fhir/ValueSet/med-admin-perform-function from the FHIR Standard
MedicationAdministration.reasonCode	example	ReasonMedicationGivenCodes http://hl7.org/fhir/ValueSet/reason-medication-given-codes from the FHIR Standard
MedicationAdministration.dosage.site	preferred	BodySite https://healthterminologies.gov.au/fhir/ValueSet/body-site-1 from https://tx.ontoserver.csiro.au/fhir
MedicationAdministration.dosage.route	preferred	RouteOfAdministration https://healthterminologies.gov.au/fhir/ValueSet/route-of-administration-1 from https://tx.ontoserver.csiro.au/fhir
MedicationAdministration.dosage.method	preferred	SNOMEDCTAdministrationMethodCodes http://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
inv-dh-mad-01	error	MedicationAdministration.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mad-02	error	MedicationAdministration.performer	If present, an actor shall at least have a reference, an identifier or a display : actor.exists() implies actor.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
MedicationAdministration		0..*	AUBaseMedicationAdministration	A record of medication administered to 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
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	External identifier
instantiates	Σ	0..*	uri	Instantiates protocol or definition
partOf	Σ	0..*	Reference(MedicationAdministration | Procedure)	Part of referenced event
status	?!SΣ	1..1	code	in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown Binding: MedicationAdministration Status Codes (required): A set of codes indicating the current status of a MedicationAdministration.
statusReason	S	0..*	CodeableConcept	Reason administration not performed Binding: SNOMEDCTReasonMedicationNotGivenCodes (example): A set of codes indicating the reason why the MedicationAdministration is negated.
category	S	0..1	CodeableConcept	Type of medication usage Binding: MedicationAdministration Category Codes (preferred): A coded concept describing where the medication administered is expected to occur.
Slices for medication[x]	SΣ	1..1		Medication Detail Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): Codes identifying substance or product that can be administered.
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	Medication Codes Slice: Unordered, Open by value:system
coding:pbs	SΣ	0..*	Coding	Medication Codes
coding:amt	SΣ	0..*	Coding	Medication Codes
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 received medication inv-dh-mad-01: At least reference or a valid identifier shall be present
context	S	0..1	Reference(ADHA Core Encounter)	Encounter or Episode of Care administered as part of
supportingInformation		0..*	Reference(Resource)	Additional information to support administration
effective[x]	SΣ	1..1		Start and end time of administration
effectiveDateTime			dateTime
effectivePeriod			Period
performer	SΣC	0..*	BackboneElement	Who performed the medication administration and what they did inv-dh-mad-02: If present, an actor shall at least have a reference, an identifier or a display
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
function	S	0..1	CodeableConcept	Type of performance Binding: MedicationAdministration Performer Function Codes (example): A code describing the role an individual played in administering the medication.
actor	SΣC	1..1	Reference(ADHA Authoring PractitionerRole | ADHA Authoring RelatedPerson | ADHA Core Patient)	Who performed the medication administration
reasonCode	S	0..*	CodeableConcept	Reason administration performed Binding: ReasonMedicationGivenCodes (example): A set of codes indicating the reason why the MedicationAdministration was made.
reasonReference	S	0..*	Reference(Condition | Observation | DiagnosticReport)	Condition or observation that supports why the medication was administered
request		0..1	Reference(MedicationRequest)	Request administration performed against
device		0..*	Reference(Device)	Device used to administer
note	S	0..*	Annotation	Information about the administration
dosage	SC	0..1	BackboneElement	Details of how medication was taken mad-1: SHALL have at least one of dosage.dose or dosage.rate[x]
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
text	S	0..1	string	Free text dosage instructions e.g. SIG
site	S	0..1	CodeableConcept	Body site administered to Binding: Body Site (preferred)
route	S	0..1	CodeableConcept	Path of substance into body Binding: Route of Administration (preferred)
method	S	0..1	CodeableConcept	How drug was administered Binding: SNOMEDCTAdministrationMethodCodes (preferred)
dose	S	0..1	SimpleQuantity	Amount of medication per dose
rate[x]	S	0..1		Dose quantity per unit of time
rateRatio			Ratio
rateQuantity			Quantity(SimpleQuantity)
eventHistory		0..*	Reference(Provenance)	A list of events of interest in the lifecycle
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
MedicationAdministration.language	preferred	CommonLanguages http://hl7.org/fhir/ValueSet/languages from the FHIR Standard Additional Bindings Purpose AllLanguages Max Binding
MedicationAdministration.status	required	MedicationAdministration Status Codes http://hl7.org/fhir/ValueSet/medication-admin-status|4.0.1 from the FHIR Standard
MedicationAdministration.statusReason	example	SNOMEDCTReasonMedicationNotGivenCodes http://hl7.org/fhir/ValueSet/reason-medication-not-given-codes from the FHIR Standard
MedicationAdministration.category	preferred	MedicationAdministration Category Codes http://hl7.org/fhir/ValueSet/medication-admin-category from the FHIR Standard
MedicationAdministration.medication[x]	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationAdministration.medication[x]:medicationCodeableConcept	example	SNOMEDCTMedicationCodes http://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard
MedicationAdministration.performer.function	example	MedicationAdministration Performer Function Codes http://hl7.org/fhir/ValueSet/med-admin-perform-function from the FHIR Standard
MedicationAdministration.reasonCode	example	ReasonMedicationGivenCodes http://hl7.org/fhir/ValueSet/reason-medication-given-codes from the FHIR Standard
MedicationAdministration.dosage.site	preferred	BodySite https://healthterminologies.gov.au/fhir/ValueSet/body-site-1 from https://tx.ontoserver.csiro.au/fhir
MedicationAdministration.dosage.route	preferred	RouteOfAdministration https://healthterminologies.gov.au/fhir/ValueSet/route-of-administration-1 from https://tx.ontoserver.csiro.au/fhir
MedicationAdministration.dosage.method	preferred	SNOMEDCTAdministrationMethodCodes http://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
inv-dh-mad-01	error	MedicationAdministration.subject	At least reference or a valid identifier shall be present : reference.exists() or identifier.where(system.count() + value.count() >1).exists()
inv-dh-mad-02	error	MedicationAdministration.performer	If present, an actor shall at least have a reference, an identifier or a display : actor.exists() implies actor.all($this.reference.exists() or $this.identifier.exists() or $this.display.exists())

This structure is derived from AUBaseMedicationAdministration

Summary

Must-Support: 22 elements

Structures

This structure refers to these other structures:

• 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 Authoring PractitionerRole (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-practitionerrole-author-1)
• ADHA Authoring RelatedPerson (http://ns.electronichealth.net.au/fhir/StructureDefinition/dh-relatedperson-author-1)

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the value of MedicationAdministration.medication[x] (Closed)
• The element 1 is sliced based on the value of MedicationAdministration.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.