EX - Remaining Supply

Übersicht Über die Extension

Name	Description	Canonical_URL	Status	Version
RemainingSupplyEX	This extension is used to specify the remaining supply of a medication	https://gematik.de/fhir/erp-servicerequest/StructureDefinition/remaining-supply-ex	draft	1.2

Über die Extension

Motivation

Diese Extension gibt strukturiert darüber Auskunft, wie lange die Reichweite der Medikation noch dauert. Angabe erfolgt mit Wert und Einheit, die per Freitext unter .unit angegeben wird. Bsp: 7 Stück.

Inhalt der Extension

Folgende Ansichten existieren die Extension:

RemainingSupplyEX (Extension)	I		Extension	There are no (further) constraints on this element Element id Extension Short description Optional Extensions Element Definition Optional Extension Element - found in all resources. Data type Extension Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
id		0..1	string	There are no (further) constraints on this element Element id Extension.id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..0	Extension	There are no (further) constraints on this element Element id Extension.extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
url		1..1	uriFixed Value	Element id Extension.url Short description identifies the meaning of the extension Definition Source of the definition for the extension code - a logical name or a URL. Comments The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension. Data type uri Fixed value https://gematik.de/fhir/erp-servicerequest/StructureDefinition/remaining-supply-ex Mappings rim: N/A
value[x]	S	1..1		There are no (further) constraints on this element Element id Extension.value[x] Short description Value of extension Definition Value of extension - must be one of a constrained set of the data types (see Extensibility for a list). Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a rim: N/A
valueQuantity			Quantity	Data type Quantity
id		0..1	string	There are no (further) constraints on this element Element id Extension.value[x].id Short description Unique id for inter-element referencing Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces. Data type string Mappings rim: n/a
extension	I	0..*	Extension	There are no (further) constraints on this element Element id Extension.value[x].extension Short description Additional content defined by implementations Alternate names extensions, user content Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone. Data type Extension Sliced: Unordered, Open, by url(Value) Extensions are always sliced by (at least) url Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()` Mappings rim: n/a rim: N/A
value	S Σ	1..1	decimal	There are no (further) constraints on this element Element id Extension.value[x].value Short description Numerical value (with implicit precision) Definition The value of the measured amount. The value includes an implicit precision in the presentation of the value. Requirements Precision is handled implicitly in almost all cases of measurement. Comments The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books). Data type decimal Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: SN.2 / CQ - N/A rim: PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
comparator	Σ ?!	0..1	codeBinding	There are no (further) constraints on this element Element id Extension.value[x].comparator Short description < \| <= \| >= \| > - how to understand the value Definition How the value should be understood and represented - whether the actual value is greater or less than the stated value due to measurement issues; e.g. if the comparator is "<" , then the real value is < stated value. Requirements Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Meaning when missing If there is no comparator, then there is no modification of the value Data type code Binding How the Quantity should be understood and represented. QuantityComparator (required) Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: SN.1 / CQ.1 rim: IVL properties
unit	S Σ	1..1	string	There are no (further) constraints on this element Element id Extension.value[x].unit Short description Unit representation Definition A human-readable form of the unit. Requirements There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms. Comments Note that FHIR strings SHALL NOT exceed 1MB in size Data type string Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: (see OBX.6 etc.) / CQ.2 rim: PQ.unit
system	Σ I	0..1	uri	There are no (further) constraints on this element Element id Extension.value[x].system Short description System that defines coded unit form Definition The identification of the system that provides the coded form of the unit. Requirements Need to know the system that defines the coded form of the unit. Comments see http://en.wikipedia.org/wiki/Uniform_resource_identifier Data type uri Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: (see OBX.6 etc.) / CQ.2 rim: CO.codeSystem, PQ.translation.codeSystem
code	Σ	0..1	code	There are no (further) constraints on this element Element id Extension.value[x].code Short description Coded form of the unit Definition A computer processable form of the unit in some unit representation system. Requirements Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest. Comments The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system. Data type code Constraints ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` Mappings rim: n/a v2: (see OBX.6 etc.) / CQ.2 rim: PQ.code, MO.currency, PQ.translation.code

Extension
Definition	Optional Extension Element - found in all resources.
Cardinality	0...*
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Extension.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Extension.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...0
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Extension.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Cardinality	1...1
Type	uri
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Fixed Value	https://gematik.de/fhir/erp-servicerequest/StructureDefinition/remaining-supply-ex
Mappings	rim: N/A
Extension.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see [Extensibility](extensibility.html) for a list).
Cardinality	1...1
Type	Quantity
Must Support	True
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a rim: N/A
Extension.value[x].id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality	0...1
Type	string
Mappings	rim: n/a
Extension.value[x].extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality	0...*
Type	Extension
Alias	extensions, user content
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Slicing	Unordered, Open, by url(Value)
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())` ext-1: Must have either extensions or value[x], not both `extension.exists() != value.exists()`
Mappings	rim: n/a rim: N/A
Extension.value[x].value
Definition	The value of the measured amount. The value includes an implicit precision in the presentation of the value.
Cardinality	1...1
Type	decimal
Must Support	True
Summary	True
Requirements	Precision is handled implicitly in almost all cases of measurement.
Comments	The implicit precision in the value should always be honored. Monetary values have their own rules for handling precision (refer to standard accounting text books).
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: SN.2 / CQ - N/A rim: PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value
Extension.value[x].comparator
Definition	How the value should be understood and represented - whether the actual value is greater or less than the stated value due to measurement issues; e.g. if the comparator is "<" , then the real value is < stated value.
Cardinality	0...1
Type	code
Binding	How the Quantity should be understood and represented. QuantityComparator (required)
Modifier	True
Summary	True
Requirements	Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology.
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: SN.1 / CQ.1 rim: IVL properties
Extension.value[x].unit
Definition	A human-readable form of the unit.
Cardinality	1...1
Type	string
Must Support	True
Summary	True
Requirements	There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms.
Comments	Note that FHIR strings SHALL NOT exceed 1MB in size
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: (see OBX.6 etc.) / CQ.2 rim: PQ.unit
Extension.value[x].system
Definition	The identification of the system that provides the coded form of the unit.
Cardinality	0...1
Type	uri
Summary	True
Requirements	Need to know the system that defines the coded form of the unit.
Comments	see http://en.wikipedia.org/wiki/Uniform_resource_identifier
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: (see OBX.6 etc.) / CQ.2 rim: CO.codeSystem, PQ.translation.codeSystem
Extension.value[x].code
Definition	A computer processable form of the unit in some unit representation system.
Cardinality	0...1
Type	code
Summary	True
Requirements	Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest.
Comments	The preferred system is UCUM, but SNOMED CT can also be used (for customary units) or ISO 4217 for currency. The context of use may additionally require a code from a particular system.
Invariants	ele-1: All FHIR elements must have a @value or children `hasValue() or (children().count() > id.count())`
Mappings	rim: n/a v2: (see OBX.6 etc.) / CQ.2 rim: PQ.code, MO.currency, PQ.translation.code

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="remaining-supply-ex" />
    <url value="https://gematik.de/fhir/erp-servicerequest/StructureDefinition/remaining-supply-ex" />
    <version value="1.2" />
    <name value="RemainingSupplyEX" />
    <title value="Remaining Supply EX" />
    <status value="draft" />
    <experimental value="false" />
    <date value="2025-01-01" />
    <publisher value="gematik GmbH" />
    <description value="This extension is used to specify the remaining supply of a medication" />
    <fhirVersion value="4.0.1" />
    <kind value="complex-type" />
    <abstract value="false" />
    <context>
        <type value="element" />
        <expression value="Element" />
    </context>
    <type value="Extension" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Extension" />
    <derivation value="constraint" />
    <differential>
        <element id="Extension.extension">
            <path value="Extension.extension" />
            <max value="0" />
        </element>
        <element id="Extension.url">
            <path value="Extension.url" />
            <fixedUri value="https://gematik.de/fhir/erp-servicerequest/StructureDefinition/remaining-supply-ex" />
        </element>
        <element id="Extension.value[x]">
            <path value="Extension.value[x]" />
            <min value="1" />
            <type>
                <code value="Quantity" />
            </type>
            <mustSupport value="true" />
        </element>
        <element id="Extension.value[x].value">
            <path value="Extension.value[x].value" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="Extension.value[x].unit">
            <path value="Extension.value[x].unit" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
    </differential>
</StructureDefinition>

{
    "resourceType": "StructureDefinition",
    "id": "remaining-supply-ex",
    "url": "https://gematik.de/fhir/erp-servicerequest/StructureDefinition/remaining-supply-ex",
    "version": "1.2",
    "name": "RemainingSupplyEX",
    "title": "Remaining Supply EX",
    "status": "draft",
    "experimental": false,
    "date": "2025-01-01",
    "publisher": "gematik GmbH",
    "description": "This extension is used to specify the remaining supply of a medication",
    "fhirVersion": "4.0.1",
    "kind": "complex-type",
    "abstract": false,
    "context":  [
        {
            "type": "element",
            "expression": "Element"
        }
    ],
    "type": "Extension",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Extension",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "Extension.extension",
                "path": "Extension.extension",
                "max": "0"
            },
            {
                "id": "Extension.url",
                "path": "Extension.url",
                "fixedUri": "https://gematik.de/fhir/erp-servicerequest/StructureDefinition/remaining-supply-ex"
            },
            {
                "id": "Extension.value[x]",
                "path": "Extension.value[x]",
                "min": 1,
                "type":  [
                    {
                        "code": "Quantity"
                    }
                ],
                "mustSupport": true
            },
            {
                "id": "Extension.value[x].value",
                "path": "Extension.value[x].value",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "Extension.value[x].unit",
                "path": "Extension.value[x].unit",
                "min": 1,
                "mustSupport": true
            }
        ]
    }
}

Remaining Supply EX