EHDS Logical Information Models
0.2.1 - qa-preview

EHDS Logical Information Models, published by Xt-EHR. This guide is not an authorized publication; it is the continuous build for version 0.2.1 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: EHDSSubstanceUse - Detailed Descriptions

Draft as of 2026-02-05

Definitions for the EHDSSubstanceUse logical model.

- Key Elements Table
- Differential Elements Table
- Snapshot Elements Table

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

0. EHDSSubstanceUse
Definition | Statement about using a substance (such as tobacco, alcohol, drugs, etc). Base definition for all types defined in FHIR type system.
Short | Substance use modelBase for all types and resources
Control | 0..*
Is Modifier | false
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. EHDSSubstanceUse.header
Definition | Basic metadata for this information
Short | Basic metadata for this information
Control | 1..1
Type | Base
4. EHDSSubstanceUse.header.subject
Definition | Patient/subject information
Short | Patient/subject information
Control | 1..1
Type | http://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSPatient
6. EHDSSubstanceUse.header.identifier
Definition | Business identifier for the object, unique within its system. Supporting disambiguation between different contexts (systems/countries).
Short | Business identifier for the object, unique within its system. Supporting disambiguation between different contexts (systems/countries).
Note | This is a business identifier, not a resource identifier (see discussion)
Control | 0..*
Type | Identifier
8. EHDSSubstanceUse.header.author[x]
Definition | Author(s) responsible for the provided information. The exact role of the responsible author varies across use cases and is specific to individual models.
Short | Author(s) responsible for the provided information.
Control | 0..*
Type | Choice of: http://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSHealthProfessional, http://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSOrganisation, http://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSDevice
[x] Note | SeeChoice of Data Typesfor further information about how to use [x]
10. EHDSSubstanceUse.header.date
Definition | Date and optionally time of authoring/issuing
Short | Date and optionally time of authoring/issuing
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
12. EHDSSubstanceUse.header.status
Definition | Status of the resource or document
Short | Status of the patient’s alcohol use.
Control | 1..1
Binding | SNOMED CT
Type | CodeableConcept
14. EHDSSubstanceUse.header.source
Definition | Source of information (e.g. patient, patient's proxy). Used in case the patient has authored the information or the author has submitted patient-stated information.
Short | Source of information (e.g. patient, patient's proxy). Used in case the patient has authored the information or the author has submitted patient-stated information.
Control | 0..1
Type | CodeableConcept
16. EHDSSubstanceUse.header.language
Definition | Language in which the resource is written. Language is expressed by the IETF language tag.
Short | Language in which the resource is written. Language is expressed by the IETF language tag.
Control | 0..1
Binding | BCP 47
Type | CodeableConcept
18. EHDSSubstanceUse.observationPeriod
Definition | Time period for which this observation about substance use is applicable
Short | Time period for which this observation about substance use is applicable
Control | 0..1
Type | Period
20. EHDSSubstanceUse.frequencyAndQuantity
Definition | The extent of the patient’s alcohol use in units of alcohol per time period.
Short | The extent of the patient’s alcohol use in units of alcohol per time period.
Control | 0..1
Type | Base
22. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition | Quantity (volume per time unit).
Short | Quantity (volume per time unit).
Control | 1..1
Type | Quantity
24. EHDSSubstanceUse.frequencyAndQuantity.periodOfUse
Definition | Time period of substance use.
Short | Time period of substance use.
Control | 0..1
Type | Period
26. EHDSSubstanceUse.substanceType
Definition | Type of substance
Short | Type of substance
Control | 0..1
Binding | SNOMED CT
Type | CodeableConcept
28. EHDSSubstanceUse.routeOfAdministration
Definition | Route(s) of administration
Short | Route(s) of administration
Control | 0..*
Binding | EDQM
Type | CodeableConcept
30. EHDSSubstanceUse.note
Definition | Textual comment.
Short | Textual comment.
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension

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

0. EHDSSubstanceUse
Definition | Statement about using a substance (such as tobacco, alcohol, drugs, etc).
Short | Substance use model
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. EHDSSubstanceUse.header
4. EHDSSubstanceUse.header.status
Short | Status of the patient’s alcohol use.
Binding | SNOMED CT
6. EHDSSubstanceUse.observationPeriod
Definition | Time period for which this observation about substance use is applicable
Short | Time period for which this observation about substance use is applicable
Control | 0..1
Type | Period
8. EHDSSubstanceUse.frequencyAndQuantity
Definition | The extent of the patient’s alcohol use in units of alcohol per time period.
Short | The extent of the patient’s alcohol use in units of alcohol per time period.
Control | 0..1
Type | Base
10. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition | Quantity (volume per time unit).
Short | Quantity (volume per time unit).
Control | 1..1
Type | Quantity
12. EHDSSubstanceUse.frequencyAndQuantity.periodOfUse
Definition | Time period of substance use.
Short | Time period of substance use.
Control | 0..1
Type | Period
14. EHDSSubstanceUse.substanceType
Definition | Type of substance
Short | Type of substance
Control | 0..1
Binding | SNOMED CT
Type | CodeableConcept
16. EHDSSubstanceUse.routeOfAdministration
Definition | Route(s) of administration
Short | Route(s) of administration
Control | 0..*
Binding | EDQM
Type | CodeableConcept
18. EHDSSubstanceUse.note
Definition | Textual comment.
Short | Textual comment.
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension

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

0. EHDSSubstanceUse
Definition | Statement about using a substance (such as tobacco, alcohol, drugs, etc).
Short | Substance use model
Control | 0..*
Is Modifier | false
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. EHDSSubstanceUse.header
Definition | Basic metadata for this information
Short | Basic metadata for this information
Control | 1..1
Type | Base
4. EHDSSubstanceUse.header.subject
Definition | Patient/subject information
Short | Patient/subject information
Control | 1..1
Type | http://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSPatient
6. EHDSSubstanceUse.header.identifier
Definition | Business identifier for the object, unique within its system. Supporting disambiguation between different contexts (systems/countries).
Short | Business identifier for the object, unique within its system. Supporting disambiguation between different contexts (systems/countries).
Note | This is a business identifier, not a resource identifier (see discussion)
Control | 0..*
Type | Identifier
8. EHDSSubstanceUse.header.author[x]
Definition | Author(s) responsible for the provided information. The exact role of the responsible author varies across use cases and is specific to individual models.
Short | Author(s) responsible for the provided information.
Control | 0..*
Type | Choice of: http://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSHealthProfessional, http://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSOrganisation, http://www.xt-ehr.eu/fhir/models/StructureDefinition/EHDSDevice
[x] Note | SeeChoice of Data Typesfor further information about how to use [x]
10. EHDSSubstanceUse.header.date
Definition | Date and optionally time of authoring/issuing
Short | Date and optionally time of authoring/issuing
Control | 0..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
12. EHDSSubstanceUse.header.status
Definition | Status of the resource or document
Short | Status of the patient’s alcohol use.
Control | 1..1
Binding | SNOMED CT
Type | CodeableConcept
14. EHDSSubstanceUse.header.source
Definition | Source of information (e.g. patient, patient's proxy). Used in case the patient has authored the information or the author has submitted patient-stated information.
Short | Source of information (e.g. patient, patient's proxy). Used in case the patient has authored the information or the author has submitted patient-stated information.
Control | 0..1
Type | CodeableConcept
16. EHDSSubstanceUse.header.language
Definition | Language in which the resource is written. Language is expressed by the IETF language tag.
Short | Language in which the resource is written. Language is expressed by the IETF language tag.
Control | 0..1
Binding | BCP 47
Type | CodeableConcept
18. EHDSSubstanceUse.observationPeriod
Definition | Time period for which this observation about substance use is applicable
Short | Time period for which this observation about substance use is applicable
Control | 0..1
Type | Period
20. EHDSSubstanceUse.frequencyAndQuantity
Definition | The extent of the patient’s alcohol use in units of alcohol per time period.
Short | The extent of the patient’s alcohol use in units of alcohol per time period.
Control | 0..1
Type | Base
22. EHDSSubstanceUse.frequencyAndQuantity.quantity
Definition | Quantity (volume per time unit).
Short | Quantity (volume per time unit).
Control | 1..1
Type | Quantity
24. EHDSSubstanceUse.frequencyAndQuantity.periodOfUse
Definition | Time period of substance use.
Short | Time period of substance use.
Control | 0..1
Type | Period
26. EHDSSubstanceUse.substanceType
Definition | Type of substance
Short | Type of substance
Control | 0..1
Binding | SNOMED CT
Type | CodeableConcept
28. EHDSSubstanceUse.routeOfAdministration
Definition | Route(s) of administration
Short | Route(s) of administration
Control | 0..*
Binding | EDQM
Type | CodeableConcept
30. EHDSSubstanceUse.note
Definition | Textual comment.
Short | Textual comment.
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension