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 - Draft for Community Review (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-04-24 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="vn-bhyt-review-issue-cs"/>
<language value="vi"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem vn-bhyt-review-issue-cs</b></p><a name="vn-bhyt-review-issue-cs"> </a><a name="hcvn-bhyt-review-issue-cs"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-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">GATEWAY_RECEPTION_ERROR<a name="vn-bhyt-review-issue-cs-GATEWAY_RECEPTION_ERROR"> </a></td><td>Lỗi tiếp nhận cổng</td><td>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ý.</td><td>Gateway reception error</td></tr><tr><td style="white-space:nowrap">FIELD_ADJUSTMENT_REQUIRED<a name="vn-bhyt-review-issue-cs-FIELD_ADJUSTMENT_REQUIRED"> </a></td><td>Cần điều chỉnh trường dữ liệu</td><td>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.</td><td>Field adjustment required</td></tr><tr><td style="white-space:nowrap">LEGAL_NON_COMPLIANT_COST<a name="vn-bhyt-review-issue-cs-LEGAL_NON_COMPLIANT_COST"> </a></td><td>Chi phí không đúng quy định pháp luật</td><td>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ừ.</td><td>Legally non-compliant cost</td></tr><tr><td style="white-space:nowrap">MANUAL_REVIEW_REQUIRED<a name="vn-bhyt-review-issue-cs-MANUAL_REVIEW_REQUIRED"> </a></td><td>Cần giám định chủ động/trực tiếp</td><td>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.</td><td>Manual review required</td></tr><tr><td style="white-space:nowrap">PENDING_SETTLEMENT<a name="vn-bhyt-review-issue-cs-PENDING_SETTLEMENT"> </a></td><td>Chi phí chưa quyết toán</td><td>Khoản chi đang treo hoặc chưa đủ điều kiện quyết toán tại kỳ hiện tại.</td><td>Pending settlement</td></tr><tr><td style="white-space:nowrap">PAYMENT_RECONCILIATION_VARIANCE<a name="vn-bhyt-review-issue-cs-PAYMENT_RECONCILIATION_VARIANCE"> </a></td><td>Chênh lệch thanh toán/quyết toán</td><td>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.</td><td>Payment or settlement reconciliation variance</td></tr></table></div>
</text>
<url
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-review-issue-cs"/>
<version value="0.5.0"/>
<name value="VNBHYTReviewIssueCS"/>
<title
value="Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue CodeSystem"/>
<status value="draft"/>
<experimental value="false"/>
<date value="2026-04-24"/>
<publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<contact>
<name value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="[email protected]"/>
</telecom>
</contact>
<contact>
<name value="Omi HealthTech (OmiGroup)"/>
<telecom>
<system value="url"/>
<value value="https://omihealthtech.vn"/>
</telecom>
<telecom>
<system value="url"/>
<value value="https://omigroup.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="[email protected]"/>
</telecom>
</contact>
<description
value="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."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<purpose
value="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 value="true"/>
<content value="complete"/>
<count value="6"/>
<concept>
<code value="GATEWAY_RECEPTION_ERROR"/>
<display value="Lỗi tiếp nhận cổng"/>
<definition
value="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 value="en"/>
<value value="Gateway reception error"/>
</designation>
</concept>
<concept>
<code value="FIELD_ADJUSTMENT_REQUIRED"/>
<display value="Cần điều chỉnh trường dữ liệu"/>
<definition
value="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 value="en"/>
<value value="Field adjustment required"/>
</designation>
</concept>
<concept>
<code value="LEGAL_NON_COMPLIANT_COST"/>
<display value="Chi phí không đúng quy định pháp luật"/>
<definition
value="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 value="en"/>
<value value="Legally non-compliant cost"/>
</designation>
</concept>
<concept>
<code value="MANUAL_REVIEW_REQUIRED"/>
<display value="Cần giám định chủ động/trực tiếp"/>
<definition
value="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 value="en"/>
<value value="Manual review required"/>
</designation>
</concept>
<concept>
<code value="PENDING_SETTLEMENT"/>
<display value="Chi phí chưa quyết toán"/>
<definition
value="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 value="en"/>
<value value="Pending settlement"/>
</designation>
</concept>
<concept>
<code value="PAYMENT_RECONCILIATION_VARIANCE"/>
<display value="Chênh lệch thanh toán/quyết toán"/>
<definition
value="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 value="en"/>
<value value="Payment or settlement reconciliation variance"/>
</designation>
</concept>
</CodeSystem>