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 Viet Nam cờ

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

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
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)

Usage info

Usages:

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.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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"
.... 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

doco 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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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

doco Documentation for this format

Dạng xem Snapshot

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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"
.... 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

doco 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