EHDS Logical Information Models
0.4.0 - draft

EHDS Logical Information Models, published by Xt-EHR. This guide is not an authorized publication; it is the continuous build for version 0.4.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/Xt-EHR/xt-ehr-common/ and changes regularly. See the Directory of published versions

Logical Model: EHDSDosageObligations - Detailed Descriptions

Draft as of 2026-02-22

Definitions for the EHDSDosageObligations logical model.

Guidance on how to interpret the contents of this table can be foundhere

0. EHDSDosage
Definition

The model covers usage instructions for administering a medicinal product, focusing on the most frequently used data elements. More complex dosage schemes may require additional elements, which should be communicated as part of the rendered dosage instructions element.


Base definition for all types defined in FHIR type system.

ShortDosage modelBase for all types and resources
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. EHDSDosage.renderedDosageInstruction
Definition

Full dosage information as human-readable text covering all dosage steps. Generating the text follows local rules and should include all locally implemented dosage data even when such elements are not present in this model.

ShortFull dosage information as human-readable text covering all dosage steps. Generating the text follows local rules and should include all locally implemented dosage data even when such elements are not present in this model.
Control0..1
Typestring
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Obligations
    ObligationsActor
    SHOULD:able-to-populateProducer
    4. EHDSDosage.dosageDetails
    Definition

    Details of single dosage scheme step

    ShortDetails of single dosage scheme step
    Control0..*
    TypeBase
    6. EHDSDosage.dosageDetails.sequence
    Definition

    Order of the dosage instruction, in case one treatment consists of several dosage steps. When two schemes share the same sequence number, they are meant to be running in parallel.

    ShortOrder of the dosage instruction, in case one treatment consists of several dosage steps. When two schemes share the same sequence number, they are meant to be running in parallel.
    Control0..1
    Typeinteger
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    8. EHDSDosage.dosageDetails.note
    Definition

    Patient oriented instructions as free text for this dosage step

    ShortPatient oriented instructions as free text for this dosage step
    Control0..1
    Typestring
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Obligations
      ObligationsActor
      SHOULD:able-to-populateProducer
      10. EHDSDosage.dosageDetails.doseAndRate
      Definition

      Amount of medication administered per one dose (= one timing)

      ShortAmount of medication administered per one dose (= one timing)
      Control0..*
      TypeBase
      12. EHDSDosage.dosageDetails.doseAndRate.dose[x]
      Definition

      Amount of medication per one dose. (1 tablet, 2-3 tablets, 20ml)

      ShortAmount of medication per one dose. (1 tablet, 2-3 tablets, 20ml)
      Control0..1
      Binding

      UCUM (units of measurement), EDQM Standard Terms (units of presentation)

      TypeChoice of: Quantity, Range
      [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
      Obligations
        ObligationsActorDocumentation
        SHALL:able-to-populateProducer

        System SHALL support at least Quantity data type for the element. System SHOULD support Range data type for the element.

        14. EHDSDosage.dosageDetails.doseAndRate.rate[x]
        Definition

        Amount of medication per time period (e.g. 100mg per 1 hour). When rate is provided per 1 time unit, Quantity data type can be used with a suitable unit (e.g. mg/h, ug/min).

        ShortAmount of medication per time period (e.g. 100mg per 1 hour). When rate is provided per 1 time unit, Quantity data type can be used with a suitable unit (e.g. mg/h, ug/min).
        Control0..1
        Binding

        UCUM (units of measurement), EDQM Standard Terms (units of presentation)

        TypeChoice of: Quantity, Ratio
        [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
        16. EHDSDosage.dosageDetails.repeat
        Definition

        Repetition of the administration.

        ShortRepetition of the administration.
        Control0..1
        TypeBase
        Obligations
          ObligationsActor
          SHALL:able-to-populateProducer
          18. EHDSDosage.dosageDetails.repeat.bounds[x]
          Definition

          Time bounds for the treatment (current dosage scheme), Quantity contains a number of time units (e.g 10 days), Period contains start and end date (e.g. 05.08.2023 - 10.08.2023).

          ShortTime bounds for the treatment (current dosage scheme), Quantity contains a number of time units (e.g 10 days), Period contains start and end date (e.g. 05.08.2023 - 10.08.2023).
          Control0..1
          Binding

          UCUM

          TypeChoice of: Quantity, Period
          [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
          Obligations
            ObligationsActorDocumentation
            SHALL:able-to-populateProducer

            System SHALL support at least Quantity data type for the element.

            20. EHDSDosage.dosageDetails.repeat.duration
            Definition

            Duration of administration (e.g '5 minutes', '1 hour')

            ShortDuration of administration (e.g '5 minutes', '1 hour')
            Control0..1
            Binding

            UCUM

            TypeQuantity
            22. EHDSDosage.dosageDetails.repeat.frequency
            Definition

            Frequency of intake/administration (e.g 'three times a day')

            ShortFrequency of intake/administration (e.g 'three times a day')
            Control0..1
            TypeBase
            Obligations
              ObligationsActor
              SHALL:able-to-populateProducer
              24. EHDSDosage.dosageDetails.repeat.frequency.numberOfTimes
              Definition

              Number of times per period (e.g '3 times')

              ShortNumber of times per period (e.g '3 times')
              Control0..1
              Typeinteger
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Obligations
                ObligationsActor
                SHALL:able-to-populateProducer
                26. EHDSDosage.dosageDetails.repeat.frequency.period
                Definition

                Duration to which the frequency applies (e.g '... / 1 day')

                ShortDuration to which the frequency applies (e.g '... / 1 day')
                Control0..1
                Binding

                UCUM

                TypeQuantity
                Obligations
                  ObligationsActor
                  SHALL:able-to-populateProducer
                  28. EHDSDosage.dosageDetails.repeat.dayOfWeek
                  Definition

                  The day of the week of administration, e.g Mon, Tue, etc

                  ShortThe day of the week of administration, e.g Mon, Tue, etc
                  Control0..*
                  TypeCodeableConcept
                  30. EHDSDosage.dosageDetails.repeat.timeOfDay
                  Definition

                  Exact time of day of administration (e.g '10:00')

                  ShortExact time of day of administration (e.g '10:00')
                  Control0..*
                  Typetime
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                  32. EHDSDosage.dosageDetails.repeat.eventTime
                  Definition

                  Time period or event when the administration should happen ('before meal', 'immediately', 'morning')

                  ShortTime period or event when the administration should happen ('before meal', 'immediately', 'morning')
                  Control0..*
                  TypeCodeableConcept
                  34. EHDSDosage.dosageDetails.asNeeded
                  Definition

                  Take as needed

                  ShortTake as needed
                  Control0..1
                  Typeboolean
                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                  36. EHDSDosage.dosageDetails.bodySite
                  Definition

                  Body site of administration

                  ShortBody site of administration
                  Control0..1
                  Typehttp://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSBodyStructure
                  38. EHDSDosage.dosageDetails.routeOfAdministration
                  Definition

                  Route of administration

                  ShortRoute of administration
                  Control0..1
                  Binding

                  EDQM Standard Terms

                  TypeCodeableConcept
                  Obligations
                    ObligationsActor
                    SHOULD:able-to-populateProducer

                    Guidance on how to interpret the contents of this table can be foundhere

                    0. EHDSDosage
                    Logical ModelInstances of this logical model are not marked to be the target of a Reference
                    2. EHDSDosage.renderedDosageInstruction
                    Obligations
                      ObligationsActor
                      SHOULD:able-to-populateProducer
                      4. EHDSDosage.dosageDetails
                      6. EHDSDosage.dosageDetails.note
                      Obligations
                        ObligationsActor
                        SHOULD:able-to-populateProducer
                        8. EHDSDosage.dosageDetails.doseAndRate
                        10. EHDSDosage.dosageDetails.doseAndRate.dose[x]
                        [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                        Obligations
                          ObligationsActorDocumentation
                          SHALL:able-to-populateProducer

                          System SHALL support at least Quantity data type for the element. System SHOULD support Range data type for the element.

                          12. EHDSDosage.dosageDetails.repeat
                          Obligations
                            ObligationsActor
                            SHALL:able-to-populateProducer
                            14. EHDSDosage.dosageDetails.repeat.bounds[x]
                            [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                            Obligations
                              ObligationsActorDocumentation
                              SHALL:able-to-populateProducer

                              System SHALL support at least Quantity data type for the element.

                              16. EHDSDosage.dosageDetails.repeat.frequency
                              Obligations
                                ObligationsActor
                                SHALL:able-to-populateProducer
                                18. EHDSDosage.dosageDetails.repeat.frequency.numberOfTimes
                                Obligations
                                  ObligationsActor
                                  SHALL:able-to-populateProducer
                                  20. EHDSDosage.dosageDetails.repeat.frequency.period
                                  Obligations
                                    ObligationsActor
                                    SHALL:able-to-populateProducer
                                    22. EHDSDosage.dosageDetails.routeOfAdministration
                                    Obligations
                                      ObligationsActor
                                      SHOULD:able-to-populateProducer

                                      Guidance on how to interpret the contents of this table can be foundhere

                                      0. EHDSDosage
                                      Definition

                                      The model covers usage instructions for administering a medicinal product, focusing on the most frequently used data elements. More complex dosage schemes may require additional elements, which should be communicated as part of the rendered dosage instructions element.

                                      ShortDosage model
                                      Control0..*
                                      Is Modifierfalse
                                      Logical ModelInstances of this logical model are not marked to be the target of a Reference
                                      2. EHDSDosage.renderedDosageInstruction
                                      Definition

                                      Full dosage information as human-readable text covering all dosage steps. Generating the text follows local rules and should include all locally implemented dosage data even when such elements are not present in this model.

                                      ShortFull dosage information as human-readable text covering all dosage steps. Generating the text follows local rules and should include all locally implemented dosage data even when such elements are not present in this model.
                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Obligations
                                        ObligationsActor
                                        SHOULD:able-to-populateProducer
                                        4. EHDSDosage.dosageDetails
                                        Definition

                                        Details of single dosage scheme step

                                        ShortDetails of single dosage scheme step
                                        Control0..*
                                        TypeBase
                                        6. EHDSDosage.dosageDetails.sequence
                                        Definition

                                        Order of the dosage instruction, in case one treatment consists of several dosage steps. When two schemes share the same sequence number, they are meant to be running in parallel.

                                        ShortOrder of the dosage instruction, in case one treatment consists of several dosage steps. When two schemes share the same sequence number, they are meant to be running in parallel.
                                        Control0..1
                                        Typeinteger
                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                        8. EHDSDosage.dosageDetails.note
                                        Definition

                                        Patient oriented instructions as free text for this dosage step

                                        ShortPatient oriented instructions as free text for this dosage step
                                        Control0..1
                                        Typestring
                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                        Obligations
                                          ObligationsActor
                                          SHOULD:able-to-populateProducer
                                          10. EHDSDosage.dosageDetails.doseAndRate
                                          Definition

                                          Amount of medication administered per one dose (= one timing)

                                          ShortAmount of medication administered per one dose (= one timing)
                                          Control0..*
                                          TypeBase
                                          12. EHDSDosage.dosageDetails.doseAndRate.dose[x]
                                          Definition

                                          Amount of medication per one dose. (1 tablet, 2-3 tablets, 20ml)

                                          ShortAmount of medication per one dose. (1 tablet, 2-3 tablets, 20ml)
                                          Control0..1
                                          Binding

                                          UCUM (units of measurement), EDQM Standard Terms (units of presentation)

                                          TypeChoice of: Quantity, Range
                                          [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                                          Obligations
                                            ObligationsActorDocumentation
                                            SHALL:able-to-populateProducer

                                            System SHALL support at least Quantity data type for the element. System SHOULD support Range data type for the element.

                                            14. EHDSDosage.dosageDetails.doseAndRate.rate[x]
                                            Definition

                                            Amount of medication per time period (e.g. 100mg per 1 hour). When rate is provided per 1 time unit, Quantity data type can be used with a suitable unit (e.g. mg/h, ug/min).

                                            ShortAmount of medication per time period (e.g. 100mg per 1 hour). When rate is provided per 1 time unit, Quantity data type can be used with a suitable unit (e.g. mg/h, ug/min).
                                            Control0..1
                                            Binding

                                            UCUM (units of measurement), EDQM Standard Terms (units of presentation)

                                            TypeChoice of: Quantity, Ratio
                                            [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                                            16. EHDSDosage.dosageDetails.repeat
                                            Definition

                                            Repetition of the administration.

                                            ShortRepetition of the administration.
                                            Control0..1
                                            TypeBase
                                            Obligations
                                              ObligationsActor
                                              SHALL:able-to-populateProducer
                                              18. EHDSDosage.dosageDetails.repeat.bounds[x]
                                              Definition

                                              Time bounds for the treatment (current dosage scheme), Quantity contains a number of time units (e.g 10 days), Period contains start and end date (e.g. 05.08.2023 - 10.08.2023).

                                              ShortTime bounds for the treatment (current dosage scheme), Quantity contains a number of time units (e.g 10 days), Period contains start and end date (e.g. 05.08.2023 - 10.08.2023).
                                              Control0..1
                                              Binding

                                              UCUM

                                              TypeChoice of: Quantity, Period
                                              [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                                              Obligations
                                                ObligationsActorDocumentation
                                                SHALL:able-to-populateProducer

                                                System SHALL support at least Quantity data type for the element.

                                                20. EHDSDosage.dosageDetails.repeat.duration
                                                Definition

                                                Duration of administration (e.g '5 minutes', '1 hour')

                                                ShortDuration of administration (e.g '5 minutes', '1 hour')
                                                Control0..1
                                                Binding

                                                UCUM

                                                TypeQuantity
                                                22. EHDSDosage.dosageDetails.repeat.frequency
                                                Definition

                                                Frequency of intake/administration (e.g 'three times a day')

                                                ShortFrequency of intake/administration (e.g 'three times a day')
                                                Control0..1
                                                TypeBase
                                                Obligations
                                                  ObligationsActor
                                                  SHALL:able-to-populateProducer
                                                  24. EHDSDosage.dosageDetails.repeat.frequency.numberOfTimes
                                                  Definition

                                                  Number of times per period (e.g '3 times')

                                                  ShortNumber of times per period (e.g '3 times')
                                                  Control0..1
                                                  Typeinteger
                                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                  Obligations
                                                    ObligationsActor
                                                    SHALL:able-to-populateProducer
                                                    26. EHDSDosage.dosageDetails.repeat.frequency.period
                                                    Definition

                                                    Duration to which the frequency applies (e.g '... / 1 day')

                                                    ShortDuration to which the frequency applies (e.g '... / 1 day')
                                                    Control0..1
                                                    Binding

                                                    UCUM

                                                    TypeQuantity
                                                    Obligations
                                                      ObligationsActor
                                                      SHALL:able-to-populateProducer
                                                      28. EHDSDosage.dosageDetails.repeat.dayOfWeek
                                                      Definition

                                                      The day of the week of administration, e.g Mon, Tue, etc

                                                      ShortThe day of the week of administration, e.g Mon, Tue, etc
                                                      Control0..*
                                                      TypeCodeableConcept
                                                      30. EHDSDosage.dosageDetails.repeat.timeOfDay
                                                      Definition

                                                      Exact time of day of administration (e.g '10:00')

                                                      ShortExact time of day of administration (e.g '10:00')
                                                      Control0..*
                                                      Typetime
                                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                      32. EHDSDosage.dosageDetails.repeat.eventTime
                                                      Definition

                                                      Time period or event when the administration should happen ('before meal', 'immediately', 'morning')

                                                      ShortTime period or event when the administration should happen ('before meal', 'immediately', 'morning')
                                                      Control0..*
                                                      TypeCodeableConcept
                                                      34. EHDSDosage.dosageDetails.asNeeded
                                                      Definition

                                                      Take as needed

                                                      ShortTake as needed
                                                      Control0..1
                                                      Typeboolean
                                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                      36. EHDSDosage.dosageDetails.bodySite
                                                      Definition

                                                      Body site of administration

                                                      ShortBody site of administration
                                                      Control0..1
                                                      Typehttp://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSBodyStructure
                                                      38. EHDSDosage.dosageDetails.routeOfAdministration
                                                      Definition

                                                      Route of administration

                                                      ShortRoute of administration
                                                      Control0..1
                                                      Binding

                                                      EDQM Standard Terms

                                                      TypeCodeableConcept
                                                      Obligations
                                                        ObligationsActor
                                                        SHOULD:able-to-populateProducer