Name	Flags	Card.	Type	Description & Constraints
Dosage		0..*	Dosage	How the medication is/was taken or should be taken ele-1: All FHIR elements must have a @value or children
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
text	Σ	0..1	string	Free text dosage instructions ele-1: All FHIR elements must have a @value or children
timing	OΣ	0..1	TimingHdrMyHealthEu	When medication should be administered ele-1: All FHIR elements must have a @value or children Obligations Actor SHALL:handle HDR Handler
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
code	OΣ	0..1	CodeableConcept	A code for the timing schedule. Binding: eHDSI Event Timing Combination (extensible) ele-1: All FHIR elements must have a @value or children Obligations Actor SHALL:handle HDR Handler from Timing: HDR
route	Σ	0..1	CodeableConcept	How drug should enter body Binding: eHDSI Route of Administration (extensible) ele-1: All FHIR elements must have a @value or children
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Dosage.timing.code	extensible	EHDSIEventTimingCombination http://fhir.ehdsi.eu/hdr/ValueSet/eHDSIEventTimingCombination from this IG
Dosage.route	extensible	EHDSIRouteofAdministration http://terminology.ehdsi.eu/ValueSet/eHDSIRouteofAdministration from this IG

Constraints

Id	Grade	Path(s)	Details	Requirements
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()

Name	Flags	Card.	Type	Description & Constraints
Dosage			Dosage
text		0..1	string	Free text dosage instructions
timing	O	0..1	TimingHdrMyHealthEu	When medication should be administered Obligations Actor SHALL:handle HDR Handler
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	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	Conformance	ValueSet	URI
Dosage.route	extensible	EHDSIRouteofAdministration http://terminology.ehdsi.eu/ValueSet/eHDSIRouteofAdministration from this IG

Name	Flags	Card.	Type	Description & Constraints
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	OΣ	0..1	TimingHdrMyHealthEu	When medication should be administered Obligations Actor SHALL:handle HDR Handler
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 tim-1: if there's a duration, there needs to be duration units tim-2: if there's a period, there needs to be period units tim-4: duration SHALL be a non-negative value tim-5: period SHALL be a non-negative value tim-6: If there's a periodMax, there must be a period tim-7: If there's a durationMax, there must be a duration tim-8: If there's a countMax, there must be a count tim-9: If there's an offset, there must be a when (and not C, CM, CD, CV) tim-10: If there's a timeOfDay, there cannot be a when, or vice versa
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	OΣ	0..1	decimal	Duration of the treatment Obligations Actor SHALL:handle HDR Handler from Timing: HDR
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	OΣ	0..1	positiveInt	Frequency times per period Obligations Actor SHALL:handle HDR Handler from Timing: HDR
frequencyMax	Σ	0..1	positiveInt	Event occurs up to frequencyMax times per period
period	OΣ	0..1	decimal	Duration of time over which repetitions are to occur Obligations Actor SHALL:handle HDR Handler from Timing: HDR
periodMax	Σ	0..1	decimal	Upper limit of period (3-4 hours)
periodUnit	OΣ	0..1	code	Unit of the period (e.g. day) Binding: UnitsOfTime (required): A unit of time (units from UCUM). Obligations Actor SHALL:handle HDR Handler from Timing: HDR
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	OΣ	0..1	CodeableConcept	A code for the timing schedule. Binding: eHDSI Event Timing Combination (extensible) Obligations Actor SHALL:handle HDR Handler from Timing: HDR
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	Upper limit on medication per administration
maxDosePerLifetime	Σ	0..1	SimpleQuantity	Upper limit on medication per lifetime of the patient
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Dosage.additionalInstruction	example	SNOMEDCTAdditionalDosageInstructions http://hl7.org/fhir/ValueSet/additional-instruction-codes from the FHIR Standard
Dosage.timing.repeat.durationUnit	required	UnitsOfTime http://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard
Dosage.timing.repeat.periodUnit	required	UnitsOfTime http://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard
Dosage.timing.repeat.dayOfWeek	required	DaysOfWeek http://hl7.org/fhir/ValueSet/days-of-week|4.0.1 from the FHIR Standard
Dosage.timing.repeat.when	required	EventTiming http://hl7.org/fhir/ValueSet/event-timing|4.0.1 from the FHIR Standard
Dosage.timing.code	extensible	EHDSIEventTimingCombination http://fhir.ehdsi.eu/hdr/ValueSet/eHDSIEventTimingCombination from this IG
Dosage.asNeeded[x]	example	SNOMEDCTMedicationAsNeededReasonCodes http://hl7.org/fhir/ValueSet/medication-as-needed-reason from the FHIR Standard
Dosage.site	example	SNOMEDCTAnatomicalStructureForAdministrationSiteCodes http://hl7.org/fhir/ValueSet/approach-site-codes from the FHIR Standard
Dosage.route	extensible	EHDSIRouteofAdministration http://terminology.ehdsi.eu/ValueSet/eHDSIRouteofAdministration from this IG
Dosage.method	example	SNOMEDCTAdministrationMethodCodes http://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard
Dosage.doseAndRate.type	example	DoseAndRateType http://hl7.org/fhir/ValueSet/dose-rate-type from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
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()

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

Name	Flags	Card.	Type	Description & Constraints
Dosage		0..*	Dosage	How the medication is/was taken or should be taken ele-1: All FHIR elements must have a @value or children
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
text	Σ	0..1	string	Free text dosage instructions ele-1: All FHIR elements must have a @value or children
timing	OΣ	0..1	TimingHdrMyHealthEu	When medication should be administered ele-1: All FHIR elements must have a @value or children Obligations Actor SHALL:handle HDR Handler
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
code	OΣ	0..1	CodeableConcept	A code for the timing schedule. Binding: eHDSI Event Timing Combination (extensible) ele-1: All FHIR elements must have a @value or children Obligations Actor SHALL:handle HDR Handler from Timing: HDR
route	Σ	0..1	CodeableConcept	How drug should enter body Binding: eHDSI Route of Administration (extensible) ele-1: All FHIR elements must have a @value or children
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Dosage.timing.code	extensible	EHDSIEventTimingCombination http://fhir.ehdsi.eu/hdr/ValueSet/eHDSIEventTimingCombination from this IG
Dosage.route	extensible	EHDSIRouteofAdministration http://terminology.ehdsi.eu/ValueSet/eHDSIRouteofAdministration from this IG

Constraints

Id	Grade	Path(s)	Details	Requirements
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()

Name	Flags	Card.	Type	Description & Constraints
Dosage			Dosage
text		0..1	string	Free text dosage instructions
timing	O	0..1	TimingHdrMyHealthEu	When medication should be administered Obligations Actor SHALL:handle HDR Handler
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	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	Conformance	ValueSet	URI
Dosage.route	extensible	EHDSIRouteofAdministration http://terminology.ehdsi.eu/ValueSet/eHDSIRouteofAdministration from this IG

Name	Flags	Card.	Type	Description & Constraints
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	OΣ	0..1	TimingHdrMyHealthEu	When medication should be administered Obligations Actor SHALL:handle HDR Handler
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 tim-1: if there's a duration, there needs to be duration units tim-2: if there's a period, there needs to be period units tim-4: duration SHALL be a non-negative value tim-5: period SHALL be a non-negative value tim-6: If there's a periodMax, there must be a period tim-7: If there's a durationMax, there must be a duration tim-8: If there's a countMax, there must be a count tim-9: If there's an offset, there must be a when (and not C, CM, CD, CV) tim-10: If there's a timeOfDay, there cannot be a when, or vice versa
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	OΣ	0..1	decimal	Duration of the treatment Obligations Actor SHALL:handle HDR Handler from Timing: HDR
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	OΣ	0..1	positiveInt	Frequency times per period Obligations Actor SHALL:handle HDR Handler from Timing: HDR
frequencyMax	Σ	0..1	positiveInt	Event occurs up to frequencyMax times per period
period	OΣ	0..1	decimal	Duration of time over which repetitions are to occur Obligations Actor SHALL:handle HDR Handler from Timing: HDR
periodMax	Σ	0..1	decimal	Upper limit of period (3-4 hours)
periodUnit	OΣ	0..1	code	Unit of the period (e.g. day) Binding: UnitsOfTime (required): A unit of time (units from UCUM). Obligations Actor SHALL:handle HDR Handler from Timing: HDR
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	OΣ	0..1	CodeableConcept	A code for the timing schedule. Binding: eHDSI Event Timing Combination (extensible) Obligations Actor SHALL:handle HDR Handler from Timing: HDR
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	Upper limit on medication per administration
maxDosePerLifetime	Σ	0..1	SimpleQuantity	Upper limit on medication per lifetime of the patient
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Dosage.additionalInstruction	example	SNOMEDCTAdditionalDosageInstructions http://hl7.org/fhir/ValueSet/additional-instruction-codes from the FHIR Standard
Dosage.timing.repeat.durationUnit	required	UnitsOfTime http://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard
Dosage.timing.repeat.periodUnit	required	UnitsOfTime http://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard
Dosage.timing.repeat.dayOfWeek	required	DaysOfWeek http://hl7.org/fhir/ValueSet/days-of-week|4.0.1 from the FHIR Standard
Dosage.timing.repeat.when	required	EventTiming http://hl7.org/fhir/ValueSet/event-timing|4.0.1 from the FHIR Standard
Dosage.timing.code	extensible	EHDSIEventTimingCombination http://fhir.ehdsi.eu/hdr/ValueSet/eHDSIEventTimingCombination from this IG
Dosage.asNeeded[x]	example	SNOMEDCTMedicationAsNeededReasonCodes http://hl7.org/fhir/ValueSet/medication-as-needed-reason from the FHIR Standard
Dosage.site	example	SNOMEDCTAnatomicalStructureForAdministrationSiteCodes http://hl7.org/fhir/ValueSet/approach-site-codes from the FHIR Standard
Dosage.route	extensible	EHDSIRouteofAdministration http://terminology.ehdsi.eu/ValueSet/eHDSIRouteofAdministration from this IG
Dosage.method	example	SNOMEDCTAdministrationMethodCodes http://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard
Dosage.doseAndRate.type	example	DoseAndRateType http://hl7.org/fhir/ValueSet/dose-rate-type from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
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()

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