HL7 Vietnam VN Core FHIR Implementation Guide

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

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

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

URL chính thức: http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-cs | Phiên bản: 0.5.0 | Làm nổi bật phần thay đổi?
| Computable Name: VNBHYTReviewIssueCS

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

This case-sensitive code system `http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-cs` defines the following codes:

Code | Display | Definition | English (English, en)
GATEWAY_RECEPTION_ERROR | Lỗi tiếp nhận cổng | 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ý. | Gateway reception error
FIELD_ADJUSTMENT_REQUIRED | Cần điều chỉnh trường dữ liệu | 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. | Field adjustment required
LEGAL_NON_COMPLIANT_COST | Chi phí không đúng quy định pháp luật | 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ừ. | Legally non-compliant cost
MANUAL_REVIEW_REQUIRED | Cần giám định chủ động/trực tiếp | 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. | Manual review required
PENDING_SETTLEMENT | Chi phí chưa quyết toán | Khoản chi đang treo hoặc chưa đủ điều kiện quyết toán tại kỳ hiện tại. | Pending settlement
PAYMENT_RECONCILIATION_VARIANCE | Chênh lệch thanh toán/quyết toán | 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. | Payment or settlement reconciliation variance

Mô tả các bảng ở trên.