HL7 Europe Laboratory Report
0.1.1 - trial-use 150

Publication Build: This will be filled in by the publication tooling

## Resource Profile: Substance: Specimen Additive Substance

Official URL: http://hl7.eu/fhir/laboratory/StructureDefinition/Substance-additive-eu-lab | Version: 0.1.1
Active as of 2025-03-25 | Computable Name: SpecimenAdditiveSubstance
Other Identifiers: OID:2.16.840.1.113883.2.51.22.1.42.29
Copyright/Legal: Used by permission of HL7 Europe, all rights reserved Creative Commons License

This profile defines how to represent Specimen Additive Substances in HL7 FHIR for the purpose of this guide.

Usage:

- Refer to this Resource Profile: Specimen: Laboratory

### 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
--- | --- | --- | --- | ---
Substance |  | 0..* | Substance | A homogeneous material with a definite composition dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated dom-5: If a resource is contained in another resource, it SHALL NOT have a security label dom-6: A resource should have narrative for robust management
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created ele-1: All FHIR elements must have a @value or children
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
status | ?!Σ | 0..1 | code | active | inactive | entered-in-error Binding: FHIRSubstanceStatus (required): A code to indicate if the substance is actively used. ele-1: All FHIR elements must have a @value or children
code | Σ | 1..1 | CodeableConcept | What substance this is Binding: Specimen Additive (preferred) ele-1: All FHIR elements must have a @value or children
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Substance.status | required | FHIRSubstanceStatus `http://hl7.org/fhir/ValueSet/substance-status|4.0.1` from the FHIR Standard
Substance.code | preferred | LabSpecimenAdditiveEu `http://hl7.eu/fhir/laboratory/ValueSet/lab-specimenAdditive-eu-lab` from this IG

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Substance | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Substance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | Substance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | Substance | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Substance | A resource should have narrative for robust management : text.`div`.exists() |
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 Substance

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Substance |  |  | Substance |
code |  | 1..1 | CodeableConcept | What substance this is Binding: Specimen Additive (preferred)
Documentation for this format

#### Terminology Bindings (Differential)

Path | Conformance | ValueSet | URI
Substance.code | preferred | LabSpecimenAdditiveEu `http://hl7.eu/fhir/laboratory/ValueSet/lab-specimenAdditive-eu-lab` from this IG

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Substance |  | 0..* | Substance | A homogeneous material with a definite composition
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 0..* | Identifier | Unique identifier
status | ?!Σ | 0..1 | code | active | inactive | entered-in-error Binding: FHIRSubstanceStatus (required): A code to indicate if the substance is actively used.
category | Σ | 0..* | CodeableConcept | What class/type of substance this is Binding: SubstanceCategoryCodes (extensible): Category or classification of substance.
code | Σ | 1..1 | CodeableConcept | What substance this is Binding: Specimen Additive (preferred)
description | Σ | 0..1 | string | Textual description of the substance, comments
instance | Σ | 0..* | BackboneElement | If this describes a specific package/container of the substance
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
identifier | Σ | 0..1 | Identifier | Identifier of the package/container
expiry | Σ | 0..1 | dateTime | When no longer valid to use
quantity | Σ | 0..1 | SimpleQuantity | Amount of substance in the package
ingredient | Σ | 0..* | BackboneElement | Composition information about the substance
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
quantity | Σ | 0..1 | Ratio | Optional amount (concentration)
substance[x] | Σ | 1..1 |  | A component of the substance Binding: SubstanceCode (example): Substance Ingredient codes.
substanceCodeableConcept |  |  | CodeableConcept |
substanceReference |  |  | Reference(Substance) |
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Substance.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` from the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding
Substance.status | required | FHIRSubstanceStatus `http://hl7.org/fhir/ValueSet/substance-status|4.0.1` from the FHIR Standard
Substance.category | extensible | SubstanceCategoryCodes `http://hl7.org/fhir/ValueSet/substance-category` from the FHIR Standard
Substance.code | preferred | LabSpecimenAdditiveEu `http://hl7.eu/fhir/laboratory/ValueSet/lab-specimenAdditive-eu-lab` from this IG
Substance.ingredient.substance[x] | example | SubstanceCode `http://hl7.org/fhir/ValueSet/substance-code` from the FHIR Standard

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Substance | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Substance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | Substance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | Substance | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Substance | A resource should have narrative for robust management : text.`div`.exists() |
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 Substance

Summary

Key Elements View

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Substance |  | 0..* | Substance | A homogeneous material with a definite composition dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated dom-5: If a resource is contained in another resource, it SHALL NOT have a security label dom-6: A resource should have narrative for robust management
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created ele-1: All FHIR elements must have a @value or children
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
status | ?!Σ | 0..1 | code | active | inactive | entered-in-error Binding: FHIRSubstanceStatus (required): A code to indicate if the substance is actively used. ele-1: All FHIR elements must have a @value or children
code | Σ | 1..1 | CodeableConcept | What substance this is Binding: Specimen Additive (preferred) ele-1: All FHIR elements must have a @value or children
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Substance.status | required | FHIRSubstanceStatus `http://hl7.org/fhir/ValueSet/substance-status|4.0.1` from the FHIR Standard
Substance.code | preferred | LabSpecimenAdditiveEu `http://hl7.eu/fhir/laboratory/ValueSet/lab-specimenAdditive-eu-lab` from this IG

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Substance | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Substance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | Substance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | Substance | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Substance | A resource should have narrative for robust management : text.`div`.exists() |
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 Substance

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Substance |  |  | Substance |
code |  | 1..1 | CodeableConcept | What substance this is Binding: Specimen Additive (preferred)
Documentation for this format

#### Terminology Bindings (Differential)

Path | Conformance | ValueSet | URI
Substance.code | preferred | LabSpecimenAdditiveEu `http://hl7.eu/fhir/laboratory/ValueSet/lab-specimenAdditive-eu-lab` from this IG

Snapshot View

Name | Flags | Card. | Type | Description & Constraints
--- | --- | --- | --- | ---
Substance |  | 0..* | Substance | A homogeneous material with a definite composition
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 0..* | Identifier | Unique identifier
status | ?!Σ | 0..1 | code | active | inactive | entered-in-error Binding: FHIRSubstanceStatus (required): A code to indicate if the substance is actively used.
category | Σ | 0..* | CodeableConcept | What class/type of substance this is Binding: SubstanceCategoryCodes (extensible): Category or classification of substance.
code | Σ | 1..1 | CodeableConcept | What substance this is Binding: Specimen Additive (preferred)
description | Σ | 0..1 | string | Textual description of the substance, comments
instance | Σ | 0..* | BackboneElement | If this describes a specific package/container of the substance
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
identifier | Σ | 0..1 | Identifier | Identifier of the package/container
expiry | Σ | 0..1 | dateTime | When no longer valid to use
quantity | Σ | 0..1 | SimpleQuantity | Amount of substance in the package
ingredient | Σ | 0..* | BackboneElement | Composition information about the substance
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
quantity | Σ | 0..1 | Ratio | Optional amount (concentration)
substance[x] | Σ | 1..1 |  | A component of the substance Binding: SubstanceCode (example): Substance Ingredient codes.
substanceCodeableConcept |  |  | CodeableConcept |
substanceReference |  |  | Reference(Substance) |
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Substance.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` from the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding
Substance.status | required | FHIRSubstanceStatus `http://hl7.org/fhir/ValueSet/substance-status|4.0.1` from the FHIR Standard
Substance.category | extensible | SubstanceCategoryCodes `http://hl7.org/fhir/ValueSet/substance-category` from the FHIR Standard
Substance.code | preferred | LabSpecimenAdditiveEu `http://hl7.eu/fhir/laboratory/ValueSet/lab-specimenAdditive-eu-lab` from this IG
Substance.ingredient.substance[x] | example | SubstanceCode `http://hl7.org/fhir/ValueSet/substance-code` from the FHIR Standard

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Substance | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Substance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | Substance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | Substance | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Substance | A resource should have narrative for robust management : text.`div`.exists() |
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 Substance

Summary

Other representations of profile: CSV, Excel, Schematron