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

ValueSet: Loại adjudication BHYT — BHYT Adjudication Category ValueSet

URL chính thức: http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs Phiên bản: 0.10.0
Computable Name: VNBHYTAdjudicationCategoryVS
Định danh khác: OID:2.25.161089673617632664299011809196868855799.48.9

Bản quyền/Pháp lý: HL7 Terminology adjudication CodeSystem + VN Core local BHYT adjudication categories.

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ứ.

References

Logical Definition (CLD)

This value set includes codes based on the following rules:

 

Khai triển

This value set contains 15 concepts

SystemCodeDisplay (vi)DefinitionJSONXML
http://terminology.hl7.org/CodeSystem/adjudication  submittedThe total submitted amount for the claim or group or line item.
http://terminology.hl7.org/CodeSystem/adjudication  copayPatient Co-Payment
http://terminology.hl7.org/CodeSystem/adjudication  eligibleAmount of the change which is considered for adjudication.
http://terminology.hl7.org/CodeSystem/adjudication  deductibleAmount deducted from the eligible amount prior to adjudication.
http://terminology.hl7.org/CodeSystem/adjudication  unallocdeductThe amount of deductible which could not allocated to other line items.
http://terminology.hl7.org/CodeSystem/adjudication  eligpercentEligible Percentage.
http://terminology.hl7.org/CodeSystem/adjudication  taxThe amount of tax.
http://terminology.hl7.org/CodeSystem/adjudication  benefitAmount payable under the coverage
http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs  patient-self-payPatient self-payPhần người bệnh tự trả ngoài phần cùng chi trả BHYT (`T_BNTT`).
http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs  other-fundOther sourcePhầ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.
http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs  non-coveredOut-of-capitation cost (paid by the fund, outside the capitation package)Chi phí NGOÀI ĐỊNH SUẤT (`T_NGOAIDS`) — phần quỹ BHYT vẫn chi trả nhưng ngoài gói khoán định suất; KHÔNG phải chi phí bị loại khỏi phạm vi hưởng. QĐ 4210/QĐ-BYT Bảng 2 STT 22: "T_NGOAIDS = T_BHTT đối với các chi phí ngoài định suất". CẢNH BÁO ĐẶT TÊN: slug `non-covered` là tên lịch sử đã công bố từ bản trước, đọc theo nghĩa tiếng Anh sẽ HIỂU NGƯỢC; giữ mã để không phá dữ liệu đã trao đổi, nghĩa chuẩn là out-of-capitation. Phần người bệnh tự trả dùng `patient-self-pay` (`T_BNTT`); khoản bị từ chối dùng `denied`.
http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs  medication-subtotalTotal medications and infusion fluidsSubtotal nhóm thuốc/dịch truyền (`T_THUOC`), dùng cho total/cost summary thay vì line-level adjudication.
http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs  supplies-subtotalTotal medical supplies/equipmentSubtotal nhóm vật tư/thiết bị y tế (`T_VTYT`), dùng cho total/cost summary thay vì line-level adjudication.
http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs  deniedDenied amountKhoản tiền bị TỪ CHỐI sau khi giám định, theo NĐ 188/2025/NĐ-CP Điều 51 khoản 1: chi phí được xác định không đúng quy định pháp luật về BHYT và khám bệnh, chữa bệnh, trong quá trình giám định và trước khi thanh toán. Bắt buộc kèm số tiền, lý do và ít nhất một căn cứ pháp lý (Điều 51 khoản 2). KHÔNG dùng cho lỗi khiến hồ sơ không thể được xử lý — lỗi đó thuộc ClaimResponse.error theo semantics FHIR R4.
http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs  recoveredRecovered amountKhoản tiền đã thanh toán nhưng bị THU HỒI theo NĐ 188/2025/NĐ-CP Điều 52. Khác từ chối ở thời điểm và ở chứng từ: từ chối xảy ra TRƯỚC thanh toán và ghi trong biên bản giám định (Điều 51 khoản 2), còn thu hồi xảy ra SAU thanh toán và ghi trong VĂN BẢN thu hồi do giám đốc cơ quan bảo hiểm xã hội ban hành, phải nêu căn cứ pháp lý, nội dung vi phạm, số tiền, thời hạn và trách nhiệm (Điều 52 khoản 2).

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