Implementation guide for dose syntax

This guidance is under active development by NHS Digital and content may be added or updated on a regular basis.

Release Notes

Change to the implementation guidance are recorded on this page.

2.1.0-private-beta (November 2021)

2.0.1-private-beta (May 2021)

  • Minor modifications to formatting / layout of guide
  • Added NHS Digital corporate branding
  • Dose-to-text guidance updated to align with the doseAndRate new element within FHIR R4
  • Homepage added

2.0.0-private-beta (April 2021)

  • Added to simplifier
  • Formatting amendments
  • Specific version aligned to FHIR R4 UK Core
  • Updated guidance for doseAndRate
  • Updated guidance for text
  • Updated guidance for count and countMax
  • Updated guidance for frequency and period
  • Added missing xmlns namespace into examples
  • Examples updated to support R4 changes (e.g. doseAndRate)

1.3.3-private-beta (March 2020)

  • Updated to private-beta
  • Updated the dosage-doseQuantity-freq-period.html page to include additional information regarding units of measure, and updated formatting.

1.3.2-alpha

  • updated external links to the AWS demonstrator with links to the demonstrator and associated API documentation provided by the North of England Commissioning Support Unit

1.3.1-alpha

  • review comment clarifications
  • clarification of use of UCUM units of measure versus SNOMED CT units of measure and presentation
  • clarification of use of SNOMED synonyms
  • clarification of use of additionalInstruction, patientInstruction, text
  • rearrange examples to illustrate standar use of dose syntax, use of additionalInstruction, use of patientInstruction
  • additional example of use of Medication not in dm+d (2nd Glucose 5% infusion example)

1.3.0-alpha

  • Reorganisation of content to foreground Dose Syntax versus background Medicines context
  • Examples rework to conform to CareConnect medication profiling
  • Dose to Product & CareConnect Text Narrative moved to appendix pending scoping decisions

1.2.0-discovery

  • "Dose to Product Translation" section added

1.1.0-discovery (Feb 2019)

  • "CareConnect Resources" section updated
  • Where a specific Trade Family (i.e brand name) is to be specified, an AMP concept must be used until a FHIR profiled resource can support a coded Trade Family concept.
  • Guidance and example for use of medicationDispense.quantity added.
  • "Dosage Structure" section updated
  • Moved the Dosage.asNeeded guidance it it’s own section.
  • New section for the Dosage.maxDosePer structure.
  • Updated the ‘additionalInstructions, patientInstructions’ section to include a note on using coded concepts that relate to specific dosing timing instructions.
  • Change to use of Dosage.text and inclusion of Dosage.timing.code Updated the Dosage doseQuantity, frequency, period section to include guidance on doseRange.
  • "CareConnect Text Narrative" section added
  • Fixed bugs within some of the worked FHIR XML examples
  • Additional FHIR XML examples to highlight difference between dose-based and product-based instructions.
  • Some examples removed where these covered duplicate aspects of the Dosage structure.

1.0.0-discovery (Dec 2018)

  • First version published.
back to top