ext-R5-Dosage.doseAndRate
type: StructureDefinition
node role: treeRoot
id:
  v: ext-R5-Dosage.doseAndRate
text:
  status:
    v: extensions
  div:
    v: Generated Narrative: StructureDefinition ext-R5-Dosage.doseAndRate Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> Extension 0..* Extension R5: Amount of medication administered, to be administered or typical amount to be administered (new) #xD; Slices for extension 0..* Extension Extension Slice: Unordered, Open by value:url #xD; extension:type 0..1 Extension R5: The kind of dose or rate specified (new) #xD; url 1..1 uri "type" #xD; value[x] 0..1 CodeableConcept The kind of dose or rate specified Binding: R5DoseRateTypeForR3 (0.1.0) (example): The kind of dose or rate specified. #xD; extension:dose 0..1 Extension R5: dose #xD; url 1..1 uri "dose" #xD; value[x] 0..1 Amount of medication per dose #xD; valueRange Range #xD; valueQuantity Quantity(SimpleQuantity) #xD; extension:rate 0..1 Extension R5: rate #xD; url 1..1 uri "rate" #xD; value[x] 0..1 Amount of medication per unit of time #xD; valueRatio Ratio #xD; valueRange Range #xD; valueQuantity Quantity(SimpleQuantity) #xD; url 1..1 uri "http://hl7.org/fhir/5.0/StructureDefinition/extension-Dosage.doseAndRate" #xD; value[x] 0..0 Value of extension #xD; <img src="[binary]" alt="doco" style="background-color: inherit"/> Documentation for this format
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-wg
    l: structuredefinition-wg
  value: Code
    v: fhir
extension:
  extension:
    url:
      v: packageId
      l: packageId
    value: Id
      v: hl7.fhir.uv.xver-r5.r3
  extension:
    url:
      v: version
      l: version
    value: String
      v: 0.1.0
  extension:
    url:
      v: uri
      l: uri
    value: Uri
      v: http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r5.r3
      l: hl7.fhir.uv.xver-r5.r3
  url:
    v: http://hl7.org/fhir/StructureDefinition/package-source
    l: package-source
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm
    l: structuredefinition-fmm
  value: Integer
    v: 0
    extension:
      url:
        v: http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom
        l: structuredefinition-conformance-derivedFrom
      value: Uri
        v: http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r5.r3
        l: hl7.fhir.uv.xver-r5.r3
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status
    l: structuredefinition-standards-status
  value: Code
    v: trial-use
    extension:
      url:
        v: http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom
        l: structuredefinition-conformance-derivedFrom
      value: Uri
        v: http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r5.r3
        l: hl7.fhir.uv.xver-r5.r3
url:
  v: http://hl7.org/fhir/5.0/StructureDefinition/extension-Dosage.doseAndRate
  l: extension-Dosage.doseAndRate
version:
  v: 0.1.0
name:
  v: ExtensionDosage_DoseAndRate
title:
  v: R5: Amount of medication administered, to be administered or typical amount to be administered (new)
status:
  v: active
experimental:
  v: false
date:
  v: 2026-03-17T21:02:03.8104715+00:00
publisher:
  v: FHIR Infrastructure
contact:
  name:
    v: FHIR Infrastructure
  telecom:
    system:
      v: url
    value:
      v: http://www.hl7.org/Special/committees/fiwg
description:
  v: R5: `Dosage.doseAndRate` (new:Element)
jurisdiction:
  coding:
    system:
      v: http://unstats.un.org/unsd/methods/m49/m49.htm
      l: m49.htm
    code:
      v: 001
    display:
      v: World
purpose:
  v: This extension is part of the cross-version definitions generated to enable use of the element `Dosage.doseAndRate` as defined in FHIR R5 in FHIR STU3. The source element is defined as: `Dosage.doseAndRate` 0..* `Element` Across FHIR versions, the element set has been mapped as: * R5: `Dosage.doseAndRate` 0..* `Element` * R4B: `Dosage.doseAndRate` 0..* `Element` * R4: `Dosage.doseAndRate` 0..* `Element` Following are the generation technical comments: Element `Dosage.doseAndRate` has a context of Dosage based on following the parent source element upwards and mapping to `Dosage`. Element `Dosage.doseAndRate` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).
fhir version:
  v: 3.0.2
mapping:
  identity:
    v: rim
  uri:
    v: http://hl7.org/v3
    l: v3
  name:
    v: RIM Mapping
kind:
  v: complex-type
abstract:
  v: false
context type:
  v: datatype
context:
  v: Dosage
type:
  v: Extension
base definition:
  v: http://hl7.org/fhir/StructureDefinition/Extension
  l: Extension
derivation:
  v: constraint
snapshot:
  element:
    id:
      v: Extension
    path:
      v: Extension
    short:
      v: R5: Amount of medication administered, to be administered or typical amount to be administered (new)
    definition:
      v: R5: `Dosage.doseAndRate` (new:Element)
    comment:
      v: Element `Dosage.doseAndRate` has a context of Dosage based on following the parent source element upwards and mapping to `Dosage`. Element `Dosage.doseAndRate` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: Extension
      min:
        v: 0
      max:
        v: *
    condition:
      v: ele-1
    constraint:
      key:
        v: ele-1
      severity:
        v: error
      human:
        v: All FHIR elements must have a @value or children
      expression:
        v: hasValue() | (children().count() > id.count())
      xpath:
        v: @value|f:*|h:div
      source:
        v: http://hl7.org/fhir/StructureDefinition/Element
        l: Element
    constraint:
      key:
        v: ext-1
      severity:
        v: error
      human:
        v: Must have either extensions or value[x], not both
      expression:
        v: extension.exists() != value.exists()
      xpath:
        v: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
      source:
        v: http://hl7.org/fhir/StructureDefinition/Extension
        l: Extension
    is modifier:
      v: false
  element:
    id:
      v: Extension.id
    path:
      v: Extension.id
    representation:
      v: xmlAttr
    short:
      v: xml:id (or equivalent in JSON)
    definition:
      v: unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
    min:
      v: 0
    max:
      v: 1
    base:
      path:
        v: Element.id
      min:
        v: 0
      max:
        v: 1

code:
  v: string
  l: string

identity:
  v: rim
map:
  v: n/a

id:
  v: Extension.extension
path:
  v: Extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  ordered:
    v: false
  rules:
    v: open
short:
  v: Extension
definition:
  v: An Extension
min:
  v: 0
max:
  v: *
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension

id:
  v: Extension.extension:type
path:
  v: Extension.extension
slice name:
  v: type
short:
  v: R5: The kind of dose or rate specified (new)
definition:
  v: R5: `Dosage.doseAndRate.type` (new:CodeableConcept)
comment:
  v: Element `Dosage.doseAndRate.type` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.type` has a context of Dosage based on following the parent source element upwards and mapping to `Dosage`. Element `Dosage.doseAndRate.type` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).
requirements:
  v: If the type is not populated, assume to be "ordered". Element `Dosage.doseAndRate.type` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.type` has a context of Dosage based on following the parent source element upwards and mapping to `Dosage`. Element `Dosage.doseAndRate.type` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension

id:
  v: Extension.extension:type.id
path:
  v: Extension.extension.id
representation:
  v: xmlAttr
short:
  v: xml:id (or equivalent in JSON)
definition:
  v: unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:type.extension
path:
  v: Extension.extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Additional Content defined by implementations
definition:
  v: May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
comment:
  v: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
alias:
  v: extensions
alias:
  v: user content
min:
  v: 0
max:
  v: *
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:type.url
path:
  v: Extension.extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: uri
    l: uri
fixed: Uri
  v: type
  l: type
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:type.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: The kind of dose or rate specified
definition:
  v: The kind of dose or rate specified, for example, ordered or calculated.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept
binding:
  strength:
    v: example
  description:
    v: The kind of dose or rate specified.
  value set: Uri
    v: http://hl7.org/fhir/uv/xver/ValueSet/R5-dose-rate-type-for-R3|0.1.0
    l: http://hl7.org/fhir/uv/xver/ValueSet/R5-dose-rate-type-for-R3
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:dose
path:
  v: Extension.extension
slice name:
  v: dose
short:
  v: R5: dose
definition:
  v: R5: `Dosage.doseAndRate.dose[x]`
comment:
  v: Element `Dosage.doseAndRate.dose[x]` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.dose[x]` is mapped to FHIR STU3 element `Dosage.dose[x]` as `Equivalent`. The target context `Dosage.dose[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`. Note that this specifies the quantity of the specified medication, not the quantity for each active ingredient(s). Each ingredient amount can be communicated in the Medication resource. For example, if one wants to communicate that a tablet was 375 mg, where the dose was one tablet, you can use the Medication resource to document that the tablet was comprised of 375 mg of drug XYZ. Alternatively if the dose was 375 mg, then you may only need to use the Medication resource to indicate this was a tablet. If the example were an IV such as dopamine and you wanted to communicate that 400mg of dopamine was mixed in 500 ml of some IV solution, then this would all be communicated in the Medication resource. If the administration is not intended to be instantaneous (rate is present or timing has a duration), this can be specified to convey the total amount to be administered over the period of time as indicated by the schedule e.g. 500 ml in dose, with timing used to convey that this should be done over 4 hours.
requirements:
  v: The amount of therapeutic or other substance given at one administration event. Element `Dosage.doseAndRate.dose[x]` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.dose[x]` is mapped to FHIR STU3 element `Dosage.dose[x]` as `Equivalent`. The target context `Dosage.dose[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension

id:
  v: Extension.extension:dose.id
path:
  v: Extension.extension.id
representation:
  v: xmlAttr
short:
  v: xml:id (or equivalent in JSON)
definition:
  v: unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:dose.extension
path:
  v: Extension.extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Additional Content defined by implementations
definition:
  v: May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
comment:
  v: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
alias:
  v: extensions
alias:
  v: user content
min:
  v: 0
max:
  v: *
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:dose.url
path:
  v: Extension.extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: uri
    l: uri
fixed: Uri
  v: dose
  l: dose
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:dose.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Amount of medication per dose
definition:
  v: Amount of medication per dose.
comment:
  v: Note that this specifies the quantity of the specified medication, not the quantity for each active ingredient(s). Each ingredient amount can be communicated in the Medication resource. For example, if one wants to communicate that a tablet was 375 mg, where the dose was one tablet, you can use the Medication resource to document that the tablet was comprised of 375 mg of drug XYZ. Alternatively if the dose was 375 mg, then you may only need to use the Medication resource to indicate this was a tablet. If the example were an IV such as dopamine and you wanted to communicate that 400mg of dopamine was mixed in 500 ml of some IV solution, then this would all be communicated in the Medication resource. If the administration is not intended to be instantaneous (rate is present or timing has a duration), this can be specified to convey the total amount to be administered over the period of time as indicated by the schedule e.g. 500 ml in dose, with timing used to convey that this should be done over 4 hours.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Range
    l: Range
type:
  code:
    v: Quantity
    l: Quantity
  profile:
    v: http://hl7.org/fhir/StructureDefinition/SimpleQuantity
    l: SimpleQuantity
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:rate
path:
  v: Extension.extension
slice name:
  v: rate
short:
  v: R5: rate
definition:
  v: R5: `Dosage.doseAndRate.rate[x]`
comment:
  v: Element `Dosage.doseAndRate.rate[x]` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.rate[x]` is mapped to FHIR STU3 element `Dosage.rate[x]` as `Equivalent`. The target context `Dosage.rate[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`. It is possible to supply both a rate and a doseQuantity to provide full details about how the medication is to be administered and supplied. If the rate is intended to change over time, depending on local rules/regulations, each change should be captured as a new version of the MedicationRequest with an updated rate, or captured with a new MedicationRequest with the new rate. It is possible to specify a rate over time (for example, 100 ml/hour) using either the rateRatio and rateQuantity. The rateQuantity approach requires systems to have the capability to parse UCUM grammar where ml/hour is included rather than a specific ratio where the time is specified as the denominator. Where a rate such as 500ml over 2 hours is specified, the use of rateRatio may be more semantically correct than specifying using a rateQuantity of 250 mg/hour.
requirements:
  v: Identifies the speed with which the medication was or will be introduced into the patient. Typically the rate for an infusion e.g. 100 ml per 1 hour or 100 ml/hr. May also be expressed as a rate per unit of time e.g. 500 ml per 2 hours. Other examples: 200 mcg/min or 200 mcg/1 minute; 1 liter/8 hours. Sometimes, a rate can imply duration when expressed as total volume / duration (e.g. 500mL/2 hours implies a duration of 2 hours). However, when rate doesn't imply duration (e.g. 250mL/hour), then the timing.repeat.duration is needed to convey the infuse over time period. Element `Dosage.doseAndRate.rate[x]` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.rate[x]` is mapped to FHIR STU3 element `Dosage.rate[x]` as `Equivalent`. The target context `Dosage.rate[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension

id:
  v: Extension.extension:rate.id
path:
  v: Extension.extension.id
representation:
  v: xmlAttr
short:
  v: xml:id (or equivalent in JSON)
definition:
  v: unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:rate.extension
path:
  v: Extension.extension.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Additional Content defined by implementations
definition:
  v: May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
comment:
  v: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
alias:
  v: extensions
alias:
  v: user content
min:
  v: 0
max:
  v: *
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: Extension.extension:rate.url
path:
  v: Extension.extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: uri
    l: uri
fixed: Uri
  v: rate
  l: rate
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:rate.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Amount of medication per unit of time
definition:
  v: Amount of medication per unit of time.
comment:
  v: It is possible to supply both a rate and a doseQuantity to provide full details about how the medication is to be administered and supplied. If the rate is intended to change over time, depending on local rules/regulations, each change should be captured as a new version of the MedicationRequest with an updated rate, or captured with a new MedicationRequest with the new rate. It is possible to specify a rate over time (for example, 100 ml/hour) using either the rateRatio and rateQuantity. The rateQuantity approach requires systems to have the capability to parse UCUM grammar where ml/hour is included rather than a specific ratio where the time is specified as the denominator. Where a rate such as 500ml over 2 hours is specified, the use of rateRatio may be more semantically correct than specifying using a rateQuantity of 250 mg/hour.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Ratio
    l: Ratio
type:
  code:
    v: Range
    l: Range
type:
  code:
    v: Quantity
    l: Quantity
  profile:
    v: http://hl7.org/fhir/StructureDefinition/SimpleQuantity
    l: SimpleQuantity
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.url
path:
  v: Extension.url
representation:
  v: xmlAttr
short:
  v: identifies the meaning of the extension
definition:
  v: Source of the definition for the extension code - a logical name or a URL.
comment:
  v: The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: uri
    l: uri
fixed: Uri
  v: http://hl7.org/fhir/5.0/StructureDefinition/extension-Dosage.doseAndRate
  l: extension-Dosage.doseAndRate
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.value[x]
path:
  v: Extension.value[x]
short:
  v: Value of extension
definition:
  v: Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).
min:
  v: 0
max:
  v: 0
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: base64Binary
    l: base64Binary
type:
  code:
    v: boolean
    l: boolean
type:
  code:
    v: code
    l: code
type:
  code:
    v: date
    l: date
type:
  code:
    v: dateTime
    l: dateTime
type:
  code:
    v: decimal
    l: decimal
type:
  code:
    v: id
    l: id
type:
  code:
    v: instant
    l: instant
type:
  code:
    v: integer
    l: integer
type:
  code:
    v: markdown
    l: markdown
type:
  code:
    v: oid
    l: oid
type:
  code:
    v: positiveInt
    l: positiveInt
type:
  code:
    v: string
    l: string
type:
  code:
    v: time
    l: time
type:
  code:
    v: unsignedInt
    l: unsignedInt
type:
  code:
    v: uri
    l: uri
type:
  code:
    v: Address
    l: Address
type:
  code:
    v: Age
    l: Age
type:
  code:
    v: Annotation
    l: Annotation
type:
  code:
    v: Attachment
    l: Attachment
type:
  code:
    v: CodeableConcept
    l: CodeableConcept
type:
  code:
    v: Coding
    l: Coding
type:
  code:
    v: ContactPoint
    l: ContactPoint
type:
  code:
    v: Count
    l: Count
type:
  code:
    v: Distance
    l: Distance
type:
  code:
    v: Duration
    l: Duration
type:
  code:
    v: HumanName
    l: HumanName
type:
  code:
    v: Identifier
    l: Identifier
type:
  code:
    v: Money
    l: Money
type:
  code:
    v: Period
    l: Period
type:
  code:
    v: Quantity
    l: Quantity
type:
  code:
    v: Range
    l: Range
type:
  code:
    v: Ratio
    l: Ratio
type:
  code:
    v: Reference
    l: Reference
type:
  code:
    v: SampledData
    l: SampledData
type:
  code:
    v: Signature
    l: Signature
type:
  code:
    v: Timing
    l: Timing
type:
  code:
    v: Meta
    l: Meta
mapping:
  identity:
    v: rim
  map:
    v: N/A

element:
  id:
    v: Extension
  path:
    v: Extension
  short:
    v: R5: Amount of medication administered, to be administered or typical amount to be administered (new)
  definition:
    v: R5: `Dosage.doseAndRate` (new:Element)
  comment:
    v: Element `Dosage.doseAndRate` has a context of Dosage based on following the parent source element upwards and mapping to `Dosage`. Element `Dosage.doseAndRate` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).
  min:
    v: 0
  max:
    v: *
  base:
    path:
      v: Extension
    min:
      v: 0
    max:
      v: *
  is modifier:
    v: false
element:
  id:
    v: Extension.extension
  path:
    v: Extension.extension
  slicing:
    discriminator:
      type:
        v: value
      path:
        v: url
    ordered:
      v: false
    rules:
      v: open
  min:
    v: 0
  max:
    v: *
  base:
    path:
      v: Extension.extension
    min:
      v: 0
    max:
      v: *
element:
  id:
    v: Extension.extension:type
  path:
    v: Extension.extension
  slice name:
    v: type
  short:
    v: R5: The kind of dose or rate specified (new)
  definition:
    v: R5: `Dosage.doseAndRate.type` (new:CodeableConcept)
  comment:
    v: Element `Dosage.doseAndRate.type` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.type` has a context of Dosage based on following the parent source element upwards and mapping to `Dosage`. Element `Dosage.doseAndRate.type` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).
  requirements:
    v: If the type is not populated, assume to be "ordered". Element `Dosage.doseAndRate.type` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.type` has a context of Dosage based on following the parent source element upwards and mapping to `Dosage`. Element `Dosage.doseAndRate.type` has no mapping targets in FHIR STU3. Typically, this is because the element has been added (is a new element).
  min:
    v: 0
  max:
    v: 1
  base:
    path:
      v: Extension.extension
    min:
      v: 0
    max:
      v: *
element:
  id:
    v: Extension.extension:type.url
  path:
    v: Extension.extension.url
  min:
    v: 1
  max:
    v: 1
  base:
    path:
      v: Extension.url
    min:
      v: 1
    max:
      v: 1
  fixed: Uri
    v: type
    l: type
element:
  id:
    v: Extension.extension:type.value[x]
  path:
    v: Extension.extension.value[x]
  short:
    v: The kind of dose or rate specified
  definition:
    v: The kind of dose or rate specified, for example, ordered or calculated.
  min:
    v: 0
  max:
    v: 1
  base:
    path:
      v: Extension.value[x]
    min:
      v: 0
    max:
      v: 1
  type:
    code:
      v: CodeableConcept
      l: CodeableConcept
  binding:
    strength:
      v: example
    description:
      v: The kind of dose or rate specified.
    value set: Uri
      v: http://hl7.org/fhir/uv/xver/ValueSet/R5-dose-rate-type-for-R3|0.1.0
      l: http://hl7.org/fhir/uv/xver/ValueSet/R5-dose-rate-type-for-R3
element:
  id:
    v: Extension.extension:dose
  path:
    v: Extension.extension
  slice name:
    v: dose
  short:
    v: R5: dose
  definition:
    v: R5: `Dosage.doseAndRate.dose[x]`
  comment:
    v: Element `Dosage.doseAndRate.dose[x]` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.dose[x]` is mapped to FHIR STU3 element `Dosage.dose[x]` as `Equivalent`. The target context `Dosage.dose[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`. Note that this specifies the quantity of the specified medication, not the quantity for each active ingredient(s). Each ingredient amount can be communicated in the Medication resource. For example, if one wants to communicate that a tablet was 375 mg, where the dose was one tablet, you can use the Medication resource to document that the tablet was comprised of 375 mg of drug XYZ. Alternatively if the dose was 375 mg, then you may only need to use the Medication resource to indicate this was a tablet. If the example were an IV such as dopamine and you wanted to communicate that 400mg of dopamine was mixed in 500 ml of some IV solution, then this would all be communicated in the Medication resource. If the administration is not intended to be instantaneous (rate is present or timing has a duration), this can be specified to convey the total amount to be administered over the period of time as indicated by the schedule e.g. 500 ml in dose, with timing used to convey that this should be done over 4 hours.
  requirements:
    v: The amount of therapeutic or other substance given at one administration event. Element `Dosage.doseAndRate.dose[x]` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.dose[x]` is mapped to FHIR STU3 element `Dosage.dose[x]` as `Equivalent`. The target context `Dosage.dose[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`.
  min:
    v: 0
  max:
    v: 1
  base:
    path:
      v: Extension.extension
    min:
      v: 0
    max:
      v: *
element:
  id:
    v: Extension.extension:dose.url
  path:
    v: Extension.extension.url
  min:
    v: 1
  max:
    v: 1
  base:
    path:
      v: Extension.url
    min:
      v: 1
    max:
      v: 1
  fixed: Uri
    v: dose
    l: dose
element:
  id:
    v: Extension.extension:dose.value[x]
  path:
    v: Extension.extension.value[x]
  short:
    v: Amount of medication per dose
  definition:
    v: Amount of medication per dose.
  comment:
    v: Note that this specifies the quantity of the specified medication, not the quantity for each active ingredient(s). Each ingredient amount can be communicated in the Medication resource. For example, if one wants to communicate that a tablet was 375 mg, where the dose was one tablet, you can use the Medication resource to document that the tablet was comprised of 375 mg of drug XYZ. Alternatively if the dose was 375 mg, then you may only need to use the Medication resource to indicate this was a tablet. If the example were an IV such as dopamine and you wanted to communicate that 400mg of dopamine was mixed in 500 ml of some IV solution, then this would all be communicated in the Medication resource. If the administration is not intended to be instantaneous (rate is present or timing has a duration), this can be specified to convey the total amount to be administered over the period of time as indicated by the schedule e.g. 500 ml in dose, with timing used to convey that this should be done over 4 hours.
  min:
    v: 0
  max:
    v: 1
  base:
    path:
      v: Extension.value[x]
    min:
      v: 0
    max:
      v: 1
  type:
    code:
      v: Range
      l: Range
  type:
    code:
      v: Quantity
      l: Quantity

id:
  v: Extension.extension:rate
path:
  v: Extension.extension
slice name:
  v: rate
short:
  v: R5: rate
definition:
  v: R5: `Dosage.doseAndRate.rate[x]`
comment:
  v: Element `Dosage.doseAndRate.rate[x]` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.rate[x]` is mapped to FHIR STU3 element `Dosage.rate[x]` as `Equivalent`. The target context `Dosage.rate[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`. It is possible to supply both a rate and a doseQuantity to provide full details about how the medication is to be administered and supplied. If the rate is intended to change over time, depending on local rules/regulations, each change should be captured as a new version of the MedicationRequest with an updated rate, or captured with a new MedicationRequest with the new rate. It is possible to specify a rate over time (for example, 100 ml/hour) using either the rateRatio and rateQuantity. The rateQuantity approach requires systems to have the capability to parse UCUM grammar where ml/hour is included rather than a specific ratio where the time is specified as the denominator. Where a rate such as 500ml over 2 hours is specified, the use of rateRatio may be more semantically correct than specifying using a rateQuantity of 250 mg/hour.
requirements:
  v: Identifies the speed with which the medication was or will be introduced into the patient. Typically the rate for an infusion e.g. 100 ml per 1 hour or 100 ml/hr. May also be expressed as a rate per unit of time e.g. 500 ml per 2 hours. Other examples: 200 mcg/min or 200 mcg/1 minute; 1 liter/8 hours. Sometimes, a rate can imply duration when expressed as total volume / duration (e.g. 500mL/2 hours implies a duration of 2 hours). However, when rate doesn't imply duration (e.g. 250mL/hour), then the timing.repeat.duration is needed to convey the infuse over time period. Element `Dosage.doseAndRate.rate[x]` is part of an existing definition because parent element `Dosage.doseAndRate` requires a cross-version extension. Element `Dosage.doseAndRate.rate[x]` is mapped to FHIR STU3 element `Dosage.rate[x]` as `Equivalent`. The target context `Dosage.rate[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:rate.url
path:
  v: Extension.extension.url
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
fixed: Uri
  v: rate
  l: rate

id:
  v: Extension.extension:rate.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Amount of medication per unit of time
definition:
  v: Amount of medication per unit of time.
comment:
  v: It is possible to supply both a rate and a doseQuantity to provide full details about how the medication is to be administered and supplied. If the rate is intended to change over time, depending on local rules/regulations, each change should be captured as a new version of the MedicationRequest with an updated rate, or captured with a new MedicationRequest with the new rate. It is possible to specify a rate over time (for example, 100 ml/hour) using either the rateRatio and rateQuantity. The rateQuantity approach requires systems to have the capability to parse UCUM grammar where ml/hour is included rather than a specific ratio where the time is specified as the denominator. Where a rate such as 500ml over 2 hours is specified, the use of rateRatio may be more semantically correct than specifying using a rateQuantity of 250 mg/hour.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Ratio
    l: Ratio
type:
  code:
    v: Range
    l: Range
type:
  code:
    v: Quantity
    l: Quantity
  profile:
    v: http://hl7.org/fhir/StructureDefinition/SimpleQuantity
    l: SimpleQuantity

id:
  v: Extension.url
path:
  v: Extension.url
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.url
  min:
    v: 1
  max:
    v: 1
fixed: Uri
  v: http://hl7.org/fhir/5.0/StructureDefinition/extension-Dosage.doseAndRate
  l: extension-Dosage.doseAndRate

id:
  v: Extension.value[x]
path:
  v: Extension.value[x]
min:
  v: 0
max:
  v: 0
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1