# Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue CodeSystem - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## CodeSystem: Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue CodeSystem 

 
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`. Danh 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. Đâ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. 

This Code system is referenced in the definition of the following value sets:

* [VNBHYTReviewIssueVS](ValueSet-vn-bhyt-review-issue-vs.md)

-------

 [Mô tả các bảng ở trên](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#terminology). 



## Resource Content

```json
{
  "resourceType" : "CodeSystem",
  "id" : "vn-bhyt-review-issue-cs",
  "url" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-cs",
  "version" : "0.5.0",
  "name" : "VNBHYTReviewIssueCS",
  "title" : "Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue CodeSystem",
  "status" : "draft",
  "experimental" : false,
  "date" : "2026-04-24",
  "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" : "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.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "purpose" : "Interim grouping vocabulary for BHYT claim review issues. Use as a baseline for ClaimResponse.error and OperationOutcome.issue.details until an official gateway/payer code list with stable provenance is available.",
  "caseSensitive" : true,
  "content" : "complete",
  "count" : 6,
  "concept" : [{
    "code" : "GATEWAY_RECEPTION_ERROR",
    "display" : "Lỗi tiếp nhận cổng",
    "definition" : "Lỗi kỹ thuật hoặc cấu trúc hồ sơ do Cổng tiếp nhận trả về trước hoặc trong quá trình xử lý.",
    "designation" : [{
      "language" : "en",
      "value" : "Gateway reception error"
    }]
  },
  {
    "code" : "FIELD_ADJUSTMENT_REQUIRED",
    "display" : "Cần điều chỉnh trường dữ liệu",
    "definition" : "Hồ sơ cần chỉnh sửa trường dữ liệu, định danh, ngày giờ hoặc metadata trước khi được tiếp tục xử lý/quyết toán.",
    "designation" : [{
      "language" : "en",
      "value" : "Field adjustment required"
    }]
  },
  {
    "code" : "LEGAL_NON_COMPLIANT_COST",
    "display" : "Chi phí không đúng quy định pháp luật",
    "definition" : "Khoản chi không đáp ứng quy định pháp luật hoặc phạm vi thanh toán BHYT nên bị từ chối/giảm trừ.",
    "designation" : [{
      "language" : "en",
      "value" : "Legally non-compliant cost"
    }]
  },
  {
    "code" : "MANUAL_REVIEW_REQUIRED",
    "display" : "Cần giám định chủ động/trực tiếp",
    "definition" : "Trường hợp cần giám định chủ động hoặc đối chiếu hồ sơ/tài liệu bổ sung thay vì chỉ giám định tự động.",
    "designation" : [{
      "language" : "en",
      "value" : "Manual review required"
    }]
  },
  {
    "code" : "PENDING_SETTLEMENT",
    "display" : "Chi phí chưa quyết toán",
    "definition" : "Khoản chi đang treo hoặc chưa đủ điều kiện quyết toán tại kỳ hiện tại.",
    "designation" : [{
      "language" : "en",
      "value" : "Pending settlement"
    }]
  },
  {
    "code" : "PAYMENT_RECONCILIATION_VARIANCE",
    "display" : "Chênh lệch thanh toán/quyết toán",
    "definition" : "Có chênh lệch giữa số đề nghị, số tổng hợp quyết toán và số thanh toán/thu hồi cần đối soát tiếp.",
    "designation" : [{
      "language" : "en",
      "value" : "Payment or settlement reconciliation variance"
    }]
  }]
}

```
