Australian Base Implementation Guide (AU Base 2)

AU Base Implementation Guide, published by HL7 Australia. This is not an authorized publication; it is the continuous build for version 2.0.0). This version is based on the current content of https://github.com/hl7au/au-fhir-base/ and changes regularly. 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 00:06:07 UTC 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..*A 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..1CodeableConceptBinding: 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)
.... strength 0..1RatioQuantity/strength of ingredient present

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication I0..*A medication in an Australian healthcare context
... id Σ0..1stringLogical id of this artifact
... meta ΣI0..1MetaMetadata about the resource
... implicitRules ?!ΣI0..1uriA set of rules under which this content was created
... language I0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred)
Max Binding: AllLanguages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension I0..*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 ?!I0..*ExtensionExtensions that cannot be ignored
... identifier ΣI0..*IdentifierBusiness identifier for this medication
... code ΣI0..1CodeableConceptCoding for the medicine
Binding: SNOMEDCTMedicationCodes (example)
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... coding ΣI0..*(Slice Definition)Code defined by a terminology system
Slice: Unordered, Open by value:system
..... coding:pbs ΣI0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (preferred)
...... id 0..1stringUnique id for inter-element referencing
...... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
...... system ΣI1..1uriIdentity of the terminology system
Fixed Value: http://pbs.gov.au/code/item
...... version ΣI0..1stringVersion of the system - if relevant
...... code ΣI0..1codeSymbol in syntax defined by the system
...... display ΣI0..1stringRepresentation defined by the system
...... userSelected ΣI0..1booleanIf this coding was chosen directly by the user
..... coding:gtin ΣI0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (preferred)
...... id 0..1stringUnique id for inter-element referencing
...... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
...... system ΣI1..1uriIdentity of the terminology system
Fixed Value: http://www.gs1.org/gtin
...... version ΣI0..1stringVersion of the system - if relevant
...... code ΣI0..1codeSymbol in syntax defined by the system
...... display ΣI0..1stringRepresentation defined by the system
...... userSelected ΣI0..1booleanIf this coding was chosen directly by the user
..... coding:amt ΣI0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (preferred)
...... id 0..1stringUnique id for inter-element referencing
...... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
...... medication-type I0..1CodingMedication Type
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
...... system ΣI1..1uriIdentity of the terminology system
Fixed Value: http://snomed.info/sct
...... version ΣI0..1stringVersion of the system - if relevant
...... code ΣI0..1codeSymbol in syntax defined by the system
...... display ΣI0..1stringRepresentation defined by the system
...... userSelected ΣI0..1booleanIf this coding was chosen directly by the user
..... coding:mimsPackage ΣI0..1CodingMIMS Package
Binding: MIMS Terminology (preferred)
...... id 0..1stringUnique id for inter-element referencing
...... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
...... system ΣI1..1uriIdentity of the terminology system
Fixed Value: http://www.mims.com.au/codes
...... version ΣI0..1stringVersion of the system - if relevant
...... code ΣI0..1codeSymbol in syntax defined by the system
...... display ΣI0..1stringRepresentation defined by the system
...... userSelected ΣI0..1booleanIf this coding was chosen directly by the user
.... text ΣI0..1stringMedication primary text
... status ?!ΣI0..1codeactive | inactive | entered-in-error
Binding: Medication Status Codes (required)
... manufacturer ΣI0..1Reference(Organization)Physical product manufacturer organisation
... form I0..1CodeableConceptpowder | tablets | capsule +
Binding: https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1 (preferred)
... amount ΣI0..1RatioAmount of drug in package
... ingredient I0..*BackboneElementActive or inactive ingredient
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... item[x] I1..1(Slice Definition)Medication ingredient
Slice: Unordered, Closed by type:$this
..... itemCodeableConceptCodeableConcept
..... itemReferenceReference(Substance | Medication)
..... item[x]:itemCodeableConcept I0..1CodeableConceptCoded Ingredient Product
Binding: AMT Medicinal Product (preferred)
.... isActive I0..1booleanActive ingredient indicator
.... strength I0..1RatioQuantity/strength of ingredient present
... batch I0..1BackboneElementDetails about packaged medications
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... lotNumber I0..1stringIdentifier assigned to batch
.... expirationDate I0..1dateTimeWhen batch will expire

doco Documentation for this format

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*A 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..1CodeableConceptBinding: 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)
.... strength 0..1RatioQuantity/strength of ingredient present

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication I0..*A medication in an Australian healthcare context
... id Σ0..1stringLogical id of this artifact
... meta ΣI0..1MetaMetadata about the resource
... implicitRules ?!ΣI0..1uriA set of rules under which this content was created
... language I0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred)
Max Binding: AllLanguages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension I0..*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 ?!I0..*ExtensionExtensions that cannot be ignored
... identifier ΣI0..*IdentifierBusiness identifier for this medication
... code ΣI0..1CodeableConceptCoding for the medicine
Binding: SNOMEDCTMedicationCodes (example)
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... coding ΣI0..*(Slice Definition)Code defined by a terminology system
Slice: Unordered, Open by value:system
..... coding:pbs ΣI0..*CodingPBS Item Code
Binding: PBS Medicines Item Codes (preferred)
...... id 0..1stringUnique id for inter-element referencing
...... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
...... system ΣI1..1uriIdentity of the terminology system
Fixed Value: http://pbs.gov.au/code/item
...... version ΣI0..1stringVersion of the system - if relevant
...... code ΣI0..1codeSymbol in syntax defined by the system
...... display ΣI0..1stringRepresentation defined by the system
...... userSelected ΣI0..1booleanIf this coding was chosen directly by the user
..... coding:gtin ΣI0..*CodingMedication Package Global Trade Item Number (GTIN)
Binding: GTIN for Medicines (preferred)
...... id 0..1stringUnique id for inter-element referencing
...... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
...... system ΣI1..1uriIdentity of the terminology system
Fixed Value: http://www.gs1.org/gtin
...... version ΣI0..1stringVersion of the system - if relevant
...... code ΣI0..1codeSymbol in syntax defined by the system
...... display ΣI0..1stringRepresentation defined by the system
...... userSelected ΣI0..1booleanIf this coding was chosen directly by the user
..... coding:amt ΣI0..*CodingAMT Medicines
Binding: https://healthterminologies.gov.au/fhir/ValueSet/australian-medication-1 (preferred)
...... id 0..1stringUnique id for inter-element referencing
...... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
...... medication-type I0..1CodingMedication Type
URL: http://hl7.org.au/fhir/StructureDefinition/medication-type
...... system ΣI1..1uriIdentity of the terminology system
Fixed Value: http://snomed.info/sct
...... version ΣI0..1stringVersion of the system - if relevant
...... code ΣI0..1codeSymbol in syntax defined by the system
...... display ΣI0..1stringRepresentation defined by the system
...... userSelected ΣI0..1booleanIf this coding was chosen directly by the user
..... coding:mimsPackage ΣI0..1CodingMIMS Package
Binding: MIMS Terminology (preferred)
...... id 0..1stringUnique id for inter-element referencing
...... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
...... system ΣI1..1uriIdentity of the terminology system
Fixed Value: http://www.mims.com.au/codes
...... version ΣI0..1stringVersion of the system - if relevant
...... code ΣI0..1codeSymbol in syntax defined by the system
...... display ΣI0..1stringRepresentation defined by the system
...... userSelected ΣI0..1booleanIf this coding was chosen directly by the user
.... text ΣI0..1stringMedication primary text
... status ?!ΣI0..1codeactive | inactive | entered-in-error
Binding: Medication Status Codes (required)
... manufacturer ΣI0..1Reference(Organization)Physical product manufacturer organisation
... form I0..1CodeableConceptpowder | tablets | capsule +
Binding: https://healthterminologies.gov.au/fhir/ValueSet/medication-form-1 (preferred)
... amount ΣI0..1RatioAmount of drug in package
... ingredient I0..*BackboneElementActive or inactive ingredient
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... item[x] I1..1(Slice Definition)Medication ingredient
Slice: Unordered, Closed by type:$this
..... itemCodeableConceptCodeableConcept
..... itemReferenceReference(Substance | Medication)
..... item[x]:itemCodeableConcept I0..1CodeableConceptCoded Ingredient Product
Binding: AMT Medicinal Product (preferred)
.... isActive I0..1booleanActive ingredient indicator
.... strength I0..1RatioQuantity/strength of ingredient present
... batch I0..1BackboneElementDetails about packaged medications
.... id 0..1stringUnique id for inter-element referencing
.... extension I0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!ΣI0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... lotNumber I0..1stringIdentifier assigned to batch
.... expirationDate I0..1dateTimeWhen batch will expire

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