ERA FHIR specification - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Extension: Extension substitutionInfo
| Official URL: https://eradocumentation.atostek.com/StructureDefinition/extension/substitutionInfo | Version: 1.0.0 | |||
| Draft as of 2026-04-29 | Computable Name: SubstitutionInfo | |||
Complex extension containing substitution information for a medication.
Context of Use
-
Element ID:
MedicationKnowledge
This extension may be used on the following element(s)
Usage info
Usages:
- Use this Extension: EraDrugDatabaseFiMedicationKnowledge
You can also check for usages in the FHIR IG Statistics
Formal Views of Extension Content
Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
This structure is derived from Extension
| Name | Flags | Card. | Type | Description & Constraints Filter:  |
|---|---|---|---|---|
  Extension |
0..1 | Extension | Substitution information | |
  Slices for extension |
3..6 | Extension | Extension Slice: Unordered, Closed by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
   extension:substitutionGroupCode |
1..1 | Extension | Substitution group code | |
   extension |
0..0 | Extension | ||
| url |
1..1 | uri | "substitutionGroupCode" | |
  value[x] |
1..1 | Coding | Value of extension | |
  system |
1..1 | uri | Identity of the terminology system Fixed Value: https://eradocumentation.atostek.com/CodeSystem/drugFiSubstitutionGroup (no extensions allowed) | |
| version |
0..0 | Version of the system - if relevant | ||
| code |
1..1 | code | Symbol in syntax defined by the system | |
 userSelected |
0..0 | If this coding was chosen directly by the user | ||
| extension:substitutionCode |
1..1 | Extension | Substitution code | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "substitutionCode" | |
| value[x] |
1..1 | Coding | Value of extension | |
| system |
0..0 | Identity of the terminology system | ||
| version |
0..0 | Version of the system - if relevant | ||
| code |
1..1 | code | Symbol in syntax defined by the system | |
| userSelected |
0..0 | If this coding was chosen directly by the user | ||
| extension:substitutionObligation |
0..1 | Extension | Substitution obligation | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "substitutionObligation" | |
  value[x] |
1..1 | boolean | Value of extension | |
| extension:referencePrice |
0..1 | Extension | Reference price | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "referencePrice" | |
| value[x] |
1..1 | Money | Value of extension | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Fixed Value: EUR (no extensions allowed) | |
 extension:referencePriceRange |
1..1 | Extension | Reference price range | |
| Slices for extension |
2..2 | Extension | Extension Slice: Unordered, Closed by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
 Slices for extension |
Content/Rules for all slices | |||
 extension:low |
1..1 | Extension | Low price | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "low" | |
| value[x] |
1..1 | Money | Value of extension | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Fixed Value: EUR (no extensions allowed) | |
| extension:high |
1..1 | Extension | High price | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "high" | |
| value[x] |
1..1 | Money | Value of extension | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Fixed Value: EUR (no extensions allowed) | |
| url |
1..1 | uri | "referencePriceRange" | |
| value[x] |
0..0 | Value of extension | ||
| url |
1..1 | uri | "https://eradocumentation.atostek.com/StructureDefinition/extension/substitutionInfo" | |
| value[x] |
0..0 | Value of extension | ||
| Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Extension |
0..1 | Extension | Substitution information | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| Slices for extension |
3..6 | Extension | Extension Slice: Unordered, Closed by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| extension:substitutionGroupCode |
1..1 | Extension | Substitution group code | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "substitutionGroupCode" | |
| value[x] |
1..1 | Coding | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| system |
1..1 | uri | Identity of the terminology system Fixed Value: https://eradocumentation.atostek.com/CodeSystem/drugFiSubstitutionGroup (no extensions allowed) | |
| code |
1..1 | code | Symbol in syntax defined by the system | |
| display |
0..1 | string | Representation defined by the system | |
| extension:substitutionCode |
1..1 | Extension | Substitution code | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "substitutionCode" | |
| value[x] |
1..1 | Coding | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| code |
1..1 | code | Symbol in syntax defined by the system | |
| display |
0..1 | string | Representation defined by the system | |
| extension:substitutionObligation |
0..1 | Extension | Substitution obligation | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "substitutionObligation" | |
| value[x] |
1..1 | boolean | Value of extension | |
| extension:referencePrice |
0..1 | Extension | Reference price | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "referencePrice" | |
| value[x] |
1..1 | Money | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: EUR (no extensions allowed) | |
| extension:referencePriceRange |
1..1 | Extension | Reference price range | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| Slices for extension |
2..2 | Extension | Extension Slice: Unordered, Closed by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| Slices for extension |
Content/Rules for all slices | |||
| extension:low |
1..1 | Extension | Low price | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "low" | |
| value[x] |
1..1 | Money | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: EUR (no extensions allowed) | |
| extension:high |
1..1 | Extension | High price | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "high" | |
| value[x] |
1..1 | Money | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: EUR (no extensions allowed) | |
| url |
1..1 | uri | "referencePriceRange" | |
| url |
1..1 | uri | "https://eradocumentation.atostek.com/StructureDefinition/extension/substitutionInfo" | |
| Documentation for this format | ||||
This structure is derived from Extension
Summary
Complex Extension: Complex extension containing substitution information for a medication.
- substitutionGroupCode: Coding: The substitution group code for this medication.
- substitutionCode: Coding: The substitution code for this medication.
- substitutionObligation: boolean: Indicates whether substitution is obligatory.
- referencePrice: Money: The reference price for this medication.
- low: Money: The low end of the reference price range.
- high: Money: The high end of the reference price range.
Differential View
This structure is derived from Extension
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Extension |
0..1 | Extension | Substitution information | |
| Slices for extension |
3..6 | Extension | Extension Slice: Unordered, Closed by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| extension:substitutionGroupCode |
1..1 | Extension | Substitution group code | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "substitutionGroupCode" | |
| value[x] |
1..1 | Coding | Value of extension | |
| system |
1..1 | uri | Identity of the terminology system Fixed Value: https://eradocumentation.atostek.com/CodeSystem/drugFiSubstitutionGroup (no extensions allowed) | |
| version |
0..0 | Version of the system - if relevant | ||
| code |
1..1 | code | Symbol in syntax defined by the system | |
| userSelected |
0..0 | If this coding was chosen directly by the user | ||
| extension:substitutionCode |
1..1 | Extension | Substitution code | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "substitutionCode" | |
| value[x] |
1..1 | Coding | Value of extension | |
| system |
0..0 | Identity of the terminology system | ||
| version |
0..0 | Version of the system - if relevant | ||
| code |
1..1 | code | Symbol in syntax defined by the system | |
| userSelected |
0..0 | If this coding was chosen directly by the user | ||
| extension:substitutionObligation |
0..1 | Extension | Substitution obligation | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "substitutionObligation" | |
| value[x] |
1..1 | boolean | Value of extension | |
| extension:referencePrice |
0..1 | Extension | Reference price | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "referencePrice" | |
| value[x] |
1..1 | Money | Value of extension | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Fixed Value: EUR (no extensions allowed) | |
| extension:referencePriceRange |
1..1 | Extension | Reference price range | |
| Slices for extension |
2..2 | Extension | Extension Slice: Unordered, Closed by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| Slices for extension |
Content/Rules for all slices | |||
| extension:low |
1..1 | Extension | Low price | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "low" | |
| value[x] |
1..1 | Money | Value of extension | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Fixed Value: EUR (no extensions allowed) | |
| extension:high |
1..1 | Extension | High price | |
| extension |
0..0 | Extension | ||
| url |
1..1 | uri | "high" | |
| value[x] |
1..1 | Money | Value of extension | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Fixed Value: EUR (no extensions allowed) | |
| url |
1..1 | uri | "referencePriceRange" | |
| value[x] |
0..0 | Value of extension | ||
| url |
1..1 | uri | "https://eradocumentation.atostek.com/StructureDefinition/extension/substitutionInfo" | |
| value[x] |
0..0 | Value of extension | ||
| Documentation for this format | ||||
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: |
|---|---|---|---|---|
| Extension |
0..1 | Extension | Substitution information | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| Slices for extension |
3..6 | Extension | Extension Slice: Unordered, Closed by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| extension:substitutionGroupCode |
1..1 | Extension | Substitution group code | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "substitutionGroupCode" | |
| value[x] |
1..1 | Coding | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| system |
1..1 | uri | Identity of the terminology system Fixed Value: https://eradocumentation.atostek.com/CodeSystem/drugFiSubstitutionGroup (no extensions allowed) | |
| code |
1..1 | code | Symbol in syntax defined by the system | |
| display |
0..1 | string | Representation defined by the system | |
| extension:substitutionCode |
1..1 | Extension | Substitution code | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "substitutionCode" | |
| value[x] |
1..1 | Coding | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| code |
1..1 | code | Symbol in syntax defined by the system | |
| display |
0..1 | string | Representation defined by the system | |
| extension:substitutionObligation |
0..1 | Extension | Substitution obligation | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "substitutionObligation" | |
| value[x] |
1..1 | boolean | Value of extension | |
| extension:referencePrice |
0..1 | Extension | Reference price | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "referencePrice" | |
| value[x] |
1..1 | Money | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: EUR (no extensions allowed) | |
| extension:referencePriceRange |
1..1 | Extension | Reference price range | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| Slices for extension |
2..2 | Extension | Extension Slice: Unordered, Closed by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
| Slices for extension |
Content/Rules for all slices | |||
| extension:low |
1..1 | Extension | Low price | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "low" | |
| value[x] |
1..1 | Money | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: EUR (no extensions allowed) | |
| extension:high |
1..1 | Extension | High price | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..0 | Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | ||
| url |
1..1 | uri | "high" | |
| value[x] |
1..1 | Money | Value of extension | |
| id |
0..1 | string | Unique id for inter-element referencing | |
| extension |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
| value |
1..1 | decimal | Numerical value (with implicit precision) | |
| currency |
1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: EUR (no extensions allowed) | |
| url |
1..1 | uri | "referencePriceRange" | |
| url |
1..1 | uri | "https://eradocumentation.atostek.com/StructureDefinition/extension/substitutionInfo" | |
| Documentation for this format | ||||
This structure is derived from Extension
Summary
Complex Extension: Complex extension containing substitution information for a medication.
- substitutionGroupCode: Coding: The substitution group code for this medication.
- substitutionCode: Coding: The substitution code for this medication.
- substitutionObligation: boolean: Indicates whether substitution is obligatory.
- referencePrice: Money: The reference price for this medication.
- low: Money: The low end of the reference price range.
- high: Money: The high end of the reference price range.
Other representations of profile: CSV, Excel, Schematron
Terminology Bindings
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.extension:referencePrice.value[x].currency | Base | required | CurrencyCode | 📍4.0.1 | FHIR Std. |
| Extension.extension:referencePriceRange.extension:low.value[x].currency | Base | required | CurrencyCode | 📍4.0.1 | FHIR Std. |
| Extension.extension:referencePriceRange.extension:high.value[x].currency | Base | required | CurrencyCode | 📍4.0.1 | FHIR Std. |
Constraints
| Id | Grade | Path(s) | Description | Expression |
| 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()
|