HL7 v2.8 Vocabulary
0.1.0 - ci-build

HL7 v2.8 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.v28/ and changes regularly. See the Directory of published versions

## : Substitution Status (2.8 - 1.1.0) - JSON Representation

Active as of 2026-01-27

Raw json | Download

    {
      "resourceType" : "CodeSystem",
      "id" : "substitutionStatus",
      "text" : {
        "status" : "generated",
        "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><ul><li>Include all codes defined in <a href=\"CodeSystem-substitutionStatus.html\"><code>http://terminology.hl7.org/v2plusvocab/CodeSystem/substitutionStatus</code></a></li></ul></div>"
      },
      "extension" : [
        {
          "url" : "http://terminology.hl7.org/v2plusvocab/StructureDefinition/codesystem-v2versionCreated",
          "valueString" : "2.8"
        },
        {
          "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"
        }
      ],
      "version" : "1.1.0",
      "name" : "SubstitutionStatus",
      "title" : "Substitution Status (2.8 - 1.1.0)",
      "status" : "active",
      "experimental" : true,
      "date" : "2026-01-27T19:37:03+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" : "versionIntroduced",
              "valueString" : "2.3.1"
            }
          ]
        },
        {
          "code" : "1",
          "display" : "Substitution not allowed by prescriber",
          "definition" : "Substitution not allowed by prescriber",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.3.1"
            }
          ]
        },
        {
          "code" : "2",
          "display" : "Substitution allowed - patient requested product dispensed",
          "definition" : "Substitution allowed - patient requested product dispensed",
          "property" : [
            {
              "code" : "versionIntroduced",
              "valueString" : "2.3.1"
            }
          ]
        },
        {
          "code" : "3",
          "display" : "Substitution allowed - pharmacist selected product dispensed",
          "definition" : "Substitution allowed - pharmacist selected product dispensed",
          "property" : [
            {
              "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" : "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" : "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" : "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" : "versionIntroduced",
              "valueString" : "2.3.1"
            }
          ]
        },
        {
          "code" : "G",
          "display" : "A generic substitution was dispensed",
          "definition" : "A generic substitution was dispensed.",
          "property" : [
            {
              "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" : "versionIntroduced",
              "valueString" : "2.2"
            }
          ]
        }
      ]
    }