DataStandardsWales-Dosage

FQL

ProfileTypeStatusCanonical
DataStandardsWalesDosageDosagedrafthttps://fhir.nhs.wales/StructureDefinition/DataStandardsWales-Dosage

The Dosage resource is a record of a medication that is administered to a patient. For information on dosage prescribed or planned for administration, this will be captured in the DosageInstruction element of the medication resource.

The DataStandardsWales-Dosage profile is derived from the HL7 Dosage Profile. It defines additional rules for use within health and care organisations in Wales.

A direct link to the Data Standards Wales asset can be accessed here - Data Standards Wales Dosage

Formal Views of Profile Content

id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
sequenceS Σ0..1integer
textS Σ0..1string
additionalInstructionS Σ0..*CodeableConcept
patientInstructionS Σ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
eventΣ0..*dateTime
id0..1string
extensionI0..*Extension
boundsDurationDuration
boundsRangeRange
boundsPeriodPeriod
countΣ0..1positiveInt
countMaxΣ0..1positiveInt
durationΣ0..1decimal
durationMaxΣ0..1decimal
durationUnitΣ0..1codeBinding
frequencyΣ0..1positiveInt
frequencyMaxΣ0..1positiveInt
periodΣ0..1decimal
periodMaxΣ0..1decimal
periodUnitΣ0..1codeBinding
dayOfWeekΣ0..*codeBinding
timeOfDayΣ0..*time
whenΣ0..*codeBinding
offsetΣ0..1unsignedInt
codeΣ0..1CodeableConceptBinding
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
siteS Σ0..1CodeableConcept
routeS Σ0..1CodeableConcept
methodS Σ0..1CodeableConcept
id0..1string
extensionI0..*Extension
typeΣ0..1CodeableConcept
doseRangeRange
doseQuantitySimpleQuantity
rateRatioRatio
rateRangeRange
rateQuantitySimpleQuantity
maxDosePerPeriodS Σ I0..1Ratio
maxDosePerAdministrationΣ I0..1SimpleQuantity
maxDosePerLifetimeΣ I0..1SimpleQuantity
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
sequenceS Σ0..1integer
textS Σ0..1string
additionalInstructionS Σ0..*CodeableConcept
patientInstructionS Σ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
eventΣ0..*dateTime
id0..1string
extensionI0..*Extension
boundsDurationDuration
boundsRangeRange
boundsPeriodPeriod
countΣ0..1positiveInt
countMaxΣ0..1positiveInt
durationΣ0..1decimal
durationMaxΣ0..1decimal
durationUnitΣ0..1codeBinding
frequencyΣ0..1positiveInt
frequencyMaxΣ0..1positiveInt
periodΣ0..1decimal
periodMaxΣ0..1decimal
periodUnitΣ0..1codeBinding
dayOfWeekΣ0..*codeBinding
timeOfDayΣ0..*time
whenΣ0..*codeBinding
offsetΣ0..1unsignedInt
codeΣ0..1CodeableConceptBinding
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
siteS Σ0..1CodeableConcept
routeS Σ0..1CodeableConcept
methodS Σ0..1CodeableConcept
id0..1string
extensionI0..*Extension
typeΣ0..1CodeableConcept
doseRangeRange
doseQuantitySimpleQuantity
rateRatioRatio
rateRangeRange
rateQuantitySimpleQuantity
maxDosePerPeriodS Σ I0..1Ratio
maxDosePerAdministrationΣ I0..1SimpleQuantity
maxDosePerLifetimeΣ I0..1SimpleQuantity
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
sequenceS Σ0..1integer
textS Σ0..1string
additionalInstructionS Σ0..*CodeableConcept
patientInstructionS Σ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
eventΣ0..*dateTime
id0..1string
extensionI0..*Extension
boundsDurationDuration
boundsRangeRange
boundsPeriodPeriod
countΣ0..1positiveInt
countMaxΣ0..1positiveInt
durationΣ0..1decimal
durationMaxΣ0..1decimal
durationUnitΣ0..1codeBinding
frequencyΣ0..1positiveInt
frequencyMaxΣ0..1positiveInt
periodΣ0..1decimal
periodMaxΣ0..1decimal
periodUnitΣ0..1codeBinding
dayOfWeekΣ0..*codeBinding
timeOfDayΣ0..*time
whenΣ0..*codeBinding
offsetΣ0..1unsignedInt
codeΣ0..1CodeableConceptBinding
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
siteS Σ0..1CodeableConcept
routeS Σ0..1CodeableConcept
methodS Σ0..1CodeableConcept
id0..1string
extensionI0..*Extension
typeΣ0..1CodeableConcept
doseRangeRange
doseQuantitySimpleQuantity
rateRatioRatio
rateRangeRange
rateQuantitySimpleQuantity
maxDosePerPeriodS Σ I0..1Ratio
maxDosePerAdministrationΣ I0..1SimpleQuantity
maxDosePerLifetimeΣ I0..1SimpleQuantity

UK Core Dose Syntax Guidance:


Example Usage Scenarios

The following are example usage scenarios for the Dosage profile:

  • Example Dosage - Drops Query for the dosage of an Eye Drops medication using the query parameter Dosage.timing.repeat.when when the time value is undefined.
  • Example Dosage - Inhaler Query for the dosage of an Inhaler medication using query parameters such as Dosage.additionalInstruction.
  • Example Dosage - Oral Solution PRN Query for the dosage of an Oral Solution PRN medication using query parameters such as Dosage.asNeededCodeableConcept and Dosage.doseAndRate.doseRange.

*Examples provided have been clinically assured on the 07-Aug-2024


Profile Specific Implementation Guidance:

Mandatory and Must Support Data Elements

Refer to the Mandatory and Must Support page for guidance on how these elements should be interpreted.

Each Dosage must support:

Element Reason
Dosage.sequence Indicates the order in which the dosage instructions should be applied or interpreted.
Dosage.text Free text that can be used for cases where the instructions are too complex to code.
Dosage.additionalInstruction Supplemental instructions or warnings.
Dosage.patientInstruction Supplemental instructions to the patient on how to take the medication.
Dosage.timing The timing schedule for taking or administering the medication.
Dosage.asNeeded It indicates if there is a precondition for taking the medication.
Dosage.site Body site to administer to.
Dosage.route Indication on how the drug should enter the body.
Dosage.method Technique for administering the medication.
Dosage.maxDosePerPeriod Upper limit on medication per unit of time.

doseAndRate

By preference, use UCUM for dose units. Examples of these units of measure are “gram” or “milliliter” or “percent”.

Where a UCUM unit of measure is not defined, use a SNOMED-CT. Examples of when a SNOMED-CT unit of measure would typically be used are “tablet”, “capsule” or “ampule”.

Recommendation: Dose is used to specify the quantity of the medication administered and not the strength of the active ingredient. This information will be specified on Medication.ingredient.strength.