MyHealth@Eu Hospital Discharge Report
9.1.1 - qa-preview 150

MyHealth@Eu Hospital Discharge Report - Local Development build (v9.1.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## Data Type Profile: Dosage: HDR

Official URL: http://fhir.ehdsi.eu/hdr/StructureDefinition/dosage-hdr-myhealtheu | Version: 9.1.1
Standards status: Draft | Maturity Level: 1 | Computable Name: DosageHdrMyHealthEu

This profile constrains the Dosage datatype for the purpose of this guide.

Usages:

- Use this DataType Profile: MedicationDispense: HDR and MedicationRequest: HDR

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Dosage |  | 0..* | Dosage | How the medication is/was taken or should be taken
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
text | Σ | 0..1 | string | Free text dosage instructions
timing | Σ | 0..1 | TimingHdrMyHealthEu | When medication should be administered
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
code | Σ | 0..1 | CodeableConcept | A code for the timing schedule. Binding: eHDSI Event Timing Combination (extensible)
route | Σ | 0..1 | CodeableConcept | How drug should enter body Binding: eHDSI Route of Administration (extensible)
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Dosage.timing.code | Base | extensible | eHDSI Event Timing Combination | 📦1.0.0 | MyHealth@EU Core v1.0
Dosage.route | Base | extensible | eHDSI Route of Administration | 📦9.1.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

This structure is derived from Dosage

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Dosage |  |  | Dosage |
text |  | 0..1 | string | Free text dosage instructions
timing |  | 0..1 | TimingHdrMyHealthEu | When medication should be administered
code |  | 0..1 | CodeableConcept | A code for the timing schedule.
route |  | 0..1 | CodeableConcept | How drug should enter body Binding: eHDSI Route of Administration (extensible)
doseAndRate |  |  |  |
Slices for dose[x] |  | 0..1 | Range, SimpleQuantity(4.0.1) | Amount of medication per dose Slice: Unordered, Open by type:$this
dose[x]:doseQuantity |  | 0..1 | SimpleQuantity | Amount of medication per dose
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Dosage.route | Base | extensible | eHDSI Route of Administration | 📦9.1.0 | This IG

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Dosage |  | 0..* | Dosage | How the medication is/was taken or should be taken
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
sequence | Σ | 0..1 | integer | The order of the dosage instructions
text | Σ | 0..1 | string | Free text dosage instructions
additionalInstruction | Σ | 0..* | CodeableConcept | Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness" Binding: SNOMEDCTAdditionalDosageInstructions (example): A coded concept identifying additional instructions such as "take with water" or "avoid operating heavy machinery".
patientInstruction | Σ | 0..1 | string | Patient or consumer oriented instructions
timing | Σ | 0..1 | TimingHdrMyHealthEu | When medication should be administered
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
event | Σ | 0..* | dateTime | When the event occurs
repeat | Σ C | 0..1 | Element | When the event is to occur Constraints: tim-1, tim-2, tim-4, tim-5, tim-6, tim-7, tim-8, tim-9, tim-10
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
bounds[x] | Σ | 0..1 |  | Length/Range of lengths, or (Start and/or end) limits
boundsDuration |  |  | Duration |
boundsRange |  |  | Range |
boundsPeriod |  |  | Period |
count | Σ | 0..1 | positiveInt | Number of times to repeat
countMax | Σ | 0..1 | positiveInt | Maximum number of times to repeat
duration | Σ | 0..1 | decimal | Duration of the treatment
durationMax | Σ | 0..1 | decimal | How long when it happens (Max)
durationUnit | Σ | 0..1 | code | s | min | h | d | wk | mo | a - unit of time (UCUM) Binding: UnitsOfTime (required): A unit of time (units from UCUM).
frequency | Σ | 0..1 | positiveInt | Frequency times per period
frequencyMax | Σ | 0..1 | positiveInt | Event occurs up to frequencyMax times per period
period | Σ | 0..1 | decimal | Duration of time over which repetitions are to occur
periodMax | Σ | 0..1 | decimal | Upper limit of period (3-4 hours)
periodUnit | Σ | 0..1 | code | Unit of the period (e.g. day) Binding: UnitsOfTime (required): A unit of time (units from UCUM).
dayOfWeek | Σ | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required)
timeOfDay | Σ | 0..* | time | Time of day for action
when | Σ | 0..* | code | Code for time period of occurrence Binding: EventTiming (required): Real world event relating to the schedule.
offset | Σ | 0..1 | unsignedInt | Minutes from event (before or after)
code | Σ | 0..1 | CodeableConcept | A code for the timing schedule. Binding: eHDSI Event Timing Combination (extensible)
asNeeded[x] | Σ | 0..1 |  | Take "as needed" (for x) Binding: SNOMEDCTMedicationAsNeededReasonCodes (example): A coded concept identifying the precondition that should be met or evaluated prior to consuming or administering a medication dose. For example "pain", "30 minutes prior to sexual intercourse", "on flare-up" etc.
asNeededBoolean |  |  | boolean |
asNeededCodeableConcept |  |  | CodeableConcept |
site | Σ | 0..1 | CodeableConcept | Body site to administer to Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (example): A coded concept describing the site location the medicine enters into or onto the body.
route | Σ | 0..1 | CodeableConcept | How drug should enter body Binding: eHDSI Route of Administration (extensible)
method | Σ | 0..1 | CodeableConcept | Technique for administering medication Binding: SNOMEDCTAdministrationMethodCodes (example): A coded concept describing the technique by which the medicine is administered.
doseAndRate | Σ | 0..* | Element | Amount of medication administered
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
type | Σ | 0..1 | CodeableConcept | The kind of dose or rate specified Binding: DoseAndRateType (example): The kind of dose or rate specified.
Slices for dose[x] | Σ | 0..1 |  | Amount of medication per dose Slice: Unordered, Open by type:$this
doseRange |  |  | Range |
doseQuantity |  |  | Quantity(SimpleQuantity) |
dose[x]:doseQuantity | Σ | 0..1 | SimpleQuantity | Amount of medication per dose
rate[x] | Σ | 0..1 |  | Amount of medication per unit of time
rateRatio |  |  | Ratio |
rateRange |  |  | Range |
rateQuantity |  |  | Quantity(SimpleQuantity) |
maxDosePerPeriod | Σ | 0..1 | Ratio | Upper limit on medication per unit of time
maxDosePerAdministration | Σ | 0..1 | SimpleQuantity(4.0.1) | Upper limit on medication per administration
maxDosePerLifetime | Σ | 0..1 | SimpleQuantity(4.0.1) | Upper limit on medication per lifetime of the patient
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Dosage.additionalInstruction | Base | example | SNOMED CT Additional Dosage Instructions | 📍4.0.1 | FHIR Std.
Dosage.timing.repeat.​durationUnit | Base | required | UnitsOfTime | 📍4.0.1 | FHIR Std.
Dosage.timing.repeat.​periodUnit | Base | required | UnitsOfTime | 📍4.0.1 | FHIR Std.
Dosage.timing.repeat.​dayOfWeek | Base | required | DaysOfWeek | 📍4.0.1 | FHIR Std.
Dosage.timing.repeat.​when | Base | required | EventTiming | 📍4.0.1 | FHIR Std.
Dosage.timing.code | Base | extensible | eHDSI Event Timing Combination | 📦1.0.0 | MyHealth@EU Core v1.0
Dosage.asNeeded[x] | Base | example | SNOMED CT Medication As Needed Reason Codes | 📍4.0.1 | FHIR Std.
Dosage.site | Base | example | SNOMED CT Anatomical Structure for Administration Site Codes | 📍4.0.1 | FHIR Std.
Dosage.route | Base | extensible | eHDSI Route of Administration | 📦9.1.0 | This IG
Dosage.method | Base | example | SNOMED CT Administration Method Codes | 📍4.0.1 | FHIR Std.
Dosage.doseAndRate.type | Base | example | DoseAndRateType | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
tim-1 | error | Dosage.timing.repeat | if there's a duration, there needs to be duration units | `duration.empty() or durationUnit.exists()`
tim-2 | error | Dosage.timing.repeat | if there's a period, there needs to be period units | `period.empty() or periodUnit.exists()`
tim-4 | error | Dosage.timing.repeat | duration SHALL be a non-negative value | `duration.exists() implies duration >= 0`
tim-5 | error | Dosage.timing.repeat | period SHALL be a non-negative value | `period.exists() implies period >= 0`
tim-6 | error | Dosage.timing.repeat | If there's a periodMax, there must be a period | `periodMax.empty() or period.exists()`
tim-7 | error | Dosage.timing.repeat | If there's a durationMax, there must be a duration | `durationMax.empty() or duration.exists()`
tim-8 | error | Dosage.timing.repeat | If there's a countMax, there must be a count | `countMax.empty() or count.exists()`
tim-9 | error | Dosage.timing.repeat | If there's an offset, there must be a when (and not C, CM, CD, CV) | `offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not()))`
tim-10 | error | Dosage.timing.repeat | If there's a timeOfDay, there cannot be a when, or vice versa | `timeOfDay.empty() or when.empty()`

This structure is derived from Dosage

Summary

Structures

This structure refers to these other structures:

- Timing: HDR (http://fhir.ehdsi.eu/hdr/StructureDefinition/timing-hdr-myhealtheu)
- SimpleQuantity (http://hl7.org/fhir/StructureDefinition/SimpleQuantity)

Slices

This structure defines the following Slices:

- The element 1 is sliced based on the value of Dosage.doseAndRate.dose[x]

Maturity: 1

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Dosage |  | 0..* | Dosage | How the medication is/was taken or should be taken
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
text | Σ | 0..1 | string | Free text dosage instructions
timing | Σ | 0..1 | TimingHdrMyHealthEu | When medication should be administered
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
code | Σ | 0..1 | CodeableConcept | A code for the timing schedule. Binding: eHDSI Event Timing Combination (extensible)
route | Σ | 0..1 | CodeableConcept | How drug should enter body Binding: eHDSI Route of Administration (extensible)
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Dosage.timing.code | Base | extensible | eHDSI Event Timing Combination | 📦1.0.0 | MyHealth@EU Core v1.0
Dosage.route | Base | extensible | eHDSI Route of Administration | 📦9.1.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

Differential View

This structure is derived from Dosage

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Dosage |  |  | Dosage |
text |  | 0..1 | string | Free text dosage instructions
timing |  | 0..1 | TimingHdrMyHealthEu | When medication should be administered
code |  | 0..1 | CodeableConcept | A code for the timing schedule.
route |  | 0..1 | CodeableConcept | How drug should enter body Binding: eHDSI Route of Administration (extensible)
doseAndRate |  |  |  |
Slices for dose[x] |  | 0..1 | Range, SimpleQuantity(4.0.1) | Amount of medication per dose Slice: Unordered, Open by type:$this
dose[x]:doseQuantity |  | 0..1 | SimpleQuantity | Amount of medication per dose
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Dosage.route | Base | extensible | eHDSI Route of Administration | 📦9.1.0 | This IG

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Dosage |  | 0..* | Dosage | How the medication is/was taken or should be taken
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
sequence | Σ | 0..1 | integer | The order of the dosage instructions
text | Σ | 0..1 | string | Free text dosage instructions
additionalInstruction | Σ | 0..* | CodeableConcept | Supplemental instruction or warnings to the patient - e.g. "with meals", "may cause drowsiness" Binding: SNOMEDCTAdditionalDosageInstructions (example): A coded concept identifying additional instructions such as "take with water" or "avoid operating heavy machinery".
patientInstruction | Σ | 0..1 | string | Patient or consumer oriented instructions
timing | Σ | 0..1 | TimingHdrMyHealthEu | When medication should be administered
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
event | Σ | 0..* | dateTime | When the event occurs
repeat | Σ C | 0..1 | Element | When the event is to occur Constraints: tim-1, tim-2, tim-4, tim-5, tim-6, tim-7, tim-8, tim-9, tim-10
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
bounds[x] | Σ | 0..1 |  | Length/Range of lengths, or (Start and/or end) limits
boundsDuration |  |  | Duration |
boundsRange |  |  | Range |
boundsPeriod |  |  | Period |
count | Σ | 0..1 | positiveInt | Number of times to repeat
countMax | Σ | 0..1 | positiveInt | Maximum number of times to repeat
duration | Σ | 0..1 | decimal | Duration of the treatment
durationMax | Σ | 0..1 | decimal | How long when it happens (Max)
durationUnit | Σ | 0..1 | code | s | min | h | d | wk | mo | a - unit of time (UCUM) Binding: UnitsOfTime (required): A unit of time (units from UCUM).
frequency | Σ | 0..1 | positiveInt | Frequency times per period
frequencyMax | Σ | 0..1 | positiveInt | Event occurs up to frequencyMax times per period
period | Σ | 0..1 | decimal | Duration of time over which repetitions are to occur
periodMax | Σ | 0..1 | decimal | Upper limit of period (3-4 hours)
periodUnit | Σ | 0..1 | code | Unit of the period (e.g. day) Binding: UnitsOfTime (required): A unit of time (units from UCUM).
dayOfWeek | Σ | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required)
timeOfDay | Σ | 0..* | time | Time of day for action
when | Σ | 0..* | code | Code for time period of occurrence Binding: EventTiming (required): Real world event relating to the schedule.
offset | Σ | 0..1 | unsignedInt | Minutes from event (before or after)
code | Σ | 0..1 | CodeableConcept | A code for the timing schedule. Binding: eHDSI Event Timing Combination (extensible)
asNeeded[x] | Σ | 0..1 |  | Take "as needed" (for x) Binding: SNOMEDCTMedicationAsNeededReasonCodes (example): A coded concept identifying the precondition that should be met or evaluated prior to consuming or administering a medication dose. For example "pain", "30 minutes prior to sexual intercourse", "on flare-up" etc.
asNeededBoolean |  |  | boolean |
asNeededCodeableConcept |  |  | CodeableConcept |
site | Σ | 0..1 | CodeableConcept | Body site to administer to Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (example): A coded concept describing the site location the medicine enters into or onto the body.
route | Σ | 0..1 | CodeableConcept | How drug should enter body Binding: eHDSI Route of Administration (extensible)
method | Σ | 0..1 | CodeableConcept | Technique for administering medication Binding: SNOMEDCTAdministrationMethodCodes (example): A coded concept describing the technique by which the medicine is administered.
doseAndRate | Σ | 0..* | Element | Amount of medication administered
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
type | Σ | 0..1 | CodeableConcept | The kind of dose or rate specified Binding: DoseAndRateType (example): The kind of dose or rate specified.
Slices for dose[x] | Σ | 0..1 |  | Amount of medication per dose Slice: Unordered, Open by type:$this
doseRange |  |  | Range |
doseQuantity |  |  | Quantity(SimpleQuantity) |
dose[x]:doseQuantity | Σ | 0..1 | SimpleQuantity | Amount of medication per dose
rate[x] | Σ | 0..1 |  | Amount of medication per unit of time
rateRatio |  |  | Ratio |
rateRange |  |  | Range |
rateQuantity |  |  | Quantity(SimpleQuantity) |
maxDosePerPeriod | Σ | 0..1 | Ratio | Upper limit on medication per unit of time
maxDosePerAdministration | Σ | 0..1 | SimpleQuantity(4.0.1) | Upper limit on medication per administration
maxDosePerLifetime | Σ | 0..1 | SimpleQuantity(4.0.1) | Upper limit on medication per lifetime of the patient
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Dosage.additionalInstruction | Base | example | SNOMED CT Additional Dosage Instructions | 📍4.0.1 | FHIR Std.
Dosage.timing.repeat.​durationUnit | Base | required | UnitsOfTime | 📍4.0.1 | FHIR Std.
Dosage.timing.repeat.​periodUnit | Base | required | UnitsOfTime | 📍4.0.1 | FHIR Std.
Dosage.timing.repeat.​dayOfWeek | Base | required | DaysOfWeek | 📍4.0.1 | FHIR Std.
Dosage.timing.repeat.​when | Base | required | EventTiming | 📍4.0.1 | FHIR Std.
Dosage.timing.code | Base | extensible | eHDSI Event Timing Combination | 📦1.0.0 | MyHealth@EU Core v1.0
Dosage.asNeeded[x] | Base | example | SNOMED CT Medication As Needed Reason Codes | 📍4.0.1 | FHIR Std.
Dosage.site | Base | example | SNOMED CT Anatomical Structure for Administration Site Codes | 📍4.0.1 | FHIR Std.
Dosage.route | Base | extensible | eHDSI Route of Administration | 📦9.1.0 | This IG
Dosage.method | Base | example | SNOMED CT Administration Method Codes | 📍4.0.1 | FHIR Std.
Dosage.doseAndRate.type | Base | example | DoseAndRateType | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
tim-1 | error | Dosage.timing.repeat | if there's a duration, there needs to be duration units | `duration.empty() or durationUnit.exists()`
tim-2 | error | Dosage.timing.repeat | if there's a period, there needs to be period units | `period.empty() or periodUnit.exists()`
tim-4 | error | Dosage.timing.repeat | duration SHALL be a non-negative value | `duration.exists() implies duration >= 0`
tim-5 | error | Dosage.timing.repeat | period SHALL be a non-negative value | `period.exists() implies period >= 0`
tim-6 | error | Dosage.timing.repeat | If there's a periodMax, there must be a period | `periodMax.empty() or period.exists()`
tim-7 | error | Dosage.timing.repeat | If there's a durationMax, there must be a duration | `durationMax.empty() or duration.exists()`
tim-8 | error | Dosage.timing.repeat | If there's a countMax, there must be a count | `countMax.empty() or count.exists()`
tim-9 | error | Dosage.timing.repeat | If there's an offset, there must be a when (and not C, CM, CD, CV) | `offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not()))`
tim-10 | error | Dosage.timing.repeat | If there's a timeOfDay, there cannot be a when, or vice versa | `timeOfDay.empty() or when.empty()`

This structure is derived from Dosage

Summary

Structures

This structure refers to these other structures:

- Timing: HDR (http://fhir.ehdsi.eu/hdr/StructureDefinition/timing-hdr-myhealtheu)
- SimpleQuantity (http://hl7.org/fhir/StructureDefinition/SimpleQuantity)

Slices

This structure defines the following Slices:

- The element 1 is sliced based on the value of Dosage.doseAndRate.dose[x]

Maturity: 1

Other representations of profile: CSV, Excel, Schematron