HL7 v2.3.1 Vocabulary
0.1.0 - ci-build

HL7 v2.3.1 Vocabulary, published by HL7/FO. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/frankoemig/hl7.v2.terminology.v231/ and changes regularly. See the Directory of published versions

## CodeSystem: Substitution Status (2.3.1 - 1.1.0) (Experimental)

Official URL: http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus | Version: 1.1.0
Active as of 2026-01-27 | Computable Name: SubstitutionStatus
Other Identifiers: OID:2.16.840.1.113883.18.85
Copyright/Legal: HL7 Inc., 2026

HL7-defined code system of concepts which specify the substitution status. Used in HL7 Version 2.x messaging in the RXE, RXD, and RXG segments.

This Code system is referenced in the content logical definition of the following value sets:

- Hl7VSsubstitutionStatus

Properties

This code system defines the following properties for its concepts

Name | Code | URI | Type | Description
versionIntroduced | versionIntroduced | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced | string | version when was this code introduced
versionDeprecated | versionDeprecated | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionDeprecated | string | version when was this code deprecated
status | status | http://hl7.org/fhir/concept-properties#status | code | A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired
comment | comment | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#comment | string | A string that provides additional detail pertinent to the use or understanding of the concept
usage | usage | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#usage | string | usage notes for this code
modified | modified | http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#modified | dateTime | date of last modification

Concepts

This case-sensitive code system `http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` defines the following codes:

Code | Display | Definition | versionIntroduced | comment | modified | Deutsch (German, de)
0 | No product selection indicated | No product selection indicated | 2.3.1 |  |  |
1 | Substitution not allowed by prescriber | Substitution not allowed by prescriber | 2.3.1 |  |  |
2 | Substitution allowed - patient requested product dispensed | Substitution allowed - patient requested product dispensed | 2.3.1 |  |  |
3 | Substitution allowed - pharmacist selected product dispensed | Substitution allowed - pharmacist selected product dispensed | 2.3.1 |  |  |
4 | Substitution allowed - generic drug not in stock | Substitution allowed - generic drug not in stock | 2.3.1 |  |  |
5 | Substitution allowed - brand drug dispensed as a generic | Substitution allowed - brand drug dispensed as a generic | 2.3.1 |  |  |
7 | Substitution not allowed - brand drug mandated by law | Substitution not allowed - brand drug mandated by law | 2.3.1 |  |  |
8 | Substitution allowed - generic drug not available in marketplace | Substitution allowed - generic drug not available in marketplace | 2.3.1 |  |  |
G | A generic substitution was dispensed | A generic substitution was dispensed. | 2.2 |  |  |
N | No substitute was dispensed | No substitute was dispensed | 2.2 | This is equivalent to the default (null) value. | 2025-07-30 | keine Substitution
T | A therapeutic substitution was dispensed | A therapeutic substitution was dispensed. | 2.2 |  |  |