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.10.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 - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Phần mở rộng: Thuộc tính dòng bảng kê chi phí — Cost Statement Line Attributes

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-statement-line Phiên bản: 0.10.0
Computable Name: VNCoreExtCostStatementLine
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.135

Bản quyền/Pháp lý: Bộ Y tế Việt Nam — QĐ 697/QĐ-BYT (19/03/2026), mẫu bảng kê chi phí khám bệnh, chữa bệnh.

Ba thuộc tính của một dòng bảng kê mà Invoice.lineItem của FHIR R4 không có sẵn: phân đoạn thẻ mà dòng thuộc về, nhóm chi phí, và ngày hoặc khoảng thực hiện.

Invoice.lineItem chỉ có sequence, chargeItem[x] và priceComponent. Ba dữ liệu dưới đây là cột bắt buộc của mẫu QĐ 697/QĐ-BYT nên phải bổ sung; số lượng và tiền thì dùng element gốc (priceComponent.factor và priceComponent.amount).

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 Thuộc tính dòng bảng kê chi phí — Cost Statement Line Attributes
... extension 3..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:segmentSequence S 1..1 Extension Phân đoạn thẻ mà dòng này thuộc về — Owning card segment
..... extension 0..0 Extension
..... url 1..1 uri "segmentSequence"
..... value[x] 1..1 positiveInt Value of extension
.... extension:category S 1..1 Extension Nhóm chi phí theo mẫu bảng kê — Cost category
..... extension 0..0 Extension
..... url 1..1 uri "category"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Danh mục chi phí KCB — Vietnam Cost Category ValueSet (required)
.... extension:serviced S 1..1 Extension Ngày hoặc khoảng thực hiện — Service date or period
..... extension 0..0 Extension
..... url 1..1 uri "serviced"
..... value[x] 1..1 Value of extension
...... valueDate date
...... valuePeriod Period
.... extension:unit S 0..1 Extension Đơn vị tính — cột (2) của mẫu
..... extension 0..0 Extension
..... url 1..1 uri "unit"
..... value[x] 1..1 string Value of extension
.... extension:hospitalUnitPrice S 0..1 Extension Đơn giá bệnh viện — cột (4) của mẫu
..... extension 0..0 Extension
..... url 1..1 uri "hospitalUnitPrice"
..... value[x] 1..1 Money Value of extension
.... extension:packageComponent S 0..* Extension Thiết bị y tế thành phần của gói — các dòng '- Tên TBYT' dưới mục 10.x
..... extension 1..* Extension Extension
..... Slices for extension Content/Rules for all slices
...... extension:item S 1..1 Extension Tên hoặc mã thiết bị y tế — cột (1)
....... extension 0..0 Extension
....... url 1..1 uri "item"
....... value[x] 1..1 CodeableConcept Value of extension
...... extension:unit S 0..1 Extension Đơn vị tính — cột (2)
....... extension 0..0 Extension
....... url 1..1 uri "unit"
....... value[x] 1..1 string Value of extension
...... extension:quantity S 0..1 Extension Số lượng — cột (3)
....... extension 0..0 Extension
....... url 1..1 uri "quantity"
....... value[x] 1..1 decimal Value of extension
...... extension:hospitalUnitPrice S 0..1 Extension Đơn giá bệnh viện — cột (4)
....... extension 0..0 Extension
....... url 1..1 uri "hospitalUnitPrice"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceUnitPrice S 0..1 Extension Đơn giá bảo hiểm — cột (5)
....... extension 0..0 Extension
....... url 1..1 uri "insuranceUnitPrice"
....... value[x] 1..1 Money Value of extension
...... extension:serviceRate 0..1 Extension Tỷ lệ thanh toán theo dịch vụ (%) — cột (6), mẫu quy định ghi 100
....... extension 0..0 Extension
....... url 1..1 uri "serviceRate"
....... value[x] 1..1 decimal Value of extension
...... extension:hospitalAmount S 0..1 Extension Thành tiền bệnh viện — cột (7)
....... extension 0..0 Extension
....... url 1..1 uri "hospitalAmount"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceRate S 0..1 Extension Tỷ lệ thanh toán BHYT (%) — cột (8), ghi theo từng TBYT
....... extension 0..0 Extension
....... url 1..1 uri "insuranceRate"
....... value[x] 1..1 decimal Value of extension
...... extension:insuranceAmount S 0..1 Extension Thành tiền bảo hiểm — cột (9)
....... extension 0..0 Extension
....... url 1..1 uri "insuranceAmount"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceFund 0..1 Extension Quỹ BHYT — cột (10), tuỳ chọn theo QĐ 697/QĐ-BYT
....... extension 0..0 Extension
....... url 1..1 uri "insuranceFund"
....... value[x] 1..1 Money Value of extension
...... extension:patientCopay 0..1 Extension Người bệnh cùng chi trả — cột (11), tuỳ chọn
....... extension 0..0 Extension
....... url 1..1 uri "patientCopay"
....... value[x] 1..1 Money Value of extension
...... extension:otherSource 0..1 Extension Nguồn khác — cột (12), tuỳ chọn
....... extension 0..0 Extension
....... url 1..1 uri "otherSource"
....... value[x] 1..1 Money Value of extension
...... extension:patientSelfPay 0..1 Extension Người bệnh tự trả — cột (13), tuỳ chọn
....... extension 0..0 Extension
....... url 1..1 uri "patientSelfPay"
....... value[x] 1..1 Money Value of extension
...... extension:excludedFromPackageTotal S 0..1 Extension Không cộng vào tổng thành tiền BH của gói
....... extension 0..0 Extension
....... url 1..1 uri "excludedFromPackageTotal"
....... value[x] 1..1 boolean Value of extension
..... url 1..1 uri "packageComponent"
..... value[x] 0..0 Value of extension
.... extension:relatedServiceSequence S 0..1 Extension Dòng dịch vụ kỹ thuật mà gói đi kèm
..... extension 0..0 Extension
..... url 1..1 uri "relatedServiceSequence"
..... value[x] 1..1 positiveInt Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-statement-line"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:category.​value[x] Base required Danh mục chi phí KCB — Vietnam Cost Category ValueSet 📦0.10.0 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thuộc tính dòng bảng kê chi phí — Cost Statement Line Attributes
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 3..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:segmentSequence S 1..1 Extension Phân đoạn thẻ mà dòng này thuộc về — Owning card segment
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "segmentSequence"
..... value[x] 1..1 positiveInt Value of extension
.... extension:category S 1..1 Extension Nhóm chi phí theo mẫu bảng kê — Cost category
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "category"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Danh mục chi phí KCB — Vietnam Cost Category ValueSet (required)
.... extension:serviced S 1..1 Extension Ngày hoặc khoảng thực hiện — Service date or period
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "serviced"
..... value[x] 1..1 Value of extension
...... valueDate date
...... valuePeriod Period
.... extension:unit S 0..1 Extension Đơn vị tính — cột (2) của mẫu
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "unit"
..... value[x] 1..1 string Value of extension
.... extension:hospitalUnitPrice S 0..1 Extension Đơn giá bệnh viện — cột (4) của mẫu
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "hospitalUnitPrice"
..... value[x] 1..1 Money Value of extension
.... extension:packageComponent S 0..* Extension Thiết bị y tế thành phần của gói — các dòng '- Tên TBYT' dưới mục 10.x
..... id 0..1 string Unique id for inter-element referencing
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
..... Slices for extension Content/Rules for all slices
...... extension:item S 1..1 Extension Tên hoặc mã thiết bị y tế — cột (1)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "item"
....... value[x] 1..1 CodeableConcept Value of extension
...... extension:unit S 0..1 Extension Đơn vị tính — cột (2)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "unit"
....... value[x] 1..1 string Value of extension
...... extension:quantity S 0..1 Extension Số lượng — cột (3)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "quantity"
....... value[x] 1..1 decimal Value of extension
...... extension:hospitalUnitPrice S 0..1 Extension Đơn giá bệnh viện — cột (4)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "hospitalUnitPrice"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceUnitPrice S 0..1 Extension Đơn giá bảo hiểm — cột (5)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "insuranceUnitPrice"
....... value[x] 1..1 Money Value of extension
...... extension:serviceRate 0..1 Extension Tỷ lệ thanh toán theo dịch vụ (%) — cột (6), mẫu quy định ghi 100
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "serviceRate"
....... value[x] 1..1 decimal Value of extension
...... extension:hospitalAmount S 0..1 Extension Thành tiền bệnh viện — cột (7)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "hospitalAmount"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceRate S 0..1 Extension Tỷ lệ thanh toán BHYT (%) — cột (8), ghi theo từng TBYT
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "insuranceRate"
....... value[x] 1..1 decimal Value of extension
...... extension:insuranceAmount S 0..1 Extension Thành tiền bảo hiểm — cột (9)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "insuranceAmount"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceFund 0..1 Extension Quỹ BHYT — cột (10), tuỳ chọn theo QĐ 697/QĐ-BYT
....... 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
...... extension:patientCopay 0..1 Extension Người bệnh cùng chi trả — cột (11), tuỳ chọn
....... 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
...... extension:otherSource 0..1 Extension Nguồn khác — cột (12), tuỳ chọn
....... 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
...... extension:patientSelfPay 0..1 Extension Người bệnh tự trả — cột (13), tuỳ chọn
....... 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
...... extension:excludedFromPackageTotal S 0..1 Extension Không cộng vào tổng thành tiền BH của gói
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "excludedFromPackageTotal"
....... value[x] 1..1 boolean Value of extension
..... url 1..1 uri "packageComponent"
.... extension:relatedServiceSequence S 0..1 Extension Dòng dịch vụ kỹ thuật mà gói đi kèm
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "relatedServiceSequence"
..... value[x] 1..1 positiveInt Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-statement-line"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:category.​value[x] Base required Danh mục chi phí KCB — Vietnam Cost Category ValueSet 📦0.10.0 This IG

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

Complex Extension: Ba thuộc tính của một dòng bảng kê mà Invoice.lineItem của FHIR R4 không có sẵn: phân đoạn thẻ mà dòng thuộc về, nhóm chi phí, và ngày hoặc khoảng thực hiện. Invoice.lineItem chỉ có sequence, chargeItem[x] và priceComponent. Ba dữ liệu dưới đây là cột bắt buộc của mẫu QĐ 697/QĐ-BYT nên phải bổ sung; số lượng và tiền thì dùng element gốc (priceComponent.factor và priceComponent.amount).

  • segmentSequence: positiveInt: Trỏ tới sequence của một phân đoạn khai ở vn-ext-cost-statement-segment trên chính Invoice này.
  • category: CodeableConcept: Một trong các nhóm chi phí của mẫu QĐ 697/QĐ-BYT (khám bệnh, ngày giường, xét nghiệm, chẩn đoán hình ảnh, thuốc, vật tư…).
  • serviced: date, Period: Thời điểm thực hiện dịch vụ của dòng. Yêu cầu nghiệp vụ: phải nằm trong period của phân đoạn mà dòng trỏ tới — nếu không thì chi phí đang bị tính vào sai mức hưởng. Về cách kiểm: ràng buộc chéo dòng↔phân đoạn không khai thành invariant FHIRPath (biểu thức phức tạp, dễ sai hơn giá trị nó mang lại — quyết định giữ nguyên); từ 0.10.0 nó được kiểm bằng máy ở tầng example-graph gate ([COST-SERVICED-SEGMENT]) cho toàn bộ corpus ví dụ của IG, còn dữ liệu production do bên triển khai kiểm ở tầng ứng dụng. Xem vn-cost-statement-line-segment-exists cho phần dòng-phải-trỏ-phân-đoạn-có-thật.
  • unit: string: Đơn vị tính của khoản chi phí: lần, ngày, viên, ống, đơn vị máu… Chỉ khai khi dòng KHÔNG trỏ tới ChargeItem; nếu có chargeItemReference thì lấy từ ChargeItem.quantity.unit.
  • hospitalUnitPrice: Money: Đơn giá theo mức giá của cơ sở, tính bằng đồng. Chỉ khai khi dòng KHÔNG trỏ tới ChargeItem; nếu có thì tra qua ChargeItem.definitionCanonical → VNCoreChargeItemDefinition. Lưu đơn giá thay vì suy ra amount ÷ factor để không lệch khi làm tròn.
  • item: CodeableConcept: Ghi theo tên kết quả trúng thầu hoặc tên thương mại của hàng hoá. Với đơn vị tính là bộ thì ghi chi tiết từng hạng mục, sản phẩm nếu có giá của từng hạng mục.
  • unit: string: An Extension
  • quantity: decimal: An Extension
  • hospitalUnitPrice: Money: Đơn giá theo giá mua vào của cơ sở KBCB theo quy định của pháp luật về đấu thầu.
  • insuranceUnitPrice: Money: Bằng đơn giá BV nếu TBYT không có mức thanh toán quy định; nếu có mức thanh toán thì lấy giá trị nhỏ hơn giữa đơn giá BV và mức thanh toán. TBYT ngoài phạm vi thanh toán của quỹ BHYT thì ghi 0.
  • serviceRate: decimal: An Extension
  • hospitalAmount: Money: An Extension
  • insuranceRate: decimal: Tỷ lệ thanh toán của từng TBYT. Đối tượng quy định tại Điều 16 NĐ 188/2025/NĐ-CP và Điều 2 NĐ 70/2015/NĐ-CP (đã sửa bởi NĐ 74/2025/NĐ-CP) ghi 100%; TBYT ngoài danh mục BHYT ghi 0%.
  • insuranceAmount: Money: Thành tiền BH của riêng thành phần này. Tổng các giá trị này (trừ thành phần có excludedFromPackageTotal = true) là bước 1 khi tính ô 'Thành tiền BH' của dòng gói.
  • insuranceFund: Money: An Extension
  • patientCopay: Money: An Extension
  • otherSource: Money: An Extension
  • patientSelfPay: Money: An Extension
  • excludedFromPackageTotal: boolean: Đặt true cho trường hợp mẫu loại trừ khỏi bước 1: dịch vụ đặt stent động mạch vành dùng từ 2 stent phủ thuốc trở lên thì stent thứ 2, thứ 3… không tính vào tổng thành tiền BH của gói. Mặc định khi vắng là false.
  • relatedServiceSequence: positiveInt: Trỏ tới sequence của dòng dịch vụ kỹ thuật trên chính bảng kê này — mẫu ghi rõ gói thiết bị phải 'ghi kèm theo tên dịch vụ kỹ thuật thực hiện'. Nhờ đó biết gói thuộc lần thực hiện dịch vụ nào thay vì chỉ dựa vào thứ tự dòng.

Dạng xem DifferentialDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thuộc tính dòng bảng kê chi phí — Cost Statement Line Attributes
... extension 3..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:segmentSequence S 1..1 Extension Phân đoạn thẻ mà dòng này thuộc về — Owning card segment
..... extension 0..0 Extension
..... url 1..1 uri "segmentSequence"
..... value[x] 1..1 positiveInt Value of extension
.... extension:category S 1..1 Extension Nhóm chi phí theo mẫu bảng kê — Cost category
..... extension 0..0 Extension
..... url 1..1 uri "category"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Danh mục chi phí KCB — Vietnam Cost Category ValueSet (required)
.... extension:serviced S 1..1 Extension Ngày hoặc khoảng thực hiện — Service date or period
..... extension 0..0 Extension
..... url 1..1 uri "serviced"
..... value[x] 1..1 Value of extension
...... valueDate date
...... valuePeriod Period
.... extension:unit S 0..1 Extension Đơn vị tính — cột (2) của mẫu
..... extension 0..0 Extension
..... url 1..1 uri "unit"
..... value[x] 1..1 string Value of extension
.... extension:hospitalUnitPrice S 0..1 Extension Đơn giá bệnh viện — cột (4) của mẫu
..... extension 0..0 Extension
..... url 1..1 uri "hospitalUnitPrice"
..... value[x] 1..1 Money Value of extension
.... extension:packageComponent S 0..* Extension Thiết bị y tế thành phần của gói — các dòng '- Tên TBYT' dưới mục 10.x
..... extension 1..* Extension Extension
..... Slices for extension Content/Rules for all slices
...... extension:item S 1..1 Extension Tên hoặc mã thiết bị y tế — cột (1)
....... extension 0..0 Extension
....... url 1..1 uri "item"
....... value[x] 1..1 CodeableConcept Value of extension
...... extension:unit S 0..1 Extension Đơn vị tính — cột (2)
....... extension 0..0 Extension
....... url 1..1 uri "unit"
....... value[x] 1..1 string Value of extension
...... extension:quantity S 0..1 Extension Số lượng — cột (3)
....... extension 0..0 Extension
....... url 1..1 uri "quantity"
....... value[x] 1..1 decimal Value of extension
...... extension:hospitalUnitPrice S 0..1 Extension Đơn giá bệnh viện — cột (4)
....... extension 0..0 Extension
....... url 1..1 uri "hospitalUnitPrice"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceUnitPrice S 0..1 Extension Đơn giá bảo hiểm — cột (5)
....... extension 0..0 Extension
....... url 1..1 uri "insuranceUnitPrice"
....... value[x] 1..1 Money Value of extension
...... extension:serviceRate 0..1 Extension Tỷ lệ thanh toán theo dịch vụ (%) — cột (6), mẫu quy định ghi 100
....... extension 0..0 Extension
....... url 1..1 uri "serviceRate"
....... value[x] 1..1 decimal Value of extension
...... extension:hospitalAmount S 0..1 Extension Thành tiền bệnh viện — cột (7)
....... extension 0..0 Extension
....... url 1..1 uri "hospitalAmount"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceRate S 0..1 Extension Tỷ lệ thanh toán BHYT (%) — cột (8), ghi theo từng TBYT
....... extension 0..0 Extension
....... url 1..1 uri "insuranceRate"
....... value[x] 1..1 decimal Value of extension
...... extension:insuranceAmount S 0..1 Extension Thành tiền bảo hiểm — cột (9)
....... extension 0..0 Extension
....... url 1..1 uri "insuranceAmount"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceFund 0..1 Extension Quỹ BHYT — cột (10), tuỳ chọn theo QĐ 697/QĐ-BYT
....... extension 0..0 Extension
....... url 1..1 uri "insuranceFund"
....... value[x] 1..1 Money Value of extension
...... extension:patientCopay 0..1 Extension Người bệnh cùng chi trả — cột (11), tuỳ chọn
....... extension 0..0 Extension
....... url 1..1 uri "patientCopay"
....... value[x] 1..1 Money Value of extension
...... extension:otherSource 0..1 Extension Nguồn khác — cột (12), tuỳ chọn
....... extension 0..0 Extension
....... url 1..1 uri "otherSource"
....... value[x] 1..1 Money Value of extension
...... extension:patientSelfPay 0..1 Extension Người bệnh tự trả — cột (13), tuỳ chọn
....... extension 0..0 Extension
....... url 1..1 uri "patientSelfPay"
....... value[x] 1..1 Money Value of extension
...... extension:excludedFromPackageTotal S 0..1 Extension Không cộng vào tổng thành tiền BH của gói
....... extension 0..0 Extension
....... url 1..1 uri "excludedFromPackageTotal"
....... value[x] 1..1 boolean Value of extension
..... url 1..1 uri "packageComponent"
..... value[x] 0..0 Value of extension
.... extension:relatedServiceSequence S 0..1 Extension Dòng dịch vụ kỹ thuật mà gói đi kèm
..... extension 0..0 Extension
..... url 1..1 uri "relatedServiceSequence"
..... value[x] 1..1 positiveInt Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-statement-line"

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Extension.extension:category.​value[x] Base required Danh mục chi phí KCB — Vietnam Cost Category ValueSet 📦0.10.0 This IG

Dạng xem Snapshot

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thuộc tính dòng bảng kê chi phí — Cost Statement Line Attributes
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 3..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:segmentSequence S 1..1 Extension Phân đoạn thẻ mà dòng này thuộc về — Owning card segment
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "segmentSequence"
..... value[x] 1..1 positiveInt Value of extension
.... extension:category S 1..1 Extension Nhóm chi phí theo mẫu bảng kê — Cost category
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "category"
..... value[x] 1..1 CodeableConcept Value of extension
Binding: Danh mục chi phí KCB — Vietnam Cost Category ValueSet (required)
.... extension:serviced S 1..1 Extension Ngày hoặc khoảng thực hiện — Service date or period
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "serviced"
..... value[x] 1..1 Value of extension
...... valueDate date
...... valuePeriod Period
.... extension:unit S 0..1 Extension Đơn vị tính — cột (2) của mẫu
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "unit"
..... value[x] 1..1 string Value of extension
.... extension:hospitalUnitPrice S 0..1 Extension Đơn giá bệnh viện — cột (4) của mẫu
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "hospitalUnitPrice"
..... value[x] 1..1 Money Value of extension
.... extension:packageComponent S 0..* Extension Thiết bị y tế thành phần của gói — các dòng '- Tên TBYT' dưới mục 10.x
..... id 0..1 string Unique id for inter-element referencing
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
..... Slices for extension Content/Rules for all slices
...... extension:item S 1..1 Extension Tên hoặc mã thiết bị y tế — cột (1)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "item"
....... value[x] 1..1 CodeableConcept Value of extension
...... extension:unit S 0..1 Extension Đơn vị tính — cột (2)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "unit"
....... value[x] 1..1 string Value of extension
...... extension:quantity S 0..1 Extension Số lượng — cột (3)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "quantity"
....... value[x] 1..1 decimal Value of extension
...... extension:hospitalUnitPrice S 0..1 Extension Đơn giá bệnh viện — cột (4)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "hospitalUnitPrice"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceUnitPrice S 0..1 Extension Đơn giá bảo hiểm — cột (5)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "insuranceUnitPrice"
....... value[x] 1..1 Money Value of extension
...... extension:serviceRate 0..1 Extension Tỷ lệ thanh toán theo dịch vụ (%) — cột (6), mẫu quy định ghi 100
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "serviceRate"
....... value[x] 1..1 decimal Value of extension
...... extension:hospitalAmount S 0..1 Extension Thành tiền bệnh viện — cột (7)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "hospitalAmount"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceRate S 0..1 Extension Tỷ lệ thanh toán BHYT (%) — cột (8), ghi theo từng TBYT
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "insuranceRate"
....... value[x] 1..1 decimal Value of extension
...... extension:insuranceAmount S 0..1 Extension Thành tiền bảo hiểm — cột (9)
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "insuranceAmount"
....... value[x] 1..1 Money Value of extension
...... extension:insuranceFund 0..1 Extension Quỹ BHYT — cột (10), tuỳ chọn theo QĐ 697/QĐ-BYT
....... 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
...... extension:patientCopay 0..1 Extension Người bệnh cùng chi trả — cột (11), tuỳ chọn
....... 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
...... extension:otherSource 0..1 Extension Nguồn khác — cột (12), tuỳ chọn
....... 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
...... extension:patientSelfPay 0..1 Extension Người bệnh tự trả — cột (13), tuỳ chọn
....... 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
...... extension:excludedFromPackageTotal S 0..1 Extension Không cộng vào tổng thành tiền BH của gói
....... id 0..1 string Unique id for inter-element referencing
....... extension 0..0 Extension
Slice: Unordered, Open by value:url
....... url 1..1 uri "excludedFromPackageTotal"
....... value[x] 1..1 boolean Value of extension
..... url 1..1 uri "packageComponent"
.... extension:relatedServiceSequence S 0..1 Extension Dòng dịch vụ kỹ thuật mà gói đi kèm
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "relatedServiceSequence"
..... value[x] 1..1 positiveInt Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-cost-statement-line"

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:category.​value[x] Base required Danh mục chi phí KCB — Vietnam Cost Category ValueSet 📦0.10.0 This IG

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

Complex Extension: Ba thuộc tính của một dòng bảng kê mà Invoice.lineItem của FHIR R4 không có sẵn: phân đoạn thẻ mà dòng thuộc về, nhóm chi phí, và ngày hoặc khoảng thực hiện. Invoice.lineItem chỉ có sequence, chargeItem[x] và priceComponent. Ba dữ liệu dưới đây là cột bắt buộc của mẫu QĐ 697/QĐ-BYT nên phải bổ sung; số lượng và tiền thì dùng element gốc (priceComponent.factor và priceComponent.amount).

  • segmentSequence: positiveInt: Trỏ tới sequence của một phân đoạn khai ở vn-ext-cost-statement-segment trên chính Invoice này.
  • category: CodeableConcept: Một trong các nhóm chi phí của mẫu QĐ 697/QĐ-BYT (khám bệnh, ngày giường, xét nghiệm, chẩn đoán hình ảnh, thuốc, vật tư…).
  • serviced: date, Period: Thời điểm thực hiện dịch vụ của dòng. Yêu cầu nghiệp vụ: phải nằm trong period của phân đoạn mà dòng trỏ tới — nếu không thì chi phí đang bị tính vào sai mức hưởng. Về cách kiểm: ràng buộc chéo dòng↔phân đoạn không khai thành invariant FHIRPath (biểu thức phức tạp, dễ sai hơn giá trị nó mang lại — quyết định giữ nguyên); từ 0.10.0 nó được kiểm bằng máy ở tầng example-graph gate ([COST-SERVICED-SEGMENT]) cho toàn bộ corpus ví dụ của IG, còn dữ liệu production do bên triển khai kiểm ở tầng ứng dụng. Xem vn-cost-statement-line-segment-exists cho phần dòng-phải-trỏ-phân-đoạn-có-thật.
  • unit: string: Đơn vị tính của khoản chi phí: lần, ngày, viên, ống, đơn vị máu… Chỉ khai khi dòng KHÔNG trỏ tới ChargeItem; nếu có chargeItemReference thì lấy từ ChargeItem.quantity.unit.
  • hospitalUnitPrice: Money: Đơn giá theo mức giá của cơ sở, tính bằng đồng. Chỉ khai khi dòng KHÔNG trỏ tới ChargeItem; nếu có thì tra qua ChargeItem.definitionCanonical → VNCoreChargeItemDefinition. Lưu đơn giá thay vì suy ra amount ÷ factor để không lệch khi làm tròn.
  • item: CodeableConcept: Ghi theo tên kết quả trúng thầu hoặc tên thương mại của hàng hoá. Với đơn vị tính là bộ thì ghi chi tiết từng hạng mục, sản phẩm nếu có giá của từng hạng mục.
  • unit: string: An Extension
  • quantity: decimal: An Extension
  • hospitalUnitPrice: Money: Đơn giá theo giá mua vào của cơ sở KBCB theo quy định của pháp luật về đấu thầu.
  • insuranceUnitPrice: Money: Bằng đơn giá BV nếu TBYT không có mức thanh toán quy định; nếu có mức thanh toán thì lấy giá trị nhỏ hơn giữa đơn giá BV và mức thanh toán. TBYT ngoài phạm vi thanh toán của quỹ BHYT thì ghi 0.
  • serviceRate: decimal: An Extension
  • hospitalAmount: Money: An Extension
  • insuranceRate: decimal: Tỷ lệ thanh toán của từng TBYT. Đối tượng quy định tại Điều 16 NĐ 188/2025/NĐ-CP và Điều 2 NĐ 70/2015/NĐ-CP (đã sửa bởi NĐ 74/2025/NĐ-CP) ghi 100%; TBYT ngoài danh mục BHYT ghi 0%.
  • insuranceAmount: Money: Thành tiền BH của riêng thành phần này. Tổng các giá trị này (trừ thành phần có excludedFromPackageTotal = true) là bước 1 khi tính ô 'Thành tiền BH' của dòng gói.
  • insuranceFund: Money: An Extension
  • patientCopay: Money: An Extension
  • otherSource: Money: An Extension
  • patientSelfPay: Money: An Extension
  • excludedFromPackageTotal: boolean: Đặt true cho trường hợp mẫu loại trừ khỏi bước 1: dịch vụ đặt stent động mạch vành dùng từ 2 stent phủ thuốc trở lên thì stent thứ 2, thứ 3… không tính vào tổng thành tiền BH của gói. Mặc định khi vắng là false.
  • relatedServiceSequence: positiveInt: Trỏ tới sequence của dòng dịch vụ kỹ thuật trên chính bảng kê này — mẫu ghi rõ gói thiết bị phải 'ghi kèm theo tên dịch vụ kỹ thuật thực hiện'. Nhờ đó biết gói thuộc lần thực hiện dịch vụ nào thay vì chỉ dựa vào thứ tự dòng.

 

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