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: Tổng cùng chi trả lũy kế trong năm — Coverage Cumulative Copay Extension

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

Tổng số tiền cùng chi trả (co-payment) BHYT lũy kế trong năm dương lịch của người tham gia BHYT, dùng để xác định khi nào đạt trần cùng chi trả và được hưởng quyền lợi không phải cùng chi trả tiếp. Căn cứ:

- NĐ 188/2025/NĐ-CP — Điều 10 (trần cùng chi trả tích lũy năm). Khi tổng cùng chi trả trong năm dương lịch vượt trần quy định, người tham gia BHYT được cấp Giấy chứng nhận không cùng chi trả và không phải cùng chi trả các lần KCB tiếp theo trong năm đó.
- Luật 51/2024/QH15 — Sửa đổi Luật BHYT, hiệu lực 01/07/2025.

Context of Use

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

- Element ID: `Coverage`

Usage info

Usages:

- Use this Extension: Thẻ BHYT VN Core — VN Core Coverage 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 | Tổng cùng chi trả lũy kế trong năm — Coverage Cumulative Copay Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-cumulative-copay"
value[x] |  | 1..1 | Money | Tổng cùng chi trả lũy kế trong năm dương lịch (VND)
currency |  | 1..1 | code | ISO 4217 Currency Code Fixed Value: VND
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Tổng cùng chi trả lũy kế trong năm — Coverage Cumulative Copay 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-coverage-cumulative-copay"
value[x] |  | 1..1 | Money | Tổng cùng chi trả lũy kế trong năm dương lịch (VND)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
value | Σ | 0..1 | decimal | Numerical value (with implicit precision)
currency | Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x].currency | Base | required | CurrencyCode | 📍4.0.1 | FHIR Std.

#### 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 Money: Tổng số tiền cùng chi trả (co-payment) BHYT lũy kế trong năm dương lịch của người tham gia BHYT, dùng để xác định khi nào đạt trần cùng chi trả và được hưởng quyền lợi không phải cùng chi trả tiếp. Căn cứ:

- NĐ 188/2025/NĐ-CP — Điều 10 (trần cùng chi trả tích lũy năm). Khi tổng cùng chi trả trong năm dương lịch vượt trần quy định, người tham gia BHYT được cấp Giấy chứng nhận không cùng chi trả và không phải cùng chi trả các lần KCB tiếp theo trong năm đó.
- Luật 51/2024/QH15 — Sửa đổi Luật BHYT, hiệu lực 01/07/2025.

Dạng xem DifferentialDifferential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Tổng cùng chi trả lũy kế trong năm — Coverage Cumulative Copay Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-cumulative-copay"
value[x] |  | 1..1 | Money | Tổng cùng chi trả lũy kế trong năm dương lịch (VND)
currency |  | 1..1 | code | ISO 4217 Currency Code Fixed Value: VND
Documentation for this format

Dạng xem Snapshot

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Tổng cùng chi trả lũy kế trong năm — Coverage Cumulative Copay 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-coverage-cumulative-copay"
value[x] |  | 1..1 | Money | Tổng cùng chi trả lũy kế trong năm dương lịch (VND)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
value | Σ | 0..1 | decimal | Numerical value (with implicit precision)
currency | Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x].currency | Base | required | CurrencyCode | 📍4.0.1 | FHIR Std.

#### 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 Money: Tổng số tiền cùng chi trả (co-payment) BHYT lũy kế trong năm dương lịch của người tham gia BHYT, dùng để xác định khi nào đạt trần cùng chi trả và được hưởng quyền lợi không phải cùng chi trả tiếp. Căn cứ:

- NĐ 188/2025/NĐ-CP — Điều 10 (trần cùng chi trả tích lũy năm). Khi tổng cùng chi trả trong năm dương lịch vượt trần quy định, người tham gia BHYT được cấp Giấy chứng nhận không cùng chi trả và không phải cùng chi trả các lần KCB tiếp theo trong năm đó.
- Luật 51/2024/QH15 — Sửa đổi Luật BHYT, hiệu lực 01/07/2025.

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