HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.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.10.0
Computable Name: VNBHYTReviewIssueCS
Định danh khác: OID:2.25.161089673617632664299011809196868855799.16.14

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.adjudication.reason (kết quả giám định) và ClaimResponse.error.code (lỗi xử lý) — hai tầng KHÁC NHAU, xem hai ValueSet con VNBHYTProcessingIssueVS/VNBHYTAdjudicationIssueVS. 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ã hoá tự do khi pilot.

PHÂN ĐỊNH NGUỒN (09/09/2026): danh mục và mã trong bộ này DO VN CORE ĐẶT (khai local-design) — đã quét 400 bản trích và không tìm thấy văn bản pháp luật nào ban hành danh mục tương ứng. Các văn bản khai kèm giữ vai governing/foundational: chúng quy định NGHĨA VỤ và CÁCH DÙNG, không ban hành bộ mã. Không đọc mã ở đây thành mã do cơ quan nhà nước ban hành.

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

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

CodeDisplayDefinitionEnglish (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.