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

## Phần mở rộng: Trạng thái giám định BHYT — Claim Audit Status Extension

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status | Phiên bản: 0.5.0 | Làm nổi bật phần thay đổi?
| Computable Name: VNCoreExtClaimAuditStatus

Trạng thái giám định, quyết toán hồ sơ thanh toán BHYT điện tử theo quy trình TT 12/2026/TT-BTC: tiếp nhận → giám định → duyệt/từ chối/tranh chấp. Đặt trên PaymentReconciliation hoặc Task workflow BHYT. Bổ sung cho `PaymentReconciliation.outcome` chuẩn FHIR (queued | complete | error | partial) để map đúng vòng đời giám định BHYT Việt Nam. Căn cứ:

- TT 12/2026/TT-BTC — Bộ Tài chính, Điều 6 và Điều 10 (tranh chấp).
- NĐ 188/2025/NĐ-CP.

Context of Use

This extension may be used on the following element(s)

- Element ID: `PaymentReconciliation`
- Element ID: `Task`
- Element ID: `ClaimResponse`

Usage info

Usages:

- Use this Extension: Quyết toán BHYT VN Core — VN Core Payment Reconciliation Profile

You can also check for usages in the FHIR IG Statistics

### Các dạng xem hình thức của nội dung phần mở rộng

Mô tả profile, differential, snapshot và các biểu diễn liên quan.

- Bảng Differential
- Bảng Snapshot
- Thống kê/Tham chiếu
- Tất cả

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Trạng thái giám định BHYT — Claim Audit Status Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status"
value[x] |  | 1..1 | CodeableConcept | received | under-review | approved | rejected | disputed Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | Trạng thái giám định BHYT — VN Claim Audit Status ValueSet | 📦0.5.0 | This IG

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Trạng thái giám định BHYT — Claim Audit Status Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status"
value[x] |  | 1..1 | CodeableConcept | received | under-review | approved | rejected | disputed Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | Trạng thái giám định BHYT — VN Claim Audit Status ValueSet | 📦0.5.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

Summary

Simple Extension with the type CodeableConcept: Trạng thái giám định, quyết toán hồ sơ thanh toán BHYT điện tử theo quy trình TT 12/2026/TT-BTC: tiếp nhận → giám định → duyệt/từ chối/tranh chấp. Đặt trên PaymentReconciliation hoặc Task workflow BHYT. Bổ sung cho `PaymentReconciliation.outcome` chuẩn FHIR (queued | complete | error | partial) để map đúng vòng đời giám định BHYT Việt Nam. Căn cứ:

- TT 12/2026/TT-BTC — Bộ Tài chính, Điều 6 và Điều 10 (tranh chấp).
- NĐ 188/2025/NĐ-CP.

Dạng xem DifferentialDifferential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Trạng thái giám định BHYT — Claim Audit Status Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status"
value[x] |  | 1..1 | CodeableConcept | received | under-review | approved | rejected | disputed Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | Trạng thái giám định BHYT — VN Claim Audit Status ValueSet | 📦0.5.0 | This IG

Dạng xem Snapshot

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Trạng thái giám định BHYT — Claim Audit Status Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status"
value[x] |  | 1..1 | CodeableConcept | received | under-review | approved | rejected | disputed Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | extensible | Trạng thái giám định BHYT — VN Claim Audit Status ValueSet | 📦0.5.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

Summary

Simple Extension with the type CodeableConcept: Trạng thái giám định, quyết toán hồ sơ thanh toán BHYT điện tử theo quy trình TT 12/2026/TT-BTC: tiếp nhận → giám định → duyệt/từ chối/tranh chấp. Đặt trên PaymentReconciliation hoặc Task workflow BHYT. Bổ sung cho `PaymentReconciliation.outcome` chuẩn FHIR (queued | complete | error | partial) để map đúng vòng đời giám định BHYT Việt Nam. Căn cứ:

- TT 12/2026/TT-BTC — Bộ Tài chính, Điều 6 và Điều 10 (tranh chấp).
- NĐ 188/2025/NĐ-CP.

Biểu diễn khác của hồ sơ: CSV, Excel, Schematron