HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Loại tổng hợp adjudication BHYT — BHYT Adjudication Category CodeSystem

Active tại thời điểm 2026-04-23

Bản thô json | Tải xuống

{
  "resourceType" : "CodeSystem",
  "id" : "vn-bhyt-adjudication-category-cs",
  "language" : "vi",
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem vn-bhyt-adjudication-category-cs</b></p><a name=\"vn-bhyt-adjudication-category-cs\"> </a><a name=\"hcvn-bhyt-adjudication-category-cs\"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs</code> defines the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>English (English, en)</b></td></tr><tr><td style=\"white-space:nowrap\">patient-self-pay<a name=\"vn-bhyt-adjudication-category-cs-patient-self-pay\"> </a></td><td>Người bệnh tự trả</td><td>Phần người bệnh tự trả ngoài phần cùng chi trả BHYT (`T_BNTT`).</td><td>Patient self-pay</td></tr><tr><td style=\"white-space:nowrap\">other-fund<a name=\"vn-bhyt-adjudication-category-cs-other-fund\"> </a></td><td>Nguồn khác</td><td>Phần chi phí từ nguồn khác (`T_NGUONKHAC`). Breakdown theo nguồn cụ thể cần extension hoặc model bổ sung khi pilot yêu cầu.</td><td>Other source</td></tr><tr><td style=\"white-space:nowrap\">non-covered<a name=\"vn-bhyt-adjudication-category-cs-non-covered\"> </a></td><td>Ngoài phạm vi/ngoài định suất</td><td>Chi phí ngoài phạm vi hoặc ngoài định suất theo hồ sơ BHYT (`T_NGOAIDS`); không đồng nhất với deductible.</td><td>Out-of-scope/out-of-capitation</td></tr><tr><td style=\"white-space:nowrap\">medication-subtotal<a name=\"vn-bhyt-adjudication-category-cs-medication-subtotal\"> </a></td><td>Tổng thuốc, dịch truyền</td><td>Subtotal nhóm thuốc/dịch truyền (`T_THUOC`), dùng cho total/cost summary thay vì line-level adjudication.</td><td>Total medications and infusion fluids</td></tr><tr><td style=\"white-space:nowrap\">supplies-subtotal<a name=\"vn-bhyt-adjudication-category-cs-supplies-subtotal\"> </a></td><td>Tổng vật tư/thiết bị y tế</td><td>Subtotal nhóm vật tư/thiết bị y tế (`T_VTYT`), dùng cho total/cost summary thay vì line-level adjudication.</td><td>Total medical supplies/equipment</td></tr></table></div>"
  },
  "extension" : [
    {
      "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
      "valueCoding" : {
        "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
        "code" : "QD-3176-2024"
      }
    },
    {
      "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
      "valueCoding" : {
        "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
        "code" : "QD-697-2026"
      }
    }
  ],
  "url" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs",
  "version" : "0.6.0",
  "name" : "VNBHYTAdjudicationCategoryCS",
  "title" : "Loại tổng hợp adjudication BHYT — BHYT Adjudication Category CodeSystem",
  "status" : "active",
  "experimental" : false,
  "date" : "2026-04-23",
  "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" : "info@hl7.org.vn"
        }
      ]
    }
  ],
  "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.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "VN",
          "display" : "Viet Nam"
        }
      ]
    }
  ],
  "copyright" : "VN Core local terminology; based on financial fields in QĐ 3176/QĐ-BYT and QĐ 697/QĐ-BYT mapping requirements.",
  "caseSensitive" : true,
  "content" : "complete",
  "count" : 5,
  "concept" : [
    {
      "code" : "patient-self-pay",
      "display" : "Người bệnh tự trả",
      "definition" : "Phần người bệnh tự trả ngoài phần cùng chi trả BHYT (`T_BNTT`).",
      "designation" : [
        {
          "language" : "en",
          "value" : "Patient self-pay"
        }
      ]
    },
    {
      "code" : "other-fund",
      "display" : "Nguồn khác",
      "definition" : "Phần chi phí từ nguồn khác (`T_NGUONKHAC`). Breakdown theo nguồn cụ thể cần extension hoặc model bổ sung khi pilot yêu cầu.",
      "designation" : [
        {
          "language" : "en",
          "value" : "Other source"
        }
      ]
    },
    {
      "code" : "non-covered",
      "display" : "Ngoài phạm vi/ngoài định suất",
      "definition" : "Chi phí ngoài phạm vi hoặc ngoài định suất theo hồ sơ BHYT (`T_NGOAIDS`); không đồng nhất với deductible.",
      "designation" : [
        {
          "language" : "en",
          "value" : "Out-of-scope/out-of-capitation"
        }
      ]
    },
    {
      "code" : "medication-subtotal",
      "display" : "Tổng thuốc, dịch truyền",
      "definition" : "Subtotal nhóm thuốc/dịch truyền (`T_THUOC`), dùng cho total/cost summary thay vì line-level adjudication.",
      "designation" : [
        {
          "language" : "en",
          "value" : "Total medications and infusion fluids"
        }
      ]
    },
    {
      "code" : "supplies-subtotal",
      "display" : "Tổng vật tư/thiết bị y tế",
      "definition" : "Subtotal nhóm vật tư/thiết bị y tế (`T_VTYT`), dùng cho total/cost summary thay vì line-level adjudication.",
      "designation" : [
        {
          "language" : "en",
          "value" : "Total medical supplies/equipment"
        }
      ]
    }
  ]
}