Australian Base Implementation Guide (AU Base 1.1.1)

This page is part of the Australian Base IG (v1.1.1: AU Base 1.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-medication

AU Base Medication [FMM Level 2]

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

The following elements available in STU3 Medication have been removed from the standard structure of R4 Medication. If required in R4 use prior version extensions1, for this reason the direct use of these elements is not encouraged:

  • Medication.isBrand
  • Medication.isOverCounter
  • Medication.package.container
  • Medication.image

Medication Coding

Medication codings are 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:

  • Medication.code.coding: Medication Type [1] - used to distinguish a level classification when the same coding system is used.
  • Medication Brand Name [1] - This text-only extension is supplied to support a brand name where no brand concept coding is available. Use code if a brand concept coding is available.
  • Medication Generic Drug Name [1] - This text-only extension is supplied to support a generic name where no generic concept coding is available. Use code if a generic concept coding is available.
  • NOTE: if extensions Medication Brand Name or Medication Generic Drug Name are used then code must also be used.

Examples

Fluconazole Dose Based Medication

Paracetamol Generic Pack

Nexium Hp7 Brand Pack

Nexium Hp7 Combination Package with Product Parts

Clarithromycin 500mg Tablet Unbranded Product

Esomeprazole 20mg Tablet Unbranded Product

Amoxicillin 500mg Capsule Unbranded Product

Norvasc 10 mg Tablet Brand Product with Batch Details

The following examples have been taken from the National guidelines for on-screen display of clinical medicines information – January 2016 published by the Australian Commission on Safety and Quality in Health Care. Care has been taken with the clinical content in the structured data, and construction of narrative to be consistent with the guidelines:

Single active ingredient product: pack-based

Two active ingredients product

Product with four or more active ingredients

1.0.1 Formal Views of Profile Content

The official URL for this profile is: 

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

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

This profile builds on Medication.

This profile was published on Thu May 11 10:06:07 AEST 2017 as a active by Health Level Seven Australia (Medications WG).

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*MedicationA medication in an Australian healthcare context
... extension 0..*ExtensionSlice: Unordered, Open by value:url
... medication-brand-name 0..1stringMedication Brand Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-brand-name
... medication-generic-name 0..1stringMedication Generic Drug Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-generic-name
... code 0..1CodeableConceptCoding for the medicine
.... coding 0..*(Slice Definition)Slice: Unordered, Open by value:system
..... coding:pbs 0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (preferred)
...... system 1..1uriFixed Value: http://pbs.gov.au/code/item
..... coding:gtin 0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (preferred)
...... system 1..1uriFixed Value: http://www.gs1.org/gtin
..... coding:amt 0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (preferred)
...... extension 0..*ExtensionSlice: Unordered, Open by value:url
...... medication-type 0..1CodingMedication Type
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
...... system 1..1uriFixed Value: http://snomed.info/sct
..... coding:mimsPackage 0..1CodingMIMS Package
Binding: MIMS Terminology (preferred)
...... system 1..1uriFixed Value: http://www.mims.com.au/codes
.... text 0..1stringMedication primary text
... manufacturer 0..1Reference(Organization)Physical product manufacturer organisation
... form 0..1CodeableConceptpowder | tablets | capsule +
Binding: https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1 (preferred)
... ingredient 0..*BackboneElement
.... item[x] 1..1(Slice Definition)Medication ingredient
Slice: Unordered, Closed by type:$this
..... item[x]:itemCodeableConcept 0..1CodeableConceptCoded Ingredient Product
Binding: AMT Medicinal Product (preferred)
..... item[x]:itemReference 0..1Reference(AU Base Medication | AU Base Substance)Item Reference
.... amount 0..1RatioStrength of ingredient
... package 0..1BackboneElement
.... batch 0..1BackboneElement

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication I0..*MedicationA medication 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: Common Languages (extensible)
Max Binding: All Languages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... medication-brand-name I0..1stringMedication Brand Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-brand-name
... medication-generic-name I0..1stringMedication Generic Drug Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-generic-name
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... code Σ0..1CodeableConceptCoding for the medicine
Binding: SNOMED CT Medication Codes (example)
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... coding Σ0..*(Slice Definition)Code defined by a terminology system
Slice: Unordered, Open by value:system
..... coding:pbs Σ0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (preferred)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... system Σ1..1uriIdentity of the terminology system
Fixed Value: http://pbs.gov.au/code/item
...... 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
..... coding:gtin Σ0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (preferred)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... system Σ1..1uriIdentity of the terminology system
Fixed Value: http://www.gs1.org/gtin
...... 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
..... coding:amt Σ0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (preferred)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
...... medication-type 0..1CodingMedication Type
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
...... system Σ1..1uriIdentity of the terminology system
Fixed Value: http://snomed.info/sct
...... 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
..... coding:mimsPackage Σ0..1CodingMIMS Package
Binding: MIMS Terminology (preferred)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... system Σ1..1uriIdentity of the terminology system
Fixed Value: http://www.mims.com.au/codes
...... 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
.... text Σ0..1stringMedication primary text
... status Σ0..1codeactive | inactive | entered-in-error
Binding: MedicationStatus (required)
... isBrand Σ0..1booleanTrue if a brand
... isOverTheCounter Σ0..1booleanTrue if medication does not require a prescription
... manufacturer Σ0..1Reference(Organization)Physical product manufacturer organisation
... form 0..1CodeableConceptpowder | tablets | capsule +
Binding: https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1 (preferred)
... ingredient I0..*BackboneElementActive or inactive ingredient
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... item[x] 1..1(Slice Definition)Medication ingredient
Slice: Unordered, Closed by type:$this
..... itemCodeableConceptCodeableConcept
..... itemReferenceReference(Substance | Medication)
..... item[x]:itemCodeableConcept 0..1CodeableConceptCoded Ingredient Product
Binding: AMT Medicinal Product (preferred)
..... item[x]:itemReference 0..1Reference(AU Base Medication | AU Base Substance)Item Reference
.... isActive 0..1booleanActive ingredient indicator
.... amount 0..1RatioStrength of ingredient
... package I0..1BackboneElementDetails about packaged medications
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... container 0..1CodeableConceptE.g. box, vial, blister-pack
Binding: MedicationContainer (example)
.... content I0..*BackboneElementWhat is in the package
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
..... item[x] 1..1The item in the package
...... itemCodeableConceptCodeableConcept
...... itemReferenceReference(Medication)
..... amount 0..1SimpleQuantityQuantity present in the package
.... batch I0..1BackboneElementIdentifies a single production run
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
..... lotNumber 0..1stringIdentifier assigned to batch
..... expirationDate 0..1dateTimeWhen batch will expire
... image 0..*AttachmentPicture of the medication

doco Documentation for this format

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*MedicationA medication in an Australian healthcare context
... extension 0..*ExtensionSlice: Unordered, Open by value:url
... medication-brand-name 0..1stringMedication Brand Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-brand-name
... medication-generic-name 0..1stringMedication Generic Drug Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-generic-name
... code 0..1CodeableConceptCoding for the medicine
.... coding 0..*(Slice Definition)Slice: Unordered, Open by value:system
..... coding:pbs 0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (preferred)
...... system 1..1uriFixed Value: http://pbs.gov.au/code/item
..... coding:gtin 0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (preferred)
...... system 1..1uriFixed Value: http://www.gs1.org/gtin
..... coding:amt 0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (preferred)
...... extension 0..*ExtensionSlice: Unordered, Open by value:url
...... medication-type 0..1CodingMedication Type
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
...... system 1..1uriFixed Value: http://snomed.info/sct
..... coding:mimsPackage 0..1CodingMIMS Package
Binding: MIMS Terminology (preferred)
...... system 1..1uriFixed Value: http://www.mims.com.au/codes
.... text 0..1stringMedication primary text
... manufacturer 0..1Reference(Organization)Physical product manufacturer organisation
... form 0..1CodeableConceptpowder | tablets | capsule +
Binding: https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1 (preferred)
... ingredient 0..*BackboneElement
.... item[x] 1..1(Slice Definition)Medication ingredient
Slice: Unordered, Closed by type:$this
..... item[x]:itemCodeableConcept 0..1CodeableConceptCoded Ingredient Product
Binding: AMT Medicinal Product (preferred)
..... item[x]:itemReference 0..1Reference(AU Base Medication | AU Base Substance)Item Reference
.... amount 0..1RatioStrength of ingredient
... package 0..1BackboneElement
.... batch 0..1BackboneElement

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication I0..*MedicationA medication 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: Common Languages (extensible)
Max Binding: All Languages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... medication-brand-name I0..1stringMedication Brand Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-brand-name
... medication-generic-name I0..1stringMedication Generic Drug Name
URL: http://hl7.org.au/fhir/StructureDefinition/medication-generic-name
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... code Σ0..1CodeableConceptCoding for the medicine
Binding: SNOMED CT Medication Codes (example)
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... coding Σ0..*(Slice Definition)Code defined by a terminology system
Slice: Unordered, Open by value:system
..... coding:pbs Σ0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (preferred)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... system Σ1..1uriIdentity of the terminology system
Fixed Value: http://pbs.gov.au/code/item
...... 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
..... coding:gtin Σ0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (preferred)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... system Σ1..1uriIdentity of the terminology system
Fixed Value: http://www.gs1.org/gtin
...... 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
..... coding:amt Σ0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (preferred)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
...... medication-type 0..1CodingMedication Type
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
...... system Σ1..1uriIdentity of the terminology system
Fixed Value: http://snomed.info/sct
...... 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
..... coding:mimsPackage Σ0..1CodingMIMS Package
Binding: MIMS Terminology (preferred)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... system Σ1..1uriIdentity of the terminology system
Fixed Value: http://www.mims.com.au/codes
...... 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
.... text Σ0..1stringMedication primary text
... status Σ0..1codeactive | inactive | entered-in-error
Binding: MedicationStatus (required)
... isBrand Σ0..1booleanTrue if a brand
... isOverTheCounter Σ0..1booleanTrue if medication does not require a prescription
... manufacturer Σ0..1Reference(Organization)Physical product manufacturer organisation
... form 0..1CodeableConceptpowder | tablets | capsule +
Binding: https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1 (preferred)
... ingredient I0..*BackboneElementActive or inactive ingredient
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... item[x] 1..1(Slice Definition)Medication ingredient
Slice: Unordered, Closed by type:$this
..... itemCodeableConceptCodeableConcept
..... itemReferenceReference(Substance | Medication)
..... item[x]:itemCodeableConcept 0..1CodeableConceptCoded Ingredient Product
Binding: AMT Medicinal Product (preferred)
..... item[x]:itemReference 0..1Reference(AU Base Medication | AU Base Substance)Item Reference
.... isActive 0..1booleanActive ingredient indicator
.... amount 0..1RatioStrength of ingredient
... package I0..1BackboneElementDetails about packaged medications
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... container 0..1CodeableConceptE.g. box, vial, blister-pack
Binding: MedicationContainer (example)
.... content I0..*BackboneElementWhat is in the package
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
..... item[x] 1..1The item in the package
...... itemCodeableConceptCodeableConcept
...... itemReferenceReference(Medication)
..... amount 0..1SimpleQuantityQuantity present in the package
.... batch I0..1BackboneElementIdentifies a single production run
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
..... lotNumber 0..1stringIdentifier assigned to batch
..... expirationDate 0..1dateTimeWhen batch will expire
... image 0..*AttachmentPicture of the medication

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-medication

none defined