HL7 v2.9 Vocabulary
0.2.0 - ci-build

HL7 v2.9 Vocabulary, published by HL7/FO. This guide is not an authorized publication; it is the continuous build for version 0.2.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.v29/ and changes regularly. See the Directory of published versions

## ValueSet: Substitution Status (2.9 - 1.1.0) (Experimental)

Official URL: http://terminology.hl7.org/v2plusvocab/ValueSet/hl7VSsubstitutionStatus | Version: 1.1.0
Active as of 2026-03-13 | Computable Name: Hl7VSsubstitutionStatus
Other Identifiers: OID:2.16.840.1.113883.21.97, urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#http://terminology.hl7.org/v2plusvocab/ValueSet/v2-0167
Copyright/Legal: HL7 Inc., 2026

Value Set of codes that specify the substitution status.

References

This value set is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)

### Logical Definition (CLD)

- Include all codes defined in `http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` version 📍1.1.0

### Expansion

Expansion performed internally based on codesystem Substitution Status (2.9 - 1.1.0) v1.1.0 (CodeSystem)

This value set contains 11 concepts

System | Code | Display (en) | Definition | JSON | XML
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | 0 | No product selection indicated | No product selection indicated |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | 1 | Substitution not allowed by prescriber | Substitution not allowed by prescriber |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | 2 | Substitution allowed - patient requested product dispensed | Substitution allowed - patient requested product dispensed |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | 3 | Substitution allowed - pharmacist selected product dispensed | Substitution allowed - pharmacist selected product dispensed |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | 4 | Substitution allowed - generic drug not in stock | Substitution allowed - generic drug not in stock |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | 5 | Substitution allowed - brand drug dispensed as a generic | Substitution allowed - brand drug dispensed as a generic |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | 7 | Substitution not allowed - brand drug mandated by law | Substitution not allowed - brand drug mandated by law |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | 8 | Substitution allowed - generic drug not available in marketplace | Substitution allowed - generic drug not available in marketplace |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | G | A generic substitution was dispensed | A generic substitution was dispensed. |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | N | No substitute was dispensed | No substitute was dispensed |  |
`http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus` | T | A therapeutic substitution was dispensed | A therapeutic substitution was dispensed. |  |

Explanation of the columns that may appear on this page:

Level | A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies
System | The source of the definition of the code (when the value set draws in codes defined elsewhere)
Code | The code (used as the code in the resource instance)
Display | The display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application
Definition | An explanation of the meaning of the concept
Comments | Additional notes about how to use the code