Australian Base Implementation Guide (AU Base 2)

This page is part of the Australian Base IG (v1.0.1: AU Base 1 on STU3 Draft) based on FHIR R3. The current version which supercedes this version is 1.0.2. For a full list of available versions, see the Directory of published versions

1.0 StructureDefinition-au-medicationstatement

AU Base Medication Statement [FMM Level 2]

This profile defines a medication statement structure including core localisation concepts for use in an Australian context.

Medication Reference/Coding

Full medication definitions as a Medication resource can be referenced or codings are use be used to define relevant drug/medication concepts. This includes coding as:

  • PBS Item Code - Pharmaceutical Benefits Scheme coding, claiming context is not relevant as medicine coding.
  • GTIN - Global Trade Item Number, physical product reference.
  • AMT Code - Australian Medicines Terminology, national drug terminology.
  • MIMS Package - commonly used medicine coding.

Extensions

Extensions used in this profile:

  • Long Term [1]
  • MedicationStatement.medication.coding: Medication Type [1]
  • Medication Brand Name [1] - Not to be used if medicationReference is used. This text-only extension is supplied to support a brand name where no brand concept coding is available. Use medicationCodeableConcept if a brand concept coding is available.
  • Medication Generic Drug Name [1] - Not to be used if medicationReference is used. This text-only extension is supplied to support a generic name where no generic concept coding is available. Use medicationCodeableConcept if a generic concept coding is available.
  • NOTE: if extensions Medication Brand Name or Medication Generic Drug Name are used then medicationCodeableConcept must also be used.

Examples

Practitioner reports patient is taking Roferon-A three times a week on Mon Wed Sat

Long-term use of medication Zoloft

Practitioner reports patient has had Diflucan

1.0.1 Formal Views of Profile Content

The official URL for this profile is: 

http://hl7.org.au/fhir/StructureDefinition/au-medicationstatement

This profile defines a medication statement structure including core localisation concepts for use in an Australian context.

This profile builds on MedicationStatement.

This profile was published on Mon Jul 29 00:00:00 AEST 2019 as a draft by Health Level Seven Australia (Medications WG).

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. MedicationStatement 0..*A record of medication being taken by a patient in an Australian healthcare context
... extension 0..*ExtensionSlice: Unordered, Open by value:url
... medication-long-term 0..*booleanMedication Long Term Indicator
URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term
... medication-brand-name 0..*stringMedication Brand Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-brand-name
... medication-generic-name 0..*stringMedication Generic Drug Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-generic-name
... medication[x] (Slice Definition)Medication Detail
Slice: Unordered, Closed by type:$this
.... medicationCodeableConceptCodeableConcept
.... medicationReferenceReference(StructureDefinition-au-medication.html)
​.... medicationCodeableConcept I1..1CodeableConceptCoded Medication
inv-amt-tpuu: AMT TPUU valueset membership required
inv-amt-tpp: AMT TPU valueset membership required
inv-amt-tp: AMT TP valueset membership required
inv-amt-mpuu: AMT MPUU valueset membership required
inv-amt-mpp: AMT MPP valueset membership required
inv-amt-mp: AMT MP valueset membership required
inv-amt-ctpp: AMT CTPP valueset membership required
​..... coding (Slice Definition)Medication Codes
Slice: Unordered, Open by value:system, value:code
​...... pbs 0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (required)
​...... gtin 0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (required)
​...... amt 0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (required)
​....... extension 0..*ExtensionSlice: Unordered, Open by value:url
​....... medication-type 0..1CodingClass of Medication Coding
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
​........ valueCoding 1..1CodingFixed Value: As shown
......... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org.au/fhir/CodeSystem/medication-type
......... code1..1codeSymbol in syntax defined by the system
Fixed Value: BPG
......... display1..1stringRepresentation defined by the system
Fixed Value: Branded package with no container
​...... mimsPackage 0..1CodingMIMS Package
Binding: MIMS Terminology (required)
​.... medicationReference 1..1Reference(AU Base Medication)Medication Reference
... dosage 0..*AUBaseDosage

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. MedicationStatement I0..*A record of medication being taken by a patient in an Australian healthcare context
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred)
Max Binding: AllLanguages
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... medication-long-term I0..*booleanMedication Long Term Indicator
URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term
... medication-brand-name I0..*stringMedication Brand Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-brand-name
... medication-generic-name I0..*stringMedication Generic Drug Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-generic-name
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierExternal identifier
... basedOn Σ0..*Reference(MedicationRequest | CarePlan | ServiceRequest)Fulfils plan, proposal or order
... partOf Σ0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Observation)Part of referenced event
... status ?!Σ1..1codeactive | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Binding: Medication Status Codes (required)
... statusReason 0..*CodeableConceptReason for current status
Binding: SNOMEDCTDrugTherapyStatusCodes (example)
... category Σ0..1CodeableConceptType of medication usage
Binding: Medication Status Codes (preferred)
... medication[x] Σ(Slice Definition)Medication Detail
Slice: Unordered, Closed by type:$this
Binding: SNOMEDCTMedicationCodes (example)
.... medicationCodeableConceptCodeableConcept
.... medicationReferenceReference(StructureDefinition-au-medication.html)
.... medicationCodeableConcept ΣI1..1CodeableConceptCoded Medication
Binding: SNOMEDCTMedicationCodes (example)
inv-amt-tpuu: AMT TPUU valueset membership required
inv-amt-tpp: AMT TPU valueset membership required
inv-amt-tp: AMT TP valueset membership required
inv-amt-mpuu: AMT MPUU valueset membership required
inv-amt-mpp: AMT MPP valueset membership required
inv-amt-mp: AMT MP valueset membership required
inv-amt-ctpp: AMT CTPP valueset membership required
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... coding Σ(Slice Definition)Medication Codes
Slice: Unordered, Open by value:system, value:code
...... pbs Σ0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (required)
...... gtin Σ0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (required)
...... amt Σ0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (required)
....... id 0..1stringUnique id for inter-element referencing
....... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
....... medication-type 0..1CodingClass of Medication Coding
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
........ id 0..1stringUnique id for inter-element referencing
........ extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
........ url 1..1stringidentifies the meaning of the extension
........ value[x] (Slice Definition)Value of extension
Slice: Unordered, Closed by type:$this
......... valueCoding 1..1CodingValue of extension
Binding: Medication Type (required)
Fixed Value: As shown
.......... id0..0stringUnique id for inter-element referencing
.......... extension0..0ExtensionAdditional content defined by implementations
.......... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org.au/fhir/CodeSystem/medication-type
.......... version0..0stringVersion of the system - if relevant
.......... code1..1codeSymbol in syntax defined by the system
Fixed Value: BPG
.......... display1..1stringRepresentation defined by the system
Fixed Value: Branded package with no container
.......... userSelected0..0booleanIf this coding was chosen directly by the user
....... system Σ0..1uriIdentity of the terminology system
....... version Σ0..1stringVersion of the system - if relevant
....... code Σ0..1codeSymbol in syntax defined by the system
....... display Σ0..1stringRepresentation defined by the system
....... userSelected Σ0..1booleanIf this coding was chosen directly by the user
...... mimsPackage Σ0..1CodingMIMS Package
Binding: MIMS Terminology (required)
..... text Σ0..1stringPlain text representation of the concept
.... medicationReference Σ1..1Reference(AU Base Medication)Medication Reference
... subject Σ1..1Reference(Patient | Group)Who is/was taking the medication
... context Σ0..1Reference(Encounter | EpisodeOfCare)Encounter / Episode associated with MedicationStatement
... effective[x] Σ0..1The date/time or interval when the medication is/was/will be taken
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
... dateAsserted Σ0..1dateTimeWhen the statement was asserted?
... informationSource 0..1Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Organization)Person or organization that provided the information about the taking of this medication
... derivedFrom 0..*Reference(Resource)Additional supporting information
... reasonCode 0..*CodeableConceptReason for why the medication is being/was taken
Binding: Condition/Problem/DiagnosisCodes (example)
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... coding Σ(Slice Definition)Code defined by a terminology system
Slice: Unordered, Open by value:system
..... snomedReasonCode Σ0..1CodingReason For Taking/Not Taking Medication (SNOMED CT)
Binding: https://healthterminologies.gov.au/fhir/ValueSet/medication-reason-taken-1 (required)
.... text Σ0..1stringPlain text representation of the concept
... reasonReference 0..*Reference(Condition | Observation | DiagnosticReport)Condition or observation that supports why the medication is being/was taken
... note 0..*AnnotationFurther information about the statement
... dosage 0..*AUBaseDosageDosage information in an Australian healthcare context

doco Documentation for this format

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. MedicationStatement 0..*A record of medication being taken by a patient in an Australian healthcare context
... extension 0..*ExtensionSlice: Unordered, Open by value:url
... medication-long-term 0..*booleanMedication Long Term Indicator
URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term
... medication-brand-name 0..*stringMedication Brand Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-brand-name
... medication-generic-name 0..*stringMedication Generic Drug Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-generic-name
... medication[x] (Slice Definition)Medication Detail
Slice: Unordered, Closed by type:$this
.... medicationCodeableConceptCodeableConcept
.... medicationReferenceReference(StructureDefinition-au-medication.html)
​.... medicationCodeableConcept I1..1CodeableConceptCoded Medication
inv-amt-tpuu: AMT TPUU valueset membership required
inv-amt-tpp: AMT TPU valueset membership required
inv-amt-tp: AMT TP valueset membership required
inv-amt-mpuu: AMT MPUU valueset membership required
inv-amt-mpp: AMT MPP valueset membership required
inv-amt-mp: AMT MP valueset membership required
inv-amt-ctpp: AMT CTPP valueset membership required
​..... coding (Slice Definition)Medication Codes
Slice: Unordered, Open by value:system, value:code
​...... pbs 0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (required)
​...... gtin 0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (required)
​...... amt 0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (required)
​....... extension 0..*ExtensionSlice: Unordered, Open by value:url
​....... medication-type 0..1CodingClass of Medication Coding
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
​........ valueCoding 1..1CodingFixed Value: As shown
......... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org.au/fhir/CodeSystem/medication-type
......... code1..1codeSymbol in syntax defined by the system
Fixed Value: BPG
......... display1..1stringRepresentation defined by the system
Fixed Value: Branded package with no container
​...... mimsPackage 0..1CodingMIMS Package
Binding: MIMS Terminology (required)
​.... medicationReference 1..1Reference(AU Base Medication)Medication Reference
... dosage 0..*AUBaseDosage

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. MedicationStatement I0..*A record of medication being taken by a patient in an Australian healthcare context
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred)
Max Binding: AllLanguages
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... medication-long-term I0..*booleanMedication Long Term Indicator
URL: http://hl7.org.au/fhir/StructureDefinition/medication-long-term
... medication-brand-name I0..*stringMedication Brand Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-brand-name
... medication-generic-name I0..*stringMedication Generic Drug Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-generic-name
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierExternal identifier
... basedOn Σ0..*Reference(MedicationRequest | CarePlan | ServiceRequest)Fulfils plan, proposal or order
... partOf Σ0..*Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Observation)Part of referenced event
... status ?!Σ1..1codeactive | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Binding: Medication Status Codes (required)
... statusReason 0..*CodeableConceptReason for current status
Binding: SNOMEDCTDrugTherapyStatusCodes (example)
... category Σ0..1CodeableConceptType of medication usage
Binding: Medication Status Codes (preferred)
... medication[x] Σ(Slice Definition)Medication Detail
Slice: Unordered, Closed by type:$this
Binding: SNOMEDCTMedicationCodes (example)
.... medicationCodeableConceptCodeableConcept
.... medicationReferenceReference(StructureDefinition-au-medication.html)
.... medicationCodeableConcept ΣI1..1CodeableConceptCoded Medication
Binding: SNOMEDCTMedicationCodes (example)
inv-amt-tpuu: AMT TPUU valueset membership required
inv-amt-tpp: AMT TPU valueset membership required
inv-amt-tp: AMT TP valueset membership required
inv-amt-mpuu: AMT MPUU valueset membership required
inv-amt-mpp: AMT MPP valueset membership required
inv-amt-mp: AMT MP valueset membership required
inv-amt-ctpp: AMT CTPP valueset membership required
..... id 0..1stringUnique id for inter-element referencing
..... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
..... coding Σ(Slice Definition)Medication Codes
Slice: Unordered, Open by value:system, value:code
...... pbs Σ0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (required)
...... gtin Σ0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (required)
...... amt Σ0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (required)
....... id 0..1stringUnique id for inter-element referencing
....... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
....... medication-type 0..1CodingClass of Medication Coding
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
........ id 0..1stringUnique id for inter-element referencing
........ extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
........ url 1..1stringidentifies the meaning of the extension
........ value[x] (Slice Definition)Value of extension
Slice: Unordered, Closed by type:$this
......... valueCoding 1..1CodingValue of extension
Binding: Medication Type (required)
Fixed Value: As shown
.......... id0..0stringUnique id for inter-element referencing
.......... extension0..0ExtensionAdditional content defined by implementations
.......... system1..1uriIdentity of the terminology system
Fixed Value: http://hl7.org.au/fhir/CodeSystem/medication-type
.......... version0..0stringVersion of the system - if relevant
.......... code1..1codeSymbol in syntax defined by the system
Fixed Value: BPG
.......... display1..1stringRepresentation defined by the system
Fixed Value: Branded package with no container
.......... userSelected0..0booleanIf this coding was chosen directly by the user
....... system Σ0..1uriIdentity of the terminology system
....... version Σ0..1stringVersion of the system - if relevant
....... code Σ0..1codeSymbol in syntax defined by the system
....... display Σ0..1stringRepresentation defined by the system
....... userSelected Σ0..1booleanIf this coding was chosen directly by the user
...... mimsPackage Σ0..1CodingMIMS Package
Binding: MIMS Terminology (required)
..... text Σ0..1stringPlain text representation of the concept
.... medicationReference Σ1..1Reference(AU Base Medication)Medication Reference
... subject Σ1..1Reference(Patient | Group)Who is/was taking the medication
... context Σ0..1Reference(Encounter | EpisodeOfCare)Encounter / Episode associated with MedicationStatement
... effective[x] Σ0..1The date/time or interval when the medication is/was/will be taken
.... effectiveDateTimedateTime
.... effectivePeriodPeriod
... dateAsserted Σ0..1dateTimeWhen the statement was asserted?
... informationSource 0..1Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Organization)Person or organization that provided the information about the taking of this medication
... derivedFrom 0..*Reference(Resource)Additional supporting information
... reasonCode 0..*CodeableConceptReason for why the medication is being/was taken
Binding: Condition/Problem/DiagnosisCodes (example)
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... coding Σ(Slice Definition)Code defined by a terminology system
Slice: Unordered, Open by value:system
..... snomedReasonCode Σ0..1CodingReason For Taking/Not Taking Medication (SNOMED CT)
Binding: https://healthterminologies.gov.au/fhir/ValueSet/medication-reason-taken-1 (required)
.... text Σ0..1stringPlain text representation of the concept
... reasonReference 0..*Reference(Condition | Observation | DiagnosticReport)Condition or observation that supports why the medication is being/was taken
... note 0..*AnnotationFurther information about the statement
... dosage 0..*AUBaseDosageDosage information in an Australian healthcare context

doco Documentation for this format

Downloads: StructureDefinition: (XML, JSON), Schema: XML Schematron

 

1.0.2 Quick Start

Below is an overview of the required search and read operations.

Summary of Search Criteria for StructureDefinition-au-medicationstatement

none defined