# Resource Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam



## Resource Content

```json
{
  "resourceType" : "ImplementationGuide",
  "id" : "hl7.fhir.vn.core",
  "language" : "vi",
  "url" : "http://fhir.hl7.org.vn/core/ImplementationGuide/hl7.fhir.vn.core",
  "version" : "0.5.0",
  "name" : "VNCoreIG",
  "title" : "Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam",
  "status" : "draft",
  "date" : "2026-04-29T14:58:55+07:00",
  "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
  "contact" : [{
    "name" : "Omi HealthTech / VN Core FHIR Community Initiative",
    "telecom" : [{
      "system" : "url",
      "value" : "https://hl7.org.vn"
    },
    {
      "system" : "email",
      "value" : "info@hl7.org.vn"
    }]
  },
  {
    "name" : "Omi HealthTech (OmiGroup)",
    "telecom" : [{
      "system" : "url",
      "value" : "https://omihealthtech.vn"
    },
    {
      "system" : "url",
      "value" : "https://omigroup.vn"
    },
    {
      "system" : "email",
      "value" : "healthtech@omigroup.vn"
    }]
  }],
  "description" : "Bộ Hướng dẫn Triển khai HL7 FHIR cốt lõi cho Việt Nam, xây dựng theo chuẩn FHIR R4 (4.0.1), tuân thủ khung pháp lý Việt Nam 2025-2026. Đây là dự án mã nguồn mở do Omi HealthTech (OmiGroup) khởi xướng và đầu tư phát triển với tinh thần đóng góp cộng đồng cho sự phát triển của ngành Y tế số Việt Nam, hướng tới khả năng tương tác (interoperability) giữa các hệ thống y tế trong nước và hội nhập chuẩn quốc tế HL7. Mọi cá nhân, tổ chức, cơ sở y tế, doanh nghiệp công nghệ y tế đều được khuyến khích tham gia đóng góp, sử dụng và phản hồi.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "packageId" : "hl7.fhir.vn.core",
  "license" : "CC-BY-4.0",
  "fhirVersion" : ["4.0.1"],
  "dependsOn" : [{
    "id" : "hl7ext",
    "extension" : [{
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/implementationguide-dependency-comment",
      "valueMarkdown" : "Automatically added as a dependency - all IGs depend on the HL7 Extension Pack"
    }],
    "uri" : "http://hl7.org/fhir/extensions/ImplementationGuide/hl7.fhir.uv.extensions",
    "packageId" : "hl7.fhir.uv.extensions.r4",
    "version" : "5.2.0"
  },
  {
    "id" : "hl7_terminology_r4",
    "uri" : "http://terminology.hl7.org/ImplementationGuide/hl7.terminology",
    "packageId" : "hl7.terminology.r4",
    "version" : "7.1.0"
  }],
  "definition" : {
    "extension" : [{
      "extension" : [{
        "url" : "code",
        "valueString" : "copyrightyear"
      },
      {
        "url" : "value",
        "valueString" : "2026+"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "releaselabel"
      },
      {
        "url" : "value",
        "valueString" : "Draft for Community Review"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "show-inherited-invariants"
      },
      {
        "url" : "value",
        "valueString" : "false"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "apply-jurisdiction"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "apply-publisher"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "default-jurisdiction"
      },
      {
        "url" : "value",
        "valueString" : "urn:iso:std:iso:3166#VN"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "default-publisher"
      },
      {
        "url" : "value",
        "valueString" : "Omi HealthTech / VN Core FHIR Community Initiative"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "path-expansion-params"
      },
      {
        "url" : "value",
        "valueString" : "../../config/publisher/Parameters-vn-expansion-parameters.json"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "special-url"
      },
      {
        "url" : "value",
        "valueString" : "http://fhir.hl7.org.vn/device/CodeSystem/vn-medical-device-nomenclature-cs"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "special-url"
      },
      {
        "url" : "value",
        "valueString" : "http://fhir.hl7.org.vn/device/ValueSet/vn-medical-device-nomenclature-vs"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "special-url"
      },
      {
        "url" : "value",
        "valueString" : "http://fhir.hl7.org.vn/device/ValueSet/vn-device-type-vs"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "autoload-resources"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "path-liquid"
      },
      {
        "url" : "value",
        "valueString" : "template/liquid"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "path-liquid"
      },
      {
        "url" : "value",
        "valueString" : "input/liquid"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "path-qa"
      },
      {
        "url" : "value",
        "valueString" : "temp/qa"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "path-temp"
      },
      {
        "url" : "value",
        "valueString" : "temp/pages"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "path-output"
      },
      {
        "url" : "value",
        "valueString" : "output"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "path-suppressed-warnings"
      },
      {
        "url" : "value",
        "valueString" : "input/ignoreWarnings.txt"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "path-history"
      },
      {
        "url" : "value",
        "valueString" : "http://fhir.hl7.org.vn/core/history.html"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "template-html"
      },
      {
        "url" : "value",
        "valueString" : "template-page.html"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "template-md"
      },
      {
        "url" : "value",
        "valueString" : "template-page-md.html"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "apply-contact"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "apply-context"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "apply-copyright"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "apply-license"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "apply-version"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "apply-wg"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "active-tables"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "fmm-definition"
      },
      {
        "url" : "value",
        "valueString" : "http://hl7.org/fhir/versions.html#maturity"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "propagate-status"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "excludelogbinaryformat"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "tabbed-snapshots"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueString" : "i18n-default-lang"
      },
      {
        "url" : "value",
        "valueString" : "vi"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/expansion-parameters",
      "valueReference" : {
        "reference" : "Parameters/expansion-parameters"
      }
    },
    {
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-internal-dependency",
      "valueCode" : "hl7.fhir.uv.tools.r4#1.1.2"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "copyrightyear"
      },
      {
        "url" : "value",
        "valueString" : "2026+"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "releaselabel"
      },
      {
        "url" : "value",
        "valueString" : "Draft for Community Review"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "show-inherited-invariants"
      },
      {
        "url" : "value",
        "valueString" : "false"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "apply-jurisdiction"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "apply-publisher"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "default-jurisdiction"
      },
      {
        "url" : "value",
        "valueString" : "urn:iso:std:iso:3166#VN"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "default-publisher"
      },
      {
        "url" : "value",
        "valueString" : "Omi HealthTech / VN Core FHIR Community Initiative"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "path-expansion-params"
      },
      {
        "url" : "value",
        "valueString" : "../../config/publisher/Parameters-vn-expansion-parameters.json"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "special-url"
      },
      {
        "url" : "value",
        "valueString" : "http://fhir.hl7.org.vn/device/CodeSystem/vn-medical-device-nomenclature-cs"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "special-url"
      },
      {
        "url" : "value",
        "valueString" : "http://fhir.hl7.org.vn/device/ValueSet/vn-medical-device-nomenclature-vs"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "special-url"
      },
      {
        "url" : "value",
        "valueString" : "http://fhir.hl7.org.vn/device/ValueSet/vn-device-type-vs"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "autoload-resources"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "path-liquid"
      },
      {
        "url" : "value",
        "valueString" : "template/liquid"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "path-liquid"
      },
      {
        "url" : "value",
        "valueString" : "input/liquid"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "path-qa"
      },
      {
        "url" : "value",
        "valueString" : "temp/qa"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "path-temp"
      },
      {
        "url" : "value",
        "valueString" : "temp/pages"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "path-output"
      },
      {
        "url" : "value",
        "valueString" : "output"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "path-suppressed-warnings"
      },
      {
        "url" : "value",
        "valueString" : "input/ignoreWarnings.txt"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "path-history"
      },
      {
        "url" : "value",
        "valueString" : "http://fhir.hl7.org.vn/core/history.html"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "template-html"
      },
      {
        "url" : "value",
        "valueString" : "template-page.html"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "template-md"
      },
      {
        "url" : "value",
        "valueString" : "template-page-md.html"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "apply-contact"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "apply-context"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "apply-copyright"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "apply-license"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "apply-version"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "apply-wg"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "active-tables"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "fmm-definition"
      },
      {
        "url" : "value",
        "valueString" : "http://hl7.org/fhir/versions.html#maturity"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "propagate-status"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "excludelogbinaryformat"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "tabbed-snapshots"
      },
      {
        "url" : "value",
        "valueString" : "true"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    },
    {
      "extension" : [{
        "url" : "code",
        "valueCode" : "i18n-default-lang"
      },
      {
        "url" : "value",
        "valueString" : "vi"
      }],
      "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-parameter"
    }],
    "grouping" : [{
      "id" : "profiles",
      "name" : "Profiles",
      "description" : "Core conformance profiles published by VN Core."
    },
    {
      "id" : "extensions",
      "name" : "Extensions",
      "description" : "FHIR extensions defined for Vietnamese implementation needs."
    },
    {
      "id" : "logical-models",
      "name" : "Logical Models",
      "description" : "Logical models and other non-profile StructureDefinitions."
    },
    {
      "id" : "codesystems",
      "name" : "CodeSystems",
      "description" : "Terminology code systems used in VN Core."
    },
    {
      "id" : "valuesets",
      "name" : "ValueSets",
      "description" : "Terminology value sets used in VN Core."
    },
    {
      "id" : "conceptmaps",
      "name" : "ConceptMaps",
      "description" : "Terminology and mapping artifacts."
    },
    {
      "id" : "naming-systems",
      "name" : "NamingSystems",
      "description" : "Identifier namespace registries and naming systems."
    },
    {
      "id" : "capabilities",
      "name" : "Capability Statements",
      "description" : "CapabilityStatement artifacts for actors and systems."
    },
    {
      "id" : "operations",
      "name" : "Operations and Parameters",
      "description" : "OperationDefinition and Parameters artifacts."
    },
    {
      "id" : "search-parameters",
      "name" : "Search Parameters",
      "description" : "FHIR search parameter definitions."
    },
    {
      "id" : "examples",
      "name" : "Examples",
      "description" : "Example instances and bundles referenced by the guide."
    },
    {
      "id" : "misc",
      "name" : "Other Artifacts",
      "description" : "Artifacts not covered by the main VN Core grouping buckets."
    }],
    "resource" : [{
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-bhyt-submission-bundle"
      },
      "name" : "Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle",
      "description" : "Profile Bundle chuyên dùng cho gửi hồ sơ thanh toán BHYT lên Cổng giám định BHXH. Bundle này thuộc lớp liên thông hồ sơ thanh toán BHYT, tách biệt với các Bundle FHIR nội bộ.\nCăn cứ: Luật 25/2008/QH12 ngày 14/11/2008 về BHYT; Luật 51/2024/QH15 ngày 27/11/2024 sửa đổi Luật BHYT; NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025 hướng dẫn Luật BHYT; QĐ 3176/QĐ-BYT ngày 29/10/2024 về chuẩn dữ liệu đầu ra KCB; QĐ 697/QĐ-BYT ngày 19/03/2026 về mẫu bảng kê chi phí KCB.\nNguồn TVPL NĐ 188/2025/NĐ-CP: https://thuvienphapluat.vn/van-ban/Bao-hiem/Nghi-dinh-188-2025-ND-CP-huong-dan-Luat-Bao-hiem-y-te-641049.aspx",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-prescription-cs"
      },
      "name" : "Bài thuốc Y học cổ truyền — VN Traditional Medicine Prescription CodeSystem",
      "description" : "Bộ mã bài thuốc Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục VI. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột `Mã bài thuốc` và thành phần được bảo toàn dưới concept properties.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-prescription-vs"
      },
      "name" : "Bài thuốc YHCT — VN Traditional Medicine Prescription ValueSet",
      "description" : "Tập giá trị bài thuốc theo thể lâm sàng y học cổ truyền. 522 bài thuốc. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL VI.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-diagnostic-report-imaging"
      },
      "name" : "Báo cáo Chẩn đoán hình ảnh VN Core — VN Core Imaging DiagnosticReport",
      "description" : "Profile DiagnosticReport chẩn đoán hình ảnh cho Việt Nam, áp dụng cho X-quang, CT, MRI, siêu âm, DSA và các báo cáo CĐHA khác.\nKế thừa VNCoreDiagnosticReport và siết category theo HL7 v2-0074 RAD cùng nhóm chi phí CĐHA theo QĐ 697/QĐ-BYT.\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — nhóm Điện quang/CĐHA 1.240 mã;\nTT 23/2024/TT-BYT — danh mục kỹ thuật hiện hành;\nTT 13/2025/TT-BYT Điều 1, 3 — bệnh án điện tử, lưu trữ và xác nhận điện tử;\nTT 38/2024/TT-BYT — Hệ thống thông tin khám bệnh, chữa bệnh;\nQĐ 3176/QĐ-BYT (29/10/2024) — XML3/XML6: MA_DICH_VU, KET_QUA, MA_LOAI_DVKT;\nQĐ 697/QĐ-BYT (19/3/2026) — nhóm chi phí 4 Chẩn đoán hình ảnh.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-diagnostic-report"
      },
      "name" : "Báo cáo cận lâm sàng VN Core — VN Core DiagnosticReport Profile",
      "description" : "Profile DiagnosticReport cho Việt Nam. Nhóm kết quả cận lâm sàng (xét nghiệm, CĐHA, TDCN).\nLiên kết với VNCoreObservationLab (kết quả chi tiết) và VNCoreEncounter (lượt khám).\nKết quả chi tiết có thể là Observation chuyên biệt theo từng loại báo cáo; child profiles sẽ siết lại loại Observation khi cần.\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — 2.964 mã CLS thuộc 5 nhóm: Huyết học-Truyền máu 1.022, Hóa sinh 447, Vi sinh 174, Giải phẫu bệnh 81, Điện quang/CĐHA 1.240;\nTT 23/2024/TT-BYT (01/10/2024) — danh mục kỹ thuật hiện hành thay TT 43/2013/TT-BYT (đã hết hiệu lực) từ 18/10/2024;\nTT 13/2025/TT-BYT Điều 1, 3 — bệnh án điện tử, lưu trữ/khai thác và ký/xác nhận điện tử;\nTT 38/2024/TT-BYT — Hệ thống thông tin khám bệnh, chữa bệnh;\nQĐ 3176/QĐ-BYT (29/10/2024) — XML3/XML6: MA_DICH_VU, KET_QUA, MA_LOAI_DVKT;\nQĐ 697/QĐ-BYT (19/3/2026) — nhóm chi phí 3 (XN), 4 (CĐHA), 5 (TDCN).\nDeferred v0.5: VNCoreDiagnosticReportFunctional cho Thăm dò chức năng do QĐ 1227 chưa có nhóm mã TDCN riêng.\nNguồn thiết kế: OHP Data Processor (DiagnosticReport mapper — XML 4750).",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-diagnostic-report-pathology"
      },
      "name" : "Báo cáo Giải phẫu bệnh VN Core — VN Core Pathology DiagnosticReport",
      "description" : "Profile DiagnosticReport giải phẫu bệnh cho Việt Nam, áp dụng cho mô bệnh học, tế bào học và báo cáo GPB liên quan mẫu bệnh phẩm.\nKế thừa VNCoreDiagnosticReport và siết category theo HL7 v2-0074 PAT cùng nhóm chi phí XN vì QĐ 697/QĐ-BYT gộp GPB vào nhóm xét nghiệm.\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — nhóm Giải phẫu bệnh 81 mã;\nQĐ 2427/QĐ-BYT (25/7/2025) — SNOMED CT VN Body Structure phục vụ bodySite;\nQĐ 2493/QĐ-BYT (08/2025) — SNOMED CT VN Morphologic Abnormality phục vụ conclusionCode với binding extensible;\nTT 23/2024/TT-BYT — danh mục kỹ thuật hiện hành;\nTT 13/2025/TT-BYT Điều 1, 3 — bệnh án điện tử, lưu trữ và xác nhận điện tử;\nTT 38/2024/TT-BYT — Hệ thống thông tin khám bệnh, chữa bệnh;\nQĐ 3176/QĐ-BYT (29/10/2024) — XML3/XML6: MA_DICH_VU, KET_QUA, MA_LOAI_DVKT;\nQĐ 697/QĐ-BYT (19/3/2026) — nhóm chi phí 3 Xét nghiệm.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-diagnostic-report-lab"
      },
      "name" : "Báo cáo Xét nghiệm VN Core — VN Core Lab DiagnosticReport",
      "description" : "Profile DiagnosticReport xét nghiệm cho Việt Nam, áp dụng cho các báo cáo huyết học-truyền máu, hóa sinh và vi sinh.\nKế thừa VNCoreDiagnosticReport và siết category theo HL7 v2-0074 LAB cùng nhóm chi phí XN theo QĐ 697/QĐ-BYT.\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — 2.964 mã CLS, trong đó Huyết học-Truyền máu 1.022 mã, Hóa sinh 447 mã, Vi sinh 174 mã;\nQĐ 3148/QĐ-BYT (2017) — liên thông, công nhận kết quả xét nghiệm giữa các cơ sở y tế;\nTT 23/2024/TT-BYT — danh mục kỹ thuật hiện hành;\nTT 13/2025/TT-BYT Điều 1, 3 — bệnh án điện tử, lưu trữ và xác nhận điện tử;\nTT 38/2024/TT-BYT — Hệ thống thông tin khám bệnh, chữa bệnh;\nQĐ 3176/QĐ-BYT (29/10/2024) — XML3/XML6: MA_DICH_VU, KET_QUA, MA_LOAI_DVKT;\nQĐ 697/QĐ-BYT (19/3/2026) — nhóm chi phí 3 Xét nghiệm.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml1SummaryLm"
      },
      "name" : "Bảng 1 tổng hợp KCB BHYT — Logical Model",
      "description" : "Logical model cho bảng 1 dữ liệu tổng hợp hồ sơ khám chữa bệnh BHYT theo QĐ 3176/QĐ-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml1-summary"
      },
      "name" : "Bảng 1 tổng hợp KCB BHYT — Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 1 tổng hợp KCB BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML1SummaryLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml10MaternityLeaveLm"
      },
      "name" : "Bảng 10 giấy chứng nhận nghỉ dưỡng thai — XML10 Maternity Leave Logical Model",
      "description" : "Logical model cho Bảng 10 QĐ 3176/QĐ-BYT: dữ liệu giấy chứng nhận nghỉ dưỡng thai.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml10-maternity-leave"
      },
      "name" : "Bảng 10 giấy chứng nhận nghỉ dưỡng thai — XML10 Maternity Leave Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 10 giấy chứng nhận nghỉ dưỡng thai — XML10 Maternity Leave Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML10MaternityLeaveLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml11SickLeaveLm"
      },
      "name" : "Bảng 11 giấy chứng nhận nghỉ việc hưởng BHXH — XML11 Sick Leave Logical Model",
      "description" : "Logical model cho Bảng 11 QĐ 3176/QĐ-BYT: dữ liệu giấy chứng nhận nghỉ việc hưởng bảo hiểm xã hội.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml11-sick-leave"
      },
      "name" : "Bảng 11 giấy chứng nhận nghỉ việc hưởng BHXH — XML11 Sick Leave Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 11 giấy chứng nhận nghỉ việc hưởng BHXH — XML11 Sick Leave Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML11SickLeaveLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml12MedicalAssessmentLm"
      },
      "name" : "Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model",
      "description" : "Logical model cho Bảng 12 QĐ 3176/QĐ-BYT: dữ liệu giám định y khoa.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml12-medical-assessment"
      },
      "name" : "Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML12MedicalAssessmentLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml2MedicationLm"
      },
      "name" : "Bảng 2 thuốc BHYT — Logical Model",
      "description" : "Logical model cho bảng 2 chi tiết thuốc và dịch truyền theo QĐ 3176/QĐ-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml2-medication"
      },
      "name" : "Bảng 2 thuốc BHYT — Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 2 thuốc BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML2MedicationLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml3ServiceLm"
      },
      "name" : "Bảng 3 DVKT và vật tư BHYT — Logical Model",
      "description" : "Logical model cho bảng 3 dịch vụ kỹ thuật và vật tư y tế theo QĐ 3176/QĐ-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml3-service"
      },
      "name" : "Bảng 3 DVKT và vật tư BHYT — Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 3 DVKT và vật tư BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML3ServiceLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml4ClsLm"
      },
      "name" : "Bảng 4 cận lâm sàng BHYT — Logical Model",
      "description" : "Logical model cho bảng 4 kết quả xét nghiệm, chẩn đoán hình ảnh và thăm dò chức năng.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml4-cls"
      },
      "name" : "Bảng 4 cận lâm sàng BHYT — Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 4 cận lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML4CLSLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml5ClinicalCourseLm"
      },
      "name" : "Bảng 5 diễn biến lâm sàng BHYT — Logical Model",
      "description" : "Logical model cho bảng 5 diễn biến bệnh và xử trí lâm sàng.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml5-clinical-course"
      },
      "name" : "Bảng 5 diễn biến lâm sàng BHYT — Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 5 diễn biến lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML5ClinicalCourseLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml6HivCareLm"
      },
      "name" : "Bảng 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care Logical Model",
      "description" : "Logical model cho Bảng 6 QĐ 3176/QĐ-BYT: hồ sơ bệnh án chăm sóc và điều trị HIV/AIDS. Dữ liệu này là dữ liệu y tế đặc biệt nhạy cảm; mọi mapping triển khai phải đi kèm chính sách Consent, SecurityLabel và Audit.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml6-hiv-care"
      },
      "name" : "Bảng 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML6HIVCareLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml7DischargePaperLm"
      },
      "name" : "Bảng 7 giấy ra viện — XML7 Discharge Paper Logical Model",
      "description" : "Logical model cho Bảng 7 QĐ 3176/QĐ-BYT: dữ liệu giấy ra viện.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml7-discharge-paper"
      },
      "name" : "Bảng 7 giấy ra viện — XML7 Discharge Paper Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 7 giấy ra viện — XML7 Discharge Paper Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML7DischargePaperLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml8TreatmentSummaryLm"
      },
      "name" : "Bảng 8 tóm tắt hồ sơ bệnh án — XML8 Treatment Summary Logical Model",
      "description" : "Logical model cho Bảng 8 QĐ 3176/QĐ-BYT: dữ liệu tóm tắt hồ sơ bệnh án.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml8-treatment-summary"
      },
      "name" : "Bảng 8 tóm tắt hồ sơ bệnh án — XML8 Treatment Summary Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 8 tóm tắt hồ sơ bệnh án — XML8 Treatment Summary Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML8TreatmentSummaryLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytXml9BirthCertificateLm"
      },
      "name" : "Bảng 9 giấy chứng sinh — XML9 Birth Certificate Logical Model",
      "description" : "Logical model cho Bảng 9 QĐ 3176/QĐ-BYT: dữ liệu giấy chứng sinh.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureMap"
      }],
      "reference" : {
        "reference" : "StructureMap/vn-sm-bhyt-xml9-birth-certificate"
      },
      "name" : "Bảng 9 giấy chứng sinh — XML9 Birth Certificate Logical Model — StructureMap",
      "description" : "Generated StructureMap scaffold for Bảng 9 giấy chứng sinh — XML9 Birth Certificate Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML9BirthCertificateLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-icd10-cs"
      },
      "name" : "Bảng phân loại quốc tế bệnh tật ICD-10 Việt Nam / Vietnam ICD-10 Classification",
      "description" : "Bảng phân loại quốc tế bệnh tật ICD-10 phiên bản Việt Nam, ban hành theo QĐ 4469/QĐ-BYT (28/10/2020), bổ sung theo QĐ 98/QĐ-BYT (14/01/2022). Artifact công bố trên IG này là metadata wrapper cho tập dữ liệu ICD-10 VN gồm `15.026` mã (2.043 type + 12.983 disease).\n\n### Dữ liệu hiện có trong lớp chuẩn hóa\n- Cấu trúc phân cấp `type -> disease`\n- `display` tiếng Việt và `designation` tiếng Anh cho từng mã khi có\n- Concept property cho `level`, `chapter-id`, `chapter-code`, `section-id`, `type-code`, `leaf`, `child-count`\n\n### Cách dùng trong VN Core\n- Khi coding trong resource FHIR, vẫn ưu tiên `system = http://hl7.org/fhir/sid/icd-10`\n- Dùng metadata wrapper này để biết phạm vi dữ liệu ICD-10 VN đã được chuẩn hóa trong release hiện hành\n- Khi cần tra cứu hoặc import toàn bộ dữ liệu FHIR JSON, dùng release download surface thay vì public IG page\n\n### Cách lấy artifact\n- Validator/FHIR server: dùng file FHIR JSON đầy đủ `CodeSystem-vn-icd10-cs.full.json` trên release download surface\n- Xem [trang tải xuống](downloads.html#icd10-fhir-json) để lấy liên kết tải trực tiếp\n- Các serialization `XML/TTL` trên public IG chỉ phản ánh metadata wrapper hiện hành; riêng route canonical `.json` được trỏ sang full JSON download",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-icd9-cm-cs"
      },
      "name" : "Bảng phân loại quốc tế thủ thuật ICD-9-CM Việt Nam / Vietnam ICD-9-CM Procedure Classification",
      "description" : "Bảng phân loại quốc tế mã hóa thủ thuật y tế ICD-9-CM (Volume 3) phiên bản Việt Nam.\n3.882 mã thủ thuật/phẫu thuật, song ngữ Việt-Anh, do Bộ Y tế Việt Nam phát hành theo QĐ 387/QĐ-BYT (05/02/2026).\nĐược dùng cho hồ sơ KCB, BHYT và ánh xạ danh mục DVKT theo QĐ 4466/QĐ-BYT (2020).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-disease-cs"
      },
      "name" : "Bệnh danh và thể lâm sàng Y học cổ truyền (Mã U) — VN Traditional Medicine Disease & Syndrome CodeSystem",
      "description" : "Bộ mã bệnh danh Y học cổ truyền Việt Nam và các thể lâm sàng theo QĐ 2552/QĐ-BYT Phụ lục I. FHIR concept `code` sử dụng cột `Mã U / Mã hóa` chính thức; cột `Mã dùng chung`, tên bệnh theo Y học hiện đại và mã ICD-10 được bảo toàn dưới concept properties.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-disease-vs"
      },
      "name" : "Bệnh danh YHCT và Thể lâm sàng (Mã U) — VN Traditional Medicine Disease ValueSet",
      "description" : "Tập giá trị bệnh danh Y học cổ truyền và các thể lâm sàng theo QĐ 2552/QĐ-BYT Phụ lục I. Bao gồm 228 mã (38 bệnh danh + 190 thể lâm sàng). FHIR `code` sử dụng Mã U / Mã hóa chính thức; Mã dùng chung được bảo toàn ở concept property `ma-dung-chung` của CodeSystem.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-patient"
      },
      "name" : "Bệnh nhân VN Core — VN Core Patient Profile",
      "description" : "Profile Patient cho Việt Nam. Bao gồm identifier slicing (CCCD, BHYT, MRN),\nextensions dân tộc/nghề nghiệp, các extension chuẩn của HL7 cho nơi sinh/quốc tịch/tôn giáo,\nvà ràng buộc địa chỉ theo VNCoreAddress.\nCăn cứ:\n- **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử phải gắn số định danh cá nhân\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025, hiệu lực 01/7/2025 — Điều 6 quy định **số định danh cá nhân là mã định danh y tế của cá nhân** (áp dụng cho cả Patient và nhân lực y tế)\n- **Luật 91/2025/QH15** — 26/6/2025 — dữ liệu định danh và dữ liệu y tế là dữ liệu cá nhân cần bảo vệ\n- **Luật Căn cước 2023 (Luật 26/2023/QH15)** — Điều 12: số định danh cá nhân là dãy 12 chữ số tự nhiên do CSDL quốc gia về dân cư xác lập\n- **Luật Hộ tịch 2014 (Luật 60/2014/QH13)** — Điều 14 Khoản 1: số định danh cá nhân được gắn vào giấy khai sinh khi đăng ký khai sinh (từ 01/01/2016, trẻ em VN sinh từ 2016 trở đi đã có số định danh cá nhân từ giấy khai sinh)\n- **Luật 25/2008/QH12** — 14/11/2008 — Luật Bảo hiểm y tế\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, nền tảng dữ liệu thẻ BHYT.\n\n**Pattern identifier cho các trường hợp đặc biệt**:\n- **Trẻ em sinh từ 2016**: số định danh cá nhân từ giấy khai sinh = CCCD trong tương lai → dùng `identifier[CCCD]`\n- **Trẻ em sinh trước 2016 chưa cấp số định danh**: dùng `identifier[GKS]` (Giấy khai sinh) làm primary, kèm `data-absent-reason` cho `identifier[CCCD]`\n- **Người nước ngoài**: dùng `identifier[passport]`\n- **Người bệnh cấp cứu chưa rõ thân nhân**: data-absent-reason + `vn-ext-force-majeure-reason`",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-composition"
      },
      "name" : "Bệnh án điện tử VN Core — VN Core Composition Profile",
      "description" : "Profile Composition cho bệnh án điện tử (EMR) Việt Nam.\nCấu trúc tài liệu y tế có phân mục: tiền sử, chẩn đoán, xét nghiệm, điều trị, ra viện.\nCăn cứ:\n- **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử, hiệu lực 21/7/2025\n- **TT 38/2024/TT-BYT** — 16/11/2024 — hệ thống thông tin quản lý hoạt động KCB\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản lý dữ liệu y tế số\n- **NĐ 278/2025/NĐ-CP** — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — kết nối, chia sẻ dữ liệu bắt buộc giữa cơ quan thuộc hệ thống chính trị; mốc chuẩn hóa/kết nối thống nhất chậm nhất 31/12/2026\n- **QĐ 11/2026/QĐ-TTg** — 28/3/2026 — danh mục CSDL quốc gia, bao gồm CSDL quốc gia về y tế\n- **NĐ 137/2024/NĐ-CP** — 23/10/2024 — giao dịch điện tử, chữ ký số\n- **Luật KCB 2023** — hồ sơ bệnh án.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:logical"
      }],
      "reference" : {
        "reference" : "StructureDefinition/bhytCheckInLm"
      },
      "name" : "Check-in BHYT — Logical Model",
      "description" : "Logical model cho dữ liệu tiếp nhận/check-in trước khi gửi hồ sơ thanh toán BHYT.",
      "exampleBoolean" : false,
      "groupingId" : "logical-models"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-body-height"
      },
      "name" : "Chiều cao VN Core — VN Core Observation Body Height Profile",
      "description" : "Profile Observation chiều cao cơ thể cho Việt Nam, dùng LOINC 8302-2 và đơn vị UCUM cm. Phục vụ ghi nhận sinh hiệu, tính BMI, theo dõi tăng trưởng và bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-specialty-cs"
      },
      "name" : "Chuyên khoa y tế — VN Medical Specialty CodeSystem",
      "description" : "Danh mục chuyên khoa y tế Việt Nam sử dụng trong hệ thống khám chữa bệnh.\nCăn cứ hiện hành: TT 32/2023/TT-BYT Điều 11, Phụ lục V–XVII (phạm vi hành nghề theo 19 nhóm hệ cơ quan)\nvà Luật KCB 2023 Điều 42. TT 43/2013/TT-BYT và TT 21/2017/TT-BYT đã hết hiệu lực từ 18/10/2024\n(thay bởi TT 23/2024/TT-BYT); content của CodeSystem này kế thừa phân loại chuyên khoa gốc nhưng\ncăn cứ pháp lý chính thức hiện hành là TT 32/2023 + Luật KCB 2023. /\nVietnamese medical specialty list for healthcare practice scope classification.\nCurrent legal basis: TT 32/2023/TT-BYT (Art.11, Appendix V–XVII) and Medical Examination and Treatment Law 2023 Art.42.\nLegacy references TT 43/2013 and TT 21/2017 are superseded as of 18/10/2024.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-specialty-vs"
      },
      "name" : "Chuyên khoa y tế — VN Medical Specialty ValueSet",
      "description" : "Tập giá trị chuyên khoa y tế Việt Nam. /\nValueSet of Vietnamese medical specialties.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-condition-diagnosis"
      },
      "name" : "Chẩn đoán lượt khám VN Core — VN Core Encounter Diagnosis Condition Profile",
      "description" : "Profile con của VNCoreCondition cho chẩn đoán được ghi nhận trong một lượt khám/điều trị tại Việt Nam.\nICD-10 VN là coding bắt buộc theo QĐ 4469/QĐ-BYT (28/10/2020), bổ sung mã COVID-19 theo QĐ 98/QĐ-BYT (14/01/2022) và hướng dẫn mã hóa theo TT 06/2026/TT-BYT (ban hành 02/04/2026, hiệu lực 01/07/2026 — future-effective).\nCategory được cố định là encounter-diagnosis để phù hợp ghi nhận chẩn đoán trong hồ sơ KCB và dữ liệu đầu ra theo QĐ 3176/QĐ-BYT (29/10/2024), trường MA_BENH/MA_BENHKHAC.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-condition"
      },
      "name" : "Chẩn đoán VN Core — VN Core Condition Profile",
      "description" : "Profile Condition cho chẩn đoán tại Việt Nam.\nHỗ trợ mã hóa chẩn đoán bằng ICD-10 (bắt buộc theo QĐ 4469/QĐ-BYT) và/hoặc SNOMED CT IPS Terminology.\nCăn cứ: QĐ 4469/QĐ-BYT (28/10/2020) — ICD-10-VN, QĐ 98/QĐ-BYT (14/01/2022) — bổ sung COVID-19,\nQĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nTham chiếu bổ sung: TT 06/2026/TT-BYT (ban hành 02/04/2026, hiệu lực 01/07/2026 — future-effective) — Quy định về mã hóa bệnh tật, nguyên nhân tử vong theo ICD-10.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-diagnosis-cs"
      },
      "name" : "Chẩn đoán Y học cổ truyền — VN Traditional Medicine Diagnosis CodeSystem",
      "description" : "Bộ mã chẩn đoán Y học cổ truyền Việt Nam theo QĐ 2552/QĐ-BYT Phụ lục II. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột `Mã` chuyên môn và nhóm chẩn đoán được bảo toàn dưới concept properties.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-diagnosis-vs"
      },
      "name" : "Chẩn đoán YHCT — VN Traditional Medicine Diagnosis ValueSet",
      "description" : "Tập giá trị chẩn đoán y học cổ truyền bao gồm bát cương, tạng phủ biện chứng, lục kinh biện chứng, vệ khí dinh huyết biện chứng, tam tiêu biện chứng. 106 thuật ngữ từ QĐ 2552/QĐ-BYT (12/8/2025).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-cls-cs"
      },
      "name" : "Chỉ số cận lâm sàng Việt Nam (Đợt 1) / Vietnam Clinical Lab Indicators (Batch 1)",
      "description" : "Danh mục mã dùng chung chỉ số cận lâm sàng Đợt 1, ban hành theo QĐ 1227/QĐ-BYT ngày 11/04/2025. FHIR concept `code` sử dụng chính cột mã CLS chính thức trong phụ lục nguồn; bản công bố giữ các thuộc tính tối thiểu phục vụ đối chiếu TT23, ánh xạ LOINC và truy vết phụ lục/trang nguồn. Dữ liệu phân tích chi tiết hơn được lưu trong dữ liệu nguồn của repo và ConceptMap liên quan. / Vietnam Clinical Lab Indicator CodeSystem (Batch 1) per QĐ 1227/QĐ-BYT dated 11/04/2025. FHIR concept `code` uses the official CLS code from the source appendix; the published CodeSystem keeps the minimum properties required for TT23 alignment, LOINC linkage, and appendix/page audit tracing. Richer analytical metadata remains in the repository source data and related ConceptMap artifacts.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-cls-vs"
      },
      "name" : "Chỉ số cận lâm sàng — VN Clinical Lab Indicator ValueSet",
      "description" : "Tập giá trị chỉ số cận lâm sàng Đợt 1. 2.964 chỉ số từ QĐ 1227/QĐ-BYT (11/04/2025).\nMỗi chỉ số có ánh xạ LOINC (100%). / ValueSet for Vietnam Clinical Lab Indicators (Batch 1),\n2,964 codes per QĐ 1227/QĐ-BYT. Each maps to LOINC.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-practitioner-title-cs"
      },
      "name" : "Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title CodeSystem",
      "description" : "Mã số chức danh nghề nghiệp viên chức ngành y tế Việt Nam (hệ V.08).\nBao gồm 32 mã cho 11 nhóm chức danh: bác sĩ, BS YHDP, y sĩ, y tế công cộng,\nđiều dưỡng, hộ sinh, kỹ thuật y, dược, dinh dưỡng, dân số, khúc xạ nhãn khoa.\nCăn cứ: TT 41/2025/TT-BYT (bác sĩ, BS YHDP, y sĩ), TT 02/2025/TT-BYT\n(điều dưỡng, hộ sinh, KTV), TTLT 27/2015/TTLT-BYT-BNV (dược). /\nVietnamese healthcare civil service position codes (V.08 series) covering 32 codes\nacross 11 professional groups. Per TT 41/2025/TT-BYT, TT 02/2025/TT-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-practitioner-title-vs"
      },
      "name" : "Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet",
      "description" : "Tập giá trị chức danh nghề nghiệp viên chức ngành y tế Việt Nam (hệ V.08). /\nValueSet of Vietnamese healthcare civil service position codes (V.08 series).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-body-weight"
      },
      "name" : "Cân nặng VN Core — VN Core Observation Body Weight Profile",
      "description" : "Profile Observation cân nặng cơ thể cho Việt Nam, dùng LOINC 29463-7 và đơn vị UCUM kg. Phục vụ ghi nhận sinh hiệu, tính BMI, kê đơn theo cân nặng và bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-legal-basis"
      },
      "name" : "Căn cứ pháp lý VN — VN Legal Basis Reference",
      "description" : "Tham chiếu structured tới văn bản pháp luật làm căn cứ cho profile/element/invariant.\nMỗi extension trỏ đến 1 concept trong VNLegalDocumentRefCS — ưu tiên hơn citation inline ở Description, vì:\n- Truy xuất được issuanceDate, effectiveDate, status (in-force/current-as-amended/transition/superseded) qua concept lookup\n- Tooling có thể validate citation hết hiệu lực\n- 1 nguồn truth duy nhất khi văn bản thay đổi\nCó thể dùng nhiều extension trên cùng artifact để tham chiếu chain (ví dụ NĐ 98/2021 + NĐ 07/2023 + NĐ 04/2025).\nContext: ElementDefinition (cho element-level) và StructureDefinition (cho artifact-level).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-supervising-authority"
      },
      "name" : "Cơ quan hướng dẫn chuyên môn — Supervising Clinical Authority Extension",
      "description" : "Mở rộng tham chiếu Cơ quan hướng dẫn chuyên môn kỹ thuật của một cơ sở y tế khi cơ quan này khác với đơn vị quản lý hành chính (Organization.partOf).\nTrường hợp điển hình: Trạm Y tế (TYT) cấp xã — về quản lý hành chính trực thuộc UBND cấp xã (đặt tại Organization.partOf), nhưng về chuyên môn kỹ thuật chịu sự hướng dẫn, kiểm tra của Sở Y tế cấp tỉnh (đặt tại extension này).\nTách biệt 2 chiều quản lý này phản ánh đúng mô hình chính quyền 2 cấp sau Luật 72/2025/QH15 và VBHN 06/2026/VBHN-BYT (hợp nhất TT 43/2025 + TT 53/2025 về Trạm Y tế xã/phường).\nCăn cứ:\n- Luật 72/2025/QH15 — 16/6/2025 — Luật Tổ chức chính quyền địa phương (hiệu lực 01/7/2025)\n- VBHN 06/2026/VBHN-BYT — 01/2026 — hợp nhất TT 43/2025 + TT 53/2025 về tổ chức và hoạt động của Trạm Y tế xã/phường/đặc khu.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-organization"
      },
      "name" : "Cơ sở y tế VN Core — VN Core Organization Profile",
      "description" : "Profile Organization cho cơ sở y tế Việt Nam. Bao gồm identifier mã CSKCB,\nextensions loại hình/cấp quản lý/phân hạng/cấp KCB hiện hành, và địa chỉ theo VNCoreAddress.\nCăn cứ:\n- **Luật KCB 2023** — Điều 47-48 — hình thức tổ chức cơ sở KCB\n- **NĐ 96/2023/NĐ-CP** — 30/12/2023 — hướng dẫn Luật KCB\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — CSDL quốc gia về y tế, dữ liệu cơ sở y tế\n- **QĐ 11/2026/QĐ-TTg** — 28/3/2026 — danh mục CSDL quốc gia, bao gồm CSDL quốc gia về y tế\n- **TT 06/2024/TT-BYT** — 16/5/2024 — phân hạng cơ sở KCB\n- **TT 35/2024/TT-BYT** — 16/11/2024 — tiêu chuẩn chất lượng cơ bản đối với bệnh viện.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-facility-care-level"
      },
      "name" : "Cấp năng lực cơ sở KCB — Facility Care Level Extension",
      "description" : "Mở rộng ghi nhận cấp khám bệnh, chữa bệnh hiện hành của cơ sở hoặc địa điểm cung cấp dịch vụ theo Luật KCB 2023 và NĐ 96/2023/NĐ-CP. Có thể được dùng trong nghiệp vụ BHYT theo NĐ 188/2025/NĐ-CP.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-facility-care-level-cs"
      },
      "name" : "Cấp năng lực cơ sở KCB — Vietnam Facility Care Level CodeSystem",
      "description" : "Danh mục cấp khám bệnh, chữa bệnh hiện hành theo mô hình 3 cấp của Luật Khám bệnh, chữa bệnh 2023 và NĐ 96/2023/NĐ-CP. Bộ mã này có thể được tái sử dụng trong nghiệp vụ BHYT nhưng không phải là khái niệm payer-only.\nCăn cứ bổ sung:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn Luật BHYT và quyền lợi theo cấp KCB.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-facility-care-level-vs"
      },
      "name" : "Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet",
      "description" : "Tập giá trị cấp khám bệnh, chữa bệnh hiện hành theo Luật KCB 2023 và NĐ 96/2023/NĐ-CP; có thể dùng trong các bài toán BHYT theo NĐ 188/2025/NĐ-CP.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-medication-dispense"
      },
      "name" : "Cấp phát thuốc VN Core — VN Core Medication Dispense Profile",
      "description" : "Profile MedicationDispense cho Việt Nam. Dùng để ghi nhận cấp phát thuốc trong chu trình đơn thuốc điện tử, điều trị nội trú/ngoại trú, bệnh án điện tử, và dữ liệu phục vụ thanh toán BHYT.\nCăn cứ pháp lý hiện hành:\n- **Luật Dược 105/2016/QH13 ngày 06/4/2016 Điều 74** — nguyên tắc kê đơn/cấp phát thuốc\n- **Luật 44/2024/QH15 ngày 21/11/2024 Điều 1 khoản 36** — sửa đổi Điều 74 Luật Dược, giao Bộ Y tế quy định chi tiết đơn thuốc, ứng dụng CNTT, liên thông CSDL quốc gia về y tế\n- **NĐ 163/2025/NĐ-CP ngày 29/6/2025** — hướng dẫn Luật Dược, thay thế hoàn toàn NĐ 54/2017/NĐ-CP từ 01/7/2025 theo Điều 129\n- **TT 26/2025/TT-BYT** — kê đơn thuốc ngoại trú: Điều 5 về kê đơn ngoại trú và sau điều trị nội trú; Điều 10 về giá trị pháp lý của đơn thuốc điện tử; Điều 12 về liên thông Hệ thống đơn thuốc quốc gia và lĩnh thuốc trong 05 ngày từ ngày kê\n- **TT 20/2022/TT-BYT + TT 37/2024/TT-BYT** — danh mục, tỷ lệ và điều kiện thanh toán thuốc hóa dược, sinh phẩm, thuốc phóng xạ và chất đánh dấu thuộc phạm vi BHYT\n- **TT 27/2025/TT-BYT** — thuốc y học cổ truyền thuộc phạm vi BHYT, hiệu lực 01/9/2025\n- **QĐ 3176/QĐ-BYT (29/10/2024)** — XML3: MA_THUOC, SO_DANG_KY, NGAY_YL\n- **QĐ 697/QĐ-BYT (19/3/2026)** — mẫu bảng kê chi phí KCB, danh mục chi phí thuốc là 1/12 nhóm\n- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — thanh toán BHYT thuốc\n- **NĐ 164/2025/NĐ-CP (29/6/2025)** — giao dịch điện tử/API Cổng BHXH\n- **TT 13/2025/TT-BYT (06/6/2025)** — bệnh án điện tử ghi nhận thông tin cấp phát thuốc.\nGhi chú: NĐ 54/2017/NĐ-CP chỉ là legacy reference và không được dùng làm current basis sau 01/7/2025.\n/\nVN Core MedicationDispense profile for recording medication dispensing events in Vietnamese EMR, ePrescription, inpatient/outpatient, and BHYT reimbursement workflows.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-healthcare-level-cs"
      },
      "name" : "Cấp quản lý hành chính y tế — Vietnam Administrative Health Level CodeSystem",
      "description" : "Danh mục cấp quản lý hành chính của cơ sở y tế trong mô hình chính quyền địa phương 2 cấp sau NQ 202/2025/QH15 và Luật 72/2025/QH15. Bộ mã này không dùng để biểu diễn tuyến chuyên môn kỹ thuật lịch sử.\nLưu ý: Cấp Huyện đã chính thức bị bãi bỏ từ 01/7/2025 theo NQ 202/2025/QH15 + Luật 72/2025/QH15 — KHÔNG còn code `huyen` trong bộ mã hiện hành. Dữ liệu lịch sử có cấp Huyện dùng VNLegacyTechnicalLineCS (#TUYEN_3) hoặc VNCoreExtLegacyTechnicalLine.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-org-level"
      },
      "name" : "Cấp quản lý hành chính y tế — Vietnam Administrative Health Level Extension",
      "description" : "Mở rộng ghi nhận cấp quản lý hành chính của cơ sở y tế trong mô hình hiện hành sau NQ 202/2025/QH15. Không dùng extension này để biểu diễn tuyến chuyên môn kỹ thuật lịch sử.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-healthcare-level-vs"
      },
      "name" : "Cấp quản lý hành chính y tế — Vietnam Administrative Health Level ValueSet",
      "description" : "Tập giá trị cấp quản lý hành chính y tế hiện hành. Không dùng thay cho tuyến chuyên môn kỹ thuật lịch sử.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-gdbhyt-portal-ns"
      },
      "name" : "Cổng tiếp nhận giám định BHYT — VN BHXH gdbhyt Portal",
      "description" : "Hệ thống định danh endpoint điện tử để cơ sở khám chữa bệnh (CSKCB) gửi hồ sơ giám định, thanh toán, quyết toán chi phí KCB BHYT lên Bảo hiểm Xã hội Việt Nam.\nURI cổng: https://gdbhyt.baohiemxahoi.gov.vn\nCăn cứ:\n- TT 12/2026/TT-BTC (Bộ Tài chính, 03/2026), Điều 2 — quy định CSKCB gửi hồ sơ giám định, quyết toán chi phí KCB BHYT qua cổng gdbhyt;\n- NĐ 164/2025/NĐ-CP (29/06/2025) — giao dịch điện tử trong lĩnh vực BHXH/BHYT.\nDùng cho Endpoint.address của VNCoreEndpointBHYT và Organization.endpoint của VNCoreOrganization (CSKCB ký hợp đồng BHXH).",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-cost-category-cs"
      },
      "name" : "Danh mục chi phí KCB — Vietnam Cost Category CodeSystem",
      "description" : "12 nhóm danh mục chi phí khám bệnh, chữa bệnh (14 mã, nhóm giường bệnh tách 3 loại) theo QĐ 697/QĐ-BYT (19/3/2026),\nthay thế QĐ 6556/QĐ-BYT (30/10/2018). Dùng để phân loại chi phí trong Claim/ExplanationOfBenefit.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-cost-category-vs"
      },
      "name" : "Danh mục chi phí KCB — Vietnam Cost Category ValueSet",
      "description" : "ValueSet chứa 14 mã danh mục chi phí KCB theo QĐ 697/QĐ-BYT (19/3/2026).\nDùng để phân loại chi phí trong Claim/ExplanationOfBenefit.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-ethnicity-cs"
      },
      "name" : "Danh mục Dân tộc Việt Nam — Vietnam Ethnicity CodeSystem",
      "description" : "Danh mục 54 dân tộc Việt Nam theo Tổng cục Thống kê (121/TCTK-PPCĐ),\nbổ sung mã 55 (Người nước ngoài) và 99 (Không rõ).\nTái sử dụng dữ liệu từ hl7vn/vn-core-ig (CodeSystem vn-core-race v1.0).\nNguồn: Tổng cục Thống kê — Danh mục các dân tộc Việt Nam (121/TCTK-PPCĐ).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-ethnicity-vs"
      },
      "name" : "Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet",
      "description" : "Tập giá trị bao gồm tất cả mã dân tộc từ Danh mục Dân tộc Việt Nam (TCTK).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-example-bhyt-service-catalog-cs"
      },
      "name" : "Danh mục dịch vụ BHYT ví dụ cục bộ — Example-only BHYT Service Catalog CodeSystem",
      "description" : "Danh mục cục bộ tối thiểu chỉ dùng cho example/round-trip seed BHYT của repo này.\nPhạm vi hiện tại chỉ gồm 2 mã example-only được giữ ngoài scope terminology chính thức.\nMột dòng là workflow tiếp nhận/xử trí cấp cứu ban đầu chưa tìm được mã khám hoặc mã dịch vụ official đủ sạch.\nMột dòng là chăm sóc sơ sinh gần với danh mục kỹ thuật hộ sinh nhưng không phải exam code và chưa có mã official phù hợp để publish.\nKHÔNG PHẢI danh mục DVKT hoặc danh mục dịch vụ khám chữa bệnh chính thức của Bộ Y tế/BHXH.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-example-bhyt-service-catalog-vs"
      },
      "name" : "Danh mục dịch vụ BHYT ví dụ cục bộ — Example-only BHYT Service Catalog ValueSet",
      "description" : "Tập giá trị mã dịch vụ BHYT ví dụ cục bộ dùng để làm sạch XML3 round-trip seed cho 2 dòng khám/chăm sóc đang chưa có mapping chính thức tương ứng.\nHai dòng này hiện được giữ example-only theo quyết định governance vì chưa có nguồn mã official đúng loại để publish.\nChỉ phục vụ example trong repo, không phải binding cho danh mục dịch vụ chính thức.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-vaccine-type-cs"
      },
      "name" : "Danh mục loại vaccine — Vietnam Vaccine Type CodeSystem",
      "description" : "Danh mục loại vaccine theo bệnh/nhóm bệnh phục vụ VNCoreImmunization. Bao gồm các bệnh trong Chương trình Tiêm chủng mở rộng (TCMR) theo QĐ 2780/QĐ-BYT ngày 29/08/2025 giai đoạn 2026-2028 và các vaccine dịch vụ/chiến dịch phổ biến. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.\nNguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-department-cs"
      },
      "name" : "Danh mục mã khoa — Vietnam Department CodeSystem",
      "description" : "Danh mục mã khoa trong cơ sở khám bệnh, chữa bệnh.\nCăn cứ hiện hành: QĐ 2010/QĐ-BYT (19/6/2025) Phụ lục 6 — Danh mục mã khoa trong cơ sở khám bệnh, chữa bệnh.\nTiền nhiệm: QĐ 5937/QĐ-BYT (2021) Phụ lục 5, đã bị QĐ 2010/QĐ-BYT bãi bỏ phần danh mục mã khoa.\nTham chiếu thêm: QĐ 130/QĐ-BYT → QĐ 4750 → QĐ 3176 (trường MA_KHOA).\nNguồn dữ liệu: OHP Data Processor (production mapping, verified with QĐ 2010).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-department-vs"
      },
      "name" : "Danh mục mã khoa — Vietnam Department ValueSet",
      "description" : "Tập giá trị mã khoa trong cơ sở KCB. Căn cứ: QĐ 2010/QĐ-BYT (19/6/2025).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-examination-code-cs"
      },
      "name" : "Danh mục mã khám bệnh BHYT — VN Examination CodeSystem",
      "description" : "Slice chính thức có provenance từ Phụ lục 2 Quyết định 2010/QĐ-BYT (19/6/2025): Danh mục mã khám bệnh.\nArtifact này hiện chỉ publish fragment gồm 2 mã khám bệnh đang được dùng an toàn trong BHYT XML3 round-trip seed.\nKhông phải toàn bộ phụ lục; sẽ mở rộng khi có thêm mapping 1:1 đủ sạch về ngữ nghĩa.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-bed-day-code-cs"
      },
      "name" : "Danh mục mã tiền giường BHYT — VN Bed Day CodeSystem",
      "description" : "Slice chính thức có provenance từ Phụ lục 3 Quyết định 2010/QĐ-BYT (19/6/2025): Danh mục mã tiền giường.\nArtifact này hiện chỉ publish fragment gồm 2 mã ngày giường đang được dùng trong BHYT XML3 round-trip seed.\nKhông phải toàn bộ phụ lục; sẽ mở rộng khi seed chính thức cần thêm mã ngày giường.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-occupation-cs"
      },
      "name" : "Danh mục nghề nghiệp Việt Nam (VSCO 2020) / Vietnam Standard Classification of Occupations",
      "description" : "Danh mục nghề nghiệp Việt Nam ban hành kèm theo QĐ 34/2020/QĐ-TTg. 5 cấp phân loại: Cấp 1 (kỹ năng) + Cấp 2-5 (chuyên môn). Tương thích ISCO-08 ở Cấp 1-4, Cấp 5 là chi tiết riêng của Việt Nam. / Vietnam Standard Classification of Occupations (VSCO 2020), issued per QĐ 34/2020/QĐ-TTg. 5-level hierarchy: Level 1 (skill level) + Levels 2-5 (specialization). ISCO-08 compatible at Levels 1-4; Level 5 is Vietnam-specific detail.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-district-vs"
      },
      "name" : "Danh mục Quận/Huyện (cũ, legacy) — Vietnam District ValueSet (deprecated)",
      "description" : "Tập giá trị bao gồm tất cả 696 quận/huyện cũ (trước NQ 202/2025).\nDùng cho backward-compatibility khi cần tra cứu hoặc chuyển đổi dữ liệu địa chỉ cũ.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-district-cs"
      },
      "name" : "Danh mục Quận/Huyện lịch sử — Vietnam District CodeSystem (legacy)",
      "description" : "Danh mục 696 quận/huyện theo hệ thống cũ (trước NQ 202/2025).\nBộ mã này chỉ dùng cho tương thích ngược với dữ liệu lịch sử.\nMỗi mã có property status để phản ánh trạng thái mã cũ và property province trỏ về mã tỉnh mới theo QĐ 19/2025.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-religion-cs"
      },
      "name" : "Danh mục Tôn giáo Việt Nam — Vietnam Religion CodeSystem",
      "description" : "16 tôn giáo được Nhà nước Việt Nam công nhận theo Công văn số 6955/BNV-TGCP\nngày 28/12/2020 của Bộ Nội vụ (Ban Tôn giáo Chính phủ).\nBổ sung mã 00 (Không tôn giáo) và 99 (Không rõ) cho mục đích kỹ thuật.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-religion-vs"
      },
      "name" : "Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet",
      "description" : "Tập giá trị bao gồm tất cả mã tôn giáo từ Danh mục Tôn giáo Việt Nam.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-province-vs"
      },
      "name" : "Danh mục Tỉnh/Thành phố Việt Nam (active) — Vietnam Province ValueSet",
      "description" : "Tập giá trị chỉ bao gồm 34 tỉnh/thành phố đang hoạt động theo NQ 202/2025.\nKhông bao gồm mã cũ (inactive).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-province-cs"
      },
      "name" : "Danh mục Tỉnh/Thành phố Việt Nam — Vietnam Province CodeSystem",
      "description" : "Danh mục 34 tỉnh/thành phố Việt Nam theo NQ 202/2025/QH15 và QĐ 19/2025/QĐ-TTg.\nMã số 2 chữ số, hiệu lực từ 01/7/2025.\nBổ sung mã cũ (trạng thái inactive) cho tương thích ngược với dữ liệu trước sáp nhập.\nCăn cứ:\n- **NQ 202/2025/QH15** — 12/6/2025 — 34 đơn vị cấp tỉnh từ 01/7/2025\n- **QĐ 19/2025/QĐ-TTg** — 2025 — mã ĐVHC cấp tỉnh.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-ward-cs"
      },
      "name" : "Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune CodeSystem",
      "description" : "Danh mục 3.321 xã/phường/thị trấn Việt Nam theo QĐ 19/2025/QĐ-TTg (Phụ lục II). Mã số 5 chữ số (00001–99999), hiệu lực từ 01/7/2025. Mỗi đơn vị có property \"province\" trỏ về mã tỉnh/TP (2 chữ số) theo Phụ lục I.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-ward-vs"
      },
      "name" : "Danh mục Xã/Phường Việt Nam — Vietnam Ward/Commune ValueSet",
      "description" : "Tập giá trị bao gồm tất cả xã/phường/thị trấn theo NQ 202/2025.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-medical-device-nomenclature-cs"
      },
      "name" : "Danh pháp thiết bị y tế Việt Nam — Vietnam Medical Device Nomenclature CodeSystem",
      "description" : "Bộ mã danh pháp thiết bị y tế Việt Nam tổng hợp từ QĐ-3107/QĐ-BYT-2024 và QĐ-847/QĐ-BYT-2025. Display/definition chính dùng tiếng Việt; tên tiếng Anh được đưa vào designation, định nghĩa tiếng Anh được giữ trong property definitionEn. Bộ mã thuộc package hl7.fhir.vn.device và không là required binding cho VN Core Device.type.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-medical-device-nomenclature-vs"
      },
      "name" : "Danh pháp thiết bị y tế Việt Nam — Vietnam Medical Device Nomenclature ValueSet",
      "description" : "Toàn bộ mã danh pháp thiết bị y tế Việt Nam trong VNMedicalDeviceNomenclatureCS. ValueSet này thuộc package hl7.fhir.vn.device và dùng cho lookup/coverage, không tự định nghĩa binding policy.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-ethnicity"
      },
      "name" : "Dân tộc — Vietnam Ethnicity Extension",
      "description" : "Mở rộng ghi nhận dân tộc của bệnh nhân theo danh mục 54 dân tộc Việt Nam\n(Tổng cục Thống kê). FHIR base chỉ có US Race/Ethnicity — không phù hợp cho Việt Nam.\nCăn cứ: Hiến pháp 2013 Điều 5, Luật Căn cước 2023.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-herb-cs"
      },
      "name" : "Dược liệu và vị thuốc Y học cổ truyền — VN Traditional Medicine Herbal Medicine CodeSystem",
      "description" : "Bộ mã dược liệu và vị thuốc Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục V. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột `Mã dược liệu, vị thuốc`, tên khoa học và nguồn gốc được bảo toàn dưới concept properties.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-herb-vs"
      },
      "name" : "Dược liệu/VTCT — VN Traditional Medicine Herbal Medicine ValueSet",
      "description" : "Tập giá trị dược liệu và vật tư cổ truyền. 442 vị thuốc với tên khoa học. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL V.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-quality-score-band"
      },
      "name" : "Dải điểm chất lượng cơ sở KCB — Quality Score Band Extension",
      "description" : "Mở rộng ghi nhận dải điểm chất lượng cơ sở khám chữa bệnh phục vụ nghiệp vụ BHYT theo NĐ 188/2025/NĐ-CP.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-quality-score-band-cs"
      },
      "name" : "Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band CodeSystem",
      "description" : "Danh mục dải điểm chất lượng cơ sở KCB dùng cho xác định một số trường hợp mức hưởng BHYT theo NĐ 188/2025/NĐ-CP.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-quality-score-band-vs"
      },
      "name" : "Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet",
      "description" : "Tập giá trị dải điểm chất lượng cơ sở KCB theo NĐ 188/2025/NĐ-CP.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-allergy-intolerance"
      },
      "name" : "Dị ứng/Bất dung nạp VN Core — VN Core AllergyIntolerance Profile",
      "description" : "Profile AllergyIntolerance cho ghi nhận dị ứng và bất dung nạp tại Việt Nam.\nSử dụng SNOMED CT IPS Terminology (miễn phí, CC-BY-4.0) cho mã hóa chất gây dị ứng.\nViệt Nam không có bộ mã dị ứng quốc gia — SNOMED CT IPS cung cấp ~15.000+ concepts\nbao gồm substances, pharmaceutical products, allergens.\nCăn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), Luật KCB 2023.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-healthcare-service"
      },
      "name" : "Dịch vụ y tế VN Core — VN Core HealthcareService Profile",
      "description" : "Profile HealthcareService cho dịch vụ y tế tại cơ sở y tế Việt Nam, đặc biệt cho Trạm Y tế cấp xã/phường/đặc khu trong mô hình chính quyền 2 cấp.\nCăn cứ:\n- VBHN 06/2026/VBHN-BYT (01/2026) — hợp nhất TT 43/2025/TT-BYT + TT 53/2025/TT-BYT, Điều 3-4 quy định phạm vi 5 nhóm dịch vụ TYT cấp xã (phòng bệnh, KCB ban đầu + PHCN, chăm sóc bà mẹ trẻ em + người cao tuổi + khuyết tật, dân số + ATTP, dược + TBYT cơ sở);\n- Luật KCB 2023 (15/2023/QH15) — Điều 47-48;\n- Luật 72/2025/QH15 — Luật Tổ chức chính quyền địa phương (mô hình 2 cấp).\nHealthcareService.type binding extensible với VNHealthcareServiceTypeVS — cho phép codes ngoài cho dịch vụ chuyên sâu của tuyến tỉnh/trung ương.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-endpoint-bhyt"
      },
      "name" : "Endpoint cổng giám định BHYT — VN Core Endpoint BHYT Profile",
      "description" : "Profile Endpoint biểu diễn cổng tiếp nhận hồ sơ giám định, thanh toán, quyết toán chi phí KCB BHYT (https://gdbhyt.baohiemxahoi.gov.vn) — endpoint điện tử của Bảo hiểm Xã hội Việt Nam mà cơ sở KCB ký hợp đồng BHXH phải gửi hồ sơ qua đó.\nCăn cứ:\n- TT 12/2026/TT-BTC (Bộ Tài chính, 03/2026), Điều 2 — CSKCB gửi hồ sơ giám định/quyết toán BHYT qua cổng gdbhyt;\n- NĐ 164/2025/NĐ-CP (29/06/2025) — giao dịch điện tử BHXH/BHYT;\n- QĐ 3176/QĐ-BYT (29/10/2024) — chuẩn dữ liệu đầu ra KCB phục vụ BHXH (XML 4210).",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-recurrent-wound-benefit"
      },
      "name" : "Flag vết thương/bệnh tật tái phát — Recurrent Wound Benefit Flag",
      "description" : "Flag nghiệp vụ theo dòng chi phí BHYT cho XML2/XML3 trường `VET_THUONG_TP`.\nChỉ dùng khi dòng thuốc, DVKT hoặc VTYT có quy định tỷ lệ thanh toán BHYT được dùng để điều trị vết thương tái phát hoặc bệnh tật tái phát cho thương binh, người hưởng chính sách như thương binh, bệnh binh theo field text của QĐ 130/QĐ-BYT và QĐ 3176/QĐ-BYT; field text này viện dẫn NĐ 131/2021/NĐ-CP.\nĐây không phải mã chẩn đoán tái phát và không phải thuộc tính cố định của thuốc, DVKT hoặc thiết bị.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-device-use-statement"
      },
      "name" : "Ghi nhận sử dụng VTYT VN Core — VN Core DeviceUseStatement Profile",
      "description" : "Profile DeviceUseStatement cho Việt Nam. Ghi nhận việc sử dụng vật tư y tế (VTYT) hoặc thiết bị cho bệnh nhân.\nLiên kết với VNCoreDevice (thông tin VTYT) và VNCoreEncounter (lượt khám).\nDùng cho theo dõi VTYT tiêu hao (catheter, kim, băng...) và VTYT lâu bền (implant, stent...).\nCăn cứ: QĐ 3176/QĐ-BYT (trường MA_VAT_TU trong chuẩn dữ liệu BHXH).\nThông tin thanh toán BHYT theo dòng chi phí như PHAM_VI, TYLE_TT và MUC_HUONG phải đặt ở Claim.item/ClaimResponse/EOB; DeviceUseStatement chỉ giữ dữ liệu sử dụng lâm sàng.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-explanation-of-benefit"
      },
      "name" : "Giải trình quyền lợi BHYT VN Core — VN Core ExplanationOfBenefit Profile",
      "description" : "Profile ExplanationOfBenefit cho Việt Nam. Giải trình quyền lợi BHYT — kết quả giám định và thanh toán.\nMapping từ chuẩn dữ liệu đầu ra phục vụ BHXH hiện hành (QĐ 130 → QĐ 4750 → QĐ 3176).\nBảng kê chi phí theo QĐ 697/QĐ-BYT (19/3/2026) — 12 danh mục, 14 mã.\nCăn cứ:\n- QĐ 3176/QĐ-BYT (29/10/2024) — Chuẩn dữ liệu đầu ra phục vụ BHXH\n- QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB\n- Luật 51/2024/QH15 (27/11/2024) — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — Hướng dẫn thi hành Luật BHYT\n- NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — xử phạt VPHC y tế, tham chiếu khi hồ sơ thanh toán/giải trình sai lệch\n- Luật BHYT 2008 sửa đổi 2014",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-bundle"
      },
      "name" : "Gói trao đổi dữ liệu VN Core — VN Core Bundle Profile",
      "description" : "Profile Bundle cho Việt Nam — gói trao đổi dữ liệu FHIR phục vụ liên thông y tế.\nHỗ trợ các use case: gửi dữ liệu BHXH (transaction), phản hồi tìm kiếm (searchset),\nbệnh án điện tử trọn bộ (document), và tập hợp resources (collection).\nCăn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 3176/QĐ-BYT (dữ liệu BHXH),\nNĐ 164/2025/NĐ-CP (giao dịch điện tử BHXH).",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "OperationDefinition"
      }],
      "reference" : {
        "reference" : "OperationDefinition/vn-submit-bhyt-claim"
      },
      "name" : "Gửi hồ sơ thanh toán BHYT — VN Submit BHYT Claim Operation",
      "description" : "OperationDefinition cho phép đóng gói và gửi hồ sơ thanh toán BHYT lên Cổng giám định BHXH.",
      "exampleBoolean" : false,
      "groupingId" : "operations"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-blood-pressure"
      },
      "name" : "Huyết áp VN Core — VN Core Observation Blood Pressure Profile",
      "description" : "Profile Observation huyết áp cho Việt Nam, dùng LOINC 85354-9 và hai component LOINC cho huyết áp tâm thu/tâm trương. Phục vụ ghi nhận sinh hiệu trong khám chữa bệnh, bệnh án điện tử và liên thông dữ liệu lâm sàng theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-acupoint-cs"
      },
      "name" : "Huyệt châm cứu Y học cổ truyền — VN Traditional Medicine Acupuncture Point CodeSystem",
      "description" : "Bộ mã huyệt châm cứu theo Y học cổ truyền Việt Nam theo QĐ 2552/QĐ-BYT Phụ lục III. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột mã quốc tế, tên quốc tế, tham chiếu SNOMED CT và thông tin đường kinh được bảo toàn dưới concept properties.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-acupoint-vs"
      },
      "name" : "Huyệt châm cứu — VN Traditional Medicine Acupuncture Point ValueSet",
      "description" : "Tập giá trị huyệt châm cứu theo y học cổ truyền. 466 huyệt với tên quốc tế và ánh xạ SNOMED CT. Từ QĐ 2552/QĐ-BYT (12/8/2025) — PL III.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-referral-mode"
      },
      "name" : "Hình thức chuyển tuyến — Referral Mode Extension",
      "description" : "Hình thức đến khám chữa bệnh (trường HTCHUYEN per QĐ 3176/QĐ-BYT).\nBổ sung cho MALYDO (VNCoreExtInsuranceVisitType): MALYDO xác định mức hưởng BHYT,\nHTCHUYEN ghi nhận nguồn gốc chuyển bệnh (tự đến, chuyển lên, chuyển xuống, chuyển ngang, cấp cứu).\nCăn cứ: QĐ 3176/QĐ-BYT (29/10/2024), NĐ 188/2025/NĐ-CP.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-referral-mode-cs"
      },
      "name" : "Hình thức chuyển tuyến — VN Referral Mode CodeSystem",
      "description" : "Danh mục hình thức đến khám chữa bệnh (trường HTCHUYEN per QĐ 3176/QĐ-BYT).\nBổ sung cho MALYDO — MALYDO xác định mức hưởng BHYT, HTCHUYEN ghi nhận nguồn gốc chuyển bệnh.\nCăn cứ: QĐ 3176/QĐ-BYT (29/10/2024), NĐ 188/2025/NĐ-CP, TT 01/2025/TT-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-referral-mode-vs"
      },
      "name" : "Hình thức chuyển tuyến — VN Referral Mode ValueSet",
      "description" : "Tập mã hình thức đến khám chữa bệnh (HTCHUYEN per QĐ 3176/QĐ-BYT).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-org-rank"
      },
      "name" : "Hạng cơ sở khám bệnh, chữa bệnh — Vietnam KCB Facility Rank Extension",
      "description" : "Mở rộng ghi nhận hạng pháp lý của cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT. Chỉ áp dụng cho cơ sở KCB; không dùng để biểu diễn trường hợp chưa xếp hạng hoặc hạng của đơn vị y tế không phải cơ sở KCB.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-hospital-rank-cs"
      },
      "name" : "Hạng cơ sở khám chữa bệnh — Vietnam Healthcare Facility Rank CodeSystem",
      "description" : "Phân hạng cơ sở khám chữa bệnh theo TT 06/2024/TT-BYT.\n4 hạng: Đặc biệt, Hạng I, Hạng II, Hạng III.\nCăn cứ:\n- **TT 06/2024/TT-BYT** — 16/5/2024 — phân hạng cơ sở khám bệnh, chữa bệnh\n- **TT 35/2024/TT-BYT** — 16/11/2024 — tiêu chuẩn chất lượng cơ bản đối với bệnh viện, tham chiếu bổ trợ khi đánh giá chất lượng.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-hospital-rank-vs"
      },
      "name" : "Hạng cơ sở khám chữa bệnh — Vietnam Healthcare Facility Rank ValueSet",
      "description" : "Tập giá trị phân hạng cơ sở KCB theo TT 06/2024/TT-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-health-unit-rank"
      },
      "name" : "Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Non-KCB Health Unit Rank Extension",
      "description" : "Mở rộng ghi nhận hạng pháp lý của đơn vị sự nghiệp y tế không phải cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT. Áp dụng cho cơ sở y tế dự phòng, trung tâm y tế, cơ sở kiểm nghiệm và kiểm định.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-health-unit-rank-cs"
      },
      "name" : "Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Vietnam Non-KCB Health Unit Rank CodeSystem",
      "description" : "Phân hạng đơn vị sự nghiệp y tế không phải cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT. Áp dụng cho cơ sở y tế dự phòng, trung tâm y tế, cơ sở kiểm nghiệm và kiểm định.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-health-unit-rank-vs"
      },
      "name" : "Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Vietnam Non-KCB Health Unit Rank ValueSet",
      "description" : "Tập giá trị phân hạng đơn vị sự nghiệp y tế không phải cơ sở khám bệnh, chữa bệnh theo TT 06/2024/TT-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-specimen-local-id-ns"
      },
      "name" : "Hệ định danh mã mẫu bệnh phẩm cục bộ — VN Specimen Local Identifier NamingSystem",
      "description" : "Hệ định danh cục bộ dành cho mã mẫu bệnh phẩm và mã tiếp nhận mẫu trong LIS/HIS của từng cơ sở y tế. Dùng khi chưa có hệ định danh quốc gia thống nhất cho Specimen.\n/ Local naming system for specimen identifiers and accession numbers assigned by a facility LIS/HIS.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-icd10-vs"
      },
      "name" : "ICD-10 Việt Nam — VN ICD-10 ValueSet",
      "description" : "Tập giá trị mã chẩn đoán ICD-10 Việt Nam dùng cho chẩn đoán bắt buộc trong VN Core.\nCăn cứ: QĐ 4469/QĐ-BYT (28/10/2020), QĐ 98/QĐ-BYT (14/01/2022) và TT 06/2026/TT-BYT (ban hành 02/04/2026, hiệu lực 01/07/2026 — future-effective) về mã hóa bệnh tật, nguyên nhân tử vong theo ICD-10.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-claim-item-department"
      },
      "name" : "Khoa thực hiện — Claim Item Department Extension",
      "description" : "Mã khoa thực hiện dịch vụ/thuốc trên từng dòng chi phí.\nMapping XML 3176: MA_KHOA.\nNguồn thiết kế: OHP Data Processor (claim-item-department).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-organization-department"
      },
      "name" : "Khoa/Phòng VN Core — VN Core Organization Department Profile",
      "description" : "Profile Organization cho khoa/phòng chuyên môn trong cơ sở khám bệnh, chữa bệnh tại Việt Nam.\nProfile này intentionally kế thừa trực tiếp từ FHIR Organization, không kế thừa VNCoreOrganization, để biểu diễn đơn vị trực thuộc với partOf bắt buộc và mã khoa chuyên ngành.\nCăn cứ pháp lý và nghiệp vụ:\n- **QĐ 2010/QĐ-BYT ngày 19/6/2025 Phụ lục 6** — Danh mục mã khoa hiện hành, 54 mã (K01-K53 + K99)\n- QĐ 5937/QĐ-BYT (2021) — tiền nhiệm, bị bãi bỏ phần Phụ lục 5 bởi QĐ 2010/QĐ-BYT Điều 2\n- QĐ 3176/QĐ-BYT (29/10/2024) — trường MA_KHOA trong XML đầu ra KCB\n- TT 32/2023/TT-BYT Chương VIII Điều 44-45 — operational reference cho trực khoa, giao ban; không phải văn bản ban hành taxonomy khoa/phòng\n- TT 13/2025/TT-BYT (06/6/2025) — bệnh án điện tử cần ghi nhận khoa điều trị.\n/\nVN Core OrganizationDepartment profile for clinical/operational departments within Vietnamese healthcare facilities.\nThis profile inherits directly from FHIR Organization, separate from VNCoreOrganization, to keep department semantics explicit through mandatory partOf and department-code identifiers.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-claim-response"
      },
      "name" : "Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile",
      "description" : "Profile ClaimResponse cho Việt Nam. Kết quả xử lý yêu cầu thanh toán BHYT.\nBao gồm adjudication chi tiết: tổng đề nghị, đủ điều kiện, cùng chi trả, BHYT thanh toán.\nCặp đôi với VNCoreClaim — Claim là yêu cầu, ClaimResponse là kết quả.\nMã phản hồi gateway như XML1_ID được biểu diễn bằng identifier slice riêng; không thay thế MA_LK của Claim/Bundle.\nCăn cứ:\n- QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (chuẩn dữ liệu BHXH hiện hành)\n- QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB\n- Luật 51/2024/QH15 (27/11/2024) — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — Hướng dẫn Luật BHYT\n- NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — xử phạt VPHC y tế, tham chiếu khi hồ sơ giám định/thanh toán sai lệch\nNguồn thiết kế: OHP Data Processor (ClaimResponse adjudication mapping).",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-treatment-outcome-cs"
      },
      "name" : "Kết quả điều trị — Vietnam Treatment Outcome CodeSystem",
      "description" : "Danh mục kết quả điều trị theo QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024) (trường KETQUA).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-treatment-outcome"
      },
      "name" : "Kết quả điều trị — Vietnam Treatment Outcome Extension",
      "description" : "Mở rộng ghi nhận kết quả điều trị (trường KETQUA) cho lượt khám/điều trị.\nCăn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024).\n5 giá trị: Khỏi, Đỡ, Không thay đổi, Nặng hơn, Tử vong.\nLưu ý: Khác với dischargeDisposition (tình trạng ra viện — TINHTRANGRA).\nKETQUA đánh giá kết quả y khoa, TINHTRANGRA ghi nhận hình thức ra viện.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-treatment-outcome-vs"
      },
      "name" : "Kết quả điều trị — Vietnam Treatment Outcome ValueSet",
      "description" : "Tập giá trị kết quả điều trị theo QĐ 130/QĐ-BYT (thay thế QĐ 4210), sửa đổi bổ sung bởi QĐ 3176/QĐ-BYT (2024).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-claim-payment-period"
      },
      "name" : "Kỳ thanh toán — Claim Payment Period Extension",
      "description" : "Năm và tháng thanh toán BHYT.\nMapping XML 3176: NAM_QT (năm), THANG_QT (tháng).\nNguồn thiết kế: OHP Data Processor (claim-payment-year, claim-payment-month).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-technique-cs"
      },
      "name" : "Kỹ thuật Y học cổ truyền — VN Traditional Medicine Technique CodeSystem",
      "description" : "Bộ mã kỹ thuật Y học cổ truyền Việt Nam theo QĐ 2552/QĐ-BYT Phụ lục IV. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột `Mã` kỹ thuật và `STT trong TT 23/2024/TT-BYT` được bảo toàn dưới concept properties.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-technique-vs"
      },
      "name" : "Kỹ thuật YHCT — VN Traditional Medicine Technique ValueSet",
      "description" : "Tập giá trị kỹ thuật y học cổ truyền. 925 kỹ thuật tham chiếu TT 23/2024/TT-BYT. Từ QĐ 2552/QĐ-BYT (12/8/2025) — PL IV.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-loinc-cs"
      },
      "name" : "LOINC Việt Nam — Vietnam LOINC CodeSystem",
      "description" : "Bảng mã xét nghiệm quốc tế LOINC (Logical Observation Identifiers Names and Codes)\nphiên bản Việt Nam. 66.077 mã LOINC unique với bản dịch tên thành phần (component) tiếng Việt.\nTrong đó ~59.000 mã có bản dịch tiếng Việt, ~7.000 mã chỉ có tên tiếng Anh.\n\nCăn cứ pháp lý:\n- QĐ 1227/QĐ-BYT (11/04/2025) — Ban hành bộ mã CLS (cận lâm sàng) quốc gia,\n  ánh xạ mã CLS VN ↔ LOINC. VN có bộ mã CLS riêng, MAPPING sang LOINC.\n- QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu BHXH, trường MA_XN (mã xét nghiệm)\n\nVietnam LOINC translation, published by Cục KCB — MOH in collaboration with\nRegenstrief Institute (USA). Contains 66,077 unique LOINC codes with Vietnamese\ncomponent translations. Source: https://loinc.whiteneuron.com\n(Deduplicated from original 108,526 entries which included duplicates, CLS VN codes,\nand EMR form field entries.)\n\n**Dữ liệu hiện có trong lớp chuẩn hóa:**\n`number` (mã LOINC chuẩn), `long_common_name` (tên tiếng Anh đầy đủ), `component` (bản dịch tiếng Việt khi có), `shortname`, `property`, `time_aspect`, `system`, `scale_type`, `method_type`, và `common_test_rank` để hỗ trợ ưu tiên các mã dùng nhiều. Dataset đã loại bỏ bản ghi trùng, mã CLS VN nội bộ, và các field biểu mẫu không phải mã LOINC chuẩn.\n\n**Nhóm dữ liệu thường gặp:** mã xét nghiệm và chỉ số định lượng/định tính; panel/order set phục vụ chỉ định và trả kết quả; report/document identifiers dùng trong Composition/DocumentReference khi phù hợp; survey/questionnaire items có trong LOINC gốc nhưng không phải mọi triển khai VN Core đều cần nạp toàn bộ.\n\n**Cách dùng trong VN Core:** Khi coding trong FHIR, dùng `system = http://loinc.org`. Với xét nghiệm cận lâm sàng trong nước, dùng cùng `vn-cls-cs` và `ConceptMap/vn-cm-cls-to-loinc`. Dùng artifact này khi cần biết lớp dữ liệu LOINC VN đã được chuẩn hóa đến mức nào trước khi import vào terminology server nội bộ.\n\n**Cách lấy artifact:** Validator/FHIR server dùng file FHIR JSON đầy đủ `CodeSystem-vn-loinc-cs.full.json` trên release download surface khi cần preload toàn bộ mã. Bộ tải xuống phát hành: xem [trang tải xuống](downloads.html#loinc-fhir-json) để lấy liên kết trực tiếp và gói `hl7.fhir.vn.terminology.clinical-0.3.0.tgz`. Public IG page này là metadata wrapper; dữ liệu chi tiết được tiêu thụ thông qua package/download surface và nguồn chuẩn hóa đi kèm. Các serialization XML/TTL trên public IG chỉ phản ánh metadata wrapper hiện hành; riêng route canonical `.json` được trỏ sang full JSON download.\n\nNote: MOH publishes a separate national lab code system (QĐ 1227/2025) that MAPS to LOINC.\nWhen coding in FHIR, use system = http://loinc.org with LOINC number from the mapping table.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-bhyt-adjudication-category-vs"
      },
      "name" : "Loại adjudication BHYT — BHYT Adjudication Category ValueSet",
      "description" : "ValueSet gộp mã adjudication chuẩn HL7 và mã bổ sung của VN Core cho tổng hợp tài chính BHYT. Binding dùng extensible để giữ tương thích với FHIR R4 và cho phép payer-specific codes khi pilot có căn cứ.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-immunization-program-type-cs"
      },
      "name" : "Loại chương trình tiêm chủng — Vietnam Immunization Program Type CodeSystem",
      "description" : "Danh mục loại chương trình tiêm chủng tại Việt Nam: tiêm chủng mở rộng, tiêm chủng dịch vụ và tiêm chủng chiến dịch. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.\nNguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-immunization-program-type"
      },
      "name" : "Loại chương trình tiêm chủng — Vietnam Immunization Program Type Extension",
      "description" : "Mở rộng ghi nhận loại chương trình tiêm chủng trên Immunization: TCMR, dịch vụ hoặc chiến dịch. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.\nNguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-immunization-program-type-vs"
      },
      "name" : "Loại chương trình tiêm chủng — Vietnam Immunization Program Type ValueSet",
      "description" : "Tập giá trị loại chương trình tiêm chủng tại Việt Nam: TCMR, dịch vụ, chiến dịch. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-healthcare-service-type-cs"
      },
      "name" : "Loại dịch vụ y tế tuyến cơ sở — VN Healthcare Service Type CodeSystem",
      "description" : "Bộ mã loại hình dịch vụ y tế cung cấp tại tuyến cơ sở (đặc biệt Trạm Y tế cấp xã/phường/đặc khu).\nCăn cứ:\n- VBHN 06/2026/VBHN-BYT (01/2026) — hợp nhất TT 43/2025/TT-BYT và TT 53/2025/TT-BYT, Điều 3-4 quy định phạm vi dịch vụ TYT cấp xã.\nPhạm vi dịch vụ gồm 5 nhóm chính:\n1. Phòng bệnh (tiêm chủng, HIV, bệnh không lây nhiễm)\n2. KCB ban đầu + phục hồi chức năng\n3. Quản lý sức khỏe bà mẹ trẻ em, người cao tuổi, khuyết tật\n4. Dân số, an toàn thực phẩm\n5. Dược, TBYT tại cơ sở.\nDùng cho HealthcareService.type của VNCoreHealthcareService (binding extensible — vẫn cho phép codes ngoài cho dịch vụ chuyên sâu).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-healthcare-service-type-vs"
      },
      "name" : "Loại dịch vụ y tế tuyến cơ sở — VN Healthcare Service Type ValueSet",
      "description" : "Tập giá trị loại hình dịch vụ y tế tuyến cơ sở (đặc biệt cho TYT cấp xã/phường/đặc khu) theo VBHN 06/2026/VBHN-BYT Điều 3-4. Dùng cho HealthcareService.type với binding extensible.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-service-request-category-cs"
      },
      "name" : "Loại dịch vụ y tế — VN Service Request Category CodeSystem",
      "description" : "Phân loại yêu cầu dịch vụ y tế theo nhóm chức năng tại các cơ sở KCB Việt Nam.\nDựa trên phân loại khoa phòng bệnh viện và danh mục DVKT (TT 20/2014/TT-BYT, TT 39/2018/TT-BYT).\nTương ứng với các nhóm chi phí trong QĐ 697/QĐ-BYT (19/3/2026). /\nVietnamese medical service request category classification.\nBased on hospital department structure and DVKT catalog (TT 20/2014, TT 39/2018).\nCorresponds to cost categories in QĐ 697/QĐ-BYT (19/3/2026).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-service-request-category-vs"
      },
      "name" : "Loại dịch vụ y tế — VN Service Request Category ValueSet",
      "description" : "Tập giá trị phân loại yêu cầu dịch vụ y tế Việt Nam. /\nValueSet of Vietnamese medical service request categories.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-organization-type-cs"
      },
      "name" : "Loại hình cơ sở y tế — Vietnam Organization Type CodeSystem",
      "description" : "Danh mục loại hình cơ sở y tế dùng trong VN Core, tổng hợp từ Luật KCB 2023, TT 06/2024/TT-BYT và VBHN 06/2026/VBHN-BYT (hợp nhất TT 43/2025 + TT 53/2025 về Trạm Y tế xã/phường).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-org-type"
      },
      "name" : "Loại hình cơ sở y tế — Vietnam Organization Type Extension",
      "description" : "Mở rộng ghi nhận loại hình cơ sở y tế (bệnh viện, phòng khám, trạm y tế...).\nFHIR Organization.type dùng mã quốc tế — extension này bổ sung phân loại theo y tế Việt Nam.\nCăn cứ: Luật KCB 2023 (15/2023/QH15), Điều 47-48.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-organization-type-vs"
      },
      "name" : "Loại hình cơ sở y tế — Vietnam Organization Type ValueSet",
      "description" : "Tập giá trị loại hình cơ sở y tế theo Luật KCB 2023.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-insurance-visit-type-cs"
      },
      "name" : "Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type CodeSystem",
      "description" : "Danh mục loại khám chữa bệnh BHYT theo QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nPhân loại mục đích đến khám theo chế độ BHYT.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-insurance-visit-type"
      },
      "name" : "Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type Extension",
      "description" : "Mở rộng ghi nhận loại khám chữa bệnh BHYT trên lượt khám\n(đúng tuyến, trái tuyến, thông tuyến, cấp cứu, KCB ban đầu).\nTương ứng trường MALYDO trong QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nCăn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024), Luật BHYT 2008 sửa đổi 2014.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-insurance-visit-type-vs"
      },
      "name" : "Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type ValueSet",
      "description" : "Tập giá trị loại khám chữa bệnh BHYT theo QĐ 130/QĐ-BYT (thay thế QĐ 4210), sửa đổi bổ sung bởi QĐ 3176/QĐ-BYT (2024).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-encounter-type-cs"
      },
      "name" : "Loại khám chữa bệnh — Vietnam Encounter Type CodeSystem",
      "description" : "Danh mục mã loại khám chữa bệnh (trường MA_LOAI_KCB).\nCăn cứ: QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nTham chiếu bổ sung:\n- **TT 30/2023/TT-BYT** — 30/12/2023 — khám bệnh, chữa bệnh từ xa; chưa tạo mã MA_LOAI_KCB riêng, dùng Encounter.class = VR khi cần\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — dữ liệu KCB trong CSDL quốc gia về y tế.\nNguồn dữ liệu: OHP Data Processor (production mapping).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-encounter-type-vs"
      },
      "name" : "Loại khám chữa bệnh — Vietnam Encounter Type ValueSet",
      "description" : "Tập giá trị mã loại KCB (MA_LOAI_KCB). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-device-type-vs"
      },
      "name" : "Loại thiết bị y tế Việt Nam — Vietnam Device Type ValueSet",
      "description" : "ValueSet dùng làm binding preferred cho Device.type hoặc DeviceDefinition.type trong package hl7.fhir.vn.device. Hiện include toàn bộ danh pháp Việt Nam; các phiên bản sau có thể chuyển thành subset curated hoặc bổ sung hệ quốc tế khi license/provenance đủ. VN Core không required-bind Device.type vào ValueSet này.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-bhyt-adjudication-category-cs"
      },
      "name" : "Loại tổng hợp adjudication BHYT — BHYT Adjudication Category CodeSystem",
      "description" : "Danh mục bổ sung cho các loại tổng hợp tài chính BHYT không có mã tương đương chính xác trong HL7 Terminology `adjudication`. Các mã này dùng chủ yếu cho `ClaimResponse.total`, `ExplanationOfBenefit.total` hoặc cost summary, không thay thế adjudication logic của payer.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-vaccine-type-vs"
      },
      "name" : "Loại vaccine Việt Nam — Vietnam Vaccine Type ValueSet",
      "description" : "Tập giá trị loại vaccine theo bệnh/nhóm bệnh cho VNCoreImmunization, bao gồm TCMR và các vaccine dịch vụ/chiến dịch phổ biến. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-ward-type"
      },
      "name" : "Loại đơn vị cấp xã (xã/phường/đặc khu) — Vietnam Ward Type Extension",
      "description" : "Mở rộng phân loại đơn vị hành chính cấp xã trên Address: xã (nông thôn), phường (đô thị), hoặc đặc khu (hải đảo).\nFHIR Address không có khái niệm phân loại đơn vị cấp xã — extension này bổ sung để phản ánh mô hình chính quyền 2 cấp.\nDùng kèm với vn-ext-ward (mã xã/phường) để biểu diễn đầy đủ cấp xã.\nCăn cứ: Luật 72/2025/QH15 (16/6/2025, hiệu lực 01/7/2025) — Luật Tổ chức chính quyền địa phương; NQ 202/2025/QH15.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-ward-type-cs"
      },
      "name" : "Loại đơn vị cấp xã — Vietnam Ward Type CodeSystem",
      "description" : "Danh mục 3 loại đơn vị hành chính cấp xã theo Luật 72/2025/QH15 (Luật Tổ chức chính quyền địa phương, hiệu lực 01/7/2025) và NQ 202/2025/QH15. Mô hình chính quyền địa phương 2 cấp (tỉnh + xã) chính thức xác lập 3 loại đơn vị cấp cơ sở: xã (nông thôn), phường (đô thị), đặc khu (hải đảo đặc biệt).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-ward-type-vs"
      },
      "name" : "Loại đơn vị cấp xã — Vietnam Ward Type ValueSet",
      "description" : "Tập giá trị 3 loại đơn vị hành chính cấp xã theo Luật 72/2025/QH15: xã, phường, đặc khu.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-identifier-type-cs"
      },
      "name" : "Loại định danh Việt Nam — Vietnam Identifier Type CodeSystem",
      "description" : "Danh mục các loại định danh sử dụng trong hệ thống y tế Việt Nam.\nBổ sung cho HL7 v2 Table 0203 (Identifier Type) với các loại định danh riêng của Việt Nam.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-identifier-type-vs"
      },
      "name" : "Loại định danh Việt Nam — Vietnam Identifier Type ValueSet",
      "description" : "Tập giá trị bao gồm tất cả loại định danh Việt Nam,\nkết hợp với HL7 v2 Table 0203.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-bhyt-card-type"
      },
      "name" : "Loại đối tượng BHYT — Vietnam BHYT Card Type Extension",
      "description" : "Mở rộng ghi nhận loại đối tượng bảo hiểm y tế (DN, HC, HN, TE, BT...).\nXác định mức quyền lợi và tỷ lệ đồng chi trả.\nTương ứng trường MATHE (2 ký tự đầu) trong QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nCăn cứ: Luật BHYT 2008 sửa đổi 2014, BHXH Việt Nam.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-bhyt-card-type-cs"
      },
      "name" : "Loại đối tượng thẻ BHYT — Vietnam BHYT Card Type CodeSystem",
      "description" : "Danh mục mã đối tượng tham gia BHYT (2 ký tự) ghi trên thẻ bảo hiểm y tế.\nCăn cứ: QĐ 1351/QĐ-BHXH (16/11/2015), QĐ 1697/QĐ-BHXH (27/11/2023),\nQĐ 1018/QĐ-BHXH (24/7/2024), NĐ 146/2018/NĐ-CP, NĐ 75/2023/NĐ-CP.\nCập nhật nền pháp lý:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT; các trích dẫn NĐ 146/2018 trong từng mã được giữ để truy xuất nguồn danh mục lịch sử.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-bhyt-card-type-vs"
      },
      "name" : "Loại đối tượng thẻ BHYT — Vietnam BHYT Card Type ValueSet",
      "description" : "Tập giá trị loại đối tượng tham gia BHYT.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-consent-category-cs"
      },
      "name" : "Loại đồng ý — VN Consent Category CodeSystem",
      "description" : "Phân loại loại đồng ý xử lý dữ liệu cá nhân trong y tế Việt Nam.\nCăn cứ: Luật 91/2025/QH15 Điều 11 (sự đồng ý), Điều 17 (miễn trừ đồng ý).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-consent-category-vs"
      },
      "name" : "Loại đồng ý — VN Consent Category ValueSet",
      "description" : "Tập mã loại đồng ý xử lý dữ liệu cá nhân trong y tế Việt Nam.\nCăn cứ: Luật 91/2025/QH15.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-force-majeure-reason"
      },
      "name" : "Lý do bất khả kháng thiếu CCCD — Force Majeure Reason Extension",
      "description" : "Mở rộng ghi nhận lý do bất khả kháng khi chưa thu thập được số CCCD/số định danh cá nhân trong hồ sơ BHYT. Dùng cho các ca đặc biệt như trẻ sơ sinh hoặc người bệnh mất ý thức.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-force-majeure-reason-cs"
      },
      "name" : "Lý do bất khả kháng thiếu CCCD — Vietnam Force Majeure Reason CodeSystem",
      "description" : "Danh mục mã cục bộ phục vụ triển khai VN Core để ghi nhận lý do bất khả kháng khi chưa thu thập được số CCCD/số định danh cá nhân trong hồ sơ BHYT. Danh mục này chỉ dùng cho các ca bất khả kháng thực sự; không dùng để thay cho trường hợp người bệnh đã có định danh thay thế hợp lệ như hộ chiếu hoặc giấy khai sinh.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-force-majeure-reason-vs"
      },
      "name" : "Lý do bất khả kháng thiếu CCCD — Vietnam Force Majeure Reason ValueSet",
      "description" : "Tập giá trị lý do bất khả kháng cho phép tạm thời để trống CCCD trong hồ sơ BHYT. Không dùng ValueSet này cho trường hợp đã có định danh thay thế hợp lệ như hộ chiếu hoặc giấy khai sinh.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-immunization-status-reason-vs"
      },
      "name" : "Lý do không tiêm chủng — Vietnam Immunization Status Reason ValueSet",
      "description" : "Tập giá trị lý do không thực hiện tiêm chủng trong VNCoreImmunization. Bao gồm các lý do tối thiểu phục vụ vận hành TCMR, tiêm chủng dịch vụ và chiến dịch. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-encounter"
      },
      "name" : "Lượt khám/nhập viện VN Core — VN Core Encounter Profile",
      "description" : "Profile Encounter cho Việt Nam. Bao gồm extension loại KCB BHYT (trường MALYDO),\nthông tin chẩn đoán, cơ sở y tế, và kết quả điều trị/tình trạng ra viện.\nCăn cứ:\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản lý dữ liệu y tế số và CSDL quốc gia về y tế\n- **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử\n- **TT 30/2023/TT-BYT** — 30/12/2023 — khám bệnh, chữa bệnh từ xa khi Encounter.class = VR/virtual\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **QĐ 130/QĐ-BYT** — 18/01/2023; **QĐ 4750/QĐ-BYT** — 29/12/2023; **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ConceptMap"
      }],
      "reference" : {
        "reference" : "ConceptMap/vn-cm-province-legacy-to-new"
      },
      "name" : "Mapping 63 → 34 tỉnh/thành (NQ 202/2025) — VN Province Legacy-to-New ConceptMap",
      "description" : "ConceptMap NON-AUTHORITATIVE DRAFT chuyển đổi 63 mã tỉnh/thành cũ (trước 01/07/2025) sang 34 mã tỉnh/thành mới theo:\n- **NQ 202/2025/QH15** (Sắp xếp đơn vị hành chính cấp tỉnh) — hiệu lực 01/07/2025\n- **QĐ 19/2025/QĐ-TTg** (Bảng danh mục và mã số ĐVHC) — Phụ lục I 34 tỉnh\n\nCác trường hợp trong mapping:\n- `equivalent`: 11 tỉnh/TP giữ nguyên (mã cũ = mã mới)\n- `narrower`: tỉnh cũ thuộc nhóm sáp nhập, mã cũ nhỏ hơn (specific) so với tỉnh mới (broader)\n- `disjoint`: trường hợp không xác định được mapping (nếu có)\n\n**Cảnh báo**: TCTK và Bộ Nội vụ chưa publish ConceptMap chính thức 63→34. Bản này là draft research-based, dùng cho:\n- Tham chiếu data legacy khi convert sang ĐVHC mới\n- Backward compatibility cho dữ liệu BHYT trước 01/07/2025\n- KHÔNG dùng cho thanh toán BHYT chính thức trước khi BHXH/Bộ Y tế xác nhận.",
      "exampleBoolean" : false,
      "groupingId" : "conceptmaps"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-morphology-vs"
      },
      "name" : "Morphologic Abnormality SNOMED CT VN — VN Morphology ValueSet",
      "description" : "Tập giá trị bất thường hình thái dựa trên SNOMED CT Morphologically abnormal structure.\nBộ Y tế Việt Nam đã ban hành subset SNOMED CT VN Đợt 2 cho Morphologic Abnormality theo QĐ 2493/QĐ-BYT (08/2025), gồm khoảng 5.155 concepts.\nValueSet này dùng cho VNCoreDiagnosticReportPathology.conclusionCode với binding extensible.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-citizen-id-birthplace-prefix-cs"
      },
      "name" : "Mã 3 số nơi đăng ký khai sinh trên CCCD/số định danh cá nhân — Citizen ID Birthplace Prefix CodeSystem",
      "description" : "Danh mục mã 3 chữ số của Bộ Công an dùng ở ba chữ số đầu của số định danh cá nhân/CCCD 12 số để biểu thị tỉnh, thành phố trực thuộc Trung ương hoặc mã quốc gia nơi công dân đăng ký khai sinh. CodeSystem này chỉ phục vụ validation-support cho định danh cá nhân/CCCD đã cấp; KHÔNG thay thế danh mục đơn vị hành chính hiện hành trong `VNProvinceCS`. Căn cứ quy chiếu nghiệp vụ: Thông tư 17/2024/TT-BCA về thi hành Luật Căn cước và hệ mã prefix BCA đang được duy trì trên các số định danh/CCCD đã cấp.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-citizen-id-birthplace-prefix-vs"
      },
      "name" : "Mã 3 số nơi đăng ký khai sinh trên CCCD/số định danh cá nhân — Citizen ID Birthplace Prefix ValueSet",
      "description" : "ValueSet toàn bộ các mã prefix BCA hợp lệ dùng để kiểm tra ba chữ số đầu của số định danh cá nhân/CCCD 12 số.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-mrn-ns"
      },
      "name" : "Mã bệnh nhân nội bộ (MRN) — Vietnam Medical Record Number",
      "description" : "Hệ thống mã bệnh nhân nội bộ (Medical Record Number), do từng cơ sở y tế tự quản lý.\nFormat và quy tắc đánh mã do từng bệnh viện tự quy định.\nCăn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), Luật KCB 2023 (15/2023/QH15).",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-condition-code-vs"
      },
      "name" : "Mã chẩn đoán — VN Core Condition Code ValueSet",
      "description" : "Tập giá trị mã chẩn đoán cho VN Core, bao gồm:\n- ICD-10 WHO (bắt buộc theo QĐ 4469/QĐ-BYT 28/10/2020, bổ sung bởi QĐ 98/QĐ-BYT 14/01/2022) — 15.026 mã\n- SNOMED CT IPS Terminology — Clinical Findings (tùy chọn, miễn phí theo CC-BY-4.0) — 36.349 mã trong VN subset\n- YHCT Mã U — 228 bệnh danh và thể lâm sàng y học cổ truyền theo QĐ 2552/QĐ-BYT Phụ lục I\nBinding extensible — cho phép dual/triple coding: ICD-10 + SNOMED CT + YHCT.\nLưu ý: Mã U YHCT KHÔNG PHẢI ICD-10, là hệ thống mã quốc gia riêng; FHIR `code` dùng Mã U/Mã hóa chính thức, còn Mã dùng chung được bảo toàn trong CodeSystem property.\nICD-11 đang trong Phase II lộ trình 2026, chưa thay thế ICD-10 tại Việt Nam.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-ma-cskcb-ns"
      },
      "name" : "Mã cơ sở khám chữa bệnh (CSKCB) — Vietnam Healthcare Facility Code",
      "description" : "Hệ thống mã cơ sở khám chữa bệnh (5 chữ số), do BHXH Việt Nam cấp.\nDùng để định danh các cơ sở y tế trong hệ thống thanh toán BHYT.\nCăn cứ: Luật KCB 2023 (15/2023/QH15), BHXH Việt Nam.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-allergy-code-vs"
      },
      "name" : "Mã dị ứng — VN Core Allergy Code ValueSet",
      "description" : "Tập giá trị mã dị ứng/bất dung nạp cho VN Core, dựa trên SNOMED CT IPS Terminology.\nViệt Nam không có bộ mã dị ứng quốc gia — sử dụng SNOMED CT IPS (miễn phí, CC-BY-4.0).\nVN subset Đợt 3 (QĐ 2805/QĐ-BYT 2025): 1.327 Allergy concepts có bản dịch tiếng Việt.\nBinding extensible — cho phép text mô tả nếu không có mã SNOMED phù hợp.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-ma-lk-ns"
      },
      "name" : "Mã liên kết hồ sơ BHYT — Vietnam MA_LK Identifier",
      "description" : "Hệ thống định danh cho mã liên kết hồ sơ `MA_LK`, dùng để liên kết toàn bộ dữ liệu của cùng một đợt khám chữa bệnh trong lớp liên thông hồ sơ BHYT. Áp dụng cho Bundle.identifier và Claim.identifier.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-vital-signs-codes-vs"
      },
      "name" : "Mã LOINC sinh hiệu VN Core — VN Core Vital Signs LOINC Codes ValueSet",
      "description" : "Tập giá trị LOINC cho sinh hiệu VN Core, bao gồm huyết áp, mạch, nhịp thở, SpO2, nhiệt độ, chiều cao, cân nặng và BMI. Căn cứ triển khai: TT 13/2025/TT-BYT (06/06/2025) về bệnh án điện tử; QĐ 1227/QĐ-BYT (11/04/2025) ban hành danh mục mã dùng chung đối với kỹ thuật, thuật ngữ chỉ số cận lâm sàng và phục vụ ánh xạ LOINC.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-ma-luot-kcb-ns"
      },
      "name" : "Mã lượt khám chữa bệnh — Vietnam Encounter Visit Identifier",
      "description" : "Hệ thống định danh khuyến nghị cho mã lượt khám `MA_LUOT_KCB` của Encounter. Mã này dùng để đối soát một lượt khám cụ thể tại cơ sở khám chữa bệnh, khác với `MA_LK` là mã liên kết của hồ sơ thanh toán BHYT.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-encounter-code"
      },
      "name" : "Mã lượt khám — Encounter Code Extension",
      "description" : "Mã lượt khám chữa bệnh (trường MA_LUOT_KCB per QĐ 3176/QĐ-BYT).\nĐược mô hình hóa như Identifier để giữ nhất quán `system` / `value` / `type` khi đối soát BHXH.\nKhác với Encounter.identifier — MA_LUOT_KCB là mã nội bộ cho từng lượt khám và dùng NamingSystem khuyến nghị riêng.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-qd3176-cost-group-cs"
      },
      "name" : "Mã nhóm chi phí QĐ 3176 — QD 3176 Cost Group CodeSystem",
      "description" : "Danh mục `MA_NHOM` dùng trong XML2/XML3 chuẩn dữ liệu đầu ra KCB theo QĐ 3176/QĐ-BYT. Đây là mã nguồn legacy/export, không đồng nhất trực tiếp với `vn-cost-category-cs` theo QĐ 697.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-qd3176-cost-group-vs"
      },
      "name" : "Mã nhóm chi phí QĐ 3176 — QD 3176 Cost Group ValueSet",
      "description" : "Tập giá trị `MA_NHOM` dùng trong XML2/XML3 chuẩn dữ liệu đầu ra KCB theo QĐ 3176/QĐ-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-bhyt-gateway-response-id-ns"
      },
      "name" : "Mã phản hồi Cổng tiếp nhận BHYT — BHYT Gateway Response Identifier",
      "description" : "Hệ thống định danh cho mã phản hồi của Cổng tiếp nhận dữ liệu BHYT, ví dụ `XML1_ID` trong báo cáo/response gateway. Đây là mã phản hồi tiếp nhận/giám định, không phải `MA_LK` và không được dùng để thay thế mã liên kết hồ sơ.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-bhxh-ns"
      },
      "name" : "Mã số BHXH — Vietnam Social Insurance Number",
      "description" : "Hệ thống định danh Mã số Bảo hiểm xã hội (10 chữ số), do BHXH Việt Nam cấp.\nGắn với sổ BHXH, dùng để tra cứu quá trình tham gia BHXH/BHYT/BHTN.\nLiên thông với CCCD nhưng vẫn tồn tại song song per NĐ 164/2025/NĐ-CP.\nCăn cứ bổ sung:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **NĐ 164/2025/NĐ-CP** — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-accident-type-cs"
      },
      "name" : "Mã tai nạn thương tích — Vietnam Accident Type CodeSystem",
      "description" : "Danh mục mã tai nạn thương tích (trường MA_TAI_NAN).\nCăn cứ: QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024), Bảng 8.\nNguồn dữ liệu: OHP Data Processor (production mapping).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-accident-type-vs"
      },
      "name" : "Mã tai nạn thương tích — Vietnam Accident Type ValueSet",
      "description" : "Tập giá trị mã tai nạn (MA_TAI_NAN). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024), Bảng 8.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-icd9-cm-vs"
      },
      "name" : "Mã thủ thuật ICD-9-CM — VN Core ICD-9-CM Procedure ValueSet",
      "description" : "Tập giá trị mã thủ thuật/phẫu thuật ICD-9-CM phiên bản Việt Nam.\n3.882 mã từ QĐ 387/QĐ-BYT (05/02/2026), dựa trên CMS V32.\nÁnh xạ với danh mục DVKT VN theo QĐ 4466/QĐ-BYT (2020).\nBinding extensible — cho phép mã DVKT VN hoặc SNOMED CT khi cần.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-procedure-code-vs"
      },
      "name" : "Mã thủ thuật/dịch vụ kỹ thuật — VN Core Procedure Code ValueSet",
      "description" : "Tập giá trị mã thủ thuật và dịch vụ kỹ thuật y tế cho VN Core, bao gồm:\n- ICD-9-CM (Volume 3) — 3.882 mã thủ thuật VN (QĐ 387/QĐ-BYT 05/02/2026, CMS V32)\n- SNOMED CT IPS Terminology — Procedures (miễn phí, CC-BY-4.0)\nBinding extensible — cho phép mã danh mục DVKT VN (TT 20/2014, TT 39/2018).\nÁnh xạ DVKT VN ↔ ICD-9-CM theo QĐ 4466/QĐ-BYT (2020).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-document-number-ns"
      },
      "name" : "Mã tài liệu lâm sàng nội bộ — Vietnam Clinical Document Identifier",
      "description" : "Namespace khuyến nghị cho mã tài liệu lâm sàng nội bộ do cơ sở y tế phát sinh, dùng cho Composition.identifier và DocumentReference.identifier khi chưa có NamingSystem riêng của từng cơ sở.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-medical-device-item-code-ns"
      },
      "name" : "Mã vật tư/thiết bị y tế — Vietnam Medical Device Item Code",
      "description" : "Hệ thống mã vật tư/thiết bị y tế dùng trong dữ liệu KCB/BHYT hoặc dữ liệu lịch sử.\nMã này phục vụ mapping trường MA_VAT_TU và dòng chi phí thiết bị/vật tư; không phải UDI, serial number, mã tài sản, số lưu hành hoặc định danh vật lý duy nhất của một thiết bị.\nCăn cứ: QĐ 3176/QĐ-BYT (29/10/2024), TT 04/2017/TT-BYT, TT 24/2025/TT-BYT, QĐ 3514/QĐ-BYT (2024) và các quyết định mã hàng VTYT lịch sử như QĐ 2178/QĐ-BYT, QĐ 5086/QĐ-BYT, QĐ 637/QĐ-BYT, QĐ 1844/QĐ-BYT, QĐ 2807/QĐ-BYT, QĐ 3181/QĐ-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-organization-local-id-ns"
      },
      "name" : "Mã định danh tổ chức nội bộ — Vietnam Local Organization Identifier",
      "description" : "Hệ thống định danh cục bộ cho Organization khi chưa có mã dùng chung cấp quốc gia tương ứng với ngữ cảnh nghiệp vụ.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-location-local-id-ns"
      },
      "name" : "Mã định danh địa điểm nội bộ — Vietnam Local Location Identifier",
      "description" : "Hệ thống định danh cục bộ cho Location trong phạm vi từng cơ sở y tế hoặc từng hệ thống HIS/EMR.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-patient-visit-type-cs"
      },
      "name" : "Mã đối tượng đến KCB — Vietnam Patient Visit Type CodeSystem",
      "description" : "Danh mục mã đối tượng đến khám bệnh, chữa bệnh (trường MA_DOITUONG_KCB) phục vụ việc gửi dữ liệu điện tử chi phí KCB BHYT.\nCăn cứ: QĐ 3276/QĐ-BYT ngày 17/10/2025.\nThay thế Phụ lục 5 QĐ 824/QĐ-BYT (15/02/2023) và Phụ lục 5 QĐ 2010/QĐ-BYT (19/6/2025).\nCăn cứ pháp lý nền: Luật BHYT, Luật 51/2024/QH15 sửa đổi Luật BHYT (27/11/2024, hiệu lực 01/7/2025), NĐ 42/2025/NĐ-CP, NĐ 188/2025/NĐ-CP, TT 48/2017/TT-BYT, TT 01/2025/TT-BYT.\nMã được xác định sau khi kết thúc KCB hoặc kết thúc điều trị.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-patient-visit-type-vs"
      },
      "name" : "Mã đối tượng đến KCB — Vietnam Patient Visit Type ValueSet",
      "description" : "Tập giá trị mã đối tượng đến khám bệnh, chữa bệnh (MA_DOITUONG_KCB) theo QĐ 3276/QĐ-BYT (17/10/2025).\n27 mã, chia 5 nhóm: KCB BHYT (nhóm 1), Cấp cứu (nhóm 2), Trái tuyến (nhóm 3), Lĩnh thuốc (nhóm 7), Khác (nhóm 8-10).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-heart-rate"
      },
      "name" : "Mạch VN Core — VN Core Observation Heart Rate Profile",
      "description" : "Profile Observation mạch/nhịp tim cho Việt Nam, dùng LOINC 8867-4 và đơn vị UCUM /min. Phục vụ ghi nhận sinh hiệu trong bệnh án điện tử, khám chữa bệnh ngoại trú/nội trú và liên thông dữ liệu lâm sàng theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-specimen"
      },
      "name" : "Mẫu bệnh phẩm VN Core — VN Core Specimen Profile",
      "description" : "Profile Specimen cho Việt Nam. Dùng để mô tả chuỗi lấy mẫu, tiếp nhận mẫu, xử lý mẫu và liên kết mẫu bệnh phẩm với chỉ định, kết quả xét nghiệm, và báo cáo cận lâm sàng.\nCăn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 1227/QĐ-BYT (chỉ số cận lâm sàng), Luật KCB 2023.\n/ VN Core Specimen profile for laboratory workflow linking orders, specimen collection, processing, observations, and diagnostic reports.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-consent-purpose-cs"
      },
      "name" : "Mục đích xử lý dữ liệu y tế — VN Consent Purpose CodeSystem",
      "description" : "Danh mục mục đích xử lý dữ liệu cá nhân trong y tế Việt Nam.\nCăn cứ: Luật 91/2025/QH15 — Bảo vệ dữ liệu cá nhân (hiệu lực 01/01/2026),\nNĐ 356/2025/NĐ-CP — Hướng dẫn chi tiết.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-consent-purpose-vs"
      },
      "name" : "Mục đích xử lý dữ liệu y tế — VN Consent Purpose ValueSet",
      "description" : "Tập mã mục đích xử lý dữ liệu cá nhân trong y tế Việt Nam.\nCăn cứ: Luật 91/2025/QH15 — Bảo vệ dữ liệu cá nhân.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionMissingMaLK"
      },
      "name" : "Negative Example: Bundle BHYT thiếu MA_LK",
      "description" : "Ví dụ bundle dùng cho validation âm tính. Bundle thiếu `identifier` MA_LK ở cấp bundle nên phải bị từ chối khi validate theo `VNCoreBHYTSubmissionBundle`.",
      "exampleBoolean" : true,
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Parameters"
      }],
      "reference" : {
        "reference" : "Parameters/ExampleBHYTSubmissionInvalidExportDateTime"
      },
      "name" : "Negative Example: exportDateTime sai định dạng",
      "description" : "Ví dụ parameters dùng cho validation âm tính. `exportDateTime` đang ở format ISO 8601 thay vì `yyyyMMddHHmm`.",
      "exampleBoolean" : true,
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Patient"
      }],
      "reference" : {
        "reference" : "Patient/ExampleBHYTSubmissionMissingCCCDInvalid"
      },
      "name" : "Negative Example: Patient BHYT thiếu CCCD không có lý do",
      "description" : "Ví dụ bệnh nhân dùng cho validation âm tính. Thiếu CCCD và không có force majeure reason.",
      "exampleBoolean" : false,
      "groupingId" : "misc"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-imaging-study"
      },
      "name" : "Nghiên cứu CĐHA VN Core — VN Core Imaging Study Profile",
      "description" : "Profile ImagingStudy cho Việt Nam. Dùng để trao đổi metadata DICOM của nghiên cứu chẩn đoán hình ảnh, liên kết với chỉ định ServiceRequest, bệnh nhân, bác sĩ chỉ định, bác sĩ đọc kết quả và báo cáo cận lâm sàng.\nCăn cứ pháp lý và thuật ngữ:\n- **QĐ 1227/QĐ-BYT (11/4/2025)** — nhóm Điện quang/Chẩn đoán hình ảnh, 1.240 mã CLS trong tổng 2.964 chỉ số cận lâm sàng\n- **QĐ 2427/QĐ-BYT (25/7/2025)** — SNOMED CT VN Body Structure, dùng cho bodySite\n- **QĐ 4469/QĐ-BYT (28/10/2020) + QĐ 98/QĐ-BYT (14/01/2022)** — ICD-10 VN cho reasonCode\n- **TT 13/2025/TT-BYT (06/6/2025)** — bệnh án điện tử và dữ liệu DICOM/kết quả cận lâm sàng\n- **QĐ 3176/QĐ-BYT (29/10/2024)** — XML MA_DICH_VU nhóm CĐHA.\n/\nVN Core ImagingStudy profile for diagnostic imaging metadata in Vietnamese EMR and clinical data exchange workflows.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-occupation"
      },
      "name" : "Nghề nghiệp — Vietnam Occupation Extension",
      "description" : "Mở rộng ghi nhận nghề nghiệp của bệnh nhân theo Danh mục Nghề nghiệp Việt Nam (VSCO 2020).\nCăn cứ: QĐ 34/2020/QĐ-TTg (20/11/2020) — Ban hành Danh mục nghề nghiệp Việt Nam.\n1.516 mã, 5 cấp phân loại, tương thích ISCO-08 (ILO).\nFHIR base Patient không có element nghề nghiệp chuẩn — cần extension.\nNghề nghiệp ảnh hưởng đánh giá nguy cơ sức khỏe nghề nghiệp (TT 28/2016/TT-BYT).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-occupation-vs"
      },
      "name" : "Nghề nghiệp — VN Occupation ValueSet",
      "description" : "Tập giá trị nghề nghiệp theo VSCO 2020 (QĐ 34/2020/QĐ-TTg).\nBao gồm tất cả 1.516 mã nghề nghiệp 5 cấp.\n\nAll occupation codes from VSCO 2020, covering 5 hierarchical levels.\nISCO-08 compatible at Levels 1-4.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-immunization-funding-source-cs"
      },
      "name" : "Nguồn chi trả tiêm chủng — Vietnam Immunization Funding Source CodeSystem",
      "description" : "Danh mục nguồn chi trả cho tiêm chủng tại Việt Nam, dùng cho Immunization.fundingSource. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.\nNguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-immunization-funding-source-vs"
      },
      "name" : "Nguồn chi trả tiêm chủng — Vietnam Immunization Funding Source ValueSet",
      "description" : "Tập giá trị nguồn chi trả cho Immunization.fundingSource trong bối cảnh Việt Nam. Căn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh; QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-payment-source"
      },
      "name" : "Nguồn chi trả — Payment Source Extension",
      "description" : "Nguồn chi trả cho dòng chi phí KCB, đặc biệt dùng cho XML2 thuốc (NGUON_CTRA) theo QĐ 3176/QĐ-BYT.\nBiểu diễn nguồn chi trả ở mức item thay vì gán vào Coverage.type hoặc payment method tổng thể.\nNguồn thiết kế: QĐ 3176/QĐ-BYT và terminology VNPaymentSourceCS/VS.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-payment-source-cs"
      },
      "name" : "Nguồn chi trả — Vietnam Payment Source CodeSystem",
      "description" : "Danh mục nguồn chi trả chi phí KCB (trường NGUON_CTRA).\nCăn cứ: QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nNguồn dữ liệu: OHP Data Processor (production mapping).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-payment-source-vs"
      },
      "name" : "Nguồn chi trả — Vietnam Payment Source ValueSet",
      "description" : "Tập giá trị nguồn chi trả (NGUON_CTRA). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-provenance"
      },
      "name" : "Nguồn gốc dữ liệu và chữ ký số VN Core — VN Core Provenance Profile",
      "description" : "Profile Provenance cho Việt Nam. Dùng để ghi nhận nguồn gốc tài liệu/hồ sơ y tế, tác nhân tạo lập/xác nhận, và chữ ký số.\nCăn cứ:\n- **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử\n- **NĐ 137/2024/NĐ-CP** — 23/10/2024 — giao dịch điện tử và chữ ký số trong hồ sơ điện tử\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản trị, xử lý dữ liệu y tế số\n- **NĐ 278/2025/NĐ-CP** — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — chia sẻ dữ liệu bắt buộc; yêu cầu chuẩn hóa và thống nhất kết nối qua Nền tảng chia sẻ, điều phối dữ liệu chậm nhất 31/12/2026; provenance hỗ trợ truy xuất nguồn khi chia sẻ\n- **Luật 91/2025/QH15** — 26/6/2025 — bảo vệ dữ liệu cá nhân.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-order-date"
      },
      "name" : "Ngày y lệnh — Order Date Extension",
      "description" : "Ngày y lệnh chỉ định dịch vụ/thuốc (NGAY_YL).\nMapping XML 3176: NGAY_YL.\nNguồn thiết kế: OHP Data Processor (procedure-order-date).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-relatedperson"
      },
      "name" : "Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile",
      "description" : "Profile RelatedPerson cho Việt Nam. Dùng cho cha, mẹ, người giám hộ, người đại diện hợp pháp\nhoặc người liên hệ của bệnh nhân. Áp dụng cho ca trẻ em, sơ sinh, consent qua cha/mẹ, và liên thông BHYT/EMR.\nThiết kế theo hướng chuẩn hóa của US Core, JP Core, CH Core: dùng base RelatedPerson thay vì extension tùy biến.\n\nCăn cứ pháp lý:\n- **Luật KCB 2023 (Luật 15/2023/QH15)** — Điều 8, 27, 41 — quyền và đại diện hợp pháp của người bệnh\n- **NĐ 96/2023/NĐ-CP** (30/12/2023) — hướng dẫn Luật KCB\n- **TT 32/2023/TT-BYT** (31/12/2023) — phạm vi hành nghề KCB liên quan đại diện\n- **Bộ luật Dân sự 2015 (Luật 91/2015/QH13)** — Điều 21, 47, 53-58 — người giám hộ, người đại diện theo pháp luật\n- **Luật Trẻ em 2016 (Luật 102/2016/QH13)** — Điều 76 — quyền đại diện cho trẻ em chưa thành niên\n- **Luật 91/2025/QH15** (Bảo vệ DLCN, hiệu lực 01/01/2026) — đại diện ký Consent xử lý DLCN cho người chưa thành niên/mất năng lực hành vi\n- **NĐ 356/2025/NĐ-CP** (31/12/2025) — hướng dẫn BVDLCN, lưu bằng chứng đồng ý qua người đại diện.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-body-temperature"
      },
      "name" : "Nhiệt độ cơ thể VN Core — VN Core Observation Body Temperature Profile",
      "description" : "Profile Observation nhiệt độ cơ thể cho Việt Nam, dùng LOINC 8310-5 và đơn vị UCUM Cel. Phục vụ ghi nhận sinh hiệu, sàng lọc sốt và theo dõi lâm sàng trong bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-practitioner"
      },
      "name" : "Nhân viên y tế VN Core — VN Core Practitioner Profile",
      "description" : "Profile Practitioner cho Việt Nam. Bao gồm identifier slicing (CCCD, GPHN hiện hành, CCHN lịch sử),\nthông tin trình độ chuyên môn (qualification).\nCăn cứ:\n- **Luật KCB 2023** — Điều 19-27 — hành nghề KCB\n- **NĐ 96/2023/NĐ-CP** — 30/12/2023 — hướng dẫn Luật KCB\n- **TT 32/2023/TT-BYT** — 31/12/2023 — hướng dẫn phạm vi hành nghề và chuyên môn KCB\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025, hiệu lực 01/7/2025 — Điều 6 quy định **số định danh cá nhân (CCCD 12 số) là mã định danh y tế của cá nhân, áp dụng cho cả Patient và nhân lực y tế**\n- **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử.\n\n**Pattern identifier**:\n- `identifier[CCCD]` = mã định danh y tế của nhân lực (per NĐ 102/2025 Điều 6) — primary key\n- `identifier[GPHN]` = số Giấy phép hành nghề (NĐ 96/2023 Mẫu 11 Phụ lục I) — professional license\n- `identifier[CCHN]` = số Chứng chỉ hành nghề (legacy trước Luật KCB 2023) — backward compat",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-bhyt-review-issue-cs"
      },
      "name" : "Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue CodeSystem",
      "description" : "Danh mục nhóm issue cục bộ dùng để ghi nhận phản hồi giám định/từ chối/yêu cầu điều chỉnh trong `ClaimResponse.error` và `OperationOutcome.issue.details`.\nDanh mục này được rút gọn từ các nhóm tình huống xuất hiện trong TT 12/2026/TT-BTC, đặc biệt phần biên bản giám định, bảng kê chi phí từ chối thanh toán và yêu cầu điều chỉnh dữ liệu qua Cổng tiếp nhận.\nĐây KHÔNG PHẢI catalog payer/gateway chính thức đầy đủ; chỉ là taxonomy baseline ở mức profile/example để tránh mã hóa tự do khi pilot.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-bhyt-review-issue-vs"
      },
      "name" : "Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue ValueSet",
      "description" : "Tập mã nhóm issue cục bộ dùng cho `ClaimResponse.error` và `OperationOutcome.issue.details` trong pilot BHYT.\nGiữ ở mức baseline taxonomy, không đại diện cho catalog mã lỗi payer/gateway chính thức đầy đủ.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-device-group"
      },
      "name" : "Nhóm TBYT theo danh mục BHYT — VN Device Group",
      "description" : "Nhóm thiết bị y tế theo danh mục BHYT N01-N09.\nCăn cứ: TT 04/2017/TT-BYT (14/4/2017) Phụ lục 01 — 9 nhóm TBYT BHYT; TT 24/2025/TT-BYT (30/6/2025, hiệu lực 01/9/2025) sửa đổi TT 04/2017/TT-BYT và thống nhất thuật ngữ VTYT → TBYT; VBHN 14/VBHN-BYT năm 2025 hợp nhất TT 04/2017/TT-BYT và TT 24/2025/TT-BYT.\nƯu tiên dùng trên Claim.item khi nhóm N01-N09 phục vụ dòng chi phí/thanh toán BHYT. Context Device chỉ giữ để hỗ trợ dữ liệu legacy hoặc trường hợp hệ thống cần gắn nhóm thanh toán vào device instance khi chưa có Claim.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-device-group-cs"
      },
      "name" : "Nhóm thiết bị y tế theo danh mục BHYT — VN Device Group CS",
      "description" : "Danh mục 9 nhóm thiết bị y tế thuộc phạm vi danh mục BHYT theo TT 04/2017/TT-BYT Phụ lục 01.\nTT 24/2025/TT-BYT (30/6/2025, hiệu lực 01/9/2025) sửa đổi TT 04/2017/TT-BYT và thống nhất thuật ngữ từ vật tư y tế (VTYT) sang thiết bị y tế (TBYT).\nVBHN 14/VBHN-BYT năm 2025 là văn bản hợp nhất hiện hành để tra cứu cùng TT 04/2017/TT-BYT và TT 24/2025/TT-BYT.\nNguồn TVPL TT 04/2017/TT-BYT: https://thuvienphapluat.vn/van-ban/Bao-hiem/Thong-tu-04-2017-TT-BYT-Danh-muc-ty-le-dieu-kien-thanh-toan-vat-tu-y-te-nguoi-tham-gia-bao-hiem-y-te-290390.aspx",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-device-group-vs"
      },
      "name" : "Nhóm thiết bị y tế theo danh mục BHYT — VN Device Group VS",
      "description" : "Tập giá trị 9 nhóm thiết bị y tế theo TT 04/2017/TT-BYT Phụ lục 01, được sửa đổi bởi TT 24/2025/TT-BYT và hợp nhất trong VBHN 14/VBHN-BYT năm 2025.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-audit-event"
      },
      "name" : "Nhật ký truy cập dữ liệu VN Core — VN Core AuditEvent Profile",
      "description" : "Profile AuditEvent cho Việt Nam. Dùng để ghi nhận truy cập, chỉnh sửa, chia sẻ, và xuất dữ liệu y tế/định danh nhạy cảm.\nCăn cứ:\n- **Luật 91/2025/QH15** — 26/6/2025 — bảo vệ dữ liệu cá nhân, dữ liệu y tế là dữ liệu nhạy cảm\n- **NĐ 356/2025/NĐ-CP** — 31/12/2025 — hướng dẫn BVDLCN; Điều 42 về thông báo vi phạm dữ liệu trong 72 giờ\n- **Luật 116/2025/QH15** (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật An ninh mạng mới; yêu cầu baseline an ninh mạng và lưu vết/log\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — bảo vệ, quản trị, xử lý dữ liệu y tế số\n- **Luật KCB 2023** — hồ sơ bệnh án và trách nhiệm cơ sở KCB.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-respiratory-rate"
      },
      "name" : "Nhịp thở VN Core — VN Core Observation Respiratory Rate Profile",
      "description" : "Profile Observation nhịp thở cho Việt Nam, dùng LOINC 9279-1 và đơn vị UCUM /min. Phục vụ ghi nhận sinh hiệu trong bệnh án điện tử, cấp cứu, hồi sức và khám chữa bệnh theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-primary-care-facility"
      },
      "name" : "Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension",
      "description" : "Mở rộng ghi nhận cơ sở KCB ban đầu trên thẻ BHYT.\nTương ứng trường MA_DKBD trong QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nTham chiếu đến Organization có mã CSKCB (5 chữ số do BHXH VN cấp).\nCăn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024), Luật BHYT 2008 sửa đổi 2014.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-treatment-method-cs"
      },
      "name" : "Pháp điều trị Y học cổ truyền — VN Traditional Medicine Treatment Method CodeSystem",
      "description" : "Bộ mã pháp điều trị Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục IV. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột `Mã chuyên môn` được bảo toàn dưới concept property.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-treatment-method-vs"
      },
      "name" : "Pháp điều trị YHCT — VN Traditional Medicine Treatment Method ValueSet",
      "description" : "Tập giá trị pháp điều trị y học cổ truyền. 77 pháp trị. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL IV.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-device-risk-class"
      },
      "name" : "Phân loại rủi ro thiết bị y tế — VN Device Risk Class",
      "description" : "Phân loại rủi ro thiết bị y tế A/B/C/D theo NĐ 98/2021/NĐ-CP Điều 4 (đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP) và TT 05/2022/TT-BYT (đã được sửa đổi, bổ sung bởi TT 59/2025/TT-BYT).\nExtension này là tùy chọn trên Device vì risk class là thuộc tính pháp lý ở mức sản phẩm/model/regulatory context; không bắt buộc cho mọi Device instance trong trao đổi lâm sàng hoặc BHYT.\nPhân biệt rõ với các dimension độc lập KHÔNG dùng extension này:\n- Nhóm TBYT BHYT N01-N09 (TT 04/2017/TT-BYT Phụ lục 01) → dùng VNCoreExtDeviceGroup;\n- Danh pháp thiết bị y tế (QĐ 3107/2024, QĐ 847/2025) → dùng Device.type với hệ danh pháp;\n- 6 nhóm phân loại tiêu chuẩn kỹ thuật/chất lượng phục vụ đấu thầu theo TT 57/2025/TT-BYT (31/12/2025, hiệu lực 15/02/2026, triển khai 01/01/2027, căn cứ NĐ 214/2025/NĐ-CP về Luật Đấu thầu) → nếu cần biểu diễn, dùng extension riêng trong package procurement, KHÔNG dùng extension này.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-device-risk-class-cs"
      },
      "name" : "Phân loại rủi ro thiết bị y tế — VN Device Risk Class CS",
      "description" : "Bộ mã phân loại thiết bị y tế theo mức độ rủi ro A/B/C/D.\nCăn cứ:\n- NĐ 98/2021/NĐ-CP (08/11/2021) Điều 4 quy định 4 loại thiết bị y tế dựa trên mức độ rủi ro;\n- NĐ 07/2023/NĐ-CP (03/03/2023) sửa đổi, bổ sung NĐ 98/2021;\n- NĐ 04/2025/NĐ-CP (01/01/2025) sửa đổi, bổ sung NĐ 98/2021 và NĐ 07/2023;\n- TT 05/2022/TT-BYT (01/03/2022) hướng dẫn quy tắc phân loại chi tiết;\n- TT 59/2025/TT-BYT sửa đổi, bổ sung TT 05/2022/TT-BYT về kiểm định thiết bị y tế.\nLưu ý: Đây là thuộc tính pháp lý ở mức sản phẩm/model/regulatory context, không phải nhóm BHYT N01-N09 (TT 04/2017) và không phải danh pháp thiết bị (QĐ 3107/2024, QĐ 847/2025).\nTT 57/2025/TT-BYT (31/12/2025, hiệu lực 15/02/2026, triển khai phân nhóm 01/01/2027) có 6 nhóm phân loại theo tiêu chuẩn kỹ thuật/chất lượng phục vụ đấu thầu (căn cứ NĐ 214/2025/NĐ-CP) — đây là dimension độc lập, KHÔNG nhập nhằng với A/B/C/D của NĐ 98/2021.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-device-risk-class-vs"
      },
      "name" : "Phân loại rủi ro thiết bị y tế — VN Device Risk Class VS",
      "description" : "Tập giá trị phân loại rủi ro thiết bị y tế A/B/C/D theo NĐ 98/2021/NĐ-CP Điều 4 và TT 05/2022/TT-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-traditional-processing-method"
      },
      "name" : "Phương pháp chế biến YHCT — Traditional Medicine Processing Method",
      "description" : "Raw gateway carrier cho XML2 `MA_PP_CHEBIEN` trong dữ liệu BHYT/KCB đối với vị thuốc, dược liệu hoặc thuốc YHCT có thông tin chế biến.\nQĐ 3176/QĐ-BYT vẫn tham chiếu bộ mã qua nền pháp lý cũ; hiện hành, Thông tư 14/2024/TT-BYT là nguồn mô tả phương pháp chế biến các vị thuốc cổ truyền. Do repo chưa ingest được một CodeSystem FHIR-ready có provenance đầy đủ từ nguồn hiện hành, extension này giữ nguyên chuỗi nghiệp vụ/raw legal string thay vì công bố mã chính thức sớm.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-payment-method-cs"
      },
      "name" : "Phương thức thanh toán BHYT — VN Payment Method CodeSystem",
      "description" : "Phương thức thanh toán KCB BHYT.\nMapping XML 3176: MA_PTTT_QT.\nCăn cứ: QĐ 3176/QĐ-BYT (29/10/2024) — Bảng 14: Phương thức thanh toán.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-payment-method-vs"
      },
      "name" : "Phương thức thanh toán BHYT — VN Payment Method ValueSet",
      "description" : "Phương thức thanh toán KCB BHYT: FFS, Capitation, DRG.\nMapping XML 3176: MA_PTTT_QT.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-payment-method"
      },
      "name" : "Phương thức thanh toán — Payment Method Extension",
      "description" : "Phương thức thanh toán KCB BHYT: phí dịch vụ (FFS), định suất (Capitation), hoặc theo trường hợp bệnh (DRG).\nMapping XML 3176: MA_PTTT_QT.\nNguồn thiết kế: OHP Data Processor (encounter-payment-method).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-consent-method-cs"
      },
      "name" : "Phương thức thể hiện sự đồng ý — VN Consent Method CodeSystem",
      "description" : "5 phương thức thể hiện sự đồng ý của chủ thể dữ liệu cá nhân theo NĐ 356/2025/NĐ-CP Điều 6 khoản 1 (verified text gốc).\nMỗi phương thức phải bảo đảm khả năng kiểm chứng được về việc xác định chủ thể dữ liệu cá nhân đã thực hiện sự đồng ý, thời điểm và nội dung được đồng ý.\nBộ mã exhaustive — 5 codes a/b/c/d/đ ánh xạ trực tiếp 5 điểm trong NĐ 356/2025 Điều 6 khoản 1.\nCode `other-verifiable` (điểm đ) là catch-all cho phương thức khác phù hợp có thể in/sao chép, bao gồm dạng điện tử/định dạng kiểm chứng được.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-consent-method"
      },
      "name" : "Phương thức thể hiện đồng ý — VN Consent Method",
      "description" : "Phương thức (cách thức) chủ thể dữ liệu cá nhân thể hiện sự đồng ý xử lý DLCN.\nCăn cứ: NĐ 356/2025/NĐ-CP Điều 6 khoản 1 — quy định 5 phương thức exhaustive (a/b/c/d/đ).\nMỗi phương thức phải bảo đảm khả năng kiểm chứng (verifiable) về xác định chủ thể, thời điểm, và nội dung đồng ý.\nĐặt extension này trên Consent.provision (mức quy tắc đồng ý chi tiết) — giúp audit + chứng minh tuân thủ NĐ 356.\nRequired binding — không cho phép code ngoài VS vì NĐ 356 đã liệt kê đầy đủ với điểm đ là catch-all `other-verifiable`.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-consent-method-vs"
      },
      "name" : "Phương thức thể hiện đồng ý — VN Consent Method VS",
      "description" : "Tập giá trị phương thức thể hiện sự đồng ý của chủ thể dữ liệu cá nhân theo NĐ 356/2025/NĐ-CP Điều 6.\nDùng required cho VNCoreExtConsentMethod trên Consent.provision.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-device-insurance-scope"
      },
      "name" : "Phạm vi BHYT cho VTYT — Device Insurance Scope Extension",
      "description" : "Phạm vi hưởng BHYT cho vật tư y tế (PHAM_VI cho VTYT).\nMapping XML 3176: PHAM_VI trong XML3.\nNguồn thiết kế: OHP Data Processor (pham-vi-bhyt-vtyt).\nExtension này không còn dùng trực tiếp trên Device hoặc DeviceUseStatement trong dữ liệu mới vì PHAM_VI là thuộc tính theo dòng chi phí/lượt thanh toán, không phải thuộc tính cố định của device instance hoặc ghi nhận sử dụng lâm sàng. Ưu tiên dùng Claim.item.extension[insuranceCostInfo].extension[scope].",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-insurance-scope-cs"
      },
      "name" : "Phạm vi hưởng BHYT — Vietnam Insurance Scope CodeSystem",
      "description" : "Danh mục phạm vi hưởng bảo hiểm y tế (trường PHAM_VI).\nXác định thuốc/DVKT/VTYT nằm trong hay ngoài danh mục do quỹ BHYT chi trả.\nCăn cứ: QĐ 130/QĐ-BYT (18/01/2023), sửa đổi bởi QĐ 4750/QĐ-BYT (29/12/2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nTham chiếu:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT\n- **NĐ 74/2025/NĐ-CP** — 31/3/2025 — sửa đổi quy định thanh toán TBYT/đối tượng đặc biệt\n- NĐ 70/2015/NĐ-CP — nền tảng lịch sử cho đối tượng quân đội, công an, cơ yếu.\nNguồn dữ liệu: OHP Data Processor (production mapping).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-insurance-scope-vs"
      },
      "name" : "Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet",
      "description" : "Tập giá trị phạm vi hưởng BHYT (PHAM_VI). Căn cứ: QĐ 3176/QĐ-BYT (29/10/2024).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-payment-reconciliation"
      },
      "name" : "Quyết toán BHYT VN Core — VN Core Payment Reconciliation Profile",
      "description" : "Profile PaymentReconciliation cho biên bản quyết toán/thanh toán chi phí KCB BHYT\ngiữa cơ sở KCB và cơ quan BHXH (biểu mẫu 06/BH).\nMỗi PaymentReconciliation tổng hợp kết quả giám định cho một chu kỳ quyết toán\n(thông thường theo tháng/quý) và liệt kê các Claim được duyệt/từ chối/tranh chấp.\nCăn cứ:\n- TT 12/2026/TT-BTC — Bộ Tài chính, hướng dẫn giám định, thanh toán, quyết toán chi phí\n  KCB BHYT điện tử; Điều 6 và Phụ lục biểu mẫu 06/BH.\n- NĐ 188/2025/NĐ-CP (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành\n  Luật BHYT.\n- NĐ 164/2025/NĐ-CP (29/06/2025) — Giao dịch điện tử trong lĩnh vực BHXH.\n- Luật 51/2024/QH15 — Luật BHYT sửa đổi.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-country-vs"
      },
      "name" : "Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship",
      "description" : "Tập giá trị quốc tịch dùng cho extension chuẩn `patient-citizenship`. Sử dụng hệ mã ISO 3166-1 alpha-2 (`urn:iso:std:iso:3166`) để thay thế binding mặc định tới `http://hl7.org/fhir/ValueSet/country`, giúp validator và implementer trong VN Core có một canonical ổn định hơn.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-vital-signs"
      },
      "name" : "Sinh hiệu VN Core — VN Core Observation Vital Signs Profile",
      "description" : "Profile Observation Vital Signs cho Việt Nam, kế thừa từ FHIR core vitalsigns profile.\nHỗ trợ: huyết áp, mạch, nhiệt độ, nhịp thở, SpO2, cân nặng, chiều cao.\nCăn cứ: TT 13/2025/TT-BYT (06/06/2025) về hồ sơ bệnh án điện tử — phần sinh hiệu; QĐ 1227/QĐ-BYT (11/04/2025) ban hành danh mục mã dùng chung đối với kỹ thuật, thuật ngữ chỉ số cận lâm sàng, làm cơ sở chuẩn hóa mã CLS và ánh xạ LOINC.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-snomed-subset-cs"
      },
      "name" : "SNOMED CT Việt Nam Subset — Vietnam SNOMED CT National Subset",
      "description" : "Bộ mã SNOMED CT phiên bản Việt Nam — subset chính thức do Bộ Y tế ban hành.\n77.393 concepts với bản dịch tiếng Việt, song ngữ Việt-Anh, chia thành 3 đợt:\n\n- Đợt 1 (QĐ 2427/QĐ-BYT, 25/7/2025): Body Structures — 35.889 concepts\n  Cấu trúc giải phẫu cơ thể người\n- Đợt 2 (QĐ 2493/QĐ-BYT, ~08/2025): Morphologic Abnormality — 5.155 concepts\n  Bất thường hình thái (mô bệnh học, khối u...)\n- Đợt 3 (QĐ 2805/QĐ-BYT, 04/9/2025): Clinical Finding + Allergy — 36.349 concepts\n  Phát hiện lâm sàng (35.022) + Dị ứng (1.327)\n\nCăn cứ nền tảng: QĐ 1928/QĐ-BYT (2023) — Kiến trúc Chính phủ điện tử Y tế v2.1,\nxác lập SNOMED CT là bộ mã thuật ngữ y tế chuẩn quốc gia.\n\nVietnam national SNOMED CT subset, published by Ministry of Health in 3 batches.\nContains 77,393 concepts with Vietnamese translations, bilingual VI-EN.\nEach concept has: vn_code (national code), snomed_ct_id (international), name_vn, name_en.\nFor international interoperability: system = http://snomed.info/sct, code = snomed_ct_id.\n\n**Dữ liệu hiện có trong lớp chuẩn hóa:**\n`vn_code` (mã quốc gia do BYT công bố), `snomed_ct_id` (mã SNOMED CT quốc tế dùng cho coding/interoperability), `name_vn`, `name_en` (tên song ngữ), và `category` (nhóm thuật ngữ gốc trong dữ liệu tích hợp).\n\n**Các nhóm dữ liệu trong artifact:** `body structure` cho vị trí giải phẫu; `morphologic abnormality` cho bất thường hình thái/mô bệnh học; `clinical finding` cho phát hiện/chẩn đoán lâm sàng; `allergy` cho các khái niệm dị ứng và chất liên quan.\n\n**Cách dùng trong VN Core:** Dùng `snomed_ct_id` làm `code` khi gửi FHIR resource quốc tế hóa. Dùng cùng các companion ValueSet như `vn-body-site-vs`, `vn-condition-code-vs`, `vn-allergy-code-vs` tùy ca sử dụng. Khi cần rà soát sai lệch bản dịch, xem [trang đính chính SNOMED CT VN](snomed-vn-errata.html).\n\n**Cách lấy artifact:** Validator/FHIR server dùng file FHIR JSON đầy đủ `CodeSystem-vn-snomed-subset-cs.full.json` trên release download surface khi cần preload toàn bộ mã. Bộ tải xuống phát hành: xem [trang tải xuống](downloads.html#snomed-fhir-json) để lấy liên kết trực tiếp và gói `hl7.fhir.vn.terminology.clinical-0.3.0.tgz`. Public IG page này là metadata wrapper; dữ liệu chi tiết được tiêu thụ qua package/download surface và bộ nguồn chuẩn hóa nội bộ. Các serialization XML/TTL trên public IG chỉ phản ánh metadata wrapper hiện hành; riêng route canonical `.json` được trỏ sang full JSON download.\n\nImplementation note: this IG publishes the VN SNOMED subset on the public HTML surface as metadata only (`content = not-present`).\nThe 77,393 concepts are distributed as a separate full FHIR JSON artifact on the release download surface, and the canonical `.json` route is redirected there for machine access.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-spo2"
      },
      "name" : "SpO2 VN Core — VN Core Observation SpO2 Profile",
      "description" : "Profile Observation bão hòa oxy ngoại vi/SpO2 cho Việt Nam, dùng LOINC 2708-6 và đơn vị UCUM %. Phục vụ ghi nhận sinh hiệu trong cấp cứu, hồi sức, hô hấp và bệnh án điện tử theo TT 13/2025/TT-BYT (06/06/2025). QĐ 1227/QĐ-BYT (11/04/2025) là căn cứ chuẩn hóa thuật ngữ chỉ số cận lâm sàng và ánh xạ LOINC khi triển khai trong nước.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-imaging-accession-number-ns"
      },
      "name" : "Số accession CĐHA — Vietnam Imaging Accession Number",
      "description" : "Hệ thống định danh số accession cho nghiên cứu chẩn đoán hình ảnh trong RIS/PACS/HIS tại Việt Nam. Giá trị cụ thể do từng cơ sở hoặc hệ thống phát sinh và quản lý.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-cchn-ns"
      },
      "name" : "Số Chứng chỉ hành nghề (CCHN) lịch sử — Vietnam Legacy Practice Certificate Number",
      "description" : "Hệ thống định danh Số Chứng chỉ hành nghề y được cấp theo khung pháp lý trước Luật KCB 2023.\nGiữ lại để chuyển đổi dữ liệu lịch sử và đối soát hồ sơ cũ. Format không cố định, tùy từng đợt cấp phép trước đây.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-cmnd-ns"
      },
      "name" : "Số Chứng minh nhân dân (CMND) — Vietnam Legacy ID Card Number",
      "description" : "Hệ thống định danh Số Chứng minh nhân dân (9 hoặc 12 chữ số), do Bộ Công an cấp.\nĐã thay thế bởi CCCD (Căn cước công dân) per Luật Căn cước 2023.\nCMND vẫn hợp lệ cho mục đích backward-compatibility đến 2030.\nLưu ý: CMND 9 số (cũ) và CMND 12 số (2012-2023) đều tồn tại trong hệ thống y tế.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-cccd-ns"
      },
      "name" : "Số Căn cước công dân (CCCD) — Vietnam Citizen Identity Card Number",
      "description" : "Hệ thống định danh Số Căn cước công dân (12 chữ số), do Bộ Công an cấp.\nLà số định danh cá nhân duy nhất theo Luật Căn cước 2023 (26/2023/QH15).\nTừ 01/7/2025, thay thế mã số thuế cá nhân.\nBắt buộc cho bệnh án điện tử theo TT 13/2025/TT-BYT.\nLiên kết với dữ liệu người bệnh trong CSDL quốc gia về y tế theo NĐ 102/2025/NĐ-CP (13/5/2025).",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-gks-ns"
      },
      "name" : "Số Giấy khai sinh — Vietnam Birth Certificate Number",
      "description" : "Hệ thống định danh Số Giấy khai sinh do UBND xã/phường/đặc khu cấp.\nDùng cho trẻ em hoặc trường hợp chưa có số định danh cá nhân/CCCD nhưng cần liên thông hồ sơ BHYT và EMR.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-gphn-ns"
      },
      "name" : "Số Giấy phép hành nghề (GPHN) — Vietnam Medical Practice License Number",
      "description" : "Hệ thống định danh Số Giấy phép hành nghề khám bệnh, chữa bệnh theo Luật KCB 2023 và NĐ 96/2023/NĐ-CP.\nĐây là định danh hành nghề current của Practitioner trong dữ liệu mới.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-payment-reconciliation-form"
      },
      "name" : "Số hiệu biên bản 06/BH — Payment Reconciliation Form Number",
      "description" : "Số hiệu biên bản quyết toán/thanh toán chi phí KCB BHYT (biểu mẫu 06/BH)\ngiữa cơ sở KCB và cơ quan BHXH.\nCăn cứ:\n- TT 12/2026/TT-BTC — Bộ Tài chính, Điều 6 và Phụ lục biểu mẫu 06/BH (Biên bản quyết toán\n  chi phí KCB BHYT).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-passport-ns"
      },
      "name" : "Số Hộ chiếu — Passport Number",
      "description" : "Hệ thống định danh Số Hộ chiếu Việt Nam, do Bộ Công an (trong nước)\nhoặc Bộ Ngoại giao (ngoài nước) cấp. Dùng cho bệnh nhân nước ngoài\nhoặc công dân Việt Nam chưa có CCCD (Việt kiều, trẻ em).\nHộ chiếu VN mới (từ 2022): mã quốc gia + 8 chữ số.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-medical-device-registration-number-ns"
      },
      "name" : "Số lưu hành thiết bị y tế — Vietnam Medical Device Registration Number",
      "description" : "Hệ thống định danh số lưu hành (registration number) của thiết bị y tế tại Việt Nam.\nSố lưu hành do Bộ Y tế (Cục Hạ tầng và Thiết bị y tế) cấp cho thiết bị y tế thuộc loại B, C, D theo quy trình đăng ký lưu hành quy định tại NĐ 98/2021/NĐ-CP (08/11/2021), đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP (03/03/2023) và NĐ 04/2025/NĐ-CP (hiệu lực 01/01/2025).\nĐây là định danh ở mức sản phẩm/model/regulatory context (không phải định danh per-instance như UDI hoặc serial number); một số lưu hành áp dụng cho mọi thiết bị cùng model đã được đăng ký lưu hành.\nLưu ý: Thiết bị y tế loại A theo NĐ 98/2021 thực hiện công bố tiêu chuẩn áp dụng (không cấp số lưu hành) — định danh khác.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-device-registration-number"
      },
      "name" : "Số lưu hành thiết bị y tế — VN Device Registration Number",
      "description" : "Số lưu hành (registration number) của thiết bị y tế tại Việt Nam.\n\n**Căn cứ pháp lý**: NĐ 98/2021/NĐ-CP Điều 21 (Phân nhóm số lưu hành), Chương III (Điều 17-33) về đăng ký lưu hành TBYT, đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP (03/03/2023) và NĐ 04/2025/NĐ-CP (hiệu lực 01/01/2025).\n\n**Phân nhóm theo NĐ 98/2021 Điều 21**:\n\n1. **Loại A & B — Số công bố tiêu chuẩn áp dụng** (Sở Y tế tỉnh/TP tiếp nhận):\n   - Format: `[STT tiếp nhận]/[Năm tiếp nhận 2 số]/[Mã ký hiệu Sở Y tế]-PCBA` (loại A)\n   - Format: `[STT tiếp nhận]/[Năm tiếp nhận 2 số]/[Mã ký hiệu Sở Y tế]-PCBB` (loại B)\n   - PCBA/PCBB = Phiếu công bố loại A / loại B\n   - Ví dụ: `2300001/23/HN-PCBA` (Hồ sơ số 1 năm 2023, Sở Y tế Hà Nội tiếp nhận)\n\n2. **Loại C & D — Số Giấy chứng nhận đăng ký lưu hành** (Bộ Y tế cấp):\n   - Format chuẩn: `[STT cấp]/[Năm cấp 2 số]/BYT-ĐKLH`\n   - Format rút gọn: `[STT cấp]/BYT-ĐKLH`\n   - ĐKLH = Đăng ký lưu hành\n   - Ví dụ: `2300055/BYT-ĐKLH` hoặc `2300055/23/BYT-ĐKLH`\n\n**Phạm vi**:\n- Bắt buộc cho loại B/C/D trước khi đưa ra thị trường\n- Loại A chỉ công bố tiêu chuẩn áp dụng (vẫn dùng PCBA format)\n- Đây là định danh ở mức sản phẩm/model/regulatory context, KHÔNG phải định danh per-instance\n\n**Lưu ý phân biệt**: Extension này độc lập với:\n- UDI (định danh per-instance theo HL7 best practice)\n- MA_VAT_TU (mã nghiệp vụ BHYT theo QĐ 3176)\n- Serial number (per-instance physical)\n- Mã tài sản BV (internal facility code)",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-bhyt-ns"
      },
      "name" : "Số thẻ Bảo hiểm Y tế (BHYT) — Vietnam Health Insurance Card Number",
      "description" : "Hệ thống định danh Số thẻ Bảo hiểm Y tế, do BHXH Việt Nam cấp.\nHỗ trợ 3 format (hiện duy trì song song):\n- CCCD 12 chữ số: hỗ trợ từ 15/8/2025 (NĐ 188/2025/NĐ-CP, hiệu lực 15/8/2025)\n- Mã số BHXH 10 chữ số: từ 01/4/2021\n- Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021\nBên triển khai cần xác minh chính sách BHXH hiện hành trước khi coi CCCD là mã BHYT duy nhất.\nCăn cứ:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT, hỗ trợ định danh BHYT theo CCCD\n- **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH\n- Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-med-reg-number"
      },
      "name" : "Số đăng ký thuốc (Visa) — Medication Registration Number",
      "description" : "Số đăng ký lưu hành thuốc (Visa) do Cục Quản lý Dược — Bộ Y tế cấp.\nTrường SO_DANG_KY per QĐ 3176/QĐ-BYT (29/10/2024).\nBắt buộc khi gửi dữ liệu chi phí thuốc cho BHXH.\nCăn cứ bổ sung:\n- **Luật 44/2024/QH15** — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025\n- Luật Dược 2016 — đăng ký lưu hành thuốc\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — dữ liệu thuốc trong CSDL quốc gia về y tế.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-implantable-device"
      },
      "name" : "Thiết bị cấy ghép VN Core — VN Core Implantable Device Profile",
      "description" : "Profile Device chuyên cho thiết bị cấy ghép gắn với người bệnh tại Việt Nam.\nKế thừa VNCoreDevice nhưng siết các điểm tối thiểu theo thông lệ US Core Implantable Device: patient-bound, type bắt buộc, status bắt buộc, UDI/lifecycle/safety là Must Support.\nUDI carrier là best practice quốc tế của HL7/FHIR và TCVN về UDI; pháp luật Việt Nam hiện chưa được model như yêu cầu UDI bắt buộc cho mọi thiết bị, nên profile chỉ cảnh báo khi UDI carrier thiếu nội dung HRF/AIDC.\nQĐ 847/QĐ-BYT (2025) và QĐ 3107/QĐ-BYT (2024) là nguồn terminology/provenance ứng viên cho danh pháp thiết bị (package hl7.fhir.vn.device), không phải required binding trong profile này.\nCăn cứ pháp lý cập nhật: NĐ 98/2021/NĐ-CP đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP; TT 05/2022/TT-BYT đã được sửa đổi, bổ sung bởi TT 59/2025/TT-BYT.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-device-ivd"
      },
      "name" : "Thiết bị y tế chẩn đoán in vitro (IVD) — Device IVD Flag Extension",
      "description" : "Cờ boolean phân biệt TBYT chẩn đoán in vitro (IVD — In Vitro Diagnostic) với TBYT thông thường, theo VBHN 08/2026/VBHN-BYT (hợp nhất NĐ 98/2021 + NĐ 07/2023 + NĐ 04/2025).\nTBYT IVD có quy định riêng về phân loại rủi ro, đăng ký lưu hành, kiểm định và quản lý chất lượng so với TBYT thông thường.\nĐây là cờ regulatory ở mức sản phẩm/model, không bắt buộc cho mọi Device instance trong trao đổi lâm sàng/BHYT.\nKhi có giá trị true: Device là sinh phẩm/thuốc thử/máy phân tích chẩn đoán in vitro (vd: máy xét nghiệm sinh hóa, test nhanh COVID-19, sinh phẩm xét nghiệm).\nKhi false hoặc không có: Device là TBYT thông thường (non-IVD).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-device"
      },
      "name" : "Thiết bị y tế VN Core — VN Core Device Profile",
      "description" : "Profile Device cho thiết bị y tế (TBYT), bao gồm vật tư tiêu hao, thiết bị dùng trong chăm sóc và thiết bị cấy ghép tại Việt Nam.\nGiữ định danh thiết bị/vật tư (MA_VAT_TU khi legacy cần trao đổi như identifier), UDI, thông tin nhận dạng và vòng đời thiết bị.\nThông tin thanh toán BHYT theo từng dòng chi phí như nhóm TBYT, phạm vi, tỷ lệ thanh toán và mức hưởng phải ưu tiên đặt tại Claim.item; Device chỉ giữ dữ liệu thiết bị hoặc fallback legacy khi chưa có Claim.\nLiên kết với Claim.item (chi phí TBYT) và DeviceUseStatement (ghi nhận sử dụng lâm sàng).\nCăn cứ pháp lý Việt Nam:\n- VBHN 08/2026/VBHN-BYT (01/2026) — Văn bản hợp nhất chính thức NĐ 98/2021/NĐ-CP (08/11/2021) + NĐ 07/2023/NĐ-CP (03/03/2023) + NĐ 04/2025/NĐ-CP (hiệu lực 01/01/2025) về quản lý thiết bị y tế (bao gồm phân biệt TBYT thông thường và TBYT IVD chẩn đoán in vitro)\n- VBHN 04/2026/VBHN-BYT (01/2026) — Văn bản hợp nhất TT 05/2022/TT-BYT (01/03/2022) + TT 59/2025/TT-BYT về phân loại TBYT và kiểm định\n- TT 04/2017/TT-BYT (14/4/2017) Phụ lục 01 — 9 nhóm TBYT BHYT\n- TT 24/2025/TT-BYT (30/6/2025, hiệu lực 01/9/2025) — sửa đổi TT 04/2017/TT-BYT, thống nhất thuật ngữ VTYT → TBYT\n- VBHN 14/VBHN-BYT năm 2025 hợp nhất TT 04/2017/TT-BYT + TT 24/2025/TT-BYT: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Van-ban-hop-nhat-14-VBHN-BYT-2025-Thong-tu-dieu-kien-thanh-toan-doi-voi-vat-tu-y-te-thuoc-bao-hiem-y-te-670262.aspx\n- QĐ 3176/QĐ-BYT — trường MA_VAT_TU trong XML dữ liệu đầu ra KCB\n- QĐ 5086/QĐ-BYT, QĐ 637/QĐ-BYT (2022), QĐ 1844/QĐ-BYT (2022), QĐ 3181/QĐ-BYT (2022) — mã hãng sản xuất VTYT/TBYT, không phải danh mục mã hàng đầy đủ\n- QĐ 3107/QĐ-BYT (2024) và QĐ 847/QĐ-BYT (2025) — danh pháp TBYT, package hl7.fhir.vn.device tách riêng, dùng tham chiếu tùy chọn khi cần chuẩn hóa tên gọi.\nGhi chú:\n- UDI carrier là best practice quốc tế của HL7/FHIR, không được trình bày như căn cứ bắt buộc trong pháp luật Việt Nam.\n- Phân loại rủi ro A/B/C/D theo VBHN 08/2026/VBHN-BYT (hợp nhất NĐ 98/2021 + NĐ 07/2023 + NĐ 04/2025) được hỗ trợ bằng extension tùy chọn, không bắt buộc cho mọi Device.\n- Cờ IVD (vn-ext-device-ivd) phân biệt TBYT chẩn đoán in vitro với TBYT thông thường theo VBHN 08/2026/VBHN-BYT, là dimension regulatory tùy chọn ở mức sản phẩm/model.\n- TT 57/2025/TT-BYT (31/12/2025, hiệu lực 15/02/2026, triển khai 01/01/2027) phân nhóm TBYT theo tiêu chuẩn kỹ thuật/chất lượng phục vụ đấu thầu (căn cứ NĐ 214/2025/NĐ-CP về Luật Đấu thầu) là dimension procurement độc lập, không thuộc VN Core; nếu cần, dùng package hl7.fhir.vn.procurement riêng.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "OperationDefinition"
      }],
      "reference" : {
        "reference" : "OperationDefinition/vn-reverse-bhyt-claim"
      },
      "name" : "Thu hồi hồ sơ BHYT — VN Reverse BHYT Claim Operation",
      "description" : "OperationDefinition cho phép thu hồi hoặc hủy hồ sơ BHYT đã gửi.",
      "exampleBoolean" : false,
      "groupingId" : "operations"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-medication"
      },
      "name" : "Thuốc VN Core — VN Core Medication Profile",
      "description" : "Profile Medication cho Việt Nam. Thông tin chi tiết thuốc: mã, tên, dạng bào chế, hàm lượng, số đăng ký.\nLiên kết với MedicationRequest (đơn thuốc) và Claim (thanh toán BHYT).\nCăn cứ:\n- **Luật 44/2024/QH15** — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025\n- Luật Dược 2016 — nền tảng quản lý thuốc\n- **TT 37/2024/TT-BYT** — 16/11/2024 — danh mục thuốc hóa dược/sinh phẩm thuộc phạm vi BHYT\n- **TT 27/2025/TT-BYT** — 01/7/2025 — thuốc dược liệu, thuốc cổ truyền thuộc phạm vi BHYT\n- Dược điển VN — chuẩn chất lượng thuốc\n- **QĐ 3176/QĐ-BYT** — 29/10/2024 — trường MA_THUOC, TEN_THUOC trong dữ liệu BHXH\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — dữ liệu thuốc trong CSDL quốc gia về y tế.\nNguồn thiết kế: OHP Data Processor (Medication mapper).",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-composition-breach-notification"
      },
      "name" : "Thông báo vi phạm DLCN (Mẫu 08) — VN Core Breach Notification Composition Profile",
      "description" : "Profile Composition cho thông báo vi phạm quy định bảo vệ dữ liệu cá nhân theo Mẫu số 08 NĐ 356/2025/NĐ-CP.\nCấu trúc 4 sections phản ánh trực tiếp Mẫu 08:\n1. Thông tin tổ chức/doanh nghiệp (organization-info) — bao gồm DPO contact\n2. Mô tả hành vi vi phạm (breach-description) — thời gian, địa điểm, hành vi, loại + số lượng DLCN, hậu quả, biện pháp\n3. Tài liệu kèm theo (attachments) — DocumentReference list\n4. Cam kết (commitment) — chữ ký số per NĐ 137/2024\n\nCăn cứ pháp lý:\n- **NĐ 356/2025/NĐ-CP** Điều 28 — Nội dung thông báo vi phạm (4 nhóm: tính chất vi phạm, liên lạc DPO, hậu quả, biện pháp)\n- **NĐ 356/2025/NĐ-CP** Điều 29 — Đặc thù dữ liệu vị trí + sinh trắc học: thông báo chủ thể trong 72 giờ, lưu hồ sơ tối thiểu 5 năm\n- **NĐ 356/2025/NĐ-CP** Phụ lục Mẫu 08 — Schema biểu mẫu thông báo\n- **Luật 91/2025/QH15** — Luật Bảo vệ dữ liệu cá nhân (nền tảng)\n- **Luật 116/2025/QH15** — Luật An ninh mạng sửa đổi (lưu vết, log) — future-effective 01/07/2026\n\nQuy trình submit:\n1. Tạo Composition này như structured form\n2. Wrap trong Bundle type=document\n3. Gửi đến Cơ quan chuyên trách BVDLCN (Bộ Công an) hoặc Cổng thông tin quốc gia về BVDLCN\n4. Optional: dùng MessageHeader nếu cần messaging pattern\n\nLý do chọn Composition (không phải Communication):\n- Mẫu 08 là biểu mẫu document có cấu trúc 4 phần rõ ràng → Composition.section pattern\n- Composition phù hợp với 'persistent legal record' — Communication chỉ cho healthcare interaction\n- DPO ký tên + đóng dấu ở phần 4 → Composition.attester pattern fit",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-insurance-cost-info"
      },
      "name" : "Thông tin chi phí BHYT — Insurance Cost Info Extension",
      "description" : "Extension tái sử dụng cho thông tin chi phí BHYT trên từng item (thuốc/DVKT/VTYT).\nBao gồm: phạm vi BHYT (PHAM_VI), tỷ lệ thanh toán (TYLE_TT), mức hưởng (MUC_HUONG).\nDùng trên: MedicationRequest, Procedure, Claim.item, ServiceRequest và MedicationDispense khi các resource đó đang đóng vai trò nguồn dữ liệu cho dòng chi phí. Với thiết bị/vật tư, ưu tiên đặt trên Claim.item; không dùng trên DeviceUseStatement vì DeviceUseStatement là ghi nhận sử dụng lâm sàng.\nMapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG.\nNguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-tender-info"
      },
      "name" : "Thông tin thầu — Tender Information Extension",
      "description" : "Thông tin thầu của dòng thuốc/vật tư/thiết bị trong dữ liệu KCB/BHYT, đặc biệt dùng cho XML2/XML3 trường TT_THAU theo QĐ 130/QĐ-BYT và QĐ 3176/QĐ-BYT.\nĐây là chuỗi nghiệp vụ phục vụ thanh toán/gateway, không phải procurement package đầy đủ và không thay thế hồ sơ đấu thầu riêng.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-coverage"
      },
      "name" : "Thẻ BHYT VN Core — VN Core Coverage Profile",
      "description" : "Profile Coverage đại diện thẻ bảo hiểm y tế Việt Nam. Bao gồm extensions\nloại đối tượng BHYT và nơi ĐKKCB ban đầu, hỗ trợ cả 3 format số thẻ.\nCăn cứ:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT, quyền lợi và định danh thẻ BHYT\n- **NĐ 164/2025/NĐ-CP** — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH\n- **QĐ 130/QĐ-BYT** — 18/01/2023; **QĐ 4750/QĐ-BYT** — 29/12/2023; **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH\n- Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-audit-retention"
      },
      "name" : "Thời hạn lưu trữ log audit — VN Audit Retention Period",
      "description" : "Thời hạn lưu trữ bắt buộc của log audit liên quan đến vi phạm DLCN.\nCăn cứ: NĐ 356/2025/NĐ-CP Điều 29 khoản 1 điểm c — 'Tổ chức phải lưu hồ sơ vi phạm trong thời gian tối thiểu 5 năm kể từ ngày khắc phục xong sự cố' (đối với dữ liệu vị trí + sinh trắc học).\nĐặt extension này trên AuditEvent để ghi nhận điểm bắt đầu retention period (typically từ ngày khắc phục xong sự cố vi phạm) và end date dự kiến.\nKhuyến nghị mặc định 5 năm cho mọi loại DLCN nhạy cảm; có thể dài hơn nếu doanh nghiệp/quy chế nội bộ yêu cầu.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-procedure"
      },
      "name" : "Thủ thuật/DVKT VN Core — VN Core Procedure Profile",
      "description" : "Profile Procedure cho thủ thuật và dịch vụ kỹ thuật y tế tại Việt Nam.\nHỗ trợ mã hóa bằng SNOMED CT IPS Terminology (miễn phí) và danh mục DVKT VN.\nCăn cứ: TT 20/2014/TT-BYT, TT 39/2018/TT-BYT (danh mục DVKT),\nQĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 3176/QĐ-BYT (2024) — trường MA_DVKT/MA_PTTT trong chuẩn dữ liệu BHXH,\nQĐ 387/QĐ-BYT (05/02/2026) — ICD-9-CM mới nhất, QĐ 4466/QĐ-BYT (2020) — ánh xạ DVKT ↔ ICD-9-CM.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-immunization"
      },
      "name" : "Tiêm chủng — VN Core Immunization",
      "description" : "Profile Immunization cho Việt Nam. Hỗ trợ mã loại vaccine theo danh mục VN, CVX cho interoperability quốc tế, loại chương trình tiêm chủng (TCMR/dịch vụ/chiến dịch), nguồn chi trả, lô vaccine và thông tin người/cơ sở thực hiện.\nCăn cứ: Luật 114/2025/QH15 (ban hành 10/12/2025, hiệu lực 01/07/2026 — future-effective) — Luật Phòng bệnh (thay thế Luật Phòng, chống bệnh truyền nhiễm 03/2007/QH12 từ 01/07/2026), QĐ 2780/QĐ-BYT ngày 29/08/2025 — Kế hoạch Tiêm chủng mở rộng giai đoạn 2026-2028, TT 13/2025/TT-BYT ngày 06/06/2025 về hồ sơ bệnh án điện tử.\nNguồn TVPL Luật 114/2025/QH15: https://thuvienphapluat.vn/van-ban/The-thao-Y-te/Luat-Phong-benh-658530.aspx",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-tongue-cs"
      },
      "name" : "Triệu chứng lưỡi Y học cổ truyền — VN Traditional Medicine Tongue Diagnosis CodeSystem",
      "description" : "Bộ mã triệu chứng lưỡi theo Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục II. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột `Mã chuyên môn` được bảo toàn dưới concept property.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-tongue-vs"
      },
      "name" : "Triệu chứng lưỡi YHCT — VN Traditional Medicine Tongue Diagnosis ValueSet",
      "description" : "Tập giá trị triệu chứng lưỡi theo y học cổ truyền. 39 triệu chứng. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL II.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-pulse-cs"
      },
      "name" : "Triệu chứng mạch Y học cổ truyền — VN Traditional Medicine Pulse Diagnosis CodeSystem",
      "description" : "Bộ mã triệu chứng mạch theo Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục III. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột `Mã chuyên môn` được bảo toàn dưới concept property.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-pulse-vs"
      },
      "name" : "Triệu chứng mạch YHCT — VN Traditional Medicine Pulse Diagnosis ValueSet",
      "description" : "Tập giá trị triệu chứng mạch theo y học cổ truyền. 18 loại mạch. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL III.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-yhct-symptom-cs"
      },
      "name" : "Triệu chứng Y học cổ truyền — VN Traditional Medicine Symptom CodeSystem",
      "description" : "Bộ mã triệu chứng theo thể lâm sàng Y học cổ truyền Việt Nam theo QĐ 3080/QĐ-BYT Phụ lục I. FHIR concept `code` sử dụng cột `Mã dùng chung`; cột `Mã hóa triệu chứng` và tên thể lâm sàng được bảo toàn dưới concept properties.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-yhct-symptom-vs"
      },
      "name" : "Triệu chứng YHCT — VN Traditional Medicine Symptom ValueSet",
      "description" : "Tập giá trị triệu chứng theo thể lâm sàng y học cổ truyền. 1451 triệu chứng. Từ QĐ 3080/QĐ-BYT (26/9/2025) — PL I.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-qualification-cs"
      },
      "name" : "Trình độ chuyên môn y tế — VN Healthcare Qualification CodeSystem",
      "description" : "Danh mục trình độ chuyên môn của nhân viên y tế Việt Nam. Bao gồm các\nhọc vị, chức danh chuyên môn phổ biến trong hệ thống khám chữa bệnh.\nCăn cứ: Luật KCB 2023 Điều 19-27 (Giấy phép hành nghề), Nghị định 96/2023/NĐ-CP. /\nVietnamese healthcare professional qualification levels covering medical degrees,\nspecialist certifications, and academic titles used in the healthcare system.\nPer Medical Examination and Treatment Law 2023 Art.19-27, Decree 96/2023/NĐ-CP.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-qualification-vs"
      },
      "name" : "Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet",
      "description" : "Tập giá trị trình độ chuyên môn của nhân viên y tế Việt Nam. /\nValueSet of Vietnamese healthcare professional qualification levels.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-bhyt-financial-field-cs"
      },
      "name" : "Trường tổng tiền BHYT — BHYT Financial Field CodeSystem",
      "description" : "Danh mục trường tổng tiền trong chuẩn dữ liệu đầu ra KCB/BHYT dùng để ánh xạ sang `Claim.total`, `ClaimResponse.total`, `ExplanationOfBenefit.total` và `VNCoreExtClaimCostSummary`. Đây là CodeSystem nguồn cho trường XML/export, không phải danh mục kết quả giám định.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-bhyt-financial-field-vs"
      },
      "name" : "Trường tổng tiền BHYT — BHYT Financial Field ValueSet",
      "description" : "Tập giá trị trường tổng tiền BHYT dùng làm source cho ConceptMap tài chính/adjudication và traceability export XML.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-claim-audit-status"
      },
      "name" : "Trạng thái giám định BHYT — Claim Audit Status Extension",
      "description" : "Trạng thái giám định, quyết toán hồ sơ thanh toán BHYT điện tử theo quy trình\nTT 12/2026/TT-BTC: tiếp nhận → giám định → duyệt/từ chối/tranh chấp.\nĐặt trên PaymentReconciliation hoặc Task workflow BHYT. Bổ sung cho `PaymentReconciliation.outcome`\nchuẩn FHIR (queued | complete | error | partial) để map đúng vòng đời giám định BHYT Việt Nam.\nCăn cứ:\n- TT 12/2026/TT-BTC — Bộ Tài chính, Điều 6 và Điều 10 (tranh chấp).\n- NĐ 188/2025/NĐ-CP.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-claim-audit-status-cs"
      },
      "name" : "Trạng thái giám định BHYT — VN Claim Audit Status CodeSystem",
      "description" : "Trạng thái quy trình giám định, quyết toán hồ sơ thanh toán BHYT điện tử\ngiữa cơ sở KCB và cơ quan BHXH.\nDùng cho `PaymentReconciliation.outcome` (VNCorePaymentReconciliation) và các trường\ntrạng thái xử lý hồ sơ tương đương trong workflow BHYT.\nCăn cứ:\n- TT 12/2026/TT-BTC — Bộ Tài chính, hướng dẫn giám định, thanh toán, quyết toán chi phí\n  KCB BHYT điện tử; quy trình tiếp nhận hồ sơ → giám định → quyết toán/từ chối/tranh chấp.\n- NĐ 188/2025/NĐ-CP (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT.\n- Biểu mẫu 06/BH (Biên bản quyết toán/thanh toán chi phí KCB BHYT).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-claim-audit-status-vs"
      },
      "name" : "Trạng thái giám định BHYT — VN Claim Audit Status ValueSet",
      "description" : "Bộ giá trị trạng thái giám định, quyết toán hồ sơ thanh toán BHYT điện tử.\nBind extensible cho `VNCorePaymentReconciliation.outcome`.\nCăn cứ TT 12/2026/TT-BTC; biểu mẫu 06/BH.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-legacy-technical-line"
      },
      "name" : "Tuyến chuyên môn kỹ thuật lịch sử — Legacy Technical Line Extension",
      "description" : "Mở rộng ghi nhận tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT cho dữ liệu cũ hoặc bài toán chuyển đổi. Không dùng để biểu diễn mô hình hiện hành.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-legacy-technical-line-cs"
      },
      "name" : "Tuyến chuyên môn kỹ thuật lịch sử — Vietnam Legacy Technical Line CodeSystem",
      "description" : "Danh mục tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT. Bộ mã này chỉ dùng cho dữ liệu lịch sử hoặc chuyển đổi từ HIS cũ. TT 43/2013/TT-BYT đã bị bãi bỏ bởi TT 23/2024/TT-BYT từ ngày 18/10/2024.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-legacy-technical-line-vs"
      },
      "name" : "Tuyến chuyên môn kỹ thuật lịch sử — Vietnam Legacy Technical Line ValueSet",
      "description" : "Tập giá trị tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT, chỉ dùng cho dữ liệu legacy.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "NamingSystem"
      }],
      "reference" : {
        "reference" : "NamingSystem/vn-vneid-ns"
      },
      "name" : "Tài khoản định danh điện tử VNeID — Vietnam Electronic Identity Account",
      "description" : "Hệ thống định danh cho tài khoản định danh điện tử VNeID do Bộ Công an quản lý.\nVNeID tích hợp hoặc hiển thị CCCD, BHYT và các giấy tờ điện tử khác trên ứng dụng/nền tảng định danh điện tử.\nTrong VN Core, URI này chỉ nên dùng cho lớp tích hợp tài khoản/xác thực khi có căn cứ nghiệp vụ rõ ràng; không model như patient identifier gốc song song với CCCD.",
      "exampleBoolean" : false,
      "groupingId" : "naming-systems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-document-reference"
      },
      "name" : "Tài liệu y tế VN Core — VN Core DocumentReference Profile",
      "description" : "Profile DocumentReference cho Việt Nam. Dùng cho tham chiếu bệnh án điện tử,\nphiếu kết quả xét nghiệm, phim ảnh CĐHA, đơn thuốc điện tử, giấy chuyển viện, v.v.\nCăn cứ:\n- TT 13/2025/TT-BYT (06/6/2025) — Bệnh án điện tử, hiệu lực 21/7/2025\n- NĐ 102/2025/NĐ-CP (13/5/2025) — Quản lý dữ liệu y tế số\n- NĐ 278/2025/NĐ-CP — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — Kết nối, chia sẻ dữ liệu bắt buộc; chuẩn hóa và thống nhất kết nối qua Nền tảng chia sẻ, điều phối dữ liệu chậm nhất 31/12/2026\n- QĐ 11/2026/QĐ-TTg (28/3/2026) — Danh mục CSDL quốc gia, gồm CSDL quốc gia về y tế\n- Luật KCB 2023 (15/2023/QH15) — Hồ sơ bệnh án\n- NĐ 137/2024/NĐ-CP — Giao dịch điện tử, chữ ký số\n- QĐ 1332/QĐ-BYT — Sổ sức khỏe điện tử trên VNeID\n- Luật 91/2025/QH15 — BVDLCN: dữ liệu y tế = DLCN nhạy cảm",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-patient-gks"
      },
      "name" : "Tìm kiếm bệnh nhân theo Giấy khai sinh — VN Patient Birth Certificate Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Patient theo số Giấy khai sinh để hỗ trợ hồ sơ trẻ em, sơ sinh và đối soát BHYT trước khi hoàn tất định danh số.",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-patient-bhxh"
      },
      "name" : "Tìm kiếm bệnh nhân theo mã BHXH — VN Patient BHXH Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Patient theo mã số BHXH 10 chữ số để hỗ trợ các workflow BHYT và đối soát dữ liệu legacy.",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-patient-cccd"
      },
      "name" : "Tìm kiếm bệnh nhân theo số CCCD — VN Patient CCCD Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Patient theo số CCCD (Căn cước công dân 12 chữ số).\nVí dụ: GET [base]/Patient?vn-cccd=001099012345",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-patient-bhyt"
      },
      "name" : "Tìm kiếm bệnh nhân theo số thẻ BHYT — VN Patient BHYT Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Patient theo số thẻ BHYT.\nHỗ trợ cả 3 format (duy trì song song): CCCD 12 số (từ 15/8/2025 per NĐ 188/2025), BHXH 10 số, legacy 15 ký tự.\nVí dụ: GET [base]/Patient?vn-bhyt=001099012345",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-condition-icd10"
      },
      "name" : "Tìm kiếm chẩn đoán theo mã ICD-10 — VN Condition ICD-10 Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Condition theo mã bệnh ICD-10.\nCăn cứ: QĐ 4469/QĐ-BYT (28/10/2020) — Ban hành Bảng phân loại quốc tế bệnh tật ICD-10,\nbổ sung bởi QĐ 98/QĐ-BYT (14/01/2022) — COVID-19 codes U07.1, U07.2.\nVí dụ: GET [base]/Condition?vn-icd10=http://hl7.org/fhir/sid/icd-10|J18.9",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-claim-ma-lk"
      },
      "name" : "Tìm kiếm Claim theo MA_LK — VN Claim MA_LK Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Claim theo mã liên kết hồ sơ `MA_LK`.\nVí dụ: GET [base]/Claim?vn-ma-lk=http://fhir.hl7.org.vn/core/sid/ma-lk|LK-2026-000123",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-claim-response-xml1-id"
      },
      "name" : "Tìm kiếm ClaimResponse theo XML1_ID — VN ClaimResponse XML1_ID Search Parameter",
      "description" : "SearchParameter cho phép tra cứu `ClaimResponse` theo `XML1_ID` hoặc mã phản hồi gateway tương đương.\nVí dụ: GET [base]/ClaimResponse?vn-xml1-id=http://fhir.hl7.org.vn/core/sid/bhyt-gateway-response-id|XML1-20260322-000042",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-coverage-ma-dkbd"
      },
      "name" : "Tìm kiếm Coverage theo MA_DKBD — VN Coverage Primary Care Facility Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Coverage theo mã nơi đăng ký KCB ban đầu `MA_DKBD`.\nVí dụ: GET [base]/Coverage?vn-ma-dkbd=79001",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-organization-cskcb"
      },
      "name" : "Tìm kiếm CSYT theo mã CSKCB — VN Organization CSKCB Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Organization theo mã cơ sở KCB (5 chữ số, BHXH cấp).\nVí dụ: GET [base]/Organization?vn-cskcb=79001",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-device-ma-vat-tu"
      },
      "name" : "Tìm kiếm Device theo MA_VAT_TU — VN Device Item Code Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Device theo mã vật tư/thiết bị y tế (MA_VAT_TU) trong dữ liệu BHXH.\nCăn cứ: QĐ 3176/QĐ-BYT — trường MA_VAT_TU.\nVí dụ: GET [base]/Device?vn-ma-vat-tu=VT-STENT-DES-001",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-device-group"
      },
      "name" : "Tìm kiếm Device theo nhóm BHYT — VN Device Group Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Device theo nhóm TBYT BHYT (N01-N09).\nCăn cứ: TT 04/2017/TT-BYT Phụ lục 01, TT 24/2025/TT-BYT, VBHN 14/VBHN-BYT.\nVí dụ:\n- GET [base]/Device?vn-device-group=N06.00.000 — tìm thiết bị cấy ghép\n- GET [base]/Device?vn-device-group=N03.00.000 — tìm vật tư chăm sóc",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-device-risk-class"
      },
      "name" : "Tìm kiếm Device theo phân loại rủi ro — VN Device Risk Class Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Device theo phân loại rủi ro A/B/C/D.\nCăn cứ: NĐ 98/2021/NĐ-CP Điều 4 (đã sửa NĐ 07/2023, NĐ 04/2025), TT 05/2022/TT-BYT (đã sửa TT 59/2025).\nVí dụ:\n- GET [base]/Device?vn-risk-class=D — tìm tất cả thiết bị loại D\n- GET [base]/Device?vn-risk-class=C,D — tìm thiết bị C hoặc D",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-device-registration-number"
      },
      "name" : "Tìm kiếm Device theo số lưu hành — VN Device Registration Number Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Device theo số lưu hành TBYT do Cục Hạ tầng & Thiết bị y tế cấp.\nCăn cứ: NĐ 98/2021/NĐ-CP Chương III (đã sửa NĐ 07/2023, NĐ 04/2025) — đăng ký lưu hành TBYT.\nVí dụ: GET [base]/Device?vn-registration-number=20255555/BYT-CCHTBYT",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-encounter-ma-luot-kcb"
      },
      "name" : "Tìm kiếm Encounter theo MA_LUOT_KCB — VN Encounter Visit Code Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Encounter theo mã lượt khám `MA_LUOT_KCB`.\nVí dụ: GET [base]/Encounter?vn-ma-luot-kcb=http://fhir.hl7.org.vn/core/sid/ma-luot-kcb|LK-2026-04-05-0142",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-encounter-malydo"
      },
      "name" : "Tìm kiếm lượt khám theo MALYDO — VN Encounter Insurance Visit Type Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Encounter theo loại KCB BHYT (trường MALYDO).\nGiá trị: 1=Đúng tuyến, 2=Cấp cứu, 3=Trái tuyến, 4=Thông tuyến, 5=KCB ban đầu.\nCăn cứ: QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024).\nVí dụ: GET [base]/Encounter?vn-malydo=1",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-practitioner-cchn"
      },
      "name" : "Tìm kiếm NVYT theo số CCHN lịch sử — VN Practitioner legacy CCHN Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Practitioner theo số Chứng chỉ hành nghề (CCHN) lịch sử.\nDùng cho chuyển đổi và tra cứu hồ sơ được lập theo khung pháp lý trước Luật KCB 2023.\nVí dụ: GET [base]/Practitioner?vn-cchn=012345",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-practitioner-gphn"
      },
      "name" : "Tìm kiếm NVYT theo số GPHN — VN Practitioner GPHN Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Practitioner theo số Giấy phép hành nghề khám bệnh, chữa bệnh.\nCăn cứ: Luật KCB 2023 (15/2023/QH15), NĐ 96/2023/NĐ-CP.\nVí dụ: GET [base]/Practitioner?vn-gphn=79/GPHN-BYT-0001234",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-patient-vneid"
      },
      "name" : "Tìm kiếm Patient theo VNeID — VN Patient VNeID Search Parameter",
      "description" : "SearchParameter lịch sử cho phép tìm kiếm Patient theo tài khoản định danh điện tử VNeID.\nArtifact này được giữ lại để ghi nhận quyết định thiết kế cũ, nhưng không còn được khuyến nghị công bố trong CapabilityStatement core vì VNeID không được coi là định danh bệnh nhân gốc song song với CCCD.",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "SearchParameter"
      }],
      "reference" : {
        "reference" : "SearchParameter/vn-sp-coverage-bhyt"
      },
      "name" : "Tìm kiếm thẻ BHYT theo số thẻ — VN Coverage BHYT Search Parameter",
      "description" : "SearchParameter cho phép tìm kiếm Coverage theo số thẻ BHYT (trường identifier).\nHỗ trợ cả 3 format (duy trì song song): CCCD 12 số (từ 15/8/2025 per NĐ 188/2025), BHXH 10 số, legacy 15 ký tự.\nCăn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP (hiệu lực 15/8/2025).\nVí dụ: GET [base]/Coverage?vn-bhyt-card=http://fhir.hl7.org.vn/core/sid/bhyt|001085012345",
      "exampleBoolean" : false,
      "groupingId" : "search-parameters"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-discharge-disposition-cs"
      },
      "name" : "Tình trạng ra viện — Vietnam Discharge Disposition CodeSystem",
      "description" : "Danh mục tình trạng ra viện theo QĐ 130/QĐ-BYT (2023), sửa đổi bởi QĐ 4750/QĐ-BYT (2023) và QĐ 3176/QĐ-BYT (29/10/2024) (trường MA_LOAI_RV, STT 42 Bảng 1).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-discharge-disposition-vs"
      },
      "name" : "Tình trạng ra viện — Vietnam Discharge Disposition ValueSet",
      "description" : "Tập giá trị tình trạng ra viện theo QĐ 130/QĐ-BYT (thay thế QĐ 4210), sửa đổi bổ sung bởi QĐ 3176/QĐ-BYT (2024).",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-org-rank-status"
      },
      "name" : "Tình trạng xếp hạng cơ sở y tế — Organization Rank Status Extension",
      "description" : "Mở rộng ghi nhận trạng thái xếp hạng của cơ sở y tế nhằm biểu diễn các trường hợp đã xếp hạng, chưa xếp hạng hoặc không áp dụng mà không làm sai bộ mã hạng pháp lý.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-organization-rank-status-cs"
      },
      "name" : "Tình trạng xếp hạng của cơ sở y tế — Vietnam Organization Rank Status CodeSystem",
      "description" : "Tình trạng vận hành của thuộc tính xếp hạng cơ sở y tế. Bộ mã này giúp biểu diễn trường hợp chưa xếp hạng hoặc không áp dụng mà không làm sai ngữ nghĩa của hạng pháp lý.",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-organization-rank-status-vs"
      },
      "name" : "Tình trạng xếp hạng của cơ sở y tế — Vietnam Organization Rank Status ValueSet",
      "description" : "Tập giá trị trạng thái xếp hạng dùng để biểu diễn cơ sở đã xếp hạng, chưa xếp hạng hoặc không áp dụng.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-province"
      },
      "name" : "Tỉnh/Thành phố (mã hóa) — Vietnam Province Extension",
      "description" : "Mở rộng ghi nhận mã tỉnh/thành phố theo QĐ 19/2025/QĐ-TTg trên Address.\nFHIR Address.state chỉ là text — extension này bổ sung mã hóa (Coding) để tra cứu chính xác.\nCăn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-claim-cost-summary"
      },
      "name" : "Tổng chi phí theo nhóm — Claim Cost Summary Extension",
      "description" : "Extension tổng hợp chi phí KCB theo từng nhóm nguồn chi trả.\nMapping từ XML 3176: T_THUOC, T_VTYT, T_BNCCT, T_BNTT, T_BHTT, T_NGUONKHAC, T_NGOAIDS.\nCăn cứ: QĐ 130/QĐ-BYT → QĐ 3176, QĐ 697/QĐ-BYT.\nCác field tổng tiền này được chuẩn hóa thêm qua `VNBHYTFinancialFieldCS` và ConceptMap `vn-cm-bhyt-financial-field-to-adjudication`; extension chỉ giữ số tiền tổng hợp, không encode công thức adjudication của payer.\nNguồn thiết kế: OHP Data Processor (Claim extensions production mapping).",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-coverage-cumulative-copay"
      },
      "name" : "Tổng cùng chi trả lũy kế trong năm — Coverage Cumulative Copay Extension",
      "description" : "Tổng số tiền cùng chi trả (co-payment) BHYT lũy kế trong năm dương lịch của\nngười tham gia BHYT, dùng để xác định khi nào đạt trần cùng chi trả và được hưởng\nquyền lợi không phải cùng chi trả tiếp.\nCăn cứ:\n- NĐ 188/2025/NĐ-CP — Điều 10 (trần cùng chi trả tích lũy năm). Khi tổng cùng chi trả\n  trong năm dương lịch vượt trần quy định, người tham gia BHYT được cấp Giấy chứng nhận\n  không cùng chi trả và không phải cùng chi trả các lần KCB tiếp theo trong năm đó.\n- Luật 51/2024/QH15 — Sửa đổi Luật BHYT, hiệu lực 01/07/2025.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-practitioner-role"
      },
      "name" : "Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile",
      "description" : "Profile PractitionerRole cho Việt Nam. Liên kết Practitioner với Organization và Location,\nghi nhận chức danh nghề nghiệp (mã V.08) và chuyên khoa hành nghề.\nCăn cứ: Luật KCB 2023 Điều 42 (phạm vi hoạt động chuyên môn),\nTT 41/2025/TT-BYT (chức danh bác sĩ), TT 02/2025/TT-BYT (chức danh điều dưỡng),\nTT 32/2023/TT-BYT Điều 11 (phạm vi hành nghề theo chuyên khoa).",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "OperationDefinition"
      }],
      "reference" : {
        "reference" : "OperationDefinition/vn-validate-bhyt-claim"
      },
      "name" : "Validate hồ sơ BHYT — VN Validate BHYT Claim Operation",
      "description" : "OperationDefinition cho phép kiểm tra hồ sơ BHYT trước khi gửi Cổng giám định BHXH.",
      "exampleBoolean" : false,
      "groupingId" : "operations"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CapabilityStatement"
      }],
      "reference" : {
        "reference" : "CapabilityStatement/vn-core-bhyt-gateway-client"
      },
      "name" : "VN Core BHYT Gateway Client CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho client gửi hồ sơ thanh toán BHYT",
      "description" : "Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho HIS/EMR hoặc middleware đóng vai trò client trong lớp liên thông hồ sơ BHYT, chịu trách nhiệm gửi hồ sơ thanh toán BHYT. / Minimum conformance requirements for payer submission clients using the VN Core BHYT Submission layer.",
      "exampleBoolean" : false,
      "groupingId" : "capabilities"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CapabilityStatement"
      }],
      "reference" : {
        "reference" : "CapabilityStatement/vn-core-bhyt-gateway-server"
      },
      "name" : "VN Core BHYT Gateway Server CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho máy chủ cổng BHYT",
      "description" : "Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho máy chủ/facade tiếp nhận hồ sơ thanh toán BHYT từ HIS/EMR. Tập trung vào lớp liên thông hồ sơ BHYT, `MA_LK`, các operation kiểm tra hợp lệ/gửi/thu hồi và các quy tắc định dạng xuất cổng. / Minimum conformance requirements for payer-facing BHYT submission servers.",
      "exampleBoolean" : false,
      "groupingId" : "capabilities"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CapabilityStatement"
      }],
      "reference" : {
        "reference" : "CapabilityStatement/vn-core-citizen-app-client"
      },
      "name" : "VN Core Citizen App Client CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho client ứng dụng người dân",
      "description" : "Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho ứng dụng người dân/cổng công dân/kết nối VNeID. Tập trung vào truy cập hồ sơ cá nhân, giấy tờ lâm sàng, `Consent` và lịch sử truy cập. / Minimum conformance requirements for citizen-facing or VNeID-connected apps.",
      "exampleBoolean" : false,
      "groupingId" : "capabilities"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CapabilityStatement"
      }],
      "reference" : {
        "reference" : "CapabilityStatement/vn-core-emr-server"
      },
      "name" : "VN Core EMR Server CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho máy chủ EMR nội bộ",
      "description" : "Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho máy chủ EMR/EHR nội bộ triển khai VN Core Base. Tập trung vào hồ sơ bệnh nhân, hồ sơ lâm sàng, tài liệu, `Consent`, `AuditEvent` và `Provenance`. / Minimum conformance requirements for internal EMR/EHR servers implementing VN Core Base.",
      "exampleBoolean" : false,
      "groupingId" : "capabilities"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CapabilityStatement"
      }],
      "reference" : {
        "reference" : "CapabilityStatement/vn-core-server"
      },
      "name" : "VN Core Server CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho máy chủ FHIR theo VN Core",
      "description" : "Yêu cầu tuân thủ tối thiểu ở mức cơ sở mà một máy chủ FHIR PHẢI đáp ứng để tuân thủ VN Core IG. Bao gồm các tài nguyên cốt lõi hành chính, lâm sàng, tài chính, quản trị dữ liệu và lớp liên thông hồ sơ BHYT (`BHYT Submission`) với các tương tác read, search-type, create và update. Các vai trò triển khai cụ thể nên tham chiếu thêm các CapabilityStatement chuyên biệt cho EMR, cổng BHYT và ứng dụng người dân. / Minimum conformance requirements for a FHIR server implementing VN Core IG.",
      "exampleBoolean" : false,
      "groupingId" : "capabilities"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Patient"
      }],
      "reference" : {
        "reference" : "Patient/ExamplePatientUnknown"
      },
      "name" : "Ví dụ (Edge Case): Bệnh nhân cấp cứu chưa xác định danh tính",
      "description" : "Bệnh nhân bất tỉnh nhập cấp cứu BV Chợ Rẫy, chưa có giấy tờ tùy thân.\nMinh họa: data-absent-reason trên birthDate và identifier[CCCD].value,\ngender = #unknown, chỉ có MRN tạm thời.\nDanh tính cần cập nhật sau khi bệnh nhân tỉnh hoặc thân nhân xác nhận.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionRefuted"
      },
      "name" : "Ví dụ (Edge Case): Chẩn đoán viêm ruột thừa K35.8 bị bác bỏ sau CT scan",
      "description" : "Chẩn đoán ban đầu K35.8 (viêm ruột thừa cấp) bị bác bỏ sau CT scan bụng.\nverificationStatus = #refuted, clinicalStatus = #inactive.\nChẩn đoán xác định: I88.0 (viêm hạch mạc treo — ghi trong Condition riêng).\nMinh họa: audit trail y khoa — giữ lại chẩn đoán sai với lý do bác bỏ.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "AllergyIntolerance"
      }],
      "reference" : {
        "reference" : "AllergyIntolerance/ExampleAllergyIntoleranceNKA"
      },
      "name" : "Ví dụ (Edge Case): Không có dị ứng đã biết (No Known Allergy — NKA)",
      "description" : "Bệnh nhân xác nhận KHÔNG có tiền sử dị ứng thuốc, thực phẩm hay các chất khác.\nSNOMED CT 716186003 = 'No known allergy' — mã chuẩn cho NKA.\nverificationStatus = #confirmed: bác sĩ đã khai thác kỹ và bệnh nhân xác nhận rõ ràng.\nMinh họa: phân biệt 'NKA đã xác nhận' với 'chưa hỏi về dị ứng'.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Encounter"
      }],
      "reference" : {
        "reference" : "Encounter/ExampleEncounterEnteredInError"
      },
      "name" : "Ví dụ (Edge Case): Lượt khám nhập sai do nhầm bệnh nhân trùng tên",
      "description" : "Tiếp nhận nhầm bệnh nhân do trùng tên — phát hiện sau 10 phút khi kiểm tra CCCD.\nstatus = #entered-in-error: lượt khám vô hiệu, giữ lại để audit trail.\nMinh họa: cách xử lý nhập sai theo chuẩn FHIR R4 — không xóa, chỉ đánh dấu sai.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Coverage"
      }],
      "reference" : {
        "reference" : "Coverage/ExampleCoverageBHYTExpired"
      },
      "name" : "Ví dụ (Edge Case): Thẻ BHYT hết hạn — đối tượng hộ nghèo",
      "description" : "Thẻ BHYT đối tượng HN (hộ nghèo) đã hết hạn 31/01/2026 (hết hạn 2 tháng tính đến 20/3/2026).\nstatus = #cancelled. Minh họa: cách ghi nhận thẻ hết hiệu lực,\nhỗ trợ hệ thống phát hiện và cảnh báo tự động.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationSpecimenError"
      },
      "name" : "Ví dụ (Edge Case): Xét nghiệm hủy do mẫu huyết tan (hemolysis)",
      "description" : "Xét nghiệm glucose máu lúc đói bị hủy vì mẫu máu bị vỡ hồng cầu (hemolysis).\nstatus = #cancelled, không có valueQuantity.\ndataAbsentReason = #error với mô tả nguyên nhân kỹ thuật.\nMinh họa: cách ghi nhận lỗi kỹ thuật bệnh phẩm theo chuẩn FHIR R4.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionMultiCKD"
      },
      "name" : "Ví dụ (Đa bệnh): Bệnh thận mãn tính giai đoạn 3 N18.3",
      "description" : "Chẩn đoán 3/3 trong kịch bản đa bệnh: Bệnh thận mãn tính stage 3 (eGFR 30-59).\nLà hậu quả của HTN (I10) và ĐTĐ type 2 (E11.9) kiểm soát chưa tốt. Cùng bệnh nhân và lượt khám với ExampleConditionMultiHTN và ExampleConditionMultiDM.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionMultiHTN"
      },
      "name" : "Ví dụ (Đa bệnh): Tăng huyết áp nguyên phát I10",
      "description" : "Chẩn đoán 1/3 trong kịch bản đa bệnh: Tăng huyết áp nguyên phát.\nLà nguyên nhân góp phần gây bệnh thận mãn. Cùng bệnh nhân và lượt khám với ExampleConditionMultiDM và ExampleConditionMultiCKD.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionMultiDM"
      },
      "name" : "Ví dụ (Đa bệnh): Đái tháo đường type 2 E11.9",
      "description" : "Chẩn đoán 2/3 trong kịch bản đa bệnh: Đái tháo đường type 2.\nLà yếu tố nguy cơ độc lập gây CKD (nefropathy do đái tháo đường). Cùng bệnh nhân và lượt khám với ExampleConditionMultiHTN và ExampleConditionMultiCKD.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionMinimal"
      },
      "name" : "Ví dụ tối giản: Viêm đường hô hấp trên cấp J06.9",
      "description" : "Ví dụ tối giản — chỉ gồm các element bắt buộc và Must Support của VNCoreConditionDiagnosis.\nKhông có encounter, không có note, không có onset, không có bodySite.\nMục tiêu: cho thấy mức tối thiểu hợp lệ theo VN Core profile.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Medication"
      }],
      "reference" : {
        "reference" : "Medication/ExampleMedicationYHCTHerbal"
      },
      "name" : "Ví dụ YHCT: Bài thuốc Độc hoạt ký sinh thang (thận hư)",
      "description" : "Bài thuốc cổ phương Độc hoạt ký sinh thang — trị yêu thống thể thận hư, bổ thận, cường cân cốt, khu phong trừ thấp.\nDạng thuốc sắc (decoction). Liệt kê 5 vị dược liệu đại diện.\nPer QĐ 3080/QĐ-BYT (YHCT Đợt 2 — Danh mục Dược liệu và Bài thuốc cổ truyền).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "MedicationRequest"
      }],
      "reference" : {
        "reference" : "MedicationRequest/ExampleMedicationRequestYHCT"
      },
      "name" : "Ví dụ YHCT: Đơn kê bài thuốc Độc hoạt ký sinh thang",
      "description" : "Đơn kê thuốc YHCT ngoại trú: Bài thuốc Độc hoạt ký sinh thang cho bệnh nhân yêu thống thể thận hư.\nPháp điều trị: Bổ thận, cường cân cốt, khu phong trừ thấp. Liệu trình 14 thang.\nHướng dẫn sắc: sắc 3 lần nước, hợp lại chia 2 lần uống/ngày.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Composition"
      }],
      "reference" : {
        "reference" : "Composition/ExampleCompositionEMR"
      },
      "name" : "Ví dụ — Bệnh án ngoại trú (tăng huyết áp)",
      "description" : "Bệnh án điện tử ngoại trú cho bệnh nhân Nguyễn Văn An\nkhám tăng huyết áp tại BV Chợ Rẫy. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-composition",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Encounter"
      }],
      "reference" : {
        "reference" : "Encounter/ExampleEncounterYHCT"
      },
      "name" : "Ví dụ — Lượt khám YHCT tích hợp (Yêu thống)",
      "description" : "Lượt khám kết hợp YHCT + Y học hiện đại: bệnh nhân đau lưng.\nChẩn đoán song song: Tây y (ICD-10: M54.5) + YHCT (Yêu thống thể hàn thấp).\nĐiều trị: châm cứu + xoa bóp bấm huyệt + thuốc Tây y giảm đau.\nPer TT 13/2025/TT-BYT, QĐ 2552/QĐ-BYT (YHCT Đợt 1).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Medication"
      }],
      "reference" : {
        "reference" : "Medication/ExampleMedicationAmlodipine"
      },
      "name" : "Ví dụ — Thuốc Amlodipine 5mg",
      "description" : "Amlodipine besylate 5mg viên nén — điều trị tăng huyết áp.\nNhóm chẹn kênh calci. ATC: C08CA01. BHYT thanh toán.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "MedicationRequest"
      }],
      "reference" : {
        "reference" : "MedicationRequest/ExampleMedicationRequestHypertension"
      },
      "name" : "Ví dụ — Đơn thuốc tăng huyết áp (Amlodipine 5mg)",
      "description" : "Đơn thuốc điện tử (ePrescription): Amlodipine 5mg x 1 viên/ngày, uống sáng,\n30 ngày. BHYT thanh toán. Per TT 13/2025/TT-BYT, Luật Dược 2016.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Consent"
      }],
      "reference" : {
        "reference" : "Consent/example-consent-privacy"
      },
      "name" : "Ví dụ — Đồng ý xử lý DLCN y tế",
      "description" : "Bệnh nhân Nguyễn Văn An đồng ý cho BV Bạch Mai xử lý dữ liệu y tế\nphục vụ khám chữa bệnh và thanh toán BHYT, thời hạn 5 năm.\nPer Luật 91/2025/QH15, NĐ 356/2025/NĐ-CP.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationLabALT"
      },
      "name" : "Ví dụ: ALT (SGPT) — Chức năng gan bình thường",
      "description" : "Kết quả ALT (SGPT) = 28 U/L — trong giới hạn bình thường, không gợi ý tổn thương tế bào gan.\nLOINC: 1742-6 (Alanine aminotransferase [Enzymatic activity/volume] in Serum or Plasma).\nVí dụ này minh họa kết quả xét nghiệm bình thường — quan trọng để theo dõi thuốc và tầm soát gan.\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — chỉ số CLS nhóm Sinh hóa — Chức năng gan.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "AuditEvent"
      }],
      "reference" : {
        "reference" : "AuditEvent/ExampleAuditEventPatientAccess"
      },
      "name" : "Ví dụ: AuditEvent truy cập hồ sơ bệnh án",
      "description" : "Ghi nhận bác sĩ truy cập bệnh án điện tử của bệnh nhân Nguyễn Văn An phục vụ điều trị nội trú.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-audit-event",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBundleInpatientDischarge"
      },
      "name" : "Ví dụ: Bundle bệnh án nội trú + xuất viện (document)",
      "description" : "Document Bundle — bệnh án điện tử nội trú hoàn chỉnh per TT 13/2025/TT-BYT.\nNguyễn Văn An nhập cấp cứu viêm ruột thừa cấp K35.8, phẫu thuật nội soi,\nnằm viện 3 ngày, Ceftriaxone 2g IV hậu phẫu, xuất viện ổn định.\nComposition có 5 sections chuẩn: lý do, chẩn đoán, thủ thuật, thuốc, ra viện.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBundleReferralUpward"
      },
      "name" : "Ví dụ: Bundle chuyển tuyến từ xã lên tỉnh",
      "description" : "Bundle workflow chuyển tuyến — kịch bản đặc thù hệ thống y tế VN.\nTrần Thị Mai (nữ, 62 tuổi) khám tại trạm y tế xã, nghi nhồi máu cơ tim cấp I21.9,\nsơ cứu Aspirin 300mg rồi chuyển tuyến lên BV tỉnh Đồng Nai.\nBao gồm: giấy chuyển viện (ServiceRequest), ECG bất thường, scan PDF giấy giới thiệu.\nMapping: HTCHUYEN=2 (chuyển lên), MALYDO=5 (KCB ban đầu tại trạm y tế).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionRecurrentWound"
      },
      "name" : "Ví dụ: Bundle hồ sơ BHYT có VET_THUONG_TP",
      "description" : "Bundle BHYT example-only cho `VET_THUONG_TP`. Flag được đặt trên từng dòng Claim.item và export adapter chỉ xuất literal `1` khi dòng thuốc/DVKT/VTYT thật sự được đánh dấu điều trị vết thương hoặc bệnh tật tái phát cho nhóm người có công/thương binh theo QĐ 130/QĐ-BYT, QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionMultiCoverage"
      },
      "name" : "Ví dụ: Bundle hồ sơ BHYT nhiều thẻ",
      "description" : "Bundle hồ sơ BHYT minh họa trường hợp có hai Coverage cùng tồn tại nhưng chỉ một insurance được đánh dấu `focal=true` theo NĐ 188/2025.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionEmergencyUnknownIdentity"
      },
      "name" : "Ví dụ: Bundle hồ sơ thanh toán BHYT cấp cứu chưa xác định danh tính",
      "description" : "Bundle minh họa ca cấp cứu chưa xác định danh tính nhưng vẫn có hồ sơ BHYT tạm thời.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionHIV"
      },
      "name" : "Ví dụ: Bundle hồ sơ thanh toán BHYT HIV/AIDS",
      "description" : "Bundle hồ sơ thanh toán BHYT minh họa hồ sơ đặc thù HIV/AIDS để phủ bảng 6 trong lớp liên thông hồ sơ BHYT theo QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionOutpatient"
      },
      "name" : "Ví dụ: Bundle hồ sơ thanh toán BHYT ngoại trú",
      "description" : "Bundle hồ sơ thanh toán BHYT ngoại trú tối thiểu, dùng MA_LK làm khóa liên kết.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionInpatient"
      },
      "name" : "Ví dụ: Bundle hồ sơ thanh toán BHYT nội trú",
      "description" : "Bundle hồ sơ thanh toán BHYT nội trú dùng thêm DiagnosticReport, Composition, DocumentReference và Observation để phủ các bảng BHYT 4-8 và 12 trong lớp liên thông hồ sơ BHYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionNewborn"
      },
      "name" : "Ví dụ: Bundle hồ sơ thanh toán BHYT trẻ sơ sinh",
      "description" : "Bundle minh họa ca trẻ sơ sinh chưa có CCCD nhưng có lý do bất khả kháng hợp lệ, đồng thời kèm giấy chứng sinh, giấy nghỉ dưỡng thai và giấy nghỉ việc hưởng BHXH.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionDeathCertificate"
      },
      "name" : "Ví dụ: Bundle hồ sơ thanh toán BHYT tử vong",
      "description" : "Bundle hồ sơ thanh toán BHYT minh họa ca tử vong ở mức FHIR workflow. Không dùng ví dụ này để phủ XML10 QĐ 3176/QĐ-BYT; XML10 hiện là giấy chứng nhận nghỉ dưỡng thai.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBHYTSubmissionYHCT"
      },
      "name" : "Ví dụ: Bundle hồ sơ thanh toán BHYT YHCT",
      "description" : "Bundle BHYT YHCT bổ sung positive seed cho XML2 `MA_PP_CHEBIEN`. Ví dụ này giữ `MA_PP_CHEBIEN` dưới dạng raw legal string (`Chích rượu`) thay vì công bố CodeSystem chính thức, vì nguồn hiện hành cho phương pháp chế biến vị thuốc cổ truyền chưa được ingest thành danh mục FHIR-ready có provenance đầy đủ.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBundleOutpatientBHYT"
      },
      "name" : "Ví dụ: Bundle khám ngoại trú + thanh toán BHYT",
      "description" : "Bundle workflow khám ngoại trú BHYT đầy đủ — kịch bản phổ biến nhất trong y tế VN.\nBệnh nhân Nguyễn Văn An (DN, 80%) khám đúng tuyến tại BV Chợ Rẫy,\nchẩn đoán viêm dạ dày mạn tính K29.5, XN glucose bình thường,\nkê đơn Omeprazole 20mg × 14 ngày. BHYT thanh toán 318.400/398.000 VND.\nMapping: MALYDO=5, MA_DOITUONG_KCB=1.1, 3 nhóm chi phí per QĐ 697/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBundleLabOrderResult"
      },
      "name" : "Ví dụ: Bundle xét nghiệm CBC + Sinh hóa — kết quả bất thường WBC",
      "description" : "Bundle workflow xét nghiệm cận lâm sàng đầy đủ: chỉ định → kết quả → chỉ định bổ sung.\nBệnh nhân Nguyễn Văn An khám ngoại trú tại BV Chợ Rẫy với sốt 3 ngày.\nCBC: WBC = 15.2 ×10⁹/L (tăng cao — nghi nhiễm trùng vi khuẩn). RBC/Hgb/PLT bình thường.\nSinh hóa: Glucose 5.4 mmol/L, Creatinine 85 µmol/L, ALT 32 U/L — bình thường.\nBS chỉ định bổ sung CRP do WBC cao.\nCăn cứ: QĐ 1227/QĐ-BYT (2.964 chỉ số CLS chuẩn hóa), LOINC per WHO.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBundleYHCTFullVisit"
      },
      "name" : "Ví dụ: Bundle YHCT đầy đủ — Yêu thống thể hàn thấp",
      "description" : "Bundle workflow Y học cổ truyền đầy đủ: tứ chẩn + biện chứng + điều trị.\nKịch bản: Nguyễn Văn An (41 tuổi) khám YHCT tại BV Chợ Rẫy — đau lưng mạn tính 3 tháng.\nMinh họa toàn bộ 10 VN YHCT CodeSystem (QĐ 2552 + QĐ 3080/QĐ-BYT):\n  VNYHCTPulseCS: Mạch trầm (6581102), Mạch trì (6581103)\n  VNYHCTTongueCS: Chất nhợt (6581007), Rêu trắng (6581027), Rêu dày (6581026)\n  VNYHCTSymptomCS: Đau thắt lưng (6541000), Đau tăng lạnh (6541001), Sợ lạnh (6541004)\n  VNYHCTDiseaseCS: Yêu thống thể hàn thấp (U62.392.5.01)\n  VNYHCTDiagnosisCS: Hàn chứng (6535004)\n  VNYHCTTreatmentMethodCS: Ôn thông kinh lạc (6581209), Trừ phong thấp (6581247)\n  VNYHCTAcupointCS: Thận Du BL23 (6536596), Yêu Dương Quan GV3 (6537277),\n                    Uỷ Trung BL40 (6536664), Đại Trường Du BL25 (6536604), Hợp Cốc LI4 (6536059)\n  VNYHCTTechniqueCS: Hào châm (3810018)\n  VNYHCTHerbCS: Can khương (6581452), Thương truật (6581784) + 7 dược liệu khác\n  VNYHCTPrescriptionCS: Can khương thương truật thang (6586400)\nMapping BHXH: MALYDO=5, MA_DOITUONG_KCB=1.1, ICD-10=M54.5 per QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Bundle"
      }],
      "reference" : {
        "reference" : "Bundle/ExampleBundleEPrescription"
      },
      "name" : "Ví dụ: Bundle đơn thuốc điện tử (ePrescription) — THA + ĐTĐ",
      "description" : "Bundle workflow đơn thuốc điện tử cho bệnh nhân đa bệnh lý.\n3 thuốc: Amlodipine 5mg (hạ áp), Metformin 500mg (tiểu đường), Aspirin 81mg (phòng ngừa).\nMinh họa đơn thuốc ngoại trú 30 ngày, đầy đủ liều lượng, đường dùng, tần suất, số đăng ký.\nPer TT 13/2025/TT-BYT (bệnh án điện tử) + Luật Dược 2016 Điều 74 (kê đơn).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Practitioner"
      }],
      "reference" : {
        "reference" : "Practitioner/ExamplePractitionerBSCKII"
      },
      "name" : "Ví dụ: Bác sĩ CKII Nguyễn Thị Lan (đầy đủ)",
      "description" : "Bác sĩ chuyên khoa II — đầy đủ: CCCD, GPHN hiện hành, CCHN lịch sử, họ tên, giới tính,\ntrình độ BS CKII Nội khoa.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Practitioner"
      }],
      "reference" : {
        "reference" : "Practitioner/ExamplePractitionerMinimal"
      },
      "name" : "Ví dụ: Bác sĩ tối thiểu (GPHN + tên)",
      "description" : "Bác sĩ với thông tin tối thiểu: GPHN hiện hành và họ tên.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Practitioner"
      }],
      "reference" : {
        "reference" : "Practitioner/ExamplePractitionerYHCT"
      },
      "name" : "Ví dụ: Bác sĩ Y học cổ truyền — BS CKI Lê Văn Minh",
      "description" : "Bác sĩ chuyên khoa I Y học cổ truyền tại TP.HCM.\nĐịnh danh: CCCD + GPHN hiện hành + CCHN lịch sử. Trình độ: BS CKI YHCT.\nMinh họa VNCorePractitioner cho nhân viên y tế YHCT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DiagnosticReport"
      }],
      "reference" : {
        "reference" : "DiagnosticReport/ExampleDiagnosticReportPathology"
      },
      "name" : "Ví dụ: Báo cáo giải phẫu bệnh — Viêm ruột thừa cấp mủ",
      "description" : "Kết quả giải phẫu bệnh lý mô ruột thừa cắt bỏ. Kết luận: Viêm ruột thừa cấp mủ, chưa vỡ.\nCategory: XN (Xét nghiệm — bao gồm giải phẫu bệnh). LOINC 60568-3 (Pathology synoptic report).\nKết luận mã hóa bằng SNOMED CT Morphologic Abnormality per QĐ 2493/QĐ-BYT, kèm ICD-10 fallback trong cùng CodeableConcept.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-report-pathology",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DiagnosticReport"
      }],
      "reference" : {
        "reference" : "DiagnosticReport/ExampleDiagnosticReportImaging"
      },
      "name" : "Ví dụ: Báo cáo X-quang ngực thẳng (bình thường)",
      "description" : "Kết quả X-quang ngực hai tư thế bình thường — bệnh nhân Nguyễn Văn An.\nCategory: CDHA (Chẩn đoán hình ảnh). LOINC 36643-5.\nKèm file PDF kết quả. Per QĐ 1227/QĐ-BYT (chỉ số CLS) + QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-report-imaging",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DiagnosticReport"
      }],
      "reference" : {
        "reference" : "DiagnosticReport/ExampleDiagnosticReportLab"
      },
      "name" : "Ví dụ: Báo cáo xét nghiệm sinh hóa",
      "description" : "Ví dụ báo cáo xét nghiệm sinh hóa máu — glucose, creatinine.\nNhóm CLS: LAB (xét nghiệm). Liên kết Observation kết quả chi tiết.\nCăn cứ: QĐ 1227/QĐ-BYT — 2.964 chỉ số CLS, QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-report-lab",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationBHXH"
      },
      "name" : "Ví dụ: Bảo hiểm xã hội Việt Nam",
      "description" : "Ví dụ tổ chức: BHXH Việt Nam — cơ quan bảo hiểm xã hội quốc gia.\nDùng làm insurer trong Claim/ClaimResponse/Coverage.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Patient"
      }],
      "reference" : {
        "reference" : "Patient/ExampleAddressFull"
      },
      "name" : "Ví dụ: Bệnh nhân có địa chỉ đầy đủ theo ĐVHC mới",
      "description" : "Ví dụ minh họa địa chỉ đầy đủ với cả text, line, state,\nextension province (mã hóa), extension ward (mã hóa),\nvà district (lịch sử) để hỗ trợ tương thích ngược.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Patient"
      }],
      "reference" : {
        "reference" : "Patient/ExamplePatientNguyenVanAn"
      },
      "name" : "Ví dụ: Bệnh nhân Nguyễn Văn An (đầy đủ)",
      "description" : "Ví dụ bệnh nhân đầy đủ: CCCD, BHYT (format mới), MRN, họ tên, giới tính,\nngày sinh, địa chỉ với mã ĐVHC mới, dân tộc Kinh, Công giáo,\nquốc tịch Việt Nam và nơi sinh.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Patient"
      }],
      "reference" : {
        "reference" : "Patient/ExamplePatientForeignPassport"
      },
      "name" : "Ví dụ: Bệnh nhân người nước ngoài dùng hộ chiếu",
      "description" : "Ví dụ bệnh nhân người nước ngoài khám tại Việt Nam, không thuộc hệ CCCD nên dùng hộ chiếu làm định danh thay thế hợp lệ. Slice CCCD vẫn hiện diện với data-absent-reason; không dùng forceMajeureReason.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Patient"
      }],
      "reference" : {
        "reference" : "Patient/ExamplePatientChildDependent"
      },
      "name" : "Ví dụ: Bệnh nhân trẻ em dưới 6 tuổi",
      "description" : "Ví dụ bệnh nhi dưới 6 tuổi theo hướng model chuẩn: Patient là bệnh nhi, contact ghi thông tin mẹ, và có thể liên kết thêm RelatedPerson để phục vụ BHYT/EMR mà không cần custom extension riêng cho người giám hộ.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Patient"
      }],
      "reference" : {
        "reference" : "Patient/ExamplePatientMinimal"
      },
      "name" : "Ví dụ: Bệnh nhân tối thiểu (chỉ CCCD + tên + giới tính)",
      "description" : "Ví dụ bệnh nhân với thông tin tối thiểu bắt buộc:\nchỉ có CCCD, họ tên (text), và giới tính.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/example-organization-bach-mai"
      },
      "name" : "Ví dụ: Bệnh viện Bạch Mai",
      "description" : "Bệnh viện Bạch Mai — bệnh viện đa khoa hạng Đặc biệt, tuyến Trung ương,\ncông lập, tại Hà Nội. Sử dụng làm parent Organization cho các ví dụ khoa/phòng.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationChoRay"
      },
      "name" : "Ví dụ: Bệnh viện Chợ Rẫy",
      "description" : "Bệnh viện Chợ Rẫy — bệnh viện đa khoa hạng Đặc biệt, tuyến Trung ương,\ncông lập, tại TP. Hồ Chí Minh.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationLegacyTechnicalLine"
      },
      "name" : "Ví dụ: Bệnh viện Đa khoa Gia Lâm (dữ liệu lịch sử)",
      "description" : "Ví dụ minh họa hồ sơ lịch sử của bệnh viện đa khoa tuyến huyện theo TT 43/2013/TT-BYT. Organization hiện vẫn có cấp quản lý tỉnh, nhưng tuyến chuyên môn kỹ thuật cũ được lưu riêng ở legacyTechnicalLine.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DocumentReference"
      }],
      "reference" : {
        "reference" : "DocumentReference/ExampleDocumentReferenceScan"
      },
      "name" : "Ví dụ: Bệnh án giấy ngoại trú số hóa (scan PDF)",
      "description" : "Bệnh án giấy ngoại trú được scan và lưu trữ dưới dạng PDF.\nPer TT 13/2025/TT-BYT Điều 5: CSYT phải chuyển đổi bệnh án giấy sang điện tử trước 31/12/2026.\nLưu ý: đây là bước chuyển tiếp — bệnh án scan (DocumentReference) khác với bệnh án điện tử gốc (Composition).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DocumentReference"
      }],
      "reference" : {
        "reference" : "DocumentReference/ExampleDocumentReferenceEMR"
      },
      "name" : "Ví dụ: Bệnh án điện tử (EMR)",
      "description" : "Ví dụ tham chiếu bệnh án điện tử per TT 13/2025/TT-BYT.\nBệnh án nội trú của bệnh nhân Nguyễn Văn An tại BV Chợ Rẫy.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Immunization"
      }],
      "reference" : {
        "reference" : "Immunization/ExampleImmunizationNotDone"
      },
      "name" : "Ví dụ: Chưa tiêm do hết vaccine",
      "description" : "Lịch tiêm TCMR chưa thực hiện vì điểm tiêm hết vaccine tại thời điểm hẹn.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-immunization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionPneumonia"
      },
      "name" : "Ví dụ: Chẩn đoán viêm phổi J18.9",
      "description" : "Chẩn đoán viêm phổi không xác định — dual coding ICD-10 + SNOMED CT.\nICD-10: J18.9 (tên VN từ icd.kcb.vn), SNOMED CT: 233604007 (từ QĐ 2805/QĐ-BYT).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionAppendicitis"
      },
      "name" : "Ví dụ: Chẩn đoán viêm ruột thừa cấp K35.8",
      "description" : "Chẩn đoán viêm ruột thừa cấp — dual coding ICD-10 + SNOMED CT.\nICD-10: K35.8, SNOMED CT: 85189001. Dùng kèm ExampleEncounterInpatient.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionYHCTYeuThong"
      },
      "name" : "Ví dụ: Chẩn đoán YHCT — Yêu thống (Đau cột sống thắt lưng)",
      "description" : "Chẩn đoán y học cổ truyền: Yêu thống thể hàn thấp.\nTriple coding: ICD-10 M54.5 + SNOMED CT 279039007 + YHCT Mã U U62.392.5.01 (thể hàn thấp).\nMinh họa khả năng mã hóa song song giữa y học hiện đại và y học cổ truyền,\nkèm mã thể lâm sàng cụ thể theo QĐ 2552/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationLabCreatinine"
      },
      "name" : "Ví dụ: Creatinine huyết thanh — Theo dõi chức năng thận",
      "description" : "Kết quả Creatinine huyết thanh = 142 µmol/L — TĂNG CAO, gợi ý suy thận mạn giai đoạn 3a.\neGFR ước tính ~52 mL/phút/1.73m² (CKD stage 3a per KDIGO 2024: eGFR 45–59).\nLOINC: 2160-0 (Creatinine [Mass/volume] in Serum or Plasma).\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — chỉ số CLS nhóm Sinh hóa — Chức năng thận.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ImagingStudy"
      }],
      "reference" : {
        "reference" : "ImagingStudy/ExampleImagingStudyChestCT"
      },
      "name" : "Ví dụ: CT lồng ngực ngoại trú",
      "description" : "Nghiên cứu DICOM CT lồng ngực ngoại trú cho bệnh nhân Nguyễn Văn An. Minh họa StudyInstanceUID, accession number, modality CT, reasonCode ICD-10 và bodySite SNOMED CT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-imaging-study",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationLabCBC"
      },
      "name" : "Ví dụ: Công thức máu toàn phần (CBC)",
      "description" : "Kết quả xét nghiệm Công thức máu (CBC) — bạch cầu tăng cao 12.8 × 10^9/L,\ngợi ý nhiễm trùng cấp. Hồng cầu, Hemoglobin và Tiểu cầu trong giới hạn bình thường.\nLOINC: 58410-2 (CBC panel - Blood by Automated count).\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — bộ mã CLS quốc gia ánh xạ LOINC.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Encounter"
      }],
      "reference" : {
        "reference" : "Encounter/ExampleEncounterEmergency"
      },
      "name" : "Ví dụ: Cấp cứu — Tai nạn giao thông, gãy cổ xương đùi",
      "description" : "Lượt cấp cứu tai nạn giao thông tại BV Chợ Rẫy.\nChẩn đoán: S72.0 Gãy cổ xương đùi. Cấp cứu qua đêm, chuyển sang Khoa Chấn thương.\nMALYDO=2 (cấp cứu) — hưởng BHYT như đúng tuyến per Điều 22 Luật BHYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "MedicationDispense"
      }],
      "reference" : {
        "reference" : "MedicationDispense/ExampleMedicationDispenseOutpatientBHYT"
      },
      "name" : "Ví dụ: Cấp phát Amlodipine ngoại trú BHYT",
      "description" : "Cấp phát Amlodipine 5mg x 30 viên cho bệnh nhân Nguyễn Văn An sau khám ngoại trú. Minh họa authorizingPrescription để nối chuỗi kê đơn → cấp phát → thanh toán BHYT, với mức hưởng BHYT 80%.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "MedicationDispense"
      }],
      "reference" : {
        "reference" : "MedicationDispense/ExampleMedicationDispenseInpatientAntibiotic"
      },
      "name" : "Ví dụ: Cấp phát Cefotaxime nội trú",
      "description" : "Cấp phát Cefotaxime tiêm tĩnh mạch cho người bệnh nội trú. Minh họa cấp phát thuốc kháng sinh trong bệnh án điện tử nội trú.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "AllergyIntolerance"
      }],
      "reference" : {
        "reference" : "AllergyIntolerance/ExampleAllergyPenicillin"
      },
      "name" : "Ví dụ: Dị ứng Penicillin",
      "description" : "Dị ứng thuốc Penicillin (SNOMED CT: 91936005), mức độ nguy hiểm cao.\nPhản ứng: ban đỏ và phù nề. Minh họa VNCoreAllergyIntolerance.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "AllergyIntolerance"
      }],
      "reference" : {
        "reference" : "AllergyIntolerance/ExampleAllergyIntoleranceFood"
      },
      "name" : "Ví dụ: Dị ứng thực phẩm — Trứng",
      "description" : "Dị ứng trứng (SNOMED CT: 213020009 — Egg protein allergy). Mức độ nguy hiểm cao.\nPhản ứng: phù mạch dị ứng và ban đỏ sau khi ăn trứng — đã xảy ra 3 lần, xác nhận.\nMinh họa VNCoreAllergyIntolerance với category food, reaction.substance, reaction.manifestation.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "AllergyIntolerance"
      }],
      "reference" : {
        "reference" : "AllergyIntolerance/ExampleAllergyIntoleranceMinimal"
      },
      "name" : "Ví dụ: Dị ứng tối thiểu — Penicillin",
      "description" : "Dị ứng với thông tin tối thiểu: chỉ code và patient và clinicalStatus.\nMinh họa VNCoreAllergyIntolerance với các trường Must Support tối giản.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DeviceUseStatement"
      }],
      "reference" : {
        "reference" : "DeviceUseStatement/ExampleDeviceUseStatementMinimal"
      },
      "name" : "Ví dụ: Ghi nhận sử dụng VTYT tối thiểu — Bơm tiêm",
      "description" : "Ghi nhận tối thiểu sử dụng VTYT (bơm tiêm 5ml) cho bệnh nhân.\nChỉ ghi nhận: trạng thái, bệnh nhân, thiết bị.\nMinh họa mức tối thiểu cần thiết cho DeviceUseStatement per VNCoreDeviceUseStatement.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device-use-statement",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DeviceUseStatement"
      }],
      "reference" : {
        "reference" : "DeviceUseStatement/ExampleDeviceUseStatementVTYT"
      },
      "name" : "Ví dụ: Ghi nhận sử dụng VTYT — Catheter tĩnh mạch",
      "description" : "Ghi nhận sử dụng catheter tĩnh mạch ngoại vi 22G cho bệnh nhân nội trú.\nLiên kết với ExampleDeviceVTYT (catheter) và ExamplePatientNguyenVanAn.\nMinh họa cách ghi nhận VTYT tiêu hao trong lượt điều trị.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device-use-statement",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ExplanationOfBenefit"
      }],
      "reference" : {
        "reference" : "ExplanationOfBenefit/ExampleExplanationOfBenefitBHYT"
      },
      "name" : "Ví dụ: Giải trình quyền lợi BHYT nội trú",
      "description" : "Giải trình quyền lợi BHYT cho lượt nội trú viêm ruột thừa tại BV Chợ Rẫy.\nAdjudication: đề nghị 14.370.000, đủ điều kiện 12.600.000, cùng chi trả 2.520.000, BHYT thanh toán 10.080.000, tự trả 1.770.000.\nMinh họa ConceptMap trường tổng tiền BHYT sang total category: submitted/eligible/copay/benefit và các category cục bộ patient-self-pay/other-fund/non-covered/medication-subtotal/supplies-subtotal.\nLiên kết với ExampleClaimBHYT (yêu cầu gốc) và ExampleClaimResponseBHYT (kết quả giám định).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-explanation-of-benefit",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ExplanationOfBenefit"
      }],
      "reference" : {
        "reference" : "ExplanationOfBenefit/ExampleEOBPartialCoverage"
      },
      "name" : "Ví dụ: Giải trình quyền lợi BHYT — 80% BHYT, 20% cùng chi trả",
      "description" : "Giải trình quyền lợi BHYT ngoại trú 3 dịch vụ: Khám (150.000) + XN (200.000) + Thuốc (350.000) = 700.000 VNĐ.\nBHYT thanh toán 80% = 560.000 VNĐ, cùng chi trả 20% = 140.000 VNĐ.\nMinh họa VNCoreExplanationOfBenefit với adjudication 3 mức: submitted/eligible/benefit.\nPer QĐ 697/QĐ-BYT (19/3/2026), NĐ 188/2025/NĐ-CP, QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-explanation-of-benefit",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ExplanationOfBenefit"
      }],
      "reference" : {
        "reference" : "ExplanationOfBenefit/ExampleEOBChildUnder6"
      },
      "name" : "Ví dụ: Giải trình quyền lợi BHYT — Trẻ em dưới 6 tuổi (hưởng 100%)",
      "description" : "Giải trình quyền lợi BHYT cho trẻ em dưới 6 tuổi Nguyễn Minh Khôi (3 tuổi).\nKhám nhi + Xét nghiệm + Thuốc = 450.000 VNĐ. BHYT thanh toán 100% (0% đồng chi trả).\nĐối tượng BHYT trẻ em dưới 6 tuổi hưởng 100% chi phí KCB per NĐ 188/2025/NĐ-CP.\nLiên kết Coverage: ExampleCoverageBHYTDependent (thẻ BHYT quyền lợi cấp trực tiếp cho trẻ).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-explanation-of-benefit",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DocumentReference"
      }],
      "reference" : {
        "reference" : "DocumentReference/ExampleDocumentReferenceConsent"
      },
      "name" : "Ví dụ: Giấy cam kết đồng ý phẫu thuật (scan PDF)",
      "description" : "Bản scan giấy cam kết đồng ý phẫu thuật cắt ruột thừa nội soi.\nBN Nguyễn Văn An ký ngày 10/4/2026 trước khi phẫu thuật. Người thân ký tên đồng ý (vợ bệnh nhân).\nPer Luật KCB 2023 Điều 15: quyền được thông tin và đồng ý điều trị.\nPer Luật 91/2025/QH15: đây là xử lý DLCN nhạy cảm — cần lưu giữ bằng chứng đồng ý.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Composition"
      }],
      "reference" : {
        "reference" : "Composition/ExampleCompositionReferralLetter"
      },
      "name" : "Ví dụ: Giấy chuyển viện — Nghi nhồi máu cơ tim I21.9",
      "description" : "Giấy chuyển viện từ Trạm Y tế Bình Thạnh gửi lên BV Chợ Rẫy.\nChẩn đoán sơ bộ: Nghi STEMI cấp (I21.9). Per Luật KCB 2023, NĐ 188/2025/NĐ-CP.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-composition",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ServiceRequest"
      }],
      "reference" : {
        "reference" : "ServiceRequest/ExampleServiceRequestReferral"
      },
      "name" : "Ví dụ: Giấy chuyển viện — Nghi viêm cơ tim cấp",
      "description" : "Giấy chuyển tuyến cấp cứu từ Trạm Y tế phường Ngọc Hà đến Bệnh viện Chợ Rẫy.\nLý do: nghi viêm cơ tim cấp (I40.9), vượt khả năng tuyến xã.\nMinh họa VNCoreServiceRequest với extension referralMode (HTCHUYEN=2: Chuyển đến từ tuyến dưới).\nPer QĐ 3176/QĐ-BYT (trường HTCHUYEN), Luật KCB 2023 (chuyển người bệnh).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationLabHbA1c"
      },
      "name" : "Ví dụ: HbA1c — Kiểm soát đường huyết dài hạn",
      "description" : "Kết quả HbA1c = 7.2% — CAO, kiểm soát đường huyết chưa đạt mục tiêu điều trị.\nTheo ADA Standards of Care 2026: mục tiêu HbA1c < 7.0% cho phần lớn BN ĐTĐ type 2.\nLOINC: 4548-4 (Hemoglobin A1c/Hemoglobin.total in Blood). Phản ánh mức đường huyết trung bình\ntrong 2–3 tháng trước, không bị ảnh hưởng bởi tình trạng nhịn ăn.\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — chỉ số CLS nhóm Sinh hóa — Nội tiết.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Device"
      }],
      "reference" : {
        "reference" : "Device/ExampleDeviceImplantLegacyNoRegnum"
      },
      "name" : "Ví dụ: Implant legacy thiếu số lưu hành (test fixture âm)",
      "description" : "TEST FIXTURE — Thiết bị cấy ghép class C/D legacy thiếu số lưu hành (registration number).\n\n**Đây là ví dụ INTENTIONAL FAIL** invariant `vn-implant-regnum-class-cd` ở mức warning.\n\nUse case:\n- Dữ liệu legacy từ trước thời điểm hiệu lực NĐ 98/2021/NĐ-CP\n- Thiết bị nhập khẩu trước 2022 chưa có quy định số lưu hành\n- Hoặc data migration từ HIS cũ chưa thu thập trường registrationNumber\n\nBehavior:\n- Invariant `vn-implant-regnum-class-cd` fires warning (KHÔNG block validation)\n- Bệnh viện tiếp nhận warning + có 90 ngày bổ sung registration per workflow nội bộ\n- Sau hiệu lực NĐ 90/2026 (15/05/2026): warning có thể nâng lên error theo policy nội bộ\n\nDisclaimer: KHÔNG dùng pattern này cho thiết bị cấy ghép mới sau 2022.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-implantable-device",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Device"
      }],
      "reference" : {
        "reference" : "Device/ExampleDeviceImplantDentalClassC"
      },
      "name" : "Ví dụ: Implant nha khoa loại C — Trụ titanium",
      "description" : "Trụ implant nha khoa titanium grade 4, đường kính 4.0mm, dài 10mm. Phân loại rủi ro loại C theo NĐ 98/2021/NĐ-CP đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP (cấy ghép dài hạn, tiếp xúc xương). Có số lưu hành do Cục Hạ tầng và Thiết bị y tế cấp, có UDI để truy xuất sau cấy ghép. Nhóm BHYT N06 (TT 04/2017/TT-BYT).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-implantable-device",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Medication"
      }],
      "reference" : {
        "reference" : "Medication/ExampleMedicationInsulin"
      },
      "name" : "Ví dụ: Insulin Mixtard 30 bút tiêm 3mL (dây chuyền lạnh)",
      "description" : "Insulin hỗn hợp Mixtard 30 (70% NPH + 30% Regular) — bút tiêm prefilled 3mL, 100 IU/mL.\nDây chuyền lạnh: bảo quản 2-8°C (chưa mở), sau mở dùng trong 28 ngày ở nhiệt độ phòng ≤ 25°C.\nDual coding: SNOMED CT 67866001 + ATC A10AB01.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationDepartmentDiagnosticImaging"
      },
      "name" : "Ví dụ: Khoa Chẩn đoán hình ảnh Bệnh viện tỉnh",
      "description" : "Khoa Chẩn đoán hình ảnh (K39) của bệnh viện tuyến tỉnh. Minh họa OrganizationDepartment liên kết với VNCoreOrganization hiện có.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization-department",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationDepartmentCardiology"
      },
      "name" : "Ví dụ: Khoa Nội Tim mạch Bệnh viện Bạch Mai",
      "description" : "Khoa Nội Tim mạch (K04) trực thuộc Bệnh viện Bạch Mai. Minh họa OrganizationDepartment dùng mã khoa BYT theo QĐ 2010/QĐ-BYT Phụ lục 6.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization-department",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Location"
      }],
      "reference" : {
        "reference" : "Location/ExampleLocationChoRayCardiology"
      },
      "name" : "Ví dụ: Khoa Tim mạch Bệnh viện Chợ Rẫy",
      "description" : "Khoa Tim mạch trực thuộc Bệnh viện Chợ Rẫy. Minh họa Location cấp khoa dùng cho EMR, phân công nhân sự và định vị nơi cung cấp dịch vụ.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Location"
      }],
      "reference" : {
        "reference" : "Location/ExampleLocationNgocHaOutpatientClinic"
      },
      "name" : "Ví dụ: Khu khám ngoại trú Trạm Y tế phường Ngọc Hà",
      "description" : "Khu khám ngoại trú trực thuộc Trạm Y tế phường Ngọc Hà. Minh họa Location cấp khu vực chuyên môn trong cơ sở tuyến xã.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Encounter"
      }],
      "reference" : {
        "reference" : "Encounter/ExampleEncounterTelehealth"
      },
      "name" : "Ví dụ: Khám từ xa (Telemedicine) — Tái khám tăng huyết áp",
      "description" : "Lượt tái khám từ xa qua video call cho bệnh nhân Nguyễn Văn An — tăng huyết áp I10.\nThời gian: 22/4/2026, 09:00-09:30 (30 phút). Kê đơn Amlodipine tiếp tục.\nLưu ý: Thanh toán BHYT cho telehealth chưa có hướng dẫn chính thức (03/2026).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ClaimResponse"
      }],
      "reference" : {
        "reference" : "ClaimResponse/ExampleClaimResponsePartialDeny"
      },
      "name" : "Ví dụ: Kết quả BHYT — Từ chối một phần (thuốc ngoài danh mục)",
      "description" : "BHXH phê duyệt một phần: Khám (approved 100%), XN (approved 100%), Thuốc (partial — 1 thuốc ngoài DM BHYT).\nThuốc XYZ ngoài danh mục: 800,000đ bị trừ, bệnh nhân tự chi trả phần này.\nPer NĐ 188/2025/NĐ-CP, danh mục thuốc BHYT hiện hành.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ClaimResponse"
      }],
      "reference" : {
        "reference" : "ClaimResponse/ExampleClaimResponseBHYT"
      },
      "name" : "Ví dụ: Kết quả giải quyết BHYT nội trú",
      "description" : "Ví dụ kết quả giải quyết BHYT cho lượt nội trú viêm ruột thừa tại BV Chợ Rẫy.\nAdjudication: đề nghị 14.370.000, đủ ĐK 12.600.000, cùng chi trả 2.520.000, BHYT thanh toán 10.080.000.\nMapping OHP ClaimResponse: submitted/eligible/copay/benefit.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ClaimResponse"
      }],
      "reference" : {
        "reference" : "ClaimResponse/ExampleClaimResponseSelfPay"
      },
      "name" : "Ví dụ: Kết quả thanh toán tự chi trả — bệnh nhân nước ngoài",
      "description" : "Kết quả thanh toán cho bệnh nhân nước ngoài John Smith, tự chi trả toàn bộ.\nKhông có BHYT → không qua giám định BHXH → BV thu trực tiếp 550.000 VNĐ.\nKhám tổng quát (300.000) + Thuốc (250.000). outcome = complete.\nPer QĐ 697/QĐ-BYT, QĐ 3276/QĐ-BYT mã đối tượng 9 (Không có BHYT).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Encounter"
      }],
      "reference" : {
        "reference" : "Encounter/ExampleEncounterOutpatient"
      },
      "name" : "Ví dụ: Lượt khám ngoại trú BHYT",
      "description" : "Lượt khám ngoại trú BHYT đúng tuyến tại BV Chợ Rẫy.\nBệnh nhân Nguyễn Văn An, chẩn đoán viêm phổi.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Encounter"
      }],
      "reference" : {
        "reference" : "Encounter/ExampleEncounterInpatient"
      },
      "name" : "Ví dụ: Lượt nhập viện nội trú",
      "description" : "Lượt nhập viện nội trú, chuyển tuyến, ra viện với tình trạng khỏi.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Specimen"
      }],
      "reference" : {
        "reference" : "Specimen/ExampleSpecimenSerumChemistry"
      },
      "name" : "Ví dụ: Mẫu huyết thanh dùng cho xét nghiệm sinh hóa",
      "description" : "Ví dụ đầy đủ cho mẫu huyết thanh dùng trong chuỗi xét nghiệm sinh hóa: glucose, creatinine, ALT.\nMinh họa liên kết giữa chỉ định, lấy mẫu, tiếp nhận mẫu, vật chứa mẫu và báo cáo cận lâm sàng.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimen",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Specimen"
      }],
      "reference" : {
        "reference" : "Specimen/ExampleSpecimenWholeBloodCBC"
      },
      "name" : "Ví dụ: Mẫu máu toàn phần cho công thức máu",
      "description" : "Ví dụ tối thiểu cho mẫu máu toàn phần chống đông EDTA dùng trong công thức máu.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimen",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Specimen"
      }],
      "reference" : {
        "reference" : "Specimen/ExampleSpecimenAppendixTissue"
      },
      "name" : "Ví dụ: Mẫu mô ruột thừa cho giải phẫu bệnh",
      "description" : "Ví dụ tối thiểu cho mẫu mô ruột thừa sau phẫu thuật, dùng trong báo cáo giải phẫu bệnh.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimen",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Specimen"
      }],
      "reference" : {
        "reference" : "Specimen/ExampleSpecimenUrineMidstream"
      },
      "name" : "Ví dụ: Mẫu nước tiểu giữa dòng",
      "description" : "Ví dụ tối thiểu cho mẫu nước tiểu giữa dòng, dùng trong tổng phân tích nước tiểu thường quy.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimen",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "OperationOutcome"
      }],
      "reference" : {
        "reference" : "OperationOutcome/ExampleOperationOutcomeBHYTClaimReview"
      },
      "name" : "Ví dụ: OperationOutcome phản hồi giám định BHYT",
      "description" : "Ví dụ OperationOutcome cho hồ sơ BHYT có một dòng chi phí bị từ chối do không đúng quy định và một cảnh báo cần điều chỉnh dữ liệu trước khi gửi lại.",
      "exampleBoolean" : true,
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Location"
      }],
      "reference" : {
        "reference" : "Location/ExampleLocationNgocHaConsultRoom1"
      },
      "name" : "Ví dụ: Phòng khám số 1 Trạm Y tế phường Ngọc Hà",
      "description" : "Phòng khám cụ thể thuộc khu khám ngoại trú Trạm Y tế phường Ngọc Hà. Minh họa cấu trúc `partOf` giữa các Location.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationPrivateClinic"
      },
      "name" : "Ví dụ: Phòng khám đa khoa tư nhân Hoàng Long",
      "description" : "Phòng khám đa khoa tư nhân Hoàng Long — tại Hà Nội.\nChưa xếp hạng, cấp quản lý tỉnh (tư nhân hợp đồng BHYT). Loại hình: tư nhân.\nCó đăng ký khám BHYT ban đầu, mã CSKCB: 01-958.\nMinh họa Organization tư nhân — đối chiếu với BV công lập (Chợ Rẫy), CSKCB nhà nước (Trạm Y tế).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Procedure"
      }],
      "reference" : {
        "reference" : "Procedure/ExampleProcedureAppendectomy"
      },
      "name" : "Ví dụ: Phẫu thuật cắt ruột thừa",
      "description" : "Phẫu thuật cắt ruột thừa nội soi (SNOMED CT: 6025007).\nMinh họa VNCoreProcedure với mã SNOMED CT IPS.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Provenance"
      }],
      "reference" : {
        "reference" : "Provenance/ExampleProvenanceEMRSignature"
      },
      "name" : "Ví dụ: Provenance và chữ ký số bệnh án điện tử",
      "description" : "Ghi nhận nguồn gốc và chữ ký số của bệnh án điện tử nội trú theo TT 13/2025/TT-BYT và NĐ 137/2024/NĐ-CP.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-provenance",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "RelatedPerson"
      }],
      "reference" : {
        "reference" : "RelatedPerson/ExampleRelatedPersonMother"
      },
      "name" : "Ví dụ: RelatedPerson mẹ của bệnh nhi",
      "description" : "Ví dụ RelatedPerson theo hướng JP Core/US Core: hồ sơ mẹ của bệnh nhi được model bằng resource riêng thay vì custom extension.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalBMI"
      },
      "name" : "Ví dụ: Sinh hiệu — BMI 26.3 kg/m² (Béo phì độ I, tiêu chuẩn Châu Á)",
      "description" : "Chỉ số khối cơ thể (BMI) = 26.3 kg/m² — béo phì độ I theo tiêu chuẩn WHO khu vực Châu Á-Thái Bình Dương (ngưỡng VN: ≥ 25). LOINC 39156-5. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-vital-signs",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalBodyHeight"
      },
      "name" : "Ví dụ: Sinh hiệu — Chiều cao 168 cm",
      "description" : "Chiều cao 168 cm, LOINC 8302-2, đơn vị UCUM cm. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-body-height",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalWeight"
      },
      "name" : "Ví dụ: Sinh hiệu — Cân nặng 65 kg",
      "description" : "Cân nặng 65 kg, LOINC 29463-7, đơn vị UCUM kg. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-body-weight",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalSigns"
      },
      "name" : "Ví dụ: Sinh hiệu — Huyết áp 120/80 mmHg",
      "description" : "Sinh hiệu huyết áp tâm thu 120 mmHg, tâm trương 80 mmHg.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-blood-pressure",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalBP"
      },
      "name" : "Ví dụ: Sinh hiệu — Huyết áp 145/92 mmHg (THA độ 1)",
      "description" : "Huyết áp tâm thu 145 mmHg, tâm trương 92 mmHg — tăng huyết áp độ 1 theo ESC 2023. Kèm interpretation cao (H) và referenceRange cho từng component. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-blood-pressure",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalHeartRate"
      },
      "name" : "Ví dụ: Sinh hiệu — Mạch 80 lần/phút",
      "description" : "Mạch 80 lần/phút, LOINC 8867-4, đơn vị UCUM /min. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-heart-rate",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalTemp"
      },
      "name" : "Ví dụ: Sinh hiệu — Nhiệt độ 38.5°C (Sốt vừa)",
      "description" : "Nhiệt độ cơ thể = 38.5°C — sốt vừa. Interpretation High (#H). LOINC 8310-5 (Body temperature). Cần tìm nguyên nhân: nhiễm trùng, viêm. Kết hợp XN WBC, CRP. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-body-temperature",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalRespiratoryRate"
      },
      "name" : "Ví dụ: Sinh hiệu — Nhịp thở 16 lần/phút",
      "description" : "Nhịp thở 16 lần/phút, LOINC 9279-1, đơn vị UCUM /min. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-respiratory-rate",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationVitalSpO2"
      },
      "name" : "Ví dụ: Sinh hiệu — SpO2 94% (Thấp, cần theo dõi)",
      "description" : "Bão hòa oxy mao mạch (SpO2) = 94% — dưới ngưỡng bình thường 95–100%. Interpretation Low (#L). Cần theo dõi sát và cân nhắc thở oxy nếu SpO2 tiếp tục giảm dưới 92%. Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-spo2",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ImagingStudy"
      }],
      "reference" : {
        "reference" : "ImagingStudy/ExampleImagingStudyAbdominalUS"
      },
      "name" : "Ví dụ: Siêu âm bụng tổng quát",
      "description" : "Nghiên cứu DICOM siêu âm bụng tổng quát. Minh họa modality US, mã thủ thuật ICD-9-CM VN và bodySite SNOMED CT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-imaging-study",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionSNOMEDVN"
      },
      "name" : "Ví dụ: SNOMED CT VN + ICD-10 song song — Đái tháo đường type 2",
      "description" : "Minh họa dual coding SNOMED CT + ICD-10 cho chẩn đoán đái tháo đường type 2.\nSNOMED CT (44054006) từ QĐ 2805/QĐ-BYT (Đợt 3 — Finding), ICD-10 (E11.9) cho báo cáo BHXH.\nMục tiêu: SNOMED CT cho trao đổi quốc tế, ICD-10 cho hệ thống nội địa.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "DeviceUseStatement"
      }],
      "reference" : {
        "reference" : "DeviceUseStatement/ExampleDeviceUseStatementImplant"
      },
      "name" : "Ví dụ: Theo dõi thiết bị cấy ghép — Stent mạch vành",
      "description" : "Ghi nhận tình trạng sử dụng stent mạch vành phủ thuốc sau thủ thuật PCI cho bệnh nhân Nguyễn Văn An.\nThủ thuật đặt stent được minh họa bằng ExampleProcedurePCIStentPlacement qua Procedure.focalDevice.\nStent XIENCE Sierra 3.0mm x 18mm (Abbott). Thông tin chi phí/BHYT được biểu diễn trên Claim.item khi lập hồ sơ thanh toán, không nằm trong DeviceUseStatement.\nLiên kết: ExampleDeviceImplant (stent), ExamplePatientNguyenVanAn (bệnh nhân).\nPer NĐ 74/2025/NĐ-CP, QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device-use-statement",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Device"
      }],
      "reference" : {
        "reference" : "Device/ExampleDeviceImplantIVCFilter"
      },
      "name" : "Ví dụ: Thiết bị cấy ghép — Lưới lọc tĩnh mạch chủ tạm thời",
      "description" : "Lưới lọc tĩnh mạch chủ dưới tạm thời đã được tháo sau giai đoạn dự phòng thuyên tắc phổi. Ví dụ này minh họa thiết bị cấy ghép có trạng thái sau explant và được Procedure.focalDevice tham chiếu khi thực hiện thủ thuật tháo.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-implantable-device",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Device"
      }],
      "reference" : {
        "reference" : "Device/ExampleDeviceImplant"
      },
      "name" : "Ví dụ: Thiết bị cấy ghép — Stent mạch vành phủ thuốc",
      "description" : "Stent mạch vành phủ thuốc (drug-eluting stent) — TBYT cấy ghép cao giá.\nGhi nhận đầy đủ: mã TBYT, manufacturer, lot, model, serial number.\nNhóm BHYT tham khảo: N06.00.000 — vật liệu thay thế, vật liệu cấy ghép nhân tạo.\nPhạm vi và giá BHYT thuộc dòng Claim.item khi lập hồ sơ thanh toán. Per TT 04/2017/TT-BYT Phụ lục 01, TT 24/2025/TT-BYT, QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-implantable-device",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Device"
      }],
      "reference" : {
        "reference" : "Device/ExampleDeviceVTYT"
      },
      "name" : "Ví dụ: Thiết bị y tế — Kim luồn tĩnh mạch 22G",
      "description" : "Ví dụ thiết bị y tế tiêu hao (TBYT) — kim luồn tĩnh mạch 22G.\nDùng trong thanh toán BHYT: mã TBYT và nhóm TBYT có thể được tham chiếu từ dòng Claim.item; Device chỉ giữ dữ liệu thiết bị/legacy identifier.\nMapping OHP: MA_VAT_TU, TEN_VAT_TU per QĐ 3176/QĐ-BYT, NĐ 74/2025/NĐ-CP.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Device"
      }],
      "reference" : {
        "reference" : "Device/ExampleDeviceVTYTClassBThermometer"
      },
      "name" : "Ví dụ: Thiết bị y tế — Nhiệt kế điện tử (loại B, N08)",
      "description" : "Nhiệt kế điện tử hồng ngoại đo trán, dùng cho khám sàng lọc và theo dõi sinh hiệu tại bệnh viện. Phân loại rủi ro loại B (rủi ro trung bình thấp) theo NĐ 98/2021/NĐ-CP đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP — tiếp xúc với cơ thể nhưng không xâm lấn, không cấy ghép. TBYT loại B yêu cầu cấp số lưu hành theo NĐ 98/2021 Chương III. Nhóm BHYT N08 (TT 04/2017/TT-BYT — thiết bị chẩn đoán/điều trị).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Medication"
      }],
      "reference" : {
        "reference" : "Medication/ExampleMedicationAmoxicillin"
      },
      "name" : "Ví dụ: Thuốc Amoxicillin 500mg",
      "description" : "Ví dụ thuốc Amoxicillin 500mg viên nang — kháng sinh phổ rộng.\nMã ATC: J01CA04. Số đăng ký: VD-12345-20.\nMapping OHP: MA_THUOC, TEN_THUOC, SO_DANG_KY per QĐ 3176/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Coverage"
      }],
      "reference" : {
        "reference" : "Coverage/ExampleCoverageBHYTLegacy"
      },
      "name" : "Ví dụ: Thẻ BHYT format cũ (15 ký tự, trước 01/4/2021)",
      "description" : "Thẻ BHYT định dạng lịch sử — 15 ký tự (2 chữ mã đối tượng + 13 số).\nĐối tượng: Hưu trí (HT). Minh họa tương thích ngược.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Coverage"
      }],
      "reference" : {
        "reference" : "Coverage/ExampleCoverageBHYTNew"
      },
      "name" : "Ví dụ: Thẻ BHYT format mới (CCCD 12 số, từ 01/8/2025)",
      "description" : "Thẻ BHYT format mới — số thẻ = số CCCD 12 chữ số.\nĐối tượng: Doanh nghiệp (DN). Nơi ĐKKCB ban đầu: BV Chợ Rẫy.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Coverage"
      }],
      "reference" : {
        "reference" : "Coverage/ExampleCoverageBHYTDependent"
      },
      "name" : "Ví dụ: Thẻ BHYT trẻ em dưới 6 tuổi — quyền lợi hưởng trực tiếp",
      "description" : "Thẻ BHYT của Nguyễn Minh Khôi, 3 tuổi — đối tượng TE (trẻ em dưới 6 tuổi).\nVí dụ này minh họa quyền lợi BHYT được cấp trực tiếp cho chính trẻ, do ngân sách nhà nước đóng.\nPer NĐ 188/2025/NĐ-CP — mức hưởng 100% cho trẻ em dưới 6 tuổi.\nVí dụ guardian-linked riêng xem `ExampleCoverageBHYTGuardianLinked`.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Coverage"
      }],
      "reference" : {
        "reference" : "Coverage/ExampleCoverageBHYTGuardianLinked"
      },
      "name" : "Ví dụ: Thẻ BHYT trẻ em liên kết người đại diện",
      "description" : "Ví dụ minh họa beneficiary là bệnh nhi Nguyễn Minh Khôi, còn subscriber tham chiếu hồ sơ RelatedPerson của mẹ là Trần Thị Mai.\nVí dụ này dùng để minh họa cách liên kết người đại diện theo mô hình Coverage + RelatedPerson, không thay thế nghiệp vụ quyền lợi do NSNN chi trả cho trẻ em dưới 6 tuổi.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Procedure"
      }],
      "reference" : {
        "reference" : "Procedure/ExampleProcedureYHCTAcupuncture"
      },
      "name" : "Ví dụ: Thủ thuật châm cứu YHCT — Hào châm điều trị đau thắt lưng",
      "description" : "Châm cứu hào châm 5 huyệt điều trị đau thắt lưng (M54.5 / Yêu thống).\nMinh họa VNCoreProcedure với mã YHCT Kỹ thuật (QĐ 2552/QĐ-BYT) và Huyệt châm cứu (QĐ 2552/QĐ-BYT).\nPerformer: BS CKII Nguyễn Thị Lan. Encounter: ExampleEncounterYHCT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Procedure"
      }],
      "reference" : {
        "reference" : "Procedure/ExampleProcedureIVCFilterRemoval"
      },
      "name" : "Ví dụ: Thủ thuật tháo lưới lọc tĩnh mạch chủ",
      "description" : "Thủ thuật tháo lưới lọc tĩnh mạch chủ dưới tạm thời. Minh họa pattern Procedure.focalDevice cho explant/removal thiết bị cấy ghép; ongoing tracking vẫn dùng Device/DeviceUseStatement, chi phí dùng Claim/EOB.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Procedure"
      }],
      "reference" : {
        "reference" : "Procedure/ExampleProcedureMinimal"
      },
      "name" : "Ví dụ: Thủ thuật tối thiểu — Khâu vết thương",
      "description" : "Thủ thuật với thông tin tối thiểu: chỉ status, code và subject.\nMinh họa VNCoreProcedure với các trường bắt buộc và Must Support.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Procedure"
      }],
      "reference" : {
        "reference" : "Procedure/ExampleProcedurePCIStentPlacement"
      },
      "name" : "Ví dụ: Thủ thuật đặt stent mạch vành",
      "description" : "Can thiệp mạch vành qua da (PCI) đặt stent mạch vành phủ thuốc cho bệnh nhân Nguyễn Văn An. Minh họa pattern Procedure.focalDevice cho thủ thuật cấy/đặt thiết bị; DeviceUseStatement dùng để ghi nhận đang sử dụng theo thời gian, Claim/EOB dùng cho chi phí.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Immunization"
      }],
      "reference" : {
        "reference" : "Immunization/ExampleImmunizationVoluntary"
      },
      "name" : "Ví dụ: Tiêm chủng dịch vụ vaccine cúm",
      "description" : "Người lớn tiêm vaccine cúm mùa theo hình thức tiêm chủng dịch vụ và tự chi trả.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-immunization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Immunization"
      }],
      "reference" : {
        "reference" : "Immunization/ExampleImmunizationTCMR"
      },
      "name" : "Ví dụ: Tiêm chủng TCMR cho trẻ em",
      "description" : "Trẻ em được tiêm mũi 1 vaccine phối hợp DPT-VGB-Hib trong Chương trình Tiêm chủng mở rộng.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-immunization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationPreventiveCenter"
      },
      "name" : "Ví dụ: Trung tâm Kiểm soát bệnh tật tỉnh Quảng Ninh",
      "description" : "Trung tâm Kiểm soát bệnh tật tỉnh Quảng Ninh — ví dụ cơ sở y tế dự phòng, sử dụng hạng đơn vị y tế không phải cơ sở KCB.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationTTYTHangIV"
      },
      "name" : "Ví dụ: Trung tâm Y tế khu vực An Phú",
      "description" : "Trung tâm y tế khu vực An Phú — ví dụ đơn vị sự nghiệp y tế không phải bệnh viện, có hạng IV theo TT 06/2024/TT-BYT, đồng thời lưu tuyến chuyên môn kỹ thuật lịch sử để phục vụ chuyển đổi dữ liệu cũ.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Organization"
      }],
      "reference" : {
        "reference" : "Organization/ExampleOrganizationTramYTe"
      },
      "name" : "Ví dụ: Trạm Y tế phường Ngọc Hà",
      "description" : "Trạm y tế phường — cấp quản lý xã, cấp KCB ban đầu, không áp dụng phân hạng pháp lý.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Composition"
      }],
      "reference" : {
        "reference" : "Composition/ExampleCompositionDischargeSummary"
      },
      "name" : "Ví dụ: Tóm tắt xuất viện — Viêm phổi J18.9",
      "description" : "Tóm tắt xuất viện cho bệnh nhân Nguyễn Văn An điều trị viêm phổi nội trú tại BV Chợ Rẫy.\nLoại tài liệu: Discharge Summary (LOINC 18842-5). Per TT 13/2025/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-composition",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationLabUrinalysis"
      },
      "name" : "Ví dụ: Tổng phân tích nước tiểu (10 thông số)",
      "description" : "Kết quả tổng phân tích nước tiểu (TPTNT) — tất cả thông số trong giới hạn bình thường.\nLOINC: 24356-8 (Urinalysis panel). Sử dụng component[] cho các thông số định tính và định lượng.\nCăn cứ: QĐ 1227/QĐ-BYT (11/4/2025) — chỉ số CLS nhóm Vi sinh/Nước tiểu.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Consent"
      }],
      "reference" : {
        "reference" : "Consent/ExampleConsentDenyShare"
      },
      "name" : "Ví dụ: Từ chối chia sẻ DLCN y tế — tiếp thị và nghiên cứu",
      "description" : "Bệnh nhân Nguyễn Văn An từ chối sử dụng dữ liệu y tế cho mục đích tiếp thị và nghiên cứu.\nPer Luật 91/2025/QH15 Điều 12 — quyền rút lại đồng ý. NĐ 356/2025/NĐ-CP.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "PractitionerRole"
      }],
      "reference" : {
        "reference" : "PractitionerRole/ExamplePractitionerRole"
      },
      "name" : "Ví dụ: Vai trò BS CKII tại BV Chợ Rẫy",
      "description" : "Vai trò bác sĩ CKII Nguyễn Thị Lan tại Bệnh viện Chợ Rẫy,\nchức danh Bác sĩ chính (V.08.01.02), chuyên khoa Nội — Tim mạch, đang hoạt động.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "PractitionerRole"
      }],
      "reference" : {
        "reference" : "PractitionerRole/ExamplePractitionerRoleSpecialist"
      },
      "name" : "Ví dụ: Vai trò chuyên gia Tim mạch — BV Chợ Rẫy",
      "description" : "Vai trò BS CKII Nguyễn Thị Lan tại Khoa Tim mạch BV Chợ Rẫy.\nChức danh: Bác sĩ chính hạng II (V.08.01.02). Chuyên khoa: Tim mạch.\nMinh họa VNCorePractitionerRole đầy đủ per TT 41/2025/TT-BYT, TT 32/2023/TT-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "PractitionerRole"
      }],
      "reference" : {
        "reference" : "PractitionerRole/ExamplePractitionerRoleMinimal"
      },
      "name" : "Ví dụ: Vai trò NVYT tối thiểu",
      "description" : "Vai trò nhân viên y tế với thông tin tối thiểu: chỉ practitioner, organization và active.\nMinh họa VNCorePractitionerRole với các trường bắt buộc và Must Support tối giản.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Device"
      }],
      "reference" : {
        "reference" : "Device/ExampleDeviceVTYTN03Syringe"
      },
      "name" : "Ví dụ: VTYT tiêu hao — Bơm tiêm 5ml dùng một lần (N03, loại A)",
      "description" : "Bơm tiêm nhựa 5ml dùng một lần, có gắn kim 23G x 1\". Vật tư tiêu hao thuộc nhóm BHYT N03 (TT 04/2017/TT-BYT). Phân loại rủi ro loại A theo NĐ 98/2021/NĐ-CP đã được sửa đổi, bổ sung bởi NĐ 07/2023/NĐ-CP và NĐ 04/2025/NĐ-CP. TBYT loại A thực hiện công bố tiêu chuẩn áp dụng (không cấp số lưu hành) — không có extension registrationNumber.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionProblemHypertension"
      },
      "name" : "Ví dụ: Vấn đề sức khỏe tăng huyết áp",
      "description" : "Ví dụ Condition dạng problem-list-item dùng VNCoreCondition nền tảng, không phải chẩn đoán lượt khám. Mã hóa bằng SNOMED CT 38341003 và trạng thái lâm sàng active.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Device"
      }],
      "reference" : {
        "reference" : "Device/ExampleDeviceMinimal"
      },
      "name" : "Ví dụ: Vật tư y tế tối thiểu — Bơm tiêm 5ml",
      "description" : "Ví dụ VTYT tối thiểu — chỉ ghi nhận mã VTYT, loại, trạng thái.\nBơm tiêm 5ml dùng 1 lần. Không có thông tin manufacturer/lot (vật tư phổ thông).\nMinh họa mức tối thiểu cần thiết khi nhập VTYT vào hệ thống HIS.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationLabGlucose"
      },
      "name" : "Ví dụ: Xét nghiệm đường huyết lúc đói (LOINC)",
      "description" : "Kết quả xét nghiệm Glucose máu lúc đói = 6.8 mmol/L (cao).\nLOINC: 14771-0 (Fasting glucose [Moles/volume] in Serum or Plasma — đơn vị mmol/L).",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ServiceRequest"
      }],
      "reference" : {
        "reference" : "ServiceRequest/ExampleServiceRequestImagingChestXray"
      },
      "name" : "Ví dụ: Yêu cầu chụp X-quang ngực",
      "description" : "Yêu cầu chụp X-quang ngực thẳng cho bệnh nhân Nguyễn Văn An.\nChỉ định bởi BS CKII Nguyễn Thị Lan, BV Chợ Rẫy. Lý do: ho kéo dài, loại trừ viêm phổi.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ServiceRequest"
      }],
      "reference" : {
        "reference" : "ServiceRequest/example-servicerequest-chest-ct"
      },
      "name" : "Ví dụ: Yêu cầu CT lồng ngực ngoại trú",
      "description" : "Yêu cầu chụp CT lồng ngực ngoại trú cho bệnh nhân Nguyễn Văn An.\nChỉ định bởi BS CKII Nguyễn Thị Lan. Lý do: ho kéo dài, loại trừ tổn thương phổi.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ServiceRequest"
      }],
      "reference" : {
        "reference" : "ServiceRequest/example-servicerequest-abdominal-us"
      },
      "name" : "Ví dụ: Yêu cầu siêu âm bụng tổng quát",
      "description" : "Yêu cầu siêu âm bụng tổng quát cho bệnh nhân Nguyễn Văn An.\nChỉ định bởi BS CKII Nguyễn Thị Lan. Lý do: đau bụng chưa rõ nguyên nhân.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Claim"
      }],
      "reference" : {
        "reference" : "Claim/ExampleClaimBHYT"
      },
      "name" : "Ví dụ: Yêu cầu thanh toán BHYT nội trú",
      "description" : "Ví dụ yêu cầu thanh toán BHYT cho lượt nội trú viêm ruột thừa tại BV Chợ Rẫy.\nMapping từ XML 3176: MA_BN, MA_THE, MA_BENH=K35.8, T_TONGCHI.\n\tChi phí theo 5 nhóm per QĐ 697/QĐ-BYT (19/3/2026), gồm một dòng thiết bị y tế để minh họa deviceGroup trên Claim.item.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Claim"
      }],
      "reference" : {
        "reference" : "Claim/ExampleClaimMultiService"
      },
      "name" : "Ví dụ: Yêu cầu thanh toán BHYT — 6 nhóm chi phí (Viêm ruột thừa)",
      "description" : "Yêu cầu thanh toán BHYT cho BN Nguyễn Văn An — viêm ruột thừa cấp K35.8, phẫu thuật nội soi.\n6 nhóm chi phí per QĐ 697/QĐ-BYT: Khám(1), Giường(2.2), XN(3), CĐHA(4), Phẫu thuật(6), Thuốc(8).\nTổng: 15.720.000 VND.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Claim"
      }],
      "reference" : {
        "reference" : "Claim/ExampleClaimSelfPay"
      },
      "name" : "Ví dụ: Yêu cầu thanh toán tự chi trả — bệnh nhân nước ngoài",
      "description" : "Yêu cầu thanh toán tự chi trả cho bệnh nhân nước ngoài John Smith.\nKhông có BHYT Việt Nam — toàn bộ chi phí tự chi trả. Áp dụng giá dịch vụ theo yêu cầu.\nChẩn đoán: J06.9 (Nhiễm trùng đường hô hấp trên cấp tính). Per QĐ 3276/QĐ-BYT mã đối tượng 9.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ServiceRequest"
      }],
      "reference" : {
        "reference" : "ServiceRequest/ExampleServiceRequestLabGlucose"
      },
      "name" : "Ví dụ: Yêu cầu xét nghiệm đường huyết",
      "description" : "Yêu cầu xét nghiệm Glucose máu lúc đói cho bệnh nhân Nguyễn Văn An.\nChỉ định bởi BS CKII Nguyễn Thị Lan, BV Chợ Rẫy. Lý do: nghi ngờ đái tháo đường.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Condition"
      }],
      "reference" : {
        "reference" : "Condition/ExampleConditionDiabetes"
      },
      "name" : "Ví dụ: Đái tháo đường type 2 (ICD-10 + SNOMED CT)",
      "description" : "Chẩn đoán đái tháo đường type 2 với cả ICD-10 coding (E11.9) và SNOMED CT coding (44054006).\nMinh họa dual coding theo khuyến nghị VN Core.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition-diagnosis",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationYHCTPulse"
      },
      "name" : "Ví dụ: Đánh giá YHCT — Thiết chẩn mạch và vọng chẩn lưỡi",
      "description" : "Đánh giá YHCT cho bệnh nhân Yêu thống thể hàn thấp.\nTứ chẩn: Vọng (lưỡi nhợt — hàn thấp), Thiết (mạch trầm — hàn).\nLiên kết với ExampleConditionYHCTYeuThong (chẩn đoán YHCT).\nMinh họa cách dùng component cho đánh giá đa chiều theo QĐ 3080/QĐ-BYT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-yhct",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationYHCTSymptom"
      },
      "name" : "Ví dụ: Đánh giá YHCT — Vấn chẩn triệu chứng (Đau lưng thể hàn thấp)",
      "description" : "Vấn chẩn triệu chứng YHCT: đau lưng vùng thắt lưng (#6541000), đau tăng khi lạnh ẩm (#6541001), sợ lạnh (#6541004). Kết luận thể hàn thấp — phù hợp biện chứng Yêu thống. Per QĐ 2552/QĐ-BYT (12/8/2025) — Đợt 1 mã YHCT.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-yhct",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Observation"
      }],
      "reference" : {
        "reference" : "Observation/ExampleObservationYHCTTongue"
      },
      "name" : "Ví dụ: Đánh giá YHCT — Vọng chẩn lưỡi (Hàn thấp)",
      "description" : "Vọng chẩn lưỡi trong khám YHCT: chất lưỡi nhợt (#6581007), rêu trắng (#6581027), rêu dày (#6581026). Kết luận hàn thấp nội tích — phù hợp biện chứng Yêu thống thể hàn thấp. Per QĐ 3080/QĐ-BYT (26/9/2025) — Phụ lục II.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-yhct",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "MedicationRequest"
      }],
      "reference" : {
        "reference" : "MedicationRequest/ExampleMedicationRequestAmoxicillin"
      },
      "name" : "Ví dụ: Đơn thuốc Amoxicillin 500mg ngoại trú",
      "description" : "Đơn thuốc ngoại trú: Amoxicillin 500mg, uống 3 lần/ngày, sau ăn, 7 ngày.\nBệnh nhân Nguyễn Văn An, BHYT. Bác sĩ CKII Nguyễn Thị Lan kê đơn tại BV Chợ Rẫy.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Consent"
      }],
      "reference" : {
        "reference" : "Consent/ExampleConsentParentalProxy"
      },
      "name" : "Ví dụ: Đồng ý qua cha mẹ cho bệnh nhi",
      "description" : "Mẹ của bệnh nhi Nguyễn Minh Khôi ký đồng ý cho cơ sở khám chữa bệnh xử lý dữ liệu y tế của trẻ phục vụ khám chữa bệnh, bệnh án điện tử và thanh toán BHYT.\nVí dụ này minh họa category `parental-proxy` và performer là `VNCoreRelatedPerson`.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "Consent"
      }],
      "reference" : {
        "reference" : "Consent/ExampleConsentResearch"
      },
      "name" : "Ví dụ: Đồng ý tham gia nghiên cứu y khoa — 1 năm",
      "description" : "Bệnh nhân đồng ý cho BV Chợ Rẫy sử dụng dữ liệu y tế cho nghiên cứu khoa học.\nDữ liệu ẩn danh hóa per Luật 91/2025 + NĐ 356/2025. Thời hạn: 04/2026 — 04/2027.",
      "exampleCanonical" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent",
      "groupingId" : "examples"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-legal-document-ref-cs"
      },
      "name" : "Văn bản pháp lý VN — Vietnam Legal Document Reference CodeSystem",
      "description" : "Bộ mã structured cho các văn bản pháp luật Việt Nam được tham chiếu trong VN Core FHIR IG.\nMỗi concept là một văn bản pháp luật với property issuanceDate, effectiveDate, status, supersedes, supersededBy, issuingAuthority, officialUrl, shortName, relationshipNote, statusReviewedAt, statusEvidenceUrl, statusEvidenceNote.\n`officialUrl` được giữ để tương thích tooling hiện có; giá trị public ưu tiên trang thông tin văn bản exact tại Thư Viện Pháp Luật.\nMục tiêu: 1 nguồn truth duy nhất cho citation, hỗ trợ tooling validate citation hết hiệu lực, render bảng status theo date.\nPhân loại status:\n- in-force: đã hiệu lực, đang áp dụng\n- future-effective: đã ban hành, chưa hiệu lực\n- transition: đang trong giai đoạn chuyển tiếp\n- superseded: đã bị thay thế\n- expired: hết hiệu lực không có thay thế",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-legal-document-ref-vs"
      },
      "name" : "Văn bản pháp lý VN — Vietnam Legal Document Reference VS",
      "description" : "Tập giá trị tham chiếu văn bản pháp luật Việt Nam, bao gồm Luật, Nghị quyết, Nghị định, Thông tư, Quyết định và Văn bản hợp nhất.\nDùng cho extension VNCoreExtLegalBasis để tag legal basis structured trên artifact/element.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-body-site-vs"
      },
      "name" : "Vị trí giải phẫu — VN Core Body Site ValueSet",
      "description" : "Tập giá trị vị trí giải phẫu (body site) dựa trên SNOMED CT Body Structures.\nBYT Việt Nam đã ban hành 35.889 concepts Body Structure tiếng Việt (QĐ 2427/QĐ-BYT 2025, Đợt 1).\nKết hợp SNOMED CT IPS Terminology (miễn phí, CC-BY-4.0).\nBinding preferred — cho phép text mô tả nếu không có mã SNOMED phù hợp.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:extension"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-ext-ward"
      },
      "name" : "Xã/Phường (mã hóa) — Vietnam Ward/Commune Extension",
      "description" : "Mở rộng ghi nhận mã xã/phường/thị trấn theo QĐ 19/2025/QĐ-TTg trên Address.\nFHIR Address không có trường cho cấp xã (ward/commune) — extension này bổ sung.\nMã 5 chữ số (00001–99999) theo danh mục 3.321 đơn vị cấp xã.\nCăn cứ: NQ 202/2025/QH15, QĐ 19/2025/QĐ-TTg.",
      "exampleBoolean" : false,
      "groupingId" : "extensions"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-lab"
      },
      "name" : "Xét nghiệm VN Core — VN Core Observation Laboratory Profile",
      "description" : "Profile Observation cho kết quả xét nghiệm lâm sàng tại Việt Nam.\nSử dụng LOINC làm mã xét nghiệm (66.077 mã unique, bản dịch tiếng Việt do BYT phát hành).\nBYT đã ban hành bộ mã CLS quốc gia ánh xạ sang LOINC (QĐ 1227/QĐ-BYT 11/04/2025).\nCăn cứ: QĐ 1227/QĐ-BYT (2025), TT 13/2025/TT-BYT, QĐ 130/QĐ-BYT sửa đổi bởi QĐ 3176/QĐ-BYT (2024).",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-service-request"
      },
      "name" : "Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile",
      "description" : "Profile ServiceRequest cho Việt Nam. Dùng cho yêu cầu xét nghiệm, chẩn đoán hình ảnh,\nthăm dò chức năng, thủ thuật, phẫu thuật, khám chuyên khoa, phục hồi chức năng, YHCT.\nCăn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), TT 20/2014/TT-BYT + TT 39/2018/TT-BYT (danh mục DVKT),\nQĐ 3176/QĐ-BYT (chuẩn dữ liệu BHXH — trường MA_DVKT).\nMã hóa dịch vụ bằng ICD-9-CM (QĐ 387/2026), SNOMED CT, hoặc mã DVKT VN. /\nVN Core ServiceRequest profile for medical service orders: lab tests, diagnostic imaging,\nfunctional diagnostics, procedures, surgery, specialist consultations, rehabilitation, traditional medicine.\nPer TT 13/2025/TT-BYT (EMR), TT 20/2014 + TT 39/2018 (DVKT catalog),\nQĐ 3176/QĐ-BYT (BHXH data — MA_DVKT field).",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-claim"
      },
      "name" : "Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile",
      "description" : "Profile Claim cho Việt Nam. Dùng cho yêu cầu thanh toán chi phí khám chữa bệnh BHYT.\nMapping từ chuẩn dữ liệu đầu ra phục vụ BHXH hiện hành (QĐ 130 → QĐ 4750 → QĐ 3176).\nBảng kê chi phí theo QĐ 697/QĐ-BYT (19/3/2026) — 12 danh mục, 14 mã.\nCăn cứ:\n- QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu đầu ra phục vụ BHXH\n- QĐ 4750/QĐ-BYT (2023) — Sửa đổi QĐ 130\n- QĐ 3176/QĐ-BYT (29/10/2024) — Sửa đổi QĐ 4750\n- QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB (thay QĐ 6556)\n- NĐ 188/2025/NĐ-CP — ban hành 01/07/2025, hiệu lực 15/08/2025 — Hướng dẫn thi hành Luật BHYT, Điều 15 về giá trị sử dụng thẻ và Điều 22 về nhiều thẻ BHYT\n- NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — Xử phạt vi phạm hành chính trong lĩnh vực y tế khi hồ sơ/chứng từ BHYT sai quy định\n- Luật BHYT 2008 sửa đổi 2014\n- Luật 25/2008/QH12 ngày 14/11/2008 về BHYT; Luật 51/2024/QH15 ngày 27/11/2024 sửa đổi Luật BHYT\nNguồn TVPL: NĐ 188/2025/NĐ-CP https://thuvienphapluat.vn/van-ban/Bao-hiem/Nghi-dinh-188-2025-ND-CP-huong-dan-Luat-Bao-hiem-y-te-641049.aspx; NĐ 90/2026/NĐ-CP https://thuvienphapluat.vn/van-ban/Vi-pham-hanh-chinh/Nghi-dinh-sua-doi-Nghi-dinh-117-2020-ND-CP-xu-phat-vi-pham-hanh-chinh-trong-linh-vuc-y-te-639959.aspx",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ConceptMap"
      }],
      "reference" : {
        "reference" : "ConceptMap/vn-cm-cls-to-loinc"
      },
      "name" : "Ánh xạ CLS VN → LOINC — Vietnam CLS to LOINC ConceptMap",
      "description" : "ConceptMap ánh xạ mã chỉ số cận lâm sàng Việt Nam (CLS VN) sang mã LOINC quốc tế.\nCăn cứ: QĐ 1227/QĐ-BYT (11/04/2025) — Danh mục mã dùng chung chỉ số cận lâm sàng (Đợt 1).\n2.964 chỉ số, 100% coverage ánh xạ LOINC (Regenstrief Institute).\n\n5 nhóm:\n- PL01: Huyết học — Truyền máu (1.022 chỉ số)\n- PL02: Sinh hóa (447 chỉ số)\n- PL03: Vi sinh (174 chỉ số)\n- PL04: Giải phẫu bệnh (81 chỉ số)\n- PL05: Chẩn đoán hình ảnh (1.240 chỉ số)\n\nDữ liệu mapping đầy đủ tại: data/cls/qd1227_cls_loinc_mapping.json\nVí dụ dưới đây chỉ bao gồm 5 mã đại diện (1 mã/nhóm).",
      "exampleBoolean" : false,
      "groupingId" : "conceptmaps"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ConceptMap"
      }],
      "reference" : {
        "reference" : "ConceptMap/vn-cm-qd3176-cost-group-to-q697-cost-category"
      },
      "name" : "Ánh xạ MA_NHOM QĐ 3176 → Nhóm chi phí QĐ 697",
      "description" : "ConceptMap ánh xạ mã `MA_NHOM` trong XML2/XML3 theo QĐ 3176/QĐ-BYT sang `VNCostCategoryCS` theo QĐ 697/QĐ-BYT. Dùng trong lớp export/import BHYT; không dùng trực tiếp mã nguồn QĐ 3176 như mã đích QĐ 697.",
      "exampleBoolean" : false,
      "groupingId" : "conceptmaps"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ConceptMap"
      }],
      "reference" : {
        "reference" : "ConceptMap/vn-cm-bhyt-financial-field-to-adjudication"
      },
      "name" : "Ánh xạ trường tổng tiền BHYT → FHIR adjudication",
      "description" : "ConceptMap ánh xạ các trường tổng tiền BHYT từ QĐ 3176/QĐ-BYT và bối cảnh bảng kê/giám định sang category dùng trong `ClaimResponse.total`, `ExplanationOfBenefit.total` và `VNCoreExtClaimCostSummary`. ConceptMap này chỉ chuẩn hóa mã category; không encode công thức quyền lợi, tỷ lệ hưởng, trần thanh toán hoặc catalog lý do từ chối của payer. Các trường breakdown nguồn khác `T_NGUONKHAC_NSNN`, `T_NGUONKHAC_VTNN`, `T_NGUONKHAC_VTTN`, `T_NGUONKHAC_CL` hiện được giữ ở source terminology và chưa map ra target riêng.",
      "exampleBoolean" : false,
      "groupingId" : "conceptmaps"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ConceptMap"
      }],
      "reference" : {
        "reference" : "ConceptMap/vn-cm-religion-to-v3-religious-affiliation"
      },
      "name" : "Ánh xạ tôn giáo Việt Nam → ReligiousAffiliation — Vietnam Religion to HL7 Religious Affiliation",
      "description" : "ConceptMap ánh xạ một phần danh mục tôn giáo Việt Nam sang bộ mã `v3-ReligiousAffiliation` của HL7.\nChỉ khai báo các ánh xạ có thể bảo vệ được về ngữ nghĩa. Các mã kỹ thuật như `00 = Không tôn giáo`, `99 = Không rõ`\nvà các tôn giáo bản địa hoặc nhóm chuyên biệt chưa có tương đương rõ trong `v3-ReligiousAffiliation` sẽ không bị ép ánh xạ.",
      "exampleBoolean" : false,
      "groupingId" : "conceptmaps"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-observation-yhct"
      },
      "name" : "Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile",
      "description" : "Profile Observation cho đánh giá Y học cổ truyền (YHCT) tại Việt Nam.\nDùng cho các phương pháp tứ chẩn: Vọng (nhìn — lưỡi, sắc mặt), Văn (nghe/ngửi),\nVấn (hỏi — triệu chứng), Thiết (bắt mạch).\nLiên kết với VNCoreCondition (chẩn đoán YHCT) và VNCoreProcedure (kỹ thuật YHCT).\nCăn cứ: QĐ 2552/QĐ-BYT (12/8/2025) — Đợt 1 mã YHCT,\nQĐ 3080/QĐ-BYT (26/9/2025) — Đợt 2 mã YHCT.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-medication-request"
      },
      "name" : "Đơn thuốc VN Core — VN Core MedicationRequest Profile",
      "description" : "Profile MedicationRequest cho Việt Nam. Dùng cho đơn thuốc điện tử (ePrescription).\nHỗ trợ đơn thuốc ngoại trú, nội trú, cấp cứu. Liên kết với BHYT qua Coverage/Claim.\nCăn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 130/QĐ-BYT sửa đổi bởi QĐ 3176/QĐ-BYT (trường MA_THUOC trong chuẩn dữ liệu BHXH),\nLuật Dược 2016 Điều 74 (kê đơn thuốc).\nCăn cứ bổ sung:\n- **Luật 44/2024/QH15** — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025\n- **TT 26/2025/TT-BYT** — 30/6/2025 — kê đơn thuốc hóa dược, sinh phẩm trong điều trị ngoại trú; hiệu lực 01/7/2025\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản lý dữ liệu y tế số và dữ liệu đơn thuốc trong CSDL quốc gia về y tế. /\nVN Core MedicationRequest profile for electronic prescriptions (ePrescription).\nSupports outpatient, inpatient, and emergency prescriptions. Links to insurance via Coverage/Claim.\nPer TT 13/2025/TT-BYT (EMR), QĐ 3176/QĐ-BYT (BHXH data standard — MA_THUOC field),\nPharmaceutical Law 2016 Art.74 and amended by Law 44/2024/QH15; TT 26/2025/TT-BYT for outpatient/electronic prescribing.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "CodeSystem"
      }],
      "reference" : {
        "reference" : "CodeSystem/vn-medication-route-cs"
      },
      "name" : "Đường dùng thuốc — Vietnam Medication Route CodeSystem",
      "description" : "Danh mục đường dùng thuốc theo quy định của Bộ Y tế Việt Nam.\nPhân loại 7 nhóm: uống, tiêm, bôi ngoài, đặt, hô hấp, mắt/tai, khác.\nCăn cứ: Dược điển Việt Nam, Luật Dược 2016, thực hành lâm sàng BV.\nNguồn dữ liệu: OHP Data Processor (production mapping).",
      "exampleBoolean" : false,
      "groupingId" : "codesystems"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "ValueSet"
      }],
      "reference" : {
        "reference" : "ValueSet/vn-medication-route-vs"
      },
      "name" : "Đường dùng thuốc — Vietnam Medication Route ValueSet",
      "description" : "Tập giá trị đường dùng thuốc theo BYT. Dùng cho MedicationRequest.dosageInstruction.route.",
      "exampleBoolean" : false,
      "groupingId" : "valuesets"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:complex-type"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-address"
      },
      "name" : "Địa chỉ VN Core — VN Core Address Profile",
      "description" : "Profile Address cho Việt Nam, hỗ trợ ĐVHC mới theo NQ 202/2025 (34 tỉnh, 3.321 xã).\nBổ sung extension mã hóa tỉnh/TP và xã/phường. Cấp huyện (district) giữ lại cho backward-compatible\nnhưng KHÔNG Must Support — khuyến khích dùng extension:province + extension:ward.\nCăn cứ:\n- **NQ 202/2025/QH15** — 12/6/2025 — sắp xếp ĐVHC cấp tỉnh, mô hình 2 cấp từ 01/7/2025\n- **QĐ 19/2025/QĐ-TTg** — 2025 — danh mục mã tỉnh/xã mới dùng cho địa chỉ.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-location"
      },
      "name" : "Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile",
      "description" : "Profile Location cho khoa, phòng, buồng khám, buồng bệnh hoặc khu vực chuyên môn trực thuộc cơ sở y tế Việt Nam. Dùng để tách rõ địa điểm cung cấp dịch vụ khỏi Organization và hỗ trợ liên kết PractitionerRole, ServiceRequest, DiagnosticReport cùng các use case EMR nội bộ. Căn cứ: TT 13/2025/TT-BYT, Luật KCB 2023, định hướng chuẩn hóa FHIR-native theo JP Core và CH Core.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    },
    {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
        "valueString" : "StructureDefinition:resource"
      }],
      "reference" : {
        "reference" : "StructureDefinition/vn-core-consent"
      },
      "name" : "Đồng ý xử lý dữ liệu VN Core — VN Core Consent Profile",
      "description" : "Profile Consent cho Việt Nam, tuân thủ Luật 91/2025/QH15 (Bảo vệ dữ liệu cá nhân)\nvà NĐ 356/2025/NĐ-CP. Ghi nhận sự đồng ý/từ chối xử lý dữ liệu y tế cá nhân,\nbao gồm mục đích xử lý, phạm vi, thời hạn, và quyền rút lại đồng ý.\nDữ liệu y tế = dữ liệu cá nhân nhạy cảm (Luật 91/2025 Điều 3 khoản 4).\nCăn cứ:\n- **Luật 91/2025/QH15** — 26/6/2025 — quyền chủ thể dữ liệu tại Điều 13-17, đồng ý/rút lại đồng ý và xử lý dữ liệu nhạy cảm\n- **NĐ 356/2025/NĐ-CP** — 31/12/2025 — hướng dẫn BVDLCN, hồ sơ đánh giá tác động và lưu bằng chứng đồng ý\n- **NĐ 278/2025/NĐ-CP** — ban hành 22/10/2025, hiệu lực từ ngày ký 22/10/2025 — chia sẻ dữ liệu bắt buộc, cần kiểm soát bằng Consent/policy khi chia sẻ ngoài cơ sở KCB; mốc chuẩn hóa/kết nối thống nhất chậm nhất 31/12/2026\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản lý dữ liệu y tế số.",
      "exampleBoolean" : false,
      "groupingId" : "profiles"
    }],
    "page" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
        "valueUrl" : "toc.html"
      }],
      "nameUrl" : "toc.html",
      "title" : "Table of Contents",
      "generation" : "html",
      "page" : [{
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "index.html"
        }],
        "nameUrl" : "index.html",
        "title" : "Trang chủ",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "getting-started.html"
        }],
        "nameUrl" : "getting-started.html",
        "title" : "Bắt đầu nhanh",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "general-guidance.html"
        }],
        "nameUrl" : "general-guidance.html",
        "title" : "Hướng dẫn chung",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "identifier-registry.html"
        }],
        "nameUrl" : "identifier-registry.html",
        "title" : "Registry định danh",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "must-support-guidance.html"
        }],
        "nameUrl" : "must-support-guidance.html",
        "title" : "Hướng dẫn Must Support",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "search-behavior.html"
        }],
        "nameUrl" : "search-behavior.html",
        "title" : "Hành vi tìm kiếm",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "string-search-guidance.html"
        }],
        "nameUrl" : "string-search-guidance.html",
        "title" : "Tìm kiếm chuỗi & Unicode",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "validation-guidance.html"
        }],
        "nameUrl" : "validation-guidance.html",
        "title" : "Hướng dẫn Validation",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "terminology-guidance.html"
        }],
        "nameUrl" : "terminology-guidance.html",
        "title" : "Hướng dẫn thuật ngữ",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "profiles.html"
        }],
        "nameUrl" : "profiles.html",
        "title" : "Hồ sơ (Profiles)",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "extensions.html"
        }],
        "nameUrl" : "extensions.html",
        "title" : "Mở rộng (Extensions)",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "terminology.html"
        }],
        "nameUrl" : "terminology.html",
        "title" : "Thuật ngữ (Terminology)",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "clinical-scenarios.html"
        }],
        "nameUrl" : "clinical-scenarios.html",
        "title" : "Tình huống lâm sàng",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "bhyt-submission.html"
        }],
        "nameUrl" : "bhyt-submission.html",
        "title" : "Liên thông hồ sơ BHYT",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "conformance-by-actor.html"
        }],
        "nameUrl" : "conformance-by-actor.html",
        "title" : "Tuân thủ theo vai trò triển khai",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "pilot-readiness-checklists.html"
        }],
        "nameUrl" : "pilot-readiness-checklists.html",
        "title" : "Checklist sẵn sàng thí điểm theo vai trò",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "legal-basis.html"
        }],
        "nameUrl" : "legal-basis.html",
        "title" : "Cơ sở pháp lý",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "security.html"
        }],
        "nameUrl" : "security.html",
        "title" : "Bảo mật và Quyền riêng tư",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "package-architecture.html"
        }],
        "nameUrl" : "package-architecture.html",
        "title" : "Kiến trúc gói phát hành",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "stability-and-conformance.html"
        }],
        "nameUrl" : "stability-and-conformance.html",
        "title" : "Ổn định & Conformance",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "release-governance.html"
        }],
        "nameUrl" : "release-governance.html",
        "title" : "Phát hành & Governance",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "design-decisions.html"
        }],
        "nameUrl" : "design-decisions.html",
        "title" : "Quyết định thiết kế",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "organization-location-governance.html"
        }],
        "nameUrl" : "organization-location-governance.html",
        "title" : "Governance cho Organization và Location",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "snomed-vn-errata.html"
        }],
        "nameUrl" : "snomed-vn-errata.html",
        "title" : "SNOMED CT VN — Đính chính",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "downloads.html"
        }],
        "nameUrl" : "downloads.html",
        "title" : "Tải xuống",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "changelog.html"
        }],
        "nameUrl" : "changelog.html",
        "title" : "Lịch sử thay đổi",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "about.html"
        }],
        "nameUrl" : "about.html",
        "title" : "Giới thiệu (redirect)",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "legal-matrix.html"
        }],
        "nameUrl" : "legal-matrix.html",
        "title" : "Ma trận pháp lý (redirect)",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "identifier-and-oid-mapping.html"
        }],
        "nameUrl" : "identifier-and-oid-mapping.html",
        "title" : "Ánh xạ URI/OID (redirect)",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "editorial-conventions.html"
        }],
        "nameUrl" : "editorial-conventions.html",
        "title" : "Quy ước biên tập (redirect)",
        "generation" : "markdown"
      },
      {
        "extension" : [{
          "url" : "http://hl7.org/fhir/tools/StructureDefinition/ig-page-name",
          "valueUrl" : "implementation-reports.html"
        }],
        "nameUrl" : "implementation-reports.html",
        "title" : "Báo cáo triển khai (redirect)",
        "generation" : "markdown"
      }]
    },
    "parameter" : [{
      "code" : "path-resource",
      "value" : "input/capabilities"
    },
    {
      "code" : "path-resource",
      "value" : "input/examples"
    },
    {
      "code" : "path-resource",
      "value" : "input/extensions"
    },
    {
      "code" : "path-resource",
      "value" : "input/models"
    },
    {
      "code" : "path-resource",
      "value" : "input/operations"
    },
    {
      "code" : "path-resource",
      "value" : "input/profiles"
    },
    {
      "code" : "path-resource",
      "value" : "input/resources"
    },
    {
      "code" : "path-resource",
      "value" : "input/vocabulary"
    },
    {
      "code" : "path-resource",
      "value" : "input/maps"
    },
    {
      "code" : "path-resource",
      "value" : "input/testing"
    },
    {
      "code" : "path-resource",
      "value" : "input/history"
    },
    {
      "code" : "path-resource",
      "value" : "fsh-generated/resources"
    },
    {
      "code" : "path-pages",
      "value" : "template/config"
    },
    {
      "code" : "path-pages",
      "value" : "input/assets"
    },
    {
      "code" : "path-pages",
      "value" : "input/images"
    },
    {
      "code" : "path-tx-cache",
      "value" : "input-cache/txcache"
    }]
  }
}

```
