# Substitution Status (2.8.2 - 1.1.0) - HL7 v2.8.2 Vocabulary v0.2.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Substitution Status (2.8.2 - 1.1.0)**

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

| | |
| :--- | :--- |
| *Official URL*:http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus | *Version*:1.1.0 |
| Active as of 2026-03-13 | *Computable Name*:SubstitutionStatus |
| *Other Identifiers:*OID:2.16.840.1.113883.18.85, urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0167 | |
| **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](ValueSet-hl7VSsubstitutionStatus.md)



## Resource Content

```json
{
  "resourceType" : "CodeSystem",
  "id" : "substitutionStatus",
  "extension" : [{
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-v2versionCreated",
    "valueString" : "2.8.2"
  },
  {
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-versionHistory",
    "valueString" : "generate correct history somehow"
  },
  {
    "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-tableNo",
    "valueString" : "0167"
  }],
  "url" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.18.85"
  },
  {
    "system" : "urn:ietf:rfc:3986",
    "value" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/v2-0167"
  }],
  "version" : "1.1.0",
  "name" : "SubstitutionStatus",
  "title" : "Substitution Status (2.8.2 - 1.1.0)",
  "status" : "active",
  "experimental" : true,
  "date" : "2026-03-13T11:11:43+00:00",
  "publisher" : "HL7/FO",
  "contact" : [{
    "name" : "HL7/FO",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org"
    }]
  }],
  "description" : "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.",
  "copyright" : "HL7 Inc., 2026",
  "caseSensitive" : true,
  "compositional" : false,
  "content" : "complete",
  "property" : [{
    "code" : "versionIntroduced",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionIntroduced",
    "description" : "version when was this code introduced",
    "type" : "string"
  },
  {
    "code" : "versionDeprecated",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#versionDeprecated",
    "description" : "version when was this code deprecated",
    "type" : "string"
  },
  {
    "code" : "status",
    "uri" : "http://hl7.org/fhir/concept-properties#status",
    "description" : "A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired",
    "type" : "code"
  },
  {
    "code" : "comment",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#comment",
    "description" : "A string that provides additional detail pertinent to the use or understanding of the concept",
    "type" : "string"
  },
  {
    "code" : "usage",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#usage",
    "description" : "usage notes for this code",
    "type" : "string"
  },
  {
    "code" : "modified",
    "uri" : "http://terminology.hl7.org/v2plusvocab/CodeSystem/Property#modified",
    "description" : "date of last modification",
    "type" : "dateTime"
  }],
  "concept" : [{
    "code" : "0",
    "display" : "No product selection indicated",
    "definition" : "No product selection indicated",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3.1"
    }]
  },
  {
    "code" : "1",
    "display" : "Substitution not allowed by prescriber",
    "definition" : "Substitution not allowed by prescriber",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3.1"
    }]
  },
  {
    "code" : "2",
    "display" : "Substitution allowed - patient requested product dispensed",
    "definition" : "Substitution allowed - patient requested product dispensed",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3.1"
    }]
  },
  {
    "code" : "3",
    "display" : "Substitution allowed - pharmacist selected product dispensed",
    "definition" : "Substitution allowed - pharmacist selected product dispensed",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3.1"
    }]
  },
  {
    "code" : "4",
    "display" : "Substitution allowed - generic drug not in stock",
    "definition" : "Substitution allowed - generic drug not in stock",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3.1"
    }]
  },
  {
    "code" : "5",
    "display" : "Substitution allowed - brand drug dispensed as a generic",
    "definition" : "Substitution allowed - brand drug dispensed as a generic",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3.1"
    }]
  },
  {
    "code" : "7",
    "display" : "Substitution not allowed - brand drug mandated by law",
    "definition" : "Substitution not allowed - brand drug mandated by law",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3.1"
    }]
  },
  {
    "code" : "8",
    "display" : "Substitution allowed - generic drug not available in marketplace",
    "definition" : "Substitution allowed - generic drug not available in marketplace",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.3.1"
    }]
  },
  {
    "code" : "G",
    "display" : "A generic substitution was dispensed",
    "definition" : "A generic substitution was dispensed.",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.2"
    }]
  },
  {
    "code" : "N",
    "display" : "No substitute was dispensed",
    "definition" : "No substitute was dispensed",
    "designation" : [{
      "language" : "de",
      "value" : "keine Substitution"
    }],
    "property" : [{
      "code" : "comment",
      "valueString" : "This is equivalent to the default (null) value."
    },
    {
      "code" : "modified",
      "valueDateTime" : "2025-07-30"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.2"
    }]
  },
  {
    "code" : "T",
    "display" : "A therapeutic substitution was dispensed",
    "definition" : "A therapeutic substitution was dispensed.",
    "property" : [{
      "code" : "modified",
      "valueDateTime" : "2015-07-13"
    },
    {
      "code" : "versionIntroduced",
      "valueString" : "2.2"
    }]
  }]
}

```
