Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.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 - Draft for Community Review (v0.10.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-cost-calculation-context | Phiên bản: 0.10.0 | ||||
| Computable Name: VNCoreExtCostCalculationContext | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.133 | |||||
Năm trục ĐỘC LẬP mô tả cách một dòng chi phí trên bảng kê được hình thành: vai trò dòng, cơ sở tính, quy tắc trần, miễn trần (lặp được) và phiên bản bộ công thức.
Vì sao không mã hoá bằng một enum tổ hợp. Các trục thực sự độc lập với nhau. Một dòng thiết bị thành phần trong gói có thể vừa lấy giá trị báo cáo làm căn cứ, vừa thuộc diện miễn trần theo NĐ 188/2025/NĐ-CP Điều 16 — ba sự thật không suy ra được từ nhau. Liệt kê tổ hợp sẽ nổ số lượng mã và vẫn bỏ sót khi văn bản mới thêm một nhánh.
Vì sao cần formulaVersion. Hai bộ quy tắc chạy song song và KHÔNG trùng nhau: mẫu bảng kê
QĐ 697/QĐ-BYT và chuẩn dữ liệu XML của chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT. Công thức không thu
thêm phần chênh lệch chỉ có ở bộ thứ hai. Không khai rõ dòng theo bộ nào thì mọi phép đối soát
đều mơ hồ.
Ranh giới. Extension mô tả dòng được tính THEO CÁCH NÀO; nó không tự tính và không thay giá trị tiền. Số tiền vẫn nằm ở carrier chi phí, và cột 9 luôn là giá trị authoritative.
Context of Use
This extension may be used on the following element(s)
Invoice.lineItem
Extension
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 | Ngữ cảnh tính chi phí dòng bảng kê — Cost Calculation Context Constraints: vn-cost-calculation-stent-ordinal, vn-cost-calculation-exemption-needs-cap, vn-cost-calculation-transport-basis-coherent |
![]() ![]() |
4..* | Extension | Extension | |
![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() |
S | 1..1 | Extension | Vai trò dòng: thông thường, tổng gói, thành phần gói, stent bổ sung, vận chuyển |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "lineRole" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Vai trò dòng chi phí — Cost Line Role (required) | |
![]() ![]() ![]() |
S | 1..1 | Extension | Cách dòng được tính — quyết định công thức nào áp được |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "calculationBasis" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Cơ sở tính chi phí — Cost Calculation Basis (required) | |
![]() ![]() ![]() |
S | 1..1 | Extension | Quy tắc trần đang áp cho dòng |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "capRule" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Quy tắc trần thanh toán — Cost Cap Rule (required) | |
![]() ![]() ![]() |
S | 0..* | Extension | Căn cứ miễn trần — lặp được vì một dòng có thể thuộc nhiều diện |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "exemption" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Miễn trần thanh toán — Cost Cap Exemption (required) | |
![]() ![]() ![]() |
S | 0..1 | Extension | Thứ tự trong nhóm — bắt buộc với stent bổ sung (2-4) |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "ordinal" | |
![]() ![]() ![]() ![]() |
1..1 | positiveInt | Value of extension | |
![]() ![]() ![]() |
S | 1..1 | Extension | Bộ công thức đang áp: QĐ 697/QĐ-BYT hay chuỗi QĐ 3176/QĐ-BYT |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "formulaVersion" | |
![]() ![]() ![]() ![]() |
1..1 | Coding | Value of extension Binding: Phiên bản bộ công thức — Cost Formula Version (required) | |
![]() ![]() |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-calculation-context" | |
![]() ![]() |
0..0 | Value of extension | ||
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.extension:lineRole.value[x] | Base | required | Vai trò dòng chi phí — Cost Line Role | 📦0.10.0 | This IG |
| Extension.extension:calculationBasis.value[x] | Base | required | Cơ sở tính chi phí — Cost Calculation Basis | 📦0.10.0 | This IG |
| Extension.extension:capRule.value[x] | Base | required | Quy tắc trần thanh toán — Cost Cap Rule | 📦0.10.0 | This IG |
| Extension.extension:exemption.value[x] | Base | required | Miễn trần thanh toán — Cost Cap Exemption | 📦0.10.0 | This IG |
| Extension.extension:formulaVersion.value[x] | Base | required | Phiên bản bộ công thức — Cost Formula Version | 📦0.10.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
| vn-cost-calculation-exemption-needs-cap | error | Extension | Chỉ khai miễn trần khi dòng đang áp một quy tắc trần. A cap exemption SHALL NOT be declared on a line with no cap rule. |
extension.where(url = 'exemption').empty() or extension.where(url = 'capRule').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'no-cap').empty()
|
| vn-cost-calculation-stent-ordinal | error | Extension | Dòng stent bổ sung phải khai thứ tự trong khoảng 2-4. An additional-stent line SHALL declare an ordinal between 2 and 4. |
extension.where(url = 'lineRole').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'additional-stent').empty() or extension.where(url = 'ordinal').value.ofType(positiveInt).where($this >= 2 and $this <= 4).exists()
|
| vn-cost-calculation-transport-basis-coherent | error | Extension | Cơ sở tính vận chuyển và vai trò dòng vận chuyển phải đi cùng nhau. A transport calculation basis and the patient-transport line role SHALL be used together. |
extension.where(url = 'calculationBasis').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and (code = 'transport-kilometre' or code = 'transport-fuel' or code = 'transport-actual-one-way')).exists() = extension.where(url = 'lineRole').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'patient-transport').exists()
|
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 0..* | Extension | Ngữ cảnh tính chi phí dòng bảng kê — Cost Calculation Context Constraints: vn-cost-calculation-stent-ordinal, vn-cost-calculation-exemption-needs-cap, vn-cost-calculation-transport-basis-coherent |
![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() |
4..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() |
S | 1..1 | Extension | Vai trò dòng: thông thường, tổng gói, thành phần gói, stent bổ sung, vận chuyển |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "lineRole" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Vai trò dòng chi phí — Cost Line Role (required) | |
![]() ![]() ![]() |
S | 1..1 | Extension | Cách dòng được tính — quyết định công thức nào áp được |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "calculationBasis" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Cơ sở tính chi phí — Cost Calculation Basis (required) | |
![]() ![]() ![]() |
S | 1..1 | Extension | Quy tắc trần đang áp cho dòng |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "capRule" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Quy tắc trần thanh toán — Cost Cap Rule (required) | |
![]() ![]() ![]() |
S | 0..* | Extension | Căn cứ miễn trần — lặp được vì một dòng có thể thuộc nhiều diện |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "exemption" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Miễn trần thanh toán — Cost Cap Exemption (required) | |
![]() ![]() ![]() |
S | 0..1 | Extension | Thứ tự trong nhóm — bắt buộc với stent bổ sung (2-4) |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "ordinal" | |
![]() ![]() ![]() ![]() |
1..1 | positiveInt | Value of extension | |
![]() ![]() ![]() |
S | 1..1 | Extension | Bộ công thức đang áp: QĐ 697/QĐ-BYT hay chuỗi QĐ 3176/QĐ-BYT |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "formulaVersion" | |
![]() ![]() ![]() ![]() |
1..1 | Coding | Value of extension Binding: Phiên bản bộ công thức — Cost Formula Version (required) | |
![]() ![]() |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-calculation-context" | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.extension:lineRole.value[x] | Base | required | Vai trò dòng chi phí — Cost Line Role | 📦0.10.0 | This IG |
| Extension.extension:calculationBasis.value[x] | Base | required | Cơ sở tính chi phí — Cost Calculation Basis | 📦0.10.0 | This IG |
| Extension.extension:capRule.value[x] | Base | required | Quy tắc trần thanh toán — Cost Cap Rule | 📦0.10.0 | This IG |
| Extension.extension:exemption.value[x] | Base | required | Miễn trần thanh toán — Cost Cap Exemption | 📦0.10.0 | This IG |
| Extension.extension:formulaVersion.value[x] | Base | required | Phiên bản bộ công thức — Cost Formula Version | 📦0.10.0 | This IG |
| 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-cost-calculation-exemption-needs-cap | error | Extension | Chỉ khai miễn trần khi dòng đang áp một quy tắc trần. A cap exemption SHALL NOT be declared on a line with no cap rule. |
extension.where(url = 'exemption').empty() or extension.where(url = 'capRule').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'no-cap').empty()
|
| vn-cost-calculation-stent-ordinal | error | Extension | Dòng stent bổ sung phải khai thứ tự trong khoảng 2-4. An additional-stent line SHALL declare an ordinal between 2 and 4. |
extension.where(url = 'lineRole').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'additional-stent').empty() or extension.where(url = 'ordinal').value.ofType(positiveInt).where($this >= 2 and $this <= 4).exists()
|
| vn-cost-calculation-transport-basis-coherent | error | Extension | Cơ sở tính vận chuyển và vai trò dòng vận chuyển phải đi cùng nhau. A transport calculation basis and the patient-transport line role SHALL be used together. |
extension.where(url = 'calculationBasis').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and (code = 'transport-kilometre' or code = 'transport-fuel' or code = 'transport-actual-one-way')).exists() = extension.where(url = 'lineRole').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'patient-transport').exists()
|
Summary
Complex Extension: Năm trục ĐỘC LẬP mô tả cách một dòng chi phí trên bảng kê được hình thành: vai trò dòng, cơ sở
tính, quy tắc trần, miễn trần (lặp được) và phiên bản bộ công thức.
Vì sao không mã hoá bằng một enum tổ hợp. Các trục thực sự độc lập với nhau. Một dòng thiết
bị thành phần trong gói có thể vừa lấy giá trị báo cáo làm căn cứ, vừa thuộc diện miễn trần theo
NĐ 188/2025/NĐ-CP Điều 16 — ba sự thật không suy ra được từ nhau. Liệt kê tổ hợp sẽ nổ số lượng
mã và vẫn bỏ sót khi văn bản mới thêm một nhánh.
Vì sao cần formulaVersion. Hai bộ quy tắc chạy song song và KHÔNG trùng nhau: mẫu bảng kê
QĐ 697/QĐ-BYT và chuẩn dữ liệu XML của chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT. Công thức không thu thêm phần chênh lệch chỉ có ở bộ thứ hai. Không khai rõ dòng theo bộ nào thì mọi phép đối soát
đều mơ hồ.
Ranh giới. Extension mô tả dòng được tính THEO CÁCH NÀO; nó không tự tính và không thay giá
trị tiền. Số tiền vẫn nằm ở carrier chi phí, và cột 9 luôn là giá trị authoritative.
Dạng xem DifferentialDifferential View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 0..* | Extension | Ngữ cảnh tính chi phí dòng bảng kê — Cost Calculation Context Constraints: vn-cost-calculation-stent-ordinal, vn-cost-calculation-exemption-needs-cap, vn-cost-calculation-transport-basis-coherent |
![]() ![]() |
4..* | Extension | Extension | |
![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() |
S | 1..1 | Extension | Vai trò dòng: thông thường, tổng gói, thành phần gói, stent bổ sung, vận chuyển |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "lineRole" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Vai trò dòng chi phí — Cost Line Role (required) | |
![]() ![]() ![]() |
S | 1..1 | Extension | Cách dòng được tính — quyết định công thức nào áp được |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "calculationBasis" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Cơ sở tính chi phí — Cost Calculation Basis (required) | |
![]() ![]() ![]() |
S | 1..1 | Extension | Quy tắc trần đang áp cho dòng |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "capRule" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Quy tắc trần thanh toán — Cost Cap Rule (required) | |
![]() ![]() ![]() |
S | 0..* | Extension | Căn cứ miễn trần — lặp được vì một dòng có thể thuộc nhiều diện |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "exemption" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Miễn trần thanh toán — Cost Cap Exemption (required) | |
![]() ![]() ![]() |
S | 0..1 | Extension | Thứ tự trong nhóm — bắt buộc với stent bổ sung (2-4) |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "ordinal" | |
![]() ![]() ![]() ![]() |
1..1 | positiveInt | Value of extension | |
![]() ![]() ![]() |
S | 1..1 | Extension | Bộ công thức đang áp: QĐ 697/QĐ-BYT hay chuỗi QĐ 3176/QĐ-BYT |
![]() ![]() ![]() ![]() |
0..0 | Extension | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "formulaVersion" | |
![]() ![]() ![]() ![]() |
1..1 | Coding | Value of extension Binding: Phiên bản bộ công thức — Cost Formula Version (required) | |
![]() ![]() |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-calculation-context" | |
![]() ![]() |
0..0 | Value of extension | ||
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.extension:lineRole.value[x] | Base | required | Vai trò dòng chi phí — Cost Line Role | 📦0.10.0 | This IG |
| Extension.extension:calculationBasis.value[x] | Base | required | Cơ sở tính chi phí — Cost Calculation Basis | 📦0.10.0 | This IG |
| Extension.extension:capRule.value[x] | Base | required | Quy tắc trần thanh toán — Cost Cap Rule | 📦0.10.0 | This IG |
| Extension.extension:exemption.value[x] | Base | required | Miễn trần thanh toán — Cost Cap Exemption | 📦0.10.0 | This IG |
| Extension.extension:formulaVersion.value[x] | Base | required | Phiên bản bộ công thức — Cost Formula Version | 📦0.10.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
| vn-cost-calculation-exemption-needs-cap | error | Extension | Chỉ khai miễn trần khi dòng đang áp một quy tắc trần. A cap exemption SHALL NOT be declared on a line with no cap rule. |
extension.where(url = 'exemption').empty() or extension.where(url = 'capRule').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'no-cap').empty()
|
| vn-cost-calculation-stent-ordinal | error | Extension | Dòng stent bổ sung phải khai thứ tự trong khoảng 2-4. An additional-stent line SHALL declare an ordinal between 2 and 4. |
extension.where(url = 'lineRole').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'additional-stent').empty() or extension.where(url = 'ordinal').value.ofType(positiveInt).where($this >= 2 and $this <= 4).exists()
|
| vn-cost-calculation-transport-basis-coherent | error | Extension | Cơ sở tính vận chuyển và vai trò dòng vận chuyển phải đi cùng nhau. A transport calculation basis and the patient-transport line role SHALL be used together. |
extension.where(url = 'calculationBasis').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and (code = 'transport-kilometre' or code = 'transport-fuel' or code = 'transport-actual-one-way')).exists() = extension.where(url = 'lineRole').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'patient-transport').exists()
|
Dạng xem Snapshot
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 0..* | Extension | Ngữ cảnh tính chi phí dòng bảng kê — Cost Calculation Context Constraints: vn-cost-calculation-stent-ordinal, vn-cost-calculation-exemption-needs-cap, vn-cost-calculation-transport-basis-coherent |
![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() |
4..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() |
S | 1..1 | Extension | Vai trò dòng: thông thường, tổng gói, thành phần gói, stent bổ sung, vận chuyển |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "lineRole" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Vai trò dòng chi phí — Cost Line Role (required) | |
![]() ![]() ![]() |
S | 1..1 | Extension | Cách dòng được tính — quyết định công thức nào áp được |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "calculationBasis" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Cơ sở tính chi phí — Cost Calculation Basis (required) | |
![]() ![]() ![]() |
S | 1..1 | Extension | Quy tắc trần đang áp cho dòng |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "capRule" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Quy tắc trần thanh toán — Cost Cap Rule (required) | |
![]() ![]() ![]() |
S | 0..* | Extension | Căn cứ miễn trần — lặp được vì một dòng có thể thuộc nhiều diện |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "exemption" | |
![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Value of extension Binding: Miễn trần thanh toán — Cost Cap Exemption (required) | |
![]() ![]() ![]() |
S | 0..1 | Extension | Thứ tự trong nhóm — bắt buộc với stent bổ sung (2-4) |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "ordinal" | |
![]() ![]() ![]() ![]() |
1..1 | positiveInt | Value of extension | |
![]() ![]() ![]() |
S | 1..1 | Extension | Bộ công thức đang áp: QĐ 697/QĐ-BYT hay chuỗi QĐ 3176/QĐ-BYT |
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |
![]() ![]() ![]() ![]() |
0..0 | Extension Slice: Unordered, Open by value:url | ||
![]() ![]() ![]() ![]() |
1..1 | uri | "formulaVersion" | |
![]() ![]() ![]() ![]() |
1..1 | Coding | Value of extension Binding: Phiên bản bộ công thức — Cost Formula Version (required) | |
![]() ![]() |
1..1 | uri | "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-calculation-context" | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Extension.extension:lineRole.value[x] | Base | required | Vai trò dòng chi phí — Cost Line Role | 📦0.10.0 | This IG |
| Extension.extension:calculationBasis.value[x] | Base | required | Cơ sở tính chi phí — Cost Calculation Basis | 📦0.10.0 | This IG |
| Extension.extension:capRule.value[x] | Base | required | Quy tắc trần thanh toán — Cost Cap Rule | 📦0.10.0 | This IG |
| Extension.extension:exemption.value[x] | Base | required | Miễn trần thanh toán — Cost Cap Exemption | 📦0.10.0 | This IG |
| Extension.extension:formulaVersion.value[x] | Base | required | Phiên bản bộ công thức — Cost Formula Version | 📦0.10.0 | This IG |
| 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-cost-calculation-exemption-needs-cap | error | Extension | Chỉ khai miễn trần khi dòng đang áp một quy tắc trần. A cap exemption SHALL NOT be declared on a line with no cap rule. |
extension.where(url = 'exemption').empty() or extension.where(url = 'capRule').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'no-cap').empty()
|
| vn-cost-calculation-stent-ordinal | error | Extension | Dòng stent bổ sung phải khai thứ tự trong khoảng 2-4. An additional-stent line SHALL declare an ordinal between 2 and 4. |
extension.where(url = 'lineRole').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'additional-stent').empty() or extension.where(url = 'ordinal').value.ofType(positiveInt).where($this >= 2 and $this <= 4).exists()
|
| vn-cost-calculation-transport-basis-coherent | error | Extension | Cơ sở tính vận chuyển và vai trò dòng vận chuyển phải đi cùng nhau. A transport calculation basis and the patient-transport line role SHALL be used together. |
extension.where(url = 'calculationBasis').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and (code = 'transport-kilometre' or code = 'transport-fuel' or code = 'transport-actual-one-way')).exists() = extension.where(url = 'lineRole').value.ofType(CodeableConcept).coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-calculation-axis-cs' and code = 'patient-transport').exists()
|
Summary
Complex Extension: Năm trục ĐỘC LẬP mô tả cách một dòng chi phí trên bảng kê được hình thành: vai trò dòng, cơ sở
tính, quy tắc trần, miễn trần (lặp được) và phiên bản bộ công thức.
Vì sao không mã hoá bằng một enum tổ hợp. Các trục thực sự độc lập với nhau. Một dòng thiết
bị thành phần trong gói có thể vừa lấy giá trị báo cáo làm căn cứ, vừa thuộc diện miễn trần theo
NĐ 188/2025/NĐ-CP Điều 16 — ba sự thật không suy ra được từ nhau. Liệt kê tổ hợp sẽ nổ số lượng
mã và vẫn bỏ sót khi văn bản mới thêm một nhánh.
Vì sao cần formulaVersion. Hai bộ quy tắc chạy song song và KHÔNG trùng nhau: mẫu bảng kê
QĐ 697/QĐ-BYT và chuẩn dữ liệu XML của chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT. Công thức không thu thêm phần chênh lệch chỉ có ở bộ thứ hai. Không khai rõ dòng theo bộ nào thì mọi phép đối soát
đều mơ hồ.
Ranh giới. Extension mô tả dòng được tính THEO CÁCH NÀO; nó không tự tính và không thay giá
trị tiền. Số tiền vẫn nằm ở carrier chi phí, và cột 9 luôn là giá trị authoritative.
Biểu diễn khác của hồ sơ: CSV, Excel, Schematron