ext-R4B-MedicationRequest.dosageInstruction
type: StructureDefinition
node role: treeRoot
id:
  v: ext-R4B-MedicationRequest.dosageInstruction
text:
  status:
    v: extensions
  div:
    v: Generated Narrative: StructureDefinition ext-R4B-MedicationRequest.dosageInstruction Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> <a href="StructureDefinition-ext-R4B-MedicationRequest.dosageInstruction-definitions.html#Extension" title="R4B: `MedicationRequest.dosageInstruction` additional types (Dosage) additional types from child elements (additionalInstruction, asNeeded[x], doseAndRate, dose[x], rate[x], type, maxDosePerAdministration, maxDosePerLifetime, maxDosePerPeriod, method, patientInstruction, route, sequence, site, text, timing)">Extension 0..* Extension R4B: dosageInstruction additional types #xD; Slices for extension 0..* Extension Extension Slice: Unordered, Open by value:url #xD; extension:_datatype 1..1 Extension DataType slice for a FHIR R4B `Dosage` value #xD; url 1..1 uri "http://hl7.org/fhir/StructureDefinition/_datatype" #xD; value[x] 1..1 string Value of extension Fixed Value: Dosage #xD; extension:sequence 0..1 Extension R4B: sequence #xD; url 1..1 uri "sequence" #xD; value[x] 0..1 integer The order of the dosage instructions #xD; extension:text 0..1 Extension R4B: text #xD; url 1..1 uri "text" #xD; value[x] 0..1 string Free text dosage instructions e.g. SIG #xD; extension:additionalInstruction 0..* Extension R4B: Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness" #xD; url 1..1 uri "additionalInstruction" #xD; <a href="StructureDefinition-ext-R4B-MedicationRequest.dosageInstruction-definitions.html#Extension.extension:additionalInstruction.value[x]" title="Supplemental instructions to the patient on how to take the medication (e.g. "with meals" or"take half to one hour before food") or warnings for the patient about the medication (e.g. "may cause drowsiness" or "avoid exposure of skin to direct sunlight or sunlamps").">value[x] 0..1 CodeableConcept Supplemental instruction or warnings to the patient - e.g. "with meals", "may caus…
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-r4b.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-r4b.r3
      l: hl7.fhir.uv.xver-r4b.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-r4b.r3
        l: hl7.fhir.uv.xver-r4b.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-r4b.r3
        l: hl7.fhir.uv.xver-r4b.r3
url:
  v: http://hl7.org/fhir/4.3/StructureDefinition/extension-MedicationRequest.dosageInstruction
  l: extension-MedicationRequest.dosageInstruction
version:
  v: 0.1.0
name:
  v: ExtensionMedicationRequest_DosageInstruction
title:
  v: R4B: dosageInstruction additional types
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: R4B: `MedicationRequest.dosageInstruction` additional types (Dosage) additional types from child elements (additionalInstruction, asNeeded[x], doseAndRate, dose[x], rate[x], type, maxDosePerAdministration, maxDosePerLifetime, maxDosePerPeriod, method, patientInstruction, route, sequence, site, text, timing)
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 `MedicationRequest.dosageInstruction` as defined in FHIR R4B in FHIR STU3. The source element is defined as: `MedicationRequest.dosageInstruction` 0..* `Dosage` Across FHIR versions, the element set has been mapped as: * R4B: `MedicationRequest.dosageInstruction` 0..* `Dosage` * R4: `MedicationRequest.dosageInstruction` 0..* `Dosage` * STU3: `MedicationRequest.dosageInstruction` 0..* `Dosage` Following are the generation technical comments: Element `MedicationRequest.dosageInstruction` is mapped to FHIR STU3 element `MedicationRequest.dosageInstruction` as `SourceIsBroaderThanTarget`. The mappings for `MedicationRequest.dosageInstruction` do not cover the following types: Dosage. The mappings for `MedicationRequest.dosageInstruction` do not cover the following types based on type expansion: additionalInstruction, asNeeded[x], dose[x], doseAndRate, maxDosePerAdministration, maxDosePerLifetime, maxDosePerPeriod, method, patientInstruction, rate[x], route, sequence, site, text, timing, type.
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: resource
context:
  v: MedicationRequest.dosageInstruction
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: R4B: dosageInstruction additional types
    definition:
      v: R4B: `MedicationRequest.dosageInstruction` additional types (Dosage) additional types from child elements (additionalInstruction, asNeeded[x], doseAndRate, dose[x], rate[x], type, maxDosePerAdministration, maxDosePerLifetime, maxDosePerPeriod, method, patientInstruction, route, sequence, site, text, timing)
    comment:
      v: Element `MedicationRequest.dosageInstruction` is mapped to FHIR STU3 element `MedicationRequest.dosageInstruction` as `SourceIsBroaderThanTarget`. The mappings for `MedicationRequest.dosageInstruction` do not cover the following types: Dosage. The mappings for `MedicationRequest.dosageInstruction` do not cover the following types based on type expansion: additionalInstruction, asNeeded[x], dose[x], doseAndRate, maxDosePerAdministration, maxDosePerLifetime, maxDosePerPeriod, method, patientInstruction, rate[x], route, sequence, site, text, timing, type. There are examples where a medication request may include the option of an oral dose or an Intravenous or Intramuscular dose. For example, "Ondansetron 8mg orally or IV twice a day as needed for nausea" or "Compazine® (prochlorperazine) 5-10mg PO or 25mg PR bid prn nausea or vomiting". In these cases, two medication requests would be created that could be grouped together. The decision on which dose and route of administration to use is based on the patient's condition at the time the dose is needed.
    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:_datatype
path:
  v: Extension.extension
slice name:
  v: _datatype
short:
  v: DataType slice for a FHIR R4B `Dosage` value
definition:
  v: Slice to indicate the presence of a R4B `Dosage` in FHIR STU3
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension

id:
  v: Extension.extension:_datatype.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:_datatype.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:_datatype.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: http://hl7.org/fhir/StructureDefinition/_datatype
  l: datatype
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:_datatype.value[x]
path:
  v: Extension.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).
comment:
  v: Must be: Dosage
min:
  v: 1
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string
fixed: String
  v: Dosage
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:sequence
path:
  v: Extension.extension
slice name:
  v: sequence
short:
  v: R4B: sequence
definition:
  v: R4B: `Dosage.sequence`
comment:
  v: Element `Dosage.sequence` is mapped to FHIR STU3 element `Dosage.sequence` as `Equivalent`.
requirements:
  v: If the sequence number of multiple Dosages is the same, then it is implied that the instructions are to be treated as concurrent. If the sequence number is different, then the Dosages are intended to be sequential. Element `Dosage.sequence` is mapped to FHIR STU3 element `Dosage.sequence` as `Equivalent`.
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:sequence.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:sequence.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:sequence.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: sequence
  l: sequence
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:sequence.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: The order of the dosage instructions
definition:
  v: Indicates the order in which the dosage instructions should be applied or interpreted.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:text
path:
  v: Extension.extension
slice name:
  v: text
short:
  v: R4B: text
definition:
  v: R4B: `Dosage.text`
comment:
  v: Element `Dosage.text` is mapped to FHIR STU3 element `Dosage.text` as `Equivalent`.
requirements:
  v: Free text dosage instructions can be used for cases where the instructions are too complex to code. The content of this attribute does not include the name or description of the medication. When coded instructions are present, the free text instructions may still be present for display to humans taking or administering the medication. It is expected that the text instructions will always be populated. If the dosage.timing attribute is also populated, then the dosage.text should reflect the same information as the timing. Additional information about administration or preparation of the medication should be included as text. Element `Dosage.text` is mapped to FHIR STU3 element `Dosage.text` as `Equivalent`.
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:text.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:text.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:text.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: text
  l: text
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:text.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Free text dosage instructions e.g. SIG
definition:
  v: Free text dosage instructions e.g. SIG.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:additionalInstruction
path:
  v: Extension.extension
slice name:
  v: additionalInstruction
short:
  v: R4B: Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness"
definition:
  v: R4B: `Dosage.additionalInstruction`
comment:
  v: Element `Dosage.additionalInstruction` is mapped to FHIR STU3 element `Dosage.additionalInstruction` as `Equivalent`. Information about administration or preparation of the medication (e.g. "infuse as rapidly as possibly via intraperitoneal port" or "immediately following drug x") should be populated in dosage.text.
requirements:
  v: Additional instruction is intended to be coded, but where no code exists, the element could include text. For example, "Swallow with plenty of water" which might or might not be coded. Element `Dosage.additionalInstruction` is mapped to FHIR STU3 element `Dosage.additionalInstruction` as `Equivalent`.
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:additionalInstruction.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:additionalInstruction.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:additionalInstruction.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: additionalInstruction
  l: additionalInstruction
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:additionalInstruction.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness"
definition:
  v: Supplemental instructions to the patient on how to take the medication (e.g. "with meals" or"take half to one hour before food") or warnings for the patient about the medication (e.g. "may cause drowsiness" or "avoid exposure of skin to direct sunlight or sunlamps").
comment:
  v: Information about administration or preparation of the medication (e.g. "infuse as rapidly as possibly via intraperitoneal port" or "immediately following drug x") should be populated in dosage.text.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:patientInstruction
path:
  v: Extension.extension
slice name:
  v: patientInstruction
short:
  v: R4B: patientInstruction
definition:
  v: R4B: `Dosage.patientInstruction`
comment:
  v: Element `Dosage.patientInstruction` is mapped to FHIR STU3 element `Dosage.patientInstruction` as `Equivalent`.
requirements:
  v: Element `Dosage.patientInstruction` is mapped to FHIR STU3 element `Dosage.patientInstruction` as `Equivalent`.
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:patientInstruction.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:patientInstruction.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:patientInstruction.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: patientInstruction
  l: patientInstruction
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:patientInstruction.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Patient or consumer oriented instructions
definition:
  v: Instructions in terms that are understood by the patient or consumer.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:timing
path:
  v: Extension.extension
slice name:
  v: timing
short:
  v: R4B: timing additional types
definition:
  v: R4B: `Dosage.timing` additional types (Timing) additional types from child elements (code, event, repeat, bounds[x], count, countMax, dayOfWeek, duration, durationMax, durationUnit, frequency, frequencyMax, offset, period, periodMax, periodUnit, timeOfDay, when)
comment:
  v: Element `Dosage.timing` is mapped to FHIR STU3 element `Dosage.timing` as `SourceIsBroaderThanTarget`. The mappings for `Dosage.timing` do not cover the following types: Timing. The mappings for `Dosage.timing` do not cover the following types based on type expansion: bounds[x], code, count, countMax, dayOfWeek, duration, durationMax, durationUnit, event, frequency, frequencyMax, offset, period, periodMax, periodUnit, repeat, timeOfDay, when. This attribute might not always be populated while the Dosage.text is expected to be populated. If both are populated, then the Dosage.text should reflect the content of the Dosage.timing.
requirements:
  v: The timing schedule for giving the medication to the patient. This data type allows many different expressions. For example: "Every 8 hours"; "Three times a day"; "1/2 an hour before breakfast for 10 days from 23-Dec 2011:"; "15 Oct 2013, 17 Oct 2013 and 1 Nov 2013". 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.timing` is mapped to FHIR STU3 element `Dosage.timing` as `SourceIsBroaderThanTarget`. The mappings for `Dosage.timing` do not cover the following types: Timing. The mappings for `Dosage.timing` do not cover the following types based on type expansion: bounds[x], code, count, countMax, dayOfWeek, duration, durationMax, durationUnit, event, frequency, frequencyMax, offset, period, periodMax, periodUnit, repeat, timeOfDay, when.
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:timing.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:timing.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:timing.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: timing
  l: timing
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:timing.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: When medication should be administered
definition:
  v: When medication should be administered.
comment:
  v: This attribute might not always be populated while the Dosage.text is expected to be populated. If both are populated, then the Dosage.text should reflect the content of the Dosage.timing.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Timing
    l: Timing
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:asNeeded
path:
  v: Extension.extension
slice name:
  v: asNeeded
short:
  v: R4B: asNeeded
definition:
  v: R4B: `Dosage.asNeeded[x]`
comment:
  v: Element `Dosage.asNeeded[x]` is mapped to FHIR STU3 element `Dosage.asNeeded[x]` as `Equivalent`. The target context `Dosage.asNeeded[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`. Can express "as needed" without a reason by setting the Boolean = True. In this case the CodeableConcept is not populated. Or you can express "as needed" with a reason by including the CodeableConcept. In this case the Boolean is assumed to be True. If you set the Boolean to False, then the dose is given according to the schedule and is not "prn" or "as needed".
requirements:
  v: Element `Dosage.asNeeded[x]` is mapped to FHIR STU3 element `Dosage.asNeeded[x]` as `Equivalent`. The target context `Dosage.asNeeded[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:asNeeded.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:asNeeded.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:asNeeded.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: asNeeded
  l: asNeeded
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:asNeeded.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Take "as needed" (for x)
definition:
  v: Indicates whether the Medication is only taken when needed within a specific dosing schedule (Boolean option), or it indicates the precondition for taking the Medication (CodeableConcept).
comment:
  v: Can express "as needed" without a reason by setting the Boolean = True. In this case the CodeableConcept is not populated. Or you can express "as needed" with a reason by including the CodeableConcept. In this case the Boolean is assumed to be True. If you set the Boolean to False, then the dose is given according to the schedule and is not "prn" or "as needed".
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: boolean
    l: boolean
type:
  code:
    v: CodeableConcept
    l: CodeableConcept
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:site
path:
  v: Extension.extension
slice name:
  v: site
short:
  v: R4B: site
definition:
  v: R4B: `Dosage.site`
comment:
  v: Element `Dosage.site` is mapped to FHIR STU3 element `Dosage.site` as `Equivalent`. If the use case requires attributes from the BodySite resource (e.g. to identify and track separately) then use the standard extension [bodySite](https://hl7.org/fhir/extension-bodysite.html). May be a summary code, or a reference to a very precise definition of the location, or both.
requirements:
  v: A coded specification of the anatomic site where the medication first enters the body. Element `Dosage.site` is mapped to FHIR STU3 element `Dosage.site` as `Equivalent`.
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:site.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:site.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:site.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: site
  l: site
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:site.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Body site to administer to
definition:
  v: Body site to administer to.
comment:
  v: If the use case requires attributes from the BodySite resource (e.g. to identify and track separately) then use the standard extension [bodySite](https://hl7.org/fhir/extension-bodysite.html). May be a summary code, or a reference to a very precise definition of the location, or both.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:route
path:
  v: Extension.extension
slice name:
  v: route
short:
  v: R4B: route
definition:
  v: R4B: `Dosage.route`
comment:
  v: Element `Dosage.route` is mapped to FHIR STU3 element `Dosage.route` as `Equivalent`.
requirements:
  v: A code specifying the route or physiological path of administration of a therapeutic agent into or onto a patient's body. Element `Dosage.route` is mapped to FHIR STU3 element `Dosage.route` as `Equivalent`.
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:route.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:route.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:route.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: route
  l: route
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:route.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: How drug should enter body
definition:
  v: How drug should enter body.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:method
path:
  v: Extension.extension
slice name:
  v: method
short:
  v: R4B: method
definition:
  v: R4B: `Dosage.method`
comment:
  v: Element `Dosage.method` is mapped to FHIR STU3 element `Dosage.method` as `Equivalent`. Terminologies used often pre-coordinate this term with the route and or form of administration.
requirements:
  v: A coded value indicating the method by which the medication is introduced into or onto the body. Most commonly used for injections. For examples, Slow Push; Deep IV. Element `Dosage.method` is mapped to FHIR STU3 element `Dosage.method` as `Equivalent`.
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:method.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:method.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:method.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: method
  l: method
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:method.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Technique for administering medication
definition:
  v: Technique for administering medication.
comment:
  v: Terminologies used often pre-coordinate this term with the route and or form of administration.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:doseAndRate
path:
  v: Extension.extension
slice name:
  v: doseAndRate
short:
  v: R4B: Amount of medication administered (new)
definition:
  v: R4B: `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).
requirements:
  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: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension

id:
  v: Extension.extension:doseAndRate.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:doseAndRate.extension
path:
  v: Extension.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:doseAndRate.extension:type
path:
  v: Extension.extension.extension
slice name:
  v: type
short:
  v: R4B: The kind of dose or rate specified (new)
definition:
  v: R4B: `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:doseAndRate.extension:type.id
path:
  v: Extension.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:doseAndRate.extension:type.extension
path:
  v: Extension.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:doseAndRate.extension:type.url
path:
  v: Extension.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:doseAndRate.extension:type.value[x]
path:
  v: Extension.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
  value set: Uri
    v: http://hl7.org/fhir/uv/xver/ValueSet/R4B-dose-rate-type-for-R3|0.1.0
    l: http://hl7.org/fhir/uv/xver/ValueSet/R4B-dose-rate-type-for-R3
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:doseAndRate.extension:dose
path:
  v: Extension.extension.extension
slice name:
  v: dose
short:
  v: R4B: dose
definition:
  v: R4B: `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 `SourceIsBroaderThanTarget`. 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 `SourceIsBroaderThanTarget`. 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:doseAndRate.extension:dose.id
path:
  v: Extension.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:doseAndRate.extension:dose.extension
path:
  v: Extension.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:doseAndRate.extension:dose.url
path:
  v: Extension.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:doseAndRate.extension:dose.value[x]
path:
  v: Extension.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:doseAndRate.extension:rate
path:
  v: Extension.extension.extension
slice name:
  v: rate
short:
  v: R4B: rate additional types
definition:
  v: R4B: `Dosage.doseAndRate.rate[x]` additional types (Ratio, Range)
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 `SourceIsBroaderThanTarget`. The mappings for `Dosage.doseAndRate.rate[x]` do not cover the following types: Range, Ratio. 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 grammer 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 `SourceIsBroaderThanTarget`. The mappings for `Dosage.doseAndRate.rate[x]` do not cover the following types: Range, Ratio. 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:doseAndRate.extension:rate.id
path:
  v: Extension.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:doseAndRate.extension:rate.extension
path:
  v: Extension.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:doseAndRate.extension:rate.url
path:
  v: Extension.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:doseAndRate.extension:rate.value[x]
path:
  v: Extension.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 grammer 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
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:doseAndRate.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: doseAndRate
  l: doseAndRate
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:doseAndRate.value[x]
path:
  v: Extension.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

id:
  v: Extension.extension:maxDosePerPeriod
path:
  v: Extension.extension
slice name:
  v: maxDosePerPeriod
short:
  v: R4B: maxDosePerPeriod additional types
definition:
  v: R4B: `Dosage.maxDosePerPeriod` additional types (Ratio) additional types from child elements (denominator, numerator)
comment:
  v: Element `Dosage.maxDosePerPeriod` is mapped to FHIR STU3 element `Dosage.maxDosePerPeriod` as `SourceIsBroaderThanTarget`. The mappings for `Dosage.maxDosePerPeriod` do not cover the following types: Ratio. The mappings for `Dosage.maxDosePerPeriod` do not cover the following types based on type expansion: denominator, numerator. This is intended for use as an adjunct to the dosage when there is an upper cap. For example "2 tablets every 4 hours to a maximum of 8/day".
requirements:
  v: The maximum total quantity of a therapeutic substance that may be administered to a subject over the period of time. For example, 1000mg in 24 hours. Element `Dosage.maxDosePerPeriod` is mapped to FHIR STU3 element `Dosage.maxDosePerPeriod` as `SourceIsBroaderThanTarget`. The mappings for `Dosage.maxDosePerPeriod` do not cover the following types: Ratio. The mappings for `Dosage.maxDosePerPeriod` do not cover the following types based on type expansion: denominator, numerator.
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:maxDosePerPeriod.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:maxDosePerPeriod.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:maxDosePerPeriod.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: maxDosePerPeriod
  l: maxDosePerPeriod
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:maxDosePerPeriod.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Upper limit on medication per unit of time
definition:
  v: Upper limit on medication per unit of time.
comment:
  v: This is intended for use as an adjunct to the dosage when there is an upper cap. For example "2 tablets every 4 hours to a maximum of 8/day".
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Ratio
    l: Ratio
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:maxDosePerAdministration
path:
  v: Extension.extension
slice name:
  v: maxDosePerAdministration
short:
  v: R4B: maxDosePerAdministration
definition:
  v: R4B: `Dosage.maxDosePerAdministration`
comment:
  v: Element `Dosage.maxDosePerAdministration` is mapped to FHIR STU3 element `Dosage.maxDosePerAdministration` as `Equivalent`. This is intended for use as an adjunct to the dosage when there is an upper cap. For example, a body surface area related dose with a maximum amount, such as 1.5 mg/m2 (maximum 2 mg) IV over 5 – 10 minutes would have doseQuantity of 1.5 mg/m2 and maxDosePerAdministration of 2 mg.
requirements:
  v: The maximum total quantity of a therapeutic substance that may be administered to a subject per administration. Element `Dosage.maxDosePerAdministration` is mapped to FHIR STU3 element `Dosage.maxDosePerAdministration` as `Equivalent`.
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:maxDosePerAdministration.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:maxDosePerAdministration.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:maxDosePerAdministration.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: maxDosePerAdministration
  l: maxDosePerAdministration
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:maxDosePerAdministration.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Upper limit on medication per administration
definition:
  v: Upper limit on medication per administration.
comment:
  v: This is intended for use as an adjunct to the dosage when there is an upper cap. For example, a body surface area related dose with a maximum amount, such as 1.5 mg/m2 (maximum 2 mg) IV over 5 – 10 minutes would have doseQuantity of 1.5 mg/m2 and maxDosePerAdministration of 2 mg.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
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:maxDosePerLifetime
path:
  v: Extension.extension
slice name:
  v: maxDosePerLifetime
short:
  v: R4B: maxDosePerLifetime
definition:
  v: R4B: `Dosage.maxDosePerLifetime`
comment:
  v: Element `Dosage.maxDosePerLifetime` is mapped to FHIR STU3 element `Dosage.maxDosePerLifetime` as `Equivalent`.
requirements:
  v: The maximum total quantity of a therapeutic substance that may be administered per lifetime of the subject. Element `Dosage.maxDosePerLifetime` is mapped to FHIR STU3 element `Dosage.maxDosePerLifetime` as `Equivalent`.
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:maxDosePerLifetime.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:maxDosePerLifetime.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:maxDosePerLifetime.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: maxDosePerLifetime
  l: maxDosePerLifetime
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: Extension.extension:maxDosePerLifetime.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Upper limit on medication per lifetime of the patient
definition:
  v: Upper limit on medication per lifetime of the patient.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
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/4.3/StructureDefinition/extension-MedicationRequest.dosageInstruction
  l: extension-MedicationRequest.dosageInstruction
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: R4B: dosageInstruction additional types
  definition:
    v: R4B: `MedicationRequest.dosageInstruction` additional types (Dosage) additional types from child elements (additionalInstruction, asNeeded[x], doseAndRate, dose[x], rate[x], type, maxDosePerAdministration, maxDosePerLifetime, maxDosePerPeriod, method, patientInstruction, route, sequence, site, text, timing)
  comment:
    v: Element `MedicationRequest.dosageInstruction` is mapped to FHIR STU3 element `MedicationRequest.dosageInstruction` as `SourceIsBroaderThanTarget`. The mappings for `MedicationRequest.dosageInstruction` do not cover the following types: Dosage. The mappings for `MedicationRequest.dosageInstruction` do not cover the following types based on type expansion: additionalInstruction, asNeeded[x], dose[x], doseAndRate, maxDosePerAdministration, maxDosePerLifetime, maxDosePerPeriod, method, patientInstruction, rate[x], route, sequence, site, text, timing, type. There are examples where a medication request may include the option of an oral dose or an Intravenous or Intramuscular dose. For example, "Ondansetron 8mg orally or IV twice a day as needed for nausea" or "Compazine® (prochlorperazine) 5-10mg PO or 25mg PR bid prn nausea or vomiting". In these cases, two medication requests would be created that could be grouped together. The decision on which dose and route of administration to use is based on the patient's condition at the time the dose is needed.
  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:_datatype
  path:
    v: Extension.extension
  slice name:
    v: _datatype
  short:
    v: DataType slice for a FHIR R4B `Dosage` value
  definition:
    v: Slice to indicate the presence of a R4B `Dosage` in FHIR STU3
  min:
    v: 1
  max:
    v: 1
  base:
    path:
      v: Extension.extension
    min:
      v: 0
    max:
      v: *
element:
  id:
    v: Extension.extension:_datatype.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: http://hl7.org/fhir/StructureDefinition/_datatype
    l: datatype
element:
  id:
    v: Extension.extension:_datatype.value[x]
  path:
    v: Extension.extension.value[x]
  comment:
    v: Must be: Dosage
  min:
    v: 1
  max:
    v: 1
  base:
    path:
      v: Extension.value[x]
    min:
      v: 0
    max:
      v: 1
  type:
    code:
      v: string
      l: string
  fixed: String
    v: Dosage
element:
  id:
    v: Extension.extension:sequence
  path:
    v: Extension.extension
  slice name:
    v: sequence
  short:
    v: R4B: sequence
  definition:
    v: R4B: `Dosage.sequence`
  comment:
    v: Element `Dosage.sequence` is mapped to FHIR STU3 element `Dosage.sequence` as `Equivalent`.
  requirements:
    v: If the sequence number of multiple Dosages is the same, then it is implied that the instructions are to be treated as concurrent. If the sequence number is different, then the Dosages are intended to be sequential. Element `Dosage.sequence` is mapped to FHIR STU3 element `Dosage.sequence` as `Equivalent`.
  min:
    v: 0
  max:
    v: 1
  base:
    path:
      v: Extension.extension
    min:
      v: 0
    max:
      v: *
element:
  id:
    v: Extension.extension:sequence.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: sequence
    l: sequence
element:
  id:
    v: Extension.extension:sequence.value[x]
  path:
    v: Extension.extension.value[x]
  short:
    v: The order of the dosage instructions
  definition:
    v: Indicates the order in which the dosage instructions should be applied or interpreted.
  min:
    v: 0
  max:
    v: 1
  base:
    path:
      v: Extension.value[x]
    min:
      v: 0
    max:
      v: 1
  type:
    code:
      v: integer
      l: integer
element:
  id:
    v: Extension.extension:text
  path:
    v: Extension.extension
  slice name:
    v: text
  short:
    v: R4B: text
  definition:
    v: R4B: `Dosage.text`
  comment:
    v: Element `Dosage.text` is mapped to FHIR STU3 element `Dosage.text` as `Equivalent`.
  requirements:
    v: Free text dosage instructions can be used for cases where the instructions are too complex to code. The content of this attribute does not include the name or description of the medication. When coded instructions are present, the free text instructions may still be present for display to humans taking or administering the medication. It is expected that the text instructions will always be populated. If the dosage.timing attribute is also populated, then the dosage.text should reflect the same information as the timing. Additional information about administration or preparation of the medication should be included as text. Element `Dosage.text` is mapped to FHIR STU3 element `Dosage.text` as `Equivalent`.
  min:
    v: 0

v: 1

path:
  v: Extension.extension
min:
  v: 0
max:
  v: *

id:
  v: Extension.extension:text.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: text
  l: text

id:
  v: Extension.extension:text.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Free text dosage instructions e.g. SIG
definition:
  v: Free text dosage instructions e.g. SIG.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: Extension.extension:additionalInstruction
path:
  v: Extension.extension
slice name:
  v: additionalInstruction
short:
  v: R4B: Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness"
definition:
  v: R4B: `Dosage.additionalInstruction`
comment:
  v: Element `Dosage.additionalInstruction` is mapped to FHIR STU3 element `Dosage.additionalInstruction` as `Equivalent`. Information about administration or preparation of the medication (e.g. "infuse as rapidly as possibly via intraperitoneal port" or "immediately following drug x") should be populated in dosage.text.
requirements:
  v: Additional instruction is intended to be coded, but where no code exists, the element could include text. For example, "Swallow with plenty of water" which might or might not be coded. Element `Dosage.additionalInstruction` is mapped to FHIR STU3 element `Dosage.additionalInstruction` as `Equivalent`.
min:
  v: 0
max:
  v: *
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:additionalInstruction.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: additionalInstruction
  l: additionalInstruction

id:
  v: Extension.extension:additionalInstruction.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness"
definition:
  v: Supplemental instructions to the patient on how to take the medication (e.g. "with meals" or"take half to one hour before food") or warnings for the patient about the medication (e.g. "may cause drowsiness" or "avoid exposure of skin to direct sunlight or sunlamps").
comment:
  v: Information about administration or preparation of the medication (e.g. "infuse as rapidly as possibly via intraperitoneal port" or "immediately following drug x") should be populated in dosage.text.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept

id:
  v: Extension.extension:patientInstruction
path:
  v: Extension.extension
slice name:
  v: patientInstruction
short:
  v: R4B: patientInstruction
definition:
  v: R4B: `Dosage.patientInstruction`
comment:
  v: Element `Dosage.patientInstruction` is mapped to FHIR STU3 element `Dosage.patientInstruction` as `Equivalent`.
requirements:
  v: Element `Dosage.patientInstruction` is mapped to FHIR STU3 element `Dosage.patientInstruction` as `Equivalent`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:patientInstruction.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: patientInstruction
  l: patientInstruction

id:
  v: Extension.extension:patientInstruction.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Patient or consumer oriented instructions
definition:
  v: Instructions in terms that are understood by the patient or consumer.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: string
    l: string

id:
  v: Extension.extension:timing
path:
  v: Extension.extension
slice name:
  v: timing
short:
  v: R4B: timing additional types
definition:
  v: R4B: `Dosage.timing` additional types (Timing) additional types from child elements (code, event, repeat, bounds[x], count, countMax, dayOfWeek, duration, durationMax, durationUnit, frequency, frequencyMax, offset, period, periodMax, periodUnit, timeOfDay, when)
comment:
  v: Element `Dosage.timing` is mapped to FHIR STU3 element `Dosage.timing` as `SourceIsBroaderThanTarget`. The mappings for `Dosage.timing` do not cover the following types: Timing. The mappings for `Dosage.timing` do not cover the following types based on type expansion: bounds[x], code, count, countMax, dayOfWeek, duration, durationMax, durationUnit, event, frequency, frequencyMax, offset, period, periodMax, periodUnit, repeat, timeOfDay, when. This attribute might not always be populated while the Dosage.text is expected to be populated. If both are populated, then the Dosage.text should reflect the content of the Dosage.timing.
requirements:
  v: The timing schedule for giving the medication to the patient. This data type allows many different expressions. For example: "Every 8 hours"; "Three times a day"; "1/2 an hour before breakfast for 10 days from 23-Dec 2011:"; "15 Oct 2013, 17 Oct 2013 and 1 Nov 2013". 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.timing` is mapped to FHIR STU3 element `Dosage.timing` as `SourceIsBroaderThanTarget`. The mappings for `Dosage.timing` do not cover the following types: Timing. The mappings for `Dosage.timing` do not cover the following types based on type expansion: bounds[x], code, count, countMax, dayOfWeek, duration, durationMax, durationUnit, event, frequency, frequencyMax, offset, period, periodMax, periodUnit, repeat, timeOfDay, when.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:timing.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: timing
  l: timing

id:
  v: Extension.extension:timing.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: When medication should be administered
definition:
  v: When medication should be administered.
comment:
  v: This attribute might not always be populated while the Dosage.text is expected to be populated. If both are populated, then the Dosage.text should reflect the content of the Dosage.timing.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Timing
    l: Timing

id:
  v: Extension.extension:asNeeded
path:
  v: Extension.extension
slice name:
  v: asNeeded
short:
  v: R4B: asNeeded
definition:
  v: R4B: `Dosage.asNeeded[x]`
comment:
  v: Element `Dosage.asNeeded[x]` is mapped to FHIR STU3 element `Dosage.asNeeded[x]` as `Equivalent`. The target context `Dosage.asNeeded[x]` is a choice-type element and cannot directly hold extensions. The context is moved up to parent element `Dosage`. Can express "as needed" without a reason by setting the Boolean = True. In this case the CodeableConcept is not populated. Or you can express "as needed" with a reason by including the CodeableConcept. In this case the Boolean is assumed to be True. If you set the Boolean to False, then the dose is given according to the schedule and is not "prn" or "as needed".
requirements:
  v: Element `Dosage.asNeeded[x]` is mapped to FHIR STU3 element `Dosage.asNeeded[x]` as `Equivalent`. The target context `Dosage.asNeeded[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:asNeeded.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: asNeeded
  l: asNeeded

id:
  v: Extension.extension:asNeeded.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Take "as needed" (for x)
definition:
  v: Indicates whether the Medication is only taken when needed within a specific dosing schedule (Boolean option), or it indicates the precondition for taking the Medication (CodeableConcept).
comment:
  v: Can express "as needed" without a reason by setting the Boolean = True. In this case the CodeableConcept is not populated. Or you can express "as needed" with a reason by including the CodeableConcept. In this case the Boolean is assumed to be True. If you set the Boolean to False, then the dose is given according to the schedule and is not "prn" or "as needed".
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: boolean
    l: boolean
type:
  code:
    v: CodeableConcept
    l: CodeableConcept

id:
  v: Extension.extension:site
path:
  v: Extension.extension
slice name:
  v: site
short:
  v: R4B: site
definition:
  v: R4B: `Dosage.site`
comment:
  v: Element `Dosage.site` is mapped to FHIR STU3 element `Dosage.site` as `Equivalent`. If the use case requires attributes from the BodySite resource (e.g. to identify and track separately) then use the standard extension [bodySite](https://hl7.org/fhir/extension-bodysite.html). May be a summary code, or a reference to a very precise definition of the location, or both.
requirements:
  v: A coded specification of the anatomic site where the medication first enters the body. Element `Dosage.site` is mapped to FHIR STU3 element `Dosage.site` as `Equivalent`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:site.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: site
  l: site

id:
  v: Extension.extension:site.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Body site to administer to
definition:
  v: Body site to administer to.
comment:
  v: If the use case requires attributes from the BodySite resource (e.g. to identify and track separately) then use the standard extension [bodySite](https://hl7.org/fhir/extension-bodysite.html). May be a summary code, or a reference to a very precise definition of the location, or both.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept

id:
  v: Extension.extension:route
path:
  v: Extension.extension
slice name:
  v: route
short:
  v: R4B: route
definition:
  v: R4B: `Dosage.route`
comment:
  v: Element `Dosage.route` is mapped to FHIR STU3 element `Dosage.route` as `Equivalent`.
requirements:
  v: A code specifying the route or physiological path of administration of a therapeutic agent into or onto a patient's body. Element `Dosage.route` is mapped to FHIR STU3 element `Dosage.route` as `Equivalent`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:route.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: route
  l: route

id:
  v: Extension.extension:route.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: How drug should enter body
definition:
  v: How drug should enter body.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept

id:
  v: Extension.extension:method
path:
  v: Extension.extension
slice name:
  v: method
short:
  v: R4B: method
definition:
  v: R4B: `Dosage.method`
comment:
  v: Element `Dosage.method` is mapped to FHIR STU3 element `Dosage.method` as `Equivalent`. Terminologies used often pre-coordinate this term with the route and or form of administration.
requirements:
  v: A coded value indicating the method by which the medication is introduced into or onto the body. Most commonly used for injections. For examples, Slow Push; Deep IV. Element `Dosage.method` is mapped to FHIR STU3 element `Dosage.method` as `Equivalent`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:method.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: method
  l: method

id:
  v: Extension.extension:method.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Technique for administering medication
definition:
  v: Technique for administering medication.
comment:
  v: Terminologies used often pre-coordinate this term with the route and or form of administration.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: CodeableConcept
    l: CodeableConcept

id:
  v: Extension.extension:doseAndRate
path:
  v: Extension.extension
slice name:
  v: doseAndRate
short:
  v: R4B: Amount of medication administered (new)
definition:
  v: R4B: `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).
requirements:
  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.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:doseAndRate.extension
path:
  v: Extension.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: *

id:
  v: Extension.extension:doseAndRate.extension:type
path:
  v: Extension.extension.extension
slice name:
  v: type
short:
  v: R4B: The kind of dose or rate specified (new)
definition:
  v: R4B: `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: *

id:
  v: Extension.extension:doseAndRate.extension:type.url
path:
  v: Extension.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

id:
  v: Extension.extension:doseAndRate.extension:type.value[x]
path:
  v: Extension.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
  value set: Uri
    v: http://hl7.org/fhir/uv/xver/ValueSet/R4B-dose-rate-type-for-R3|0.1.0
    l: http://hl7.org/fhir/uv/xver/ValueSet/R4B-dose-rate-type-for-R3

id:
  v: Extension.extension:doseAndRate.extension:dose
path:
  v: Extension.extension.extension
slice name:
  v: dose
short:
  v: R4B: dose
definition:
  v: R4B: `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 `SourceIsBroaderThanTarget`. 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 `SourceIsBroaderThanTarget`. 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: *

id:
  v: Extension.extension:doseAndRate.extension:dose.url
path:
  v: Extension.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

id:
  v: Extension.extension:doseAndRate.extension:dose.value[x]
path:
  v: Extension.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

id:
  v: Extension.extension:doseAndRate.extension:rate
path:
  v: Extension.extension.extension
slice name:
  v: rate
short:
  v: R4B: rate additional types
definition:
  v: R4B: `Dosage.doseAndRate.rate[x]` additional types (Ratio, Range)
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 `SourceIsBroaderThanTarget`. The mappings for `Dosage.doseAndRate.rate[x]` do not cover the following types: Range, Ratio. 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 grammer 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 `SourceIsBroaderThanTarget`. The mappings for `Dosage.doseAndRate.rate[x]` do not cover the following types: Range, Ratio. 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:doseAndRate.extension:rate.url
path:
  v: Extension.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:doseAndRate.extension:rate.value[x]
path:
  v: Extension.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 grammer 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

id:
  v: Extension.extension:doseAndRate.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: doseAndRate
  l: doseAndRate

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

id:
  v: Extension.extension:maxDosePerPeriod
path:
  v: Extension.extension
slice name:
  v: maxDosePerPeriod
short:
  v: R4B: maxDosePerPeriod additional types
definition:
  v: R4B: `Dosage.maxDosePerPeriod` additional types (Ratio) additional types from child elements (denominator, numerator)
comment:
  v: Element `Dosage.maxDosePerPeriod` is mapped to FHIR STU3 element `Dosage.maxDosePerPeriod` as `SourceIsBroaderThanTarget`. The mappings for `Dosage.maxDosePerPeriod` do not cover the following types: Ratio. The mappings for `Dosage.maxDosePerPeriod` do not cover the following types based on type expansion: denominator, numerator. This is intended for use as an adjunct to the dosage when there is an upper cap. For example "2 tablets every 4 hours to a maximum of 8/day".
requirements:
  v: The maximum total quantity of a therapeutic substance that may be administered to a subject over the period of time. For example, 1000mg in 24 hours. Element `Dosage.maxDosePerPeriod` is mapped to FHIR STU3 element `Dosage.maxDosePerPeriod` as `SourceIsBroaderThanTarget`. The mappings for `Dosage.maxDosePerPeriod` do not cover the following types: Ratio. The mappings for `Dosage.maxDosePerPeriod` do not cover the following types based on type expansion: denominator, numerator.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:maxDosePerPeriod.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: maxDosePerPeriod
  l: maxDosePerPeriod

id:
  v: Extension.extension:maxDosePerPeriod.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Upper limit on medication per unit of time
definition:
  v: Upper limit on medication per unit of time.
comment:
  v: This is intended for use as an adjunct to the dosage when there is an upper cap. For example "2 tablets every 4 hours to a maximum of 8/day".
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Ratio
    l: Ratio

id:
  v: Extension.extension:maxDosePerAdministration
path:
  v: Extension.extension
slice name:
  v: maxDosePerAdministration
short:
  v: R4B: maxDosePerAdministration
definition:
  v: R4B: `Dosage.maxDosePerAdministration`
comment:
  v: Element `Dosage.maxDosePerAdministration` is mapped to FHIR STU3 element `Dosage.maxDosePerAdministration` as `Equivalent`. This is intended for use as an adjunct to the dosage when there is an upper cap. For example, a body surface area related dose with a maximum amount, such as 1.5 mg/m2 (maximum 2 mg) IV over 5 – 10 minutes would have doseQuantity of 1.5 mg/m2 and maxDosePerAdministration of 2 mg.
requirements:
  v: The maximum total quantity of a therapeutic substance that may be administered to a subject per administration. Element `Dosage.maxDosePerAdministration` is mapped to FHIR STU3 element `Dosage.maxDosePerAdministration` as `Equivalent`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:maxDosePerAdministration.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: maxDosePerAdministration
  l: maxDosePerAdministration

id:
  v: Extension.extension:maxDosePerAdministration.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Upper limit on medication per administration
definition:
  v: Upper limit on medication per administration.
comment:
  v: This is intended for use as an adjunct to the dosage when there is an upper cap. For example, a body surface area related dose with a maximum amount, such as 1.5 mg/m2 (maximum 2 mg) IV over 5 – 10 minutes would have doseQuantity of 1.5 mg/m2 and maxDosePerAdministration of 2 mg.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: Quantity
    l: Quantity
  profile:
    v: http://hl7.org/fhir/StructureDefinition/SimpleQuantity
    l: SimpleQuantity

id:
  v: Extension.extension:maxDosePerLifetime
path:
  v: Extension.extension
slice name:
  v: maxDosePerLifetime
short:
  v: R4B: maxDosePerLifetime
definition:
  v: R4B: `Dosage.maxDosePerLifetime`
comment:
  v: Element `Dosage.maxDosePerLifetime` is mapped to FHIR STU3 element `Dosage.maxDosePerLifetime` as `Equivalent`.
requirements:
  v: The maximum total quantity of a therapeutic substance that may be administered per lifetime of the subject. Element `Dosage.maxDosePerLifetime` is mapped to FHIR STU3 element `Dosage.maxDosePerLifetime` as `Equivalent`.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.extension
  min:
    v: 0
  max:
    v: *

id:
  v: Extension.extension:maxDosePerLifetime.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: maxDosePerLifetime
  l: maxDosePerLifetime

id:
  v: Extension.extension:maxDosePerLifetime.value[x]
path:
  v: Extension.extension.value[x]
short:
  v: Upper limit on medication per lifetime of the patient
definition:
  v: Upper limit on medication per lifetime of the patient.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Extension.value[x]
  min:
    v: 0
  max:
    v: 1
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/4.3/StructureDefinition/extension-MedicationRequest.dosageInstruction
  l: extension-MedicationRequest.dosageInstruction

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