{
  "description": "Codes that the type of an issue in the response to a $validate-code operation. The validator will handle some types of issues differently. In the absence of an issue type, issues are passed to the user without processing, and this may be confusing to users",
  "_filename": "CodeSystem-tx-issue-type.json",
  "package_name": "hl7.fhir.uv.tools",
  "date": "2026-09-15T11:23:23+10:00",
  "publisher": "HL7 International / FHIR Infrastructure",
  "jurisdiction": [ {
    "coding": [ {
      "code": "001",
      "system": "http://unstats.un.org/unsd/methods/m49/m49.htm"
    } ]
  } ],
  "content": "complete",
  "name": "TerminologyIssueType",
  "type": null,
  "experimental": "false",
  "resourceType": "CodeSystem",
  "title": "Terminology Issue Type",
  "package_version": "1.2.0",
  "extension": [ {
    "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger": 4
  }, {
    "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode": "fhir"
  }, {
    "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode": "informative",
    "_valueCode": {
      "extension": [ {
        "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical": "http://hl7.org/fhir/tools/ImplementationGuide/hl7.fhir.uv.tools"
      } ]
    }
  } ],
  "compositional": true,
  "status": "active",
  "id": "fb318ba5-e76c-4a3c-9c2e-6c01b6ec4241",
  "kind": null,
  "url": "http://hl7.org/fhir/tools/CodeSystem/tx-issue-type",
  "identifier": [ {
    "value": "urn:oid:2.16.840.1.113883.4.642.40.1.16.12",
    "system": "urn:ietf:rfc:3986"
  } ],
  "concept": [ {
    "code": "not-found",
    "display": "Not Found",
    "definition": "An issue that identifies a code system or value set that was not found validating the code(s)"
  }, {
    "code": "not-in-vs",
    "display": "Not in ValueSet",
    "definition": "An issue that represents the value set validation failure"
  }, {
    "code": "this-code-not-in-vs",
    "display": "This code not in valueset",
    "definition": "An issue that indicates that a particular code as not in the value set (but others might be)"
  }, {
    "code": "invalid-data",
    "display": "Invalid Data",
    "definition": "An issue that indicates that the code/Coding/CodeableConcept provided was invalid"
  }, {
    "code": "invalid-code",
    "display": "Invalid Code",
    "definition": "An issue that indicates that a provided code is not valid in a code system"
  }, {
    "code": "code-comment",
    "display": "Code Comment",
    "definition": "An issue that provides some hints or warnings about the use of the code, but does not indicate that is invalid"
  }, {
    "code": "invalid-display",
    "display": "Invalid Display",
    "definition": "An issue relating to the display provided for a code"
  }, {
    "code": "display-comment",
    "display": "Display Comment",
    "definition": "An issue that provides some hints or warnings about the use of the display, but does not indicate that is invalid"
  }, {
    "code": "cannot-infer",
    "display": "Cannot Infer System",
    "definition": "An issue indicating why inferring the code system failed (for type=code)"
  }, {
    "code": "code-rule",
    "display": "Code Rule",
    "definition": "An issue indicating that a valid code was not valid in this context"
  }, {
    "code": "vs-invalid",
    "display": "ValueSet Invalid",
    "definition": "An issue relating to a problem processing a value set while validating"
  }, {
    "code": "status-check",
    "display": "Status Check",
    "definition": "An issue pertaining to the status of the underlying resources"
  }, {
    "code": "cannot-determine",
    "display": "Cannot Determine",
    "definition": "An issue indicating that the server was unable to determine the answer to the question it was asked, and is declining to give one rather than giving one that may be wrong. This arises where an operation's outcome codes have no value meaning \"unknown\": $subsumes, for instance, can answer equivalent, subsumes, subsumed-by or not-subsumed, so a server that cannot establish the relationship - between SNOMED CT expressions that no classifier has seen, or between media types differing in a parameter the server does not understand - has no outcome it can honestly return. The client should treat the relationship as undetermined; it must not read this as a negative answer"
  }, {
    "code": "not-supported",
    "display": "Not Supported",
    "definition": "An issue indicating that the server understood the request but does not implement what it asks for: a parameter, filter or property it does not support, or a code system whose codes it cannot enumerate at all. The request is not wrong, so repeating it against this server will not produce a different answer, but another server may be able to give one"
  }, {
    "code": "too-costly",
    "display": "Too Costly",
    "definition": "An issue indicating that the server can work out the answer but the answer is too large or too expensive to produce - typically an expansion with more members than the server is prepared to return. Nothing is wrong with the value set: the client should narrow the request with a filter, or page through it with count and offset"
  }, {
    "code": "version-error",
    "display": "Version Error",
    "definition": "An issue arising from the versions of the resources involved rather than from the code or the value set: a version was asked for that does not exist, the same code system was pinned to two different versions in the one request, or a value set's stated version does not match the version it was fetched by. The client can usually recover by changing or dropping the version it named"
  }, {
    "code": "business-rule",
    "display": "Business Rule",
    "definition": "An issue indicating that the server is declining to process content because of a rule it enforces about what it will accept, rather than because the content is invalid - a resource carrying implicit rules or modifier extensions it cannot safely ignore, say, or a compose with a lockedDate. The content may be perfectly valid; this server will not act on it"
  }, {
    "code": "cache-id-duplicate",
    "display": "Duplicate Cache Id",
    "definition": "An issue indicating that the request carried more than one cache-id. Each request must carry exactly one; a server has no way to choose between them. This is a client error, and usually means a second cache was started on a connection that already had one without the first cache-id being removed"
  }, {
    "code": "cache-id-unknown",
    "display": "Unknown Cache",
    "definition": "An issue indicating that the cache-id provided by the client is not known to the server: it was never created (caches are created with $cache-control mode=start), or it has expired or been released. The client cannot continue to refer to resources by that cache-id, and should establish a new cache if it wishes to keep using one"
  } ],
  "caseSensitive": true,
  "version": "1.2.0",
  "contact": [ {
    "telecom": [ {
      "value": "http://www.hl7.org/Special/committees/fiwg",
      "system": "url"
    } ]
  } ]
}