AU Core Implementation Guide
1.0.0-ci-build - CI Build
AU Core Implementation Guide, published by HL7 Australia. This guide is not an authorized publication; it is the continuous build for version 1.0.0-ci-build built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7au/au-fhir-core/ and changes regularly. See the Directory of published versions
Page standards status: Informative |
The FHIR standard defines the following resources for exchanging medicine information:
AU Core defines the following profiles:
It is anticipated that future releases of AU Core will define profiles of:
The guidance below addresses how medicinal product identification can be structured in FHIR conformant to AU Core.
For extemporaneous medications, the medication code element is the primary mechanism to identify a medicine. In this case, a list of ingredients including strength and form is recommended to be provided as text in the medication code element e.g. Medication.code.text
or MedicationRequest.medicationCodeableConcept.text
.
For non-extemporaneous medications, the medication code element is the primary mechanism to identify a medicine. In this case, information identifying the medicinal product including strength and form is recommended to be provided as a code from a terminology in the medication code element, e.g. Medication.code.coding
or MedicationRequest.medicationCodeableConcept.coding
, and the description of the medicinal product as presented to the user is provided in the text e.g. Medication.code.text
or MedicationRequest.medicationCodeableConcept.text
.
Australian Medicines Terminology (AMT) is the national terminology for identification and naming of medicines in clinical systems for Australia. The AMT is published monthly to include new items on the Australian Register of Therapeutic Goods from the TGA, as well as items listed on the Pharmaceutical Benefits Scheme. The AMT is published as part of SNOMED CT-AU (Australian edition of SNOMED CT) and can be downloaded in a variety of formats from the National Clinical Terminology Service (NCTS).
In addition to the medication code, the majority of use cases support exchange of structured medicine information as separate data elements covering brand name, generic name, item form and strength, and manufacturer. These data elements may be supported as coded, or text, and systems are likely to use a combination of coded and text elements when constructing a Medication resource.
The guidance for how to support coded or text identification of medicinal products is summarised below:
code.coding
with Medication Type extension using UPDSF
from the Medication Type code systemcode.coding
with Medication Type extension using BPDSF
from the Medication Type code systemExample: Medication with single code identifying brand name, item form and strength.
{
"resourceType": "Medication",
...
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "32328011000036106",
"display": "Benpen 3 g powder for injection, 1 vial"
},
]
}
}
Example: Medication with single code identifying generic name, item form and strength, with identification of product type.
{
"resourceType": "Medication",
...
"code": {
"coding": [
{
"extension": [
{
"url": "http://hl7.org.au/fhir/StructureDefinition/medication-type",
"valueCoding": {
"system": "http://terminology.hl7.org.au/CodeSystem/medication-type",
"code": "UPDSF",
"display": "Unbranded product with strengths and form"
}
}
],
"system": "http://snomed.info/sct",
"code": "32686011000036108",
"display": "benzylpenicillin 3 g injection, vial"
},
]
}
}
code.coding
with Medication Type extension using BPD
from the Medication Type code systemcode.coding
with Medication Type extension using UPD
from the Medication Type code systemMedication.form
, Medication.ingredient.itemCodeableConcept
and Medication.ingredient.strength
when they are not implicit in Medication.code
Example: Medication with coded brand name, generic name, item form and strength.
{
"resourceType": "Medication",
...
"code": {
"coding": [
{
"extension": [
{
"url": "http://hl7.org.au/fhir/StructureDefinition/medication-type",
"valueCoding": {
"system": "http://terminology.hl7.org.au/CodeSystem/medication-type",
"code": "UPD",
"display": "Unbranded product with no strengths or form"
}
}
],
"system": "http://pbs.gov.au/code/item",
"code": "02647H",
"display": "BENZYLPENICILLIN"
},
{
"extension": [
{
"url": "http://hl7.org.au/fhir/StructureDefinition/medication-type",
"valueCoding": {
"system": "http://terminology.hl7.org.au/CodeSystem/medication-type",
"code": "BPD",
"display": "Branded product with no strengths or form"
}
}
],
"system": "http://snomed.info/sct",
"code": "3539011000036105",
"display": "Benpen"
},
]
},
"manufacturer": {
"identifier": {
"system": "http://pbs.gov.au/code/manufacturer",
"value": "CS"
}
},
"form": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "129011000036109",
"display": "Injection"
}
],
"text": "Injection"
},
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "323389000",
"display": "Benzylpenicillin"
}
]
},
"strength": {
"numerator": {
"value": 3,
"unit": "g"
},
"denominator": {
"value": 1,
"unit": "unit"
}
}
}
]
}
Medication.extension
Medication Brand Name extensionMedication.extension
Medication Generic Name extensionMedication.code.text
Example: Medication with text only brand name, generic name, item form and strength.
{
"resourceType": "Medication",
...
"extension": [
{
"url": "http://hl7.org.au/fhir/StructureDefinition/medication-generic-name",
"valueString": "Benzylpenicillin"
},
{
"url": "http://hl7.org.au/fhir/StructureDefinition/medication-brand-name",
"valueString": "Benpen"
}
],
"code": {
"text": "Benpen 3 g powder for injection, 1 vial"
}
}
Medication.manufacturer.identifier
Medication.manufacturer.display
Example: Medication with coded manufacturer.
{
"resourceType": "Medication",
...
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "32328011000036106",
"display": "Benpen 3 g powder for injection, 1 vial"
}
]
},
"manufacturer": {
"identifier": {
"system": "http://pbs.gov.au/code/manufacturer",
"value": "CS"
}
}
}
Example: Medication with non-coded manufacturer.
{
"resourceType": "Medication",
...
"code": {
"text": "Benpen 3 g powder for injection, 1 vial"
},
"manufacturer": {
"display": "Seqirus"
}
}