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.9.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 - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Phần mở rộng: Phân bổ nguồn thanh toán theo dòng — Line Payment Allocation

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation Phiên bản: 0.9.0
Computable Name: VNCoreExtLinePaymentAllocation
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.130

Phân bổ thành tiền bệnh viện của một dòng Claim vào bốn nguồn thanh toán trên bảng kê chi phí KCB: quỹ BHYT, người bệnh cùng chi trả, nguồn khác và người bệnh tự trả. Mỗi khoản bắt buộc có giá trị không âm và tiền tệ VND. Dòng chi tiết bên trong gói thiết bị được biểu diễn bằng Claim.item.detail và không mang extension này; phân bổ chỉ bắt buộc ở item tổng gói. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB.

This extension allocates a Claim line's hospital amount across the four payment sources in the itemized healthcare-cost statement: the BHYT fund, patient co-payment, other sources, and patient self-pay. Every component is required, non-negative, and denominated in VND. Device-package detail rows are represented by Claim.item.detail and do not carry this extension; allocation is required only on the package-level item.

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 C 0..* Extension Phân bổ nguồn thanh toán theo dòng — Line Payment Allocation
Constraints: vn-line-payment-allocation-vnd, vn-line-payment-allocation-nonnegative
... extension 4..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:insuranceFund S 1..1 Extension Quỹ BHYT thanh toán — BHYT fund payment
..... extension 0..0 Extension
..... url 1..1 uri "insuranceFund"
..... value[x] 1..1 Money Value of extension
...... value 1..1 decimal Numerical value (with implicit precision)
...... currency 1..1 code ISO 4217 Currency Code
Fixed Value: VND
.... extension:patientCopay S 1..1 Extension Người bệnh cùng chi trả — Patient co-payment
..... extension 0..0 Extension
..... url 1..1 uri "patientCopay"
..... value[x] 1..1 Money Value of extension
...... value 1..1 decimal Numerical value (with implicit precision)
...... currency 1..1 code ISO 4217 Currency Code
Fixed Value: VND
.... extension:otherSource S 1..1 Extension Nguồn khác thanh toán — Other-source payment
..... extension 0..0 Extension
..... url 1..1 uri "otherSource"
..... value[x] 1..1 Money Value of extension
...... value 1..1 decimal Numerical value (with implicit precision)
...... currency 1..1 code ISO 4217 Currency Code
Fixed Value: VND
.... extension:patientSelfPay S 1..1 Extension Người bệnh tự trả — Patient self-pay
..... extension 0..0 Extension
..... url 1..1 uri "patientSelfPay"
..... value[x] 1..1 Money Value of extension
...... value 1..1 decimal Numerical value (with implicit precision)
...... currency 1..1 code ISO 4217 Currency Code
Fixed Value: VND
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation"

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-line-payment-allocation-nonnegative error Extension Mọi khoản tiền phân bổ phải lớn hơn hoặc bằng 0. Every allocated Money value SHALL be greater than or equal to zero. extension.value.ofType(Money).all(value >= 0)
vn-line-payment-allocation-vnd error Extension Mọi khoản tiền phân bổ phải dùng VND. Every allocated Money value SHALL use VND. extension.value.ofType(Money).all(currency = 'VND')
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Phân bổ nguồn thanh toán theo dòng — Line Payment Allocation
Constraints: vn-line-payment-allocation-vnd, vn-line-payment-allocation-nonnegative
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 4..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:insuranceFund S 1..1 Extension Quỹ BHYT thanh toán — BHYT fund payment
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "insuranceFund"
..... value[x] 1..1 Money Value of extension
...... 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 Σ 1..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
.... extension:patientCopay S 1..1 Extension Người bệnh cùng chi trả — Patient co-payment
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "patientCopay"
..... value[x] 1..1 Money Value of extension
...... 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 Σ 1..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
.... extension:otherSource S 1..1 Extension Nguồn khác thanh toán — Other-source payment
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "otherSource"
..... value[x] 1..1 Money Value of extension
...... 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 Σ 1..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
.... extension:patientSelfPay S 1..1 Extension Người bệnh tự trả — Patient self-pay
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "patientSelfPay"
..... value[x] 1..1 Money Value of extension
...... 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 Σ 1..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
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:insuranceFund.​value[x].currency Base required CurrencyCode 📍4.0.1 FHIR Std.
Extension.extension:patientCopay.​value[x].currency Base required CurrencyCode 📍4.0.1 FHIR Std.
Extension.extension:otherSource.​value[x].currency Base required CurrencyCode 📍4.0.1 FHIR Std.
Extension.extension:patientSelfPay.​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()
vn-line-payment-allocation-nonnegative error Extension Mọi khoản tiền phân bổ phải lớn hơn hoặc bằng 0. Every allocated Money value SHALL be greater than or equal to zero. extension.value.ofType(Money).all(value >= 0)
vn-line-payment-allocation-vnd error Extension Mọi khoản tiền phân bổ phải dùng VND. Every allocated Money value SHALL use VND. extension.value.ofType(Money).all(currency = 'VND')

Summary

Complex Extension: Phân bổ thành tiền bệnh viện của một dòng Claim vào bốn nguồn thanh toán trên bảng kê chi phí KCB: quỹ BHYT, người bệnh cùng chi trả, nguồn khác và người bệnh tự trả. Mỗi khoản bắt buộc có giá trị không âm và tiền tệ VND. Dòng chi tiết bên trong gói thiết bị được biểu diễn bằng Claim.item.detail và không mang extension này; phân bổ chỉ bắt buộc ở item tổng gói. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB. This extension allocates a Claim line's hospital amount across the four payment sources in the itemized healthcare-cost statement: the BHYT fund, patient co-payment, other sources, and patient self-pay. Every component is required, non-negative, and denominated in VND. Device-package detail rows are represented by Claim.item.detail and do not carry this extension; allocation is required only on the package-level item.

  • insuranceFund: Money: Số tiền của dòng do quỹ BHYT thanh toán, tương ứng cột 10. The line amount paid by the BHYT fund, corresponding to column 10.
  • patientCopay: Money: Số tiền người bệnh cùng chi trả trong phạm vi BHYT, tương ứng cột 11. The patient's co-payment within BHYT coverage, corresponding to column 11.
  • otherSource: Money: Số tiền của dòng do nguồn khác thanh toán, tương ứng cột 12. The line amount paid by other sources, corresponding to column 12.
  • patientSelfPay: Money: Số tiền người bệnh tự trả ngoài phần cùng chi trả BHYT, tương ứng cột 13. The patient's self-pay amount outside BHYT co-payment, corresponding to column 13.

Dạng xem DifferentialDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Phân bổ nguồn thanh toán theo dòng — Line Payment Allocation
Constraints: vn-line-payment-allocation-vnd, vn-line-payment-allocation-nonnegative
... extension 4..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:insuranceFund S 1..1 Extension Quỹ BHYT thanh toán — BHYT fund payment
..... extension 0..0 Extension
..... url 1..1 uri "insuranceFund"
..... value[x] 1..1 Money Value of extension
...... value 1..1 decimal Numerical value (with implicit precision)
...... currency 1..1 code ISO 4217 Currency Code
Fixed Value: VND
.... extension:patientCopay S 1..1 Extension Người bệnh cùng chi trả — Patient co-payment
..... extension 0..0 Extension
..... url 1..1 uri "patientCopay"
..... value[x] 1..1 Money Value of extension
...... value 1..1 decimal Numerical value (with implicit precision)
...... currency 1..1 code ISO 4217 Currency Code
Fixed Value: VND
.... extension:otherSource S 1..1 Extension Nguồn khác thanh toán — Other-source payment
..... extension 0..0 Extension
..... url 1..1 uri "otherSource"
..... value[x] 1..1 Money Value of extension
...... value 1..1 decimal Numerical value (with implicit precision)
...... currency 1..1 code ISO 4217 Currency Code
Fixed Value: VND
.... extension:patientSelfPay S 1..1 Extension Người bệnh tự trả — Patient self-pay
..... extension 0..0 Extension
..... url 1..1 uri "patientSelfPay"
..... value[x] 1..1 Money Value of extension
...... value 1..1 decimal Numerical value (with implicit precision)
...... currency 1..1 code ISO 4217 Currency Code
Fixed Value: VND
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation"

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-line-payment-allocation-nonnegative error Extension Mọi khoản tiền phân bổ phải lớn hơn hoặc bằng 0. Every allocated Money value SHALL be greater than or equal to zero. extension.value.ofType(Money).all(value >= 0)
vn-line-payment-allocation-vnd error Extension Mọi khoản tiền phân bổ phải dùng VND. Every allocated Money value SHALL use VND. extension.value.ofType(Money).all(currency = 'VND')

Dạng xem Snapshot

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Phân bổ nguồn thanh toán theo dòng — Line Payment Allocation
Constraints: vn-line-payment-allocation-vnd, vn-line-payment-allocation-nonnegative
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 4..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:insuranceFund S 1..1 Extension Quỹ BHYT thanh toán — BHYT fund payment
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "insuranceFund"
..... value[x] 1..1 Money Value of extension
...... 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 Σ 1..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
.... extension:patientCopay S 1..1 Extension Người bệnh cùng chi trả — Patient co-payment
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "patientCopay"
..... value[x] 1..1 Money Value of extension
...... 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 Σ 1..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
.... extension:otherSource S 1..1 Extension Nguồn khác thanh toán — Other-source payment
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "otherSource"
..... value[x] 1..1 Money Value of extension
...... 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 Σ 1..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
.... extension:patientSelfPay S 1..1 Extension Người bệnh tự trả — Patient self-pay
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "patientSelfPay"
..... value[x] 1..1 Money Value of extension
...... 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 Σ 1..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
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:insuranceFund.​value[x].currency Base required CurrencyCode 📍4.0.1 FHIR Std.
Extension.extension:patientCopay.​value[x].currency Base required CurrencyCode 📍4.0.1 FHIR Std.
Extension.extension:otherSource.​value[x].currency Base required CurrencyCode 📍4.0.1 FHIR Std.
Extension.extension:patientSelfPay.​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()
vn-line-payment-allocation-nonnegative error Extension Mọi khoản tiền phân bổ phải lớn hơn hoặc bằng 0. Every allocated Money value SHALL be greater than or equal to zero. extension.value.ofType(Money).all(value >= 0)
vn-line-payment-allocation-vnd error Extension Mọi khoản tiền phân bổ phải dùng VND. Every allocated Money value SHALL use VND. extension.value.ofType(Money).all(currency = 'VND')

Summary

Complex Extension: Phân bổ thành tiền bệnh viện của một dòng Claim vào bốn nguồn thanh toán trên bảng kê chi phí KCB: quỹ BHYT, người bệnh cùng chi trả, nguồn khác và người bệnh tự trả. Mỗi khoản bắt buộc có giá trị không âm và tiền tệ VND. Dòng chi tiết bên trong gói thiết bị được biểu diễn bằng Claim.item.detail và không mang extension này; phân bổ chỉ bắt buộc ở item tổng gói. Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB. This extension allocates a Claim line's hospital amount across the four payment sources in the itemized healthcare-cost statement: the BHYT fund, patient co-payment, other sources, and patient self-pay. Every component is required, non-negative, and denominated in VND. Device-package detail rows are represented by Claim.item.detail and do not carry this extension; allocation is required only on the package-level item.

  • insuranceFund: Money: Số tiền của dòng do quỹ BHYT thanh toán, tương ứng cột 10. The line amount paid by the BHYT fund, corresponding to column 10.
  • patientCopay: Money: Số tiền người bệnh cùng chi trả trong phạm vi BHYT, tương ứng cột 11. The patient's co-payment within BHYT coverage, corresponding to column 11.
  • otherSource: Money: Số tiền của dòng do nguồn khác thanh toán, tương ứng cột 12. The line amount paid by other sources, corresponding to column 12.
  • patientSelfPay: Money: Số tiền người bệnh tự trả ngoài phần cùng chi trả BHYT, tương ứng cột 13. The patient's self-pay amount outside BHYT co-payment, corresponding to column 13.

 

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