STU3 Candidate

This page is part of the FHIR Specification (v1.8.0: STU 3 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

?.? Dosage Instruction

Pharmacy

Work Group

Maturity Level: N/A

Ballot Status: STU 3

The Dosage Instruction structure defines general dosage instruction information typically represented in medication requests, medication dispenses and medication statements.

Structure

Name	Flags	Card.	Type	Description & Constraints
DosageInstruction	Σ		Element	How medication should be taken
sequence	Σ	0..1	integer	The order of the dosage instructions
text	Σ	0..1	string	Free text dosage instructions e.g. SIG
additionalInstructions	Σ	0..*	CodeableConcept	Supplemental instructions - e.g. "with meals" SNOMED CT Additional Dosage Instructions (Example)
timing	Σ	0..1	Timing	When medication should be administered
asNeeded[x]	Σ	0..1		Take "as needed" (for x) SNOMED CT Medication As Needed Reason Codes (Example)
asNeededBoolean			boolean
asNeededCodeableConcept			CodeableConcept
site	Σ	0..1	CodeableConcept	Body site to administer to SNOMED CT Anatomical Structure for Administration Site Codes (Example)
route	Σ	0..1	CodeableConcept	How drug should enter body SNOMED CT Route Codes (Example)
method	Σ	0..1	CodeableConcept	Technique for administering medication SNOMED CT Administration Method Codes (Example)
dose[x]	Σ	0..1		Amount of medication per dose
doseRange			Range
doseQuantity			SimpleQuantity
maxDosePerPeriod	Σ	0..1	Ratio	Upper limit on medication per unit of time
maxDosePerAdministration	Σ	0..1	SimpleQuantity	Upper limit on medication per administration
maxDosePerLifetime	Σ	0..1	SimpleQuantity	Upper limit on medication per lifetime of the patient
rate[x]	Σ	0..1		Amount of medication per unit of time
rateRatio			Ratio
rateRange			Range
rateQuantity			SimpleQuantity
Documentation for this format

UML Diagram (Legend)

XML Template

<[name] xmlns="http://hl7.org/fhir"> 
 <!-- from Element: extension -->
 <sequence value="[integer]"/><!-- 0..1 The order of the dosage instructions -->
 <text value="[string]"/><!-- 0..1 Free text dosage instructions e.g. SIG -->
 <additionalInstructions><!-- 0..* CodeableConcept Supplemental instructions - e.g. "with meals" --></additionalInstructions>
 <timing><!-- 0..1 Timing When medication should be administered --></timing>
 <asNeeded[x]><!-- 0..1 boolean|CodeableConcept Take "as needed" (for x) --></asNeeded[x]>
 <site><!-- 0..1 CodeableConcept Body site to administer to --></site>
 <route><!-- 0..1 CodeableConcept How drug should enter body --></route>
 <method><!-- 0..1 CodeableConcept Technique for administering medication --></method>
 <dose[x]><!-- 0..1 Range|Quantity(SimpleQuantity) Amount of medication per dose --></dose[x]>
 <maxDosePerPeriod><!-- 0..1 Ratio Upper limit on medication per unit of time --></maxDosePerPeriod>
 <maxDosePerAdministration><!-- 0..1 Quantity(SimpleQuantity) Upper limit on medication per administration --></maxDosePerAdministration>
 <maxDosePerLifetime><!-- 0..1 Quantity(SimpleQuantity) Upper limit on medication per lifetime of the patient --></maxDosePerLifetime>
 <rate[x]><!-- 0..1 Ratio|Range|Quantity(SimpleQuantity) Amount of medication per unit of time --></rate[x]>
</[name]>

JSON Template

{
  "resourceType" : "DosageInstruction",
  // from Element: extension
  "sequence" : <integer>, // The order of the dosage instructions
  "text" : "<string>", // Free text dosage instructions e.g. SIG
  "additionalInstructions" : [{ CodeableConcept }], // Supplemental instructions - e.g. "with meals"
  "timing" : { Timing }, // When medication should be administered
  // asNeeded[x]: Take "as needed" (for x). One of these 2:
  "asNeededBoolean" : <boolean>,
  "asNeededCodeableConcept" : { CodeableConcept },
  "site" : { CodeableConcept }, // Body site to administer to
  "route" : { CodeableConcept }, // How drug should enter body
  "method" : { CodeableConcept }, // Technique for administering medication
  // dose[x]: Amount of medication per dose. One of these 2:
  "doseRange" : { Range },
  "doseQuantity" : { Quantity(SimpleQuantity) },
  "maxDosePerPeriod" : { Ratio }, // Upper limit on medication per unit of time
  "maxDosePerAdministration" : { Quantity(SimpleQuantity) }, // Upper limit on medication per administration
  "maxDosePerLifetime" : { Quantity(SimpleQuantity) }, // Upper limit on medication per lifetime of the patient
  // rate[x]: Amount of medication per unit of time. One of these 3:
  "rateRatio" : { Ratio }
  "rateRange" : { Range }
  "rateQuantity" : { Quantity(SimpleQuantity) }
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .

[
 # from Element: Element.extension
  fhir:DosageInstruction.sequence [ integer ]; # 0..1 The order of the dosage instructions
  fhir:DosageInstruction.text [ string ]; # 0..1 Free text dosage instructions e.g. SIG
  fhir:DosageInstruction.additionalInstructions [ CodeableConcept ], ... ; # 0..* Supplemental instructions - e.g. "with meals"
  fhir:DosageInstruction.timing [ Timing ]; # 0..1 When medication should be administered
  # DosageInstruction.asNeeded[x] : 0..1 Take "as needed" (for x). One of these 2
    fhir:DosageInstruction.asNeededBoolean [ boolean ]
    fhir:DosageInstruction.asNeededCodeableConcept [ CodeableConcept ]
  fhir:DosageInstruction.site [ CodeableConcept ]; # 0..1 Body site to administer to
  fhir:DosageInstruction.route [ CodeableConcept ]; # 0..1 How drug should enter body
  fhir:DosageInstruction.method [ CodeableConcept ]; # 0..1 Technique for administering medication
  # DosageInstruction.dose[x] : 0..1 Amount of medication per dose. One of these 2
    fhir:DosageInstruction.doseRange [ Range ]
    fhir:DosageInstruction.doseSimpleQuantity [ Quantity(SimpleQuantity) ]
  fhir:DosageInstruction.maxDosePerPeriod [ Ratio ]; # 0..1 Upper limit on medication per unit of time
  fhir:DosageInstruction.maxDosePerAdministration [ Quantity(SimpleQuantity) ]; # 0..1 Upper limit on medication per administration
  fhir:DosageInstruction.maxDosePerLifetime [ Quantity(SimpleQuantity) ]; # 0..1 Upper limit on medication per lifetime of the patient
  # DosageInstruction.rate[x] : 0..1 Amount of medication per unit of time. One of these 3
    fhir:DosageInstruction.rateRatio [ Ratio ]
    fhir:DosageInstruction.rateRange [ Range ]
    fhir:DosageInstruction.rateSimpleQuantity [ Quantity(SimpleQuantity) ]
]

Changes since DSTU2

This complex-type did not exist in Release 2