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
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
| 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)
Claim.item
Usage info
Usages:
You can also check for usages in the FHIR IG Statistics
Mô tả profile, differential, snapshot và các biểu diễn liên quan.
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
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 |
![]() ![]() |
4..* | Extension | Extension | |
![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() |
S | 1..1 | Extension | Quỹ BHYT thanh toán — BHYT fund payment |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "insuranceFund" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | ISO 4217 Currency Code Fixed Value: VND | |
![]() ![]() ![]() |
S | 1..1 | Extension | Người bệnh cùng chi trả — Patient co-payment |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "patientCopay" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | ISO 4217 Currency Code Fixed Value: VND | |
![]() ![]() ![]() |
S | 1..1 | Extension | Nguồn khác thanh toán — Other-source payment |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "otherSource" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | ISO 4217 Currency Code Fixed Value: VND | |
![]() ![]() ![]() |
S | 1..1 | Extension | Người bệnh tự trả — Patient self-pay |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "patientSelfPay" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | ISO 4217 Currency Code Fixed Value: VND | |
![]() ![]() |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation" | |
![]() ![]() |
0..0 | Value of extension | ||
Documentation for this format | ||||
| 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')
|
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
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 |
![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() |
4..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() |
S | 1..1 | Extension | Quỹ BHYT thanh toán — BHYT fund payment |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "insuranceFund" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND |
![]() ![]() ![]() |
S | 1..1 | Extension | Người bệnh cùng chi trả — Patient co-payment |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "patientCopay" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND |
![]() ![]() ![]() |
S | 1..1 | Extension | Nguồn khác thanh toán — Other-source payment |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "otherSource" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND |
![]() ![]() ![]() |
S | 1..1 | Extension | Người bệnh tự trả — Patient self-pay |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "patientSelfPay" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND |
![]() ![]() |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation" | |
Documentation for this format | ||||
| 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. |
| 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.
Dạng xem DifferentialDifferential View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
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 |
![]() ![]() |
4..* | Extension | Extension | |
![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() |
S | 1..1 | Extension | Quỹ BHYT thanh toán — BHYT fund payment |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "insuranceFund" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | ISO 4217 Currency Code Fixed Value: VND | |
![]() ![]() ![]() |
S | 1..1 | Extension | Người bệnh cùng chi trả — Patient co-payment |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "patientCopay" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | ISO 4217 Currency Code Fixed Value: VND | |
![]() ![]() ![]() |
S | 1..1 | Extension | Nguồn khác thanh toán — Other-source payment |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "otherSource" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | ISO 4217 Currency Code Fixed Value: VND | |
![]() ![]() ![]() |
S | 1..1 | Extension | Người bệnh tự trả — Patient self-pay |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "patientSelfPay" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
1..1 | decimal | Numerical value (with implicit precision) | |
![]() ![]() ![]() ![]() ![]() |
1..1 | code | ISO 4217 Currency Code Fixed Value: VND | |
![]() ![]() |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation" | |
![]() ![]() |
0..0 | Value of extension | ||
Documentation for this format | ||||
| 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
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
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 |
![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() |
4..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() |
S | 1..1 | Extension | Quỹ BHYT thanh toán — BHYT fund payment |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "insuranceFund" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND |
![]() ![]() ![]() |
S | 1..1 | Extension | Người bệnh cùng chi trả — Patient co-payment |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "patientCopay" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND |
![]() ![]() ![]() |
S | 1..1 | Extension | Nguồn khác thanh toán — Other-source payment |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "otherSource" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND |
![]() ![]() ![]() |
S | 1..1 | Extension | Người bệnh tự trả — Patient self-pay |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "patientSelfPay" | |
![]() ![]() ![]() ![]() |
1..1 | Money | Value of extension | |
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | decimal | Numerical value (with implicit precision) |
![]() ![]() ![]() ![]() ![]() |
Σ | 1..1 | code | ISO 4217 Currency Code Binding: Currencies (required): A code indicating the currency, taken from ISO 4217. Fixed Value: VND |
![]() ![]() |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-line-payment-allocation" | |
Documentation for this format | ||||
| 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. |
| 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.
Biểu diễn khác của hồ sơ: CSV, Excel, Schematron