Thông tin chi phí BHYT — Insurance Cost Info Extension - Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide v0.10.0

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: Thông tin chi phí BHYT — Insurance Cost Info Extension - Mô tả chi tiết

Draft tại thời điểm 2026-08-06

Các định nghĩa cho vn-ext-insurance-cost-info phần mở rộng

Bảng phần tử chính
Bảng Differential
Bảng Snapshot

Guidance on how to interpret the contents of this table can be foundhere

0. Extension
Definition	Extension tái sử dụng cho thông tin chi phí BHYT trên từng item (thuốc/DVKT/VTYT). Bao gồm: phạm vi BHYT (PHAM_VI), tỷ lệ thanh toán BHYT (TYLE_TT/TYLE_TT_BH), mức hưởng (MUC_HUONG), mức trần thanh toán BHYT (T_TRANTT), tỷ lệ thanh toán dịch vụ (TYLE_TT_DV), đơn giá BHYT (DON_GIA_BH) và thành tiền BHYT (THANH_TIEN_BH). Dùng trên Claim.item, Claim.item.detail, ExplanationOfBenefit.item, ExplanationOfBenefit.item.detail và Invoice.lineItem. Thông tin từ các resource lâm sàng hoặc dược được đưa vào dòng chi phí tương ứng; không gắn extension này trực tiếp lên những resource nguồn đó. Với thiết bị/vật tư, ưu tiên đặt trên Claim.item hoặc item.detail; không dùng trên DeviceUseStatement vì DeviceUseStatement là ghi nhận sử dụng lâm sàng. Theo QĐ 697/QĐ-BYT (các dòng hướng dẫn khoảng 389 và 407), component trong gói TBYT mang lossless các cột 5/6/8/9; chỉ các cột 10–13 được tính ở item tổng gói. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG; DON_GIA_BH (Bảng 3 STT 15), TYLE_TT_DV (Bảng 3 STT 17), THANH_TIEN_BH (Bảng 2 STT 21, Bảng 3 STT 20), T_TRANTT (Bảng 3 STT 21). Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level). Căn cứ: QĐ 3176/QĐ-BYT đọc cùng QĐ 1931/QĐ-BYT (áp dụng từ 01/07/2026) cho trường MUC_HUONG/SO_DANG_KY; QĐ 697/QĐ-BYT cho các cột bảng kê; VBHN 14/VBHN-BYT (hợp nhất TT 04/2017/TT-BYT với TT 50/2017/TT-BYT và TT 24/2025/TT-BYT) cho mức thanh toán TBYT; NĐ 188/2025/NĐ-CP là bối cảnh quyền lợi/ngoại lệ, không phải nguồn duy nhất của mọi trần dòng chi phí. English summary: Reusable BHYT cost information on Claim/EOB items and item details, and Invoice line items. Medication, procedure and service facts are represented on the corresponding financial line, not by placing this extension on the source clinical resource. On a medical-device package, each Claim/EOB item detail carries columns 5/6/8/9 losslessly, while columns 10–13 remain on the package item. `insuranceLineAmount` represents the insurance-eligible line amount (THANH_TIEN_BH/column 9), not the final BHYT fund allocation; on an EOB it aligns with adjudication `eligible`, while the fund allocation uses adjudication `benefit`. Optional Extension Element - found in all resources.
Short	Thông tin chi phí BHYT — Insurance Cost Info ExtensionOptional Extensions Element
Control	0..* This element is affected by the following invariants: ele-1
Is Modifier	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) vn-insurance-cost-ratio-and-lexical: Các tỷ lệ phải nằm trong khoảng 0-100; chuỗi lexical gốc nếu có phải đi kèm paymentRatio; khoảng hiệu lực trần nếu có phải đi kèm paymentCeiling. Percentage values SHALL be within 0-100; a source lexical string SHALL accompany paymentRatio; a ceiling period SHALL accompany paymentCeiling. (extension.where(url = 'paymentRatio').value.ofType(decimal).all($this >= 0 and $this <= 100) and extension.where(url = 'servicePaymentRatio').value.ofType(decimal).all($this >= 0 and $this <= 100) and extension.where(url = 'benefitLevel').value.ofType(decimal).all($this >= 0 and $this <= 100) and (extension.where(url = 'paymentRatioSourceLexical').empty() or extension.where(url = 'paymentRatio').exists()) and (extension.where(url = 'paymentCeilingPeriod').empty() or extension.where(url = 'paymentCeiling').exists())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
2. Extension.extension:scope
Slice Name	scope
Definition	An Extension
Short	Phạm vi BHYT (PHAM_VI): 1=trong DM, 2=ngoài DM, 3=NĐ 70/2015/NĐ-CPAdditional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
4. Extension.extension:scope.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
6. Extension.extension:scope.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`scope`
8. Extension.extension:scope.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	10..1
Binding	Unless not suitable, these codes SHALL be taken from For codes, see Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet (extensible to `http://fhir.hl7.org.vn/core/ValueSet/vn-insurance-scope-vs`)
Type	CodeableConcept, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
10. Extension.extension:paymentRatio
Slice Name	paymentRatio
Definition	Tỷ lệ thanh toán BHYT của dòng (cột 8). Không bắt buộc trên mọi dòng: vắng mặt biểu thị dòng ngoài phạm vi BHYT; nếu cần truyền lý do không có giá trị, dùng Data Absent Reason (DAR). NGOẠI LỆ trên VNCoreCostStatementInvoice: dòng thuộc phân đoạn không có `coverage` phải khai `paymentRatio = 0` tường minh, KHÔNG dùng DAR và không để trống (QĐ 697/QĐ-BYT Phần Hai mục 2). The line's BHYT payment ratio (column 8). It is not mandatory on every line: absence denotes a line outside BHYT scope; use Data Absent Reason (DAR) when the reason for a missing value must be conveyed. EXCEPTION on VNCoreCostStatementInvoice: a line owned by a segment without Coverage SHALL declare paymentRatio = 0 explicitly, neither absent nor DAR.
Short	Tỷ lệ thanh toán BHYT (TYLE_TT) — VD: 100, 80, 50Additional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
12. Extension.extension:paymentRatio.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
14. Extension.extension:paymentRatio.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`paymentRatio`
16. Extension.extension:paymentRatio.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	10..1
Type	decimal, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
18. Extension.extension:paymentRatioSourceLexical
Slice Name	paymentRatioSourceLexical
Definition	Giữ NGUYÊN chuỗi nhận từ chứng từ nguồn để đối soát và round-trip. Cần thiết vì hai nguồn không tương thích về kiểu: QĐ 697/QĐ-BYT ghi tỷ lệ dạng thập phân có dấu phẩy — dòng stent thứ ba trong mẫu bảng kê ghi `33,33` — trong khi QĐ 130/QĐ-BYT (chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT) quy định TYLE_TT_BH là số NGUYÊN dương độ dài 3. Chuẩn hoá sang decimal làm mất chuỗi gốc, còn ép về số nguyên làm mất giá trị. Trường này KHÔNG thay `paymentRatio`: bên tính toán luôn đọc `paymentRatio`.
Short	Chuỗi tỷ lệ nguyên gốc từ nguồn (vd `33,33`)Additional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
20. Extension.extension:paymentRatioSourceLexical.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
22. Extension.extension:paymentRatioSourceLexical.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`paymentRatioSourceLexical`
24. Extension.extension:paymentRatioSourceLexical.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	10..1
Type	string, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
26. Extension.extension:benefitLevel
Slice Name	benefitLevel
Definition	Mức hưởng dùng trong dữ liệu đầu ra KCB. QĐ 1931/QĐ-BYT sửa QĐ 3176/QĐ-BYT, cho phép trường MUC_HUONG ở Bảng 2 và Bảng 3 có tối đa 4 ký tự từ 01/07/2026; giới hạn chuỗi này thuộc lớp xuất XML, không phải precision/cardinality của decimal FHIR.
Short	Mức hưởng BHYT (MUC_HUONG) — VD: 100, 80, 40Additional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
28. Extension.extension:benefitLevel.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
30. Extension.extension:benefitLevel.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`benefitLevel`
32. Extension.extension:benefitLevel.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	10..1
Type	decimal, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
34. Extension.extension:paymentCeiling
Slice Name	paymentCeiling
Definition	An Extension
Short	Mức trần thanh toán BHYT của dòng chi phí (T_TRANTT)Additional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
36. Extension.extension:paymentCeiling.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
38. Extension.extension:paymentCeiling.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`paymentCeiling`
40. Extension.extension:paymentCeiling.value[x]
Definition	Mức thanh toán tối đa của quỹ BHYT đối với dòng chi phí DVKT/TBYT trong một lần thực hiện (T_TRANTT). Nguồn trực tiếp cho trần TBYT là TT 04/2017/TT-BYT đã được sửa bởi TT 24/2025/TT-BYT và hợp nhất tại VBHN 14/VBHN-BYT; NĐ 188/2025/NĐ-CP Điều 16 và NĐ 74/2025/NĐ-CP cung cấp các bối cảnh/ngoại lệ liên quan, không phải nguồn duy nhất của mọi trần. Chỉ ghi khi dòng có quy định mức thanh toán BHYT; ánh xạ trường T_TRANTT (Bảng 3 STT 21) theo QĐ 3176/QĐ-BYT. Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Trần thanh toán BHYT (VND)Value of extension
Control	10..1
Type	Money, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
42. Extension.extension:paymentCeiling.value[x].currency
Definition	ISO 4217 Currency Code.
Short	ISO 4217 Currency Code
Control	10..1
Binding	The codes SHALL be taken from Currencieshttp://hl7.org/fhir/ValueSet/currencies\|4.0.1 (required to `http://hl7.org/fhir/ValueSet/currencies\|4.0.1`) A code indicating the currency, taken from ISO 4217.
Type	code
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	A code indicating the currency, taken from ISO 4217.
Fixed Value	`VND`
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
44. Extension.extension:paymentCeilingPeriod
Slice Name	paymentCeilingPeriod
Definition	Khoảng thời gian mà giá trị `paymentCeiling` áp dụng. Cần thiết vì trần 45 tháng lương cơ sở là số tiền TÍNH RA từ mức lương cơ sở tại thời điểm, không phải hằng số: NĐ 161/2026/NĐ-CP Điều 3 khoản 2 đặt lương cơ sở 2.530.000 đồng/tháng từ 01/07/2026, nên trần tương ứng là 113.850.000 đồng. Một bảng kê lập trước mốc đó mang trần khác; không có khoảng hiệu lực thì không đối chiếu lại được.
Short	Khoảng hiệu lực của mức trần thanh toánAdditional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
46. Extension.extension:paymentCeilingPeriod.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
48. Extension.extension:paymentCeilingPeriod.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`paymentCeilingPeriod`
50. Extension.extension:paymentCeilingPeriod.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	10..1
Type	Period, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
52. Extension.extension:paymentCeilingPeriod.value[x].start
Definition	The start of the period. The boundary is inclusive.
Short	Starting time with inclusive boundary
Comments	If the low element is missing, the meaning is that the low boundary is not known.
Control	10..1 This element is affected by the following invariants: per-1
Type	dateTime
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
54. Extension.extension:servicePaymentRatio
Slice Name	servicePaymentRatio
Definition	Tỷ lệ thanh toán của dịch vụ kỹ thuật, ngày giường hoặc tiền công khám (TYLE_TT_DV, cột 6; Bảng 3 STT 17) theo QĐ 3176/QĐ-BYT. Khác với paymentRatio (TYLE_TT_BH, cột 8; Bảng 3 STT 18), TYLE_TT_DV phản ánh mức tính giá dịch vụ, ví dụ nằm ghép 02 người ghi 50, nằm ghép từ 03 người ghi 33, giường 01 người ghi 100. Không bắt buộc trên mọi dòng; vắng mặt biểu thị dòng ngoài phạm vi BHYT hoặc cột không áp dụng, và dùng Data Absent Reason (DAR) khi cần phân biệt lý do. Tham gia công thức THANH_TIEN_BV = SO_LUONG × DON_GIA_BV × TYLE_TT_DV/100 (Bảng 3 STT 19) và THANH_TIEN_BH (Bảng 3 STT 20).
Short	Tỷ lệ thanh toán DVKT/giường/công khám (TYLE_TT_DV) — VD: 100, 50, 33Additional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
56. Extension.extension:servicePaymentRatio.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
58. Extension.extension:servicePaymentRatio.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`servicePaymentRatio`
60. Extension.extension:servicePaymentRatio.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	10..1
Type	decimal, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, Money, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
62. Extension.extension:insuranceUnitPrice
Slice Name	insuranceUnitPrice
Definition	Đơn giá dịch vụ kỹ thuật, VTYT, tiền giường bệnh, tiền công khám do quỹ BHYT thanh toán (DON_GIA_BH, cột 5; Bảng 3 STT 15) theo QĐ 3176/QĐ-BYT. Có thể khác đơn giá bệnh viện (DON_GIA_BV — Claim.item.unitPrice): khi VTYT có quy định mức thanh toán BHYT và DON_GIA_BV cao hơn mức thanh toán thì DON_GIA_BH = T_TRANTT (sub-extension paymentCeiling); không cao hơn thì DON_GIA_BH = DON_GIA_BV. Trường hợp VTYT tái sử dụng: DON_GIA_BH là giá thanh toán của 1 lần tái sử dụng. Không bắt buộc trên mọi dòng; vắng mặt biểu thị dòng ngoài phạm vi BHYT hoặc cột không áp dụng, và dùng Data Absent Reason (DAR) khi cần phân biệt lý do.
Short	Đơn giá do quỹ BHYT thanh toán (DON_GIA_BH)Additional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
64. Extension.extension:insuranceUnitPrice.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
66. Extension.extension:insuranceUnitPrice.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`insuranceUnitPrice`
68. Extension.extension:insuranceUnitPrice.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Đơn giá BHYT thanh toán (VND)Value of extension
Control	10..1
Type	Money, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
70. Extension.extension:insuranceUnitPrice.value[x].currency
Definition	ISO 4217 Currency Code.
Short	ISO 4217 Currency Code
Control	10..1
Binding	The codes SHALL be taken from Currencieshttp://hl7.org/fhir/ValueSet/currencies\|4.0.1 (required to `http://hl7.org/fhir/ValueSet/currencies\|4.0.1`) A code indicating the currency, taken from ISO 4217.
Type	code
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	A code indicating the currency, taken from ISO 4217.
Fixed Value	`VND`
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
72. Extension.extension:insuranceLineAmount
Slice Name	insuranceLineAmount
Definition	Giá trị AUTHORITATIVE của cột 9 bảng kê QĐ 697/QĐ-BYT (THANH_TIEN_BH), nhận từ chứng từ hoặc nguồn nghiệp vụ. TUYỆT ĐỐI KHÔNG suy ngược hay ghi đè từ số lượng × đơn giá × tỷ lệ: mẫu bảng kê QĐ 697/QĐ-BYT có dòng stent thứ ba với Đơn giá BH = 0 và tỷ lệ 33,33 nhưng Thành tiền BH = 12.000.000 đồng, vì stent thứ ba được thanh toán theo 1/3 chi phí giá mua vào và không quá 12.000.000 đồng chứ không theo công thức nhân. Công thức chỉ dùng để CẢNH BÁO đối soát trên những calculationBasis xác định.
Short	Thành tiền BH đủ điều kiện của dòng, cột 9 (THANH_TIEN_BH) — Eligible insurance line amountAdditional content defined by implementations
Control	0..1*
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
74. Extension.extension:insuranceLineAmount.extension
Definition	An Extension May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	ExtensionAdditional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..0*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
76. Extension.extension:insuranceLineAmount.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`insuranceLineAmount`
78. Extension.extension:insuranceLineAmount.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Thành tiền BH đủ điều kiện (VND) — Eligible insurance line amountValue of extension
Control	10..1
Type	Money, date, Meta, Address, Attachment, integer, Count, DataRequirement, Dosage, uuid, Identifier, Coding, SampledData, id, positiveInt, Distance, Period, Duration, canonical, Range, RelatedArtifact, base64Binary, UsageContext, Timing, decimal, CodeableConcept, ParameterDefinition, dateTime, code, string, Contributor, oid, instant, ContactPoint, HumanName, markdown, Ratio, Age, Reference, TriggerDefinition, Quantity, uri, url, Annotation, ContactDetail, boolean, Expression, Signature, unsignedInt, time
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
80. Extension.extension:insuranceLineAmount.value[x].currency
Definition	ISO 4217 Currency Code.
Short	ISO 4217 Currency Code
Control	10..1
Binding	The codes SHALL be taken from Currencieshttp://hl7.org/fhir/ValueSet/currencies\|4.0.1 (required to `http://hl7.org/fhir/ValueSet/currencies\|4.0.1`) A code indicating the currency, taken from ISO 4217.
Type	code
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	A code indicating the currency, taken from ISO 4217.
Fixed Value	`VND`
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
82. Extension.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info`
84. Extension.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	0..01
Type	Choice of: base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference, SampledData, Signature, Timing, ContactDetail, Contributor, DataRequirement, Expression, ParameterDefinition, RelatedArtifact, TriggerDefinition, UsageContext, Dosage, Meta
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))

Guidance on how to interpret the contents of this table can be foundhere

0. Extension
Definition	Extension tái sử dụng cho thông tin chi phí BHYT trên từng item (thuốc/DVKT/VTYT). Bao gồm: phạm vi BHYT (PHAM_VI), tỷ lệ thanh toán BHYT (TYLE_TT/TYLE_TT_BH), mức hưởng (MUC_HUONG), mức trần thanh toán BHYT (T_TRANTT), tỷ lệ thanh toán dịch vụ (TYLE_TT_DV), đơn giá BHYT (DON_GIA_BH) và thành tiền BHYT (THANH_TIEN_BH). Dùng trên Claim.item, Claim.item.detail, ExplanationOfBenefit.item, ExplanationOfBenefit.item.detail và Invoice.lineItem. Thông tin từ các resource lâm sàng hoặc dược được đưa vào dòng chi phí tương ứng; không gắn extension này trực tiếp lên những resource nguồn đó. Với thiết bị/vật tư, ưu tiên đặt trên Claim.item hoặc item.detail; không dùng trên DeviceUseStatement vì DeviceUseStatement là ghi nhận sử dụng lâm sàng. Theo QĐ 697/QĐ-BYT (các dòng hướng dẫn khoảng 389 và 407), component trong gói TBYT mang lossless các cột 5/6/8/9; chỉ các cột 10–13 được tính ở item tổng gói. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG; DON_GIA_BH (Bảng 3 STT 15), TYLE_TT_DV (Bảng 3 STT 17), THANH_TIEN_BH (Bảng 2 STT 21, Bảng 3 STT 20), T_TRANTT (Bảng 3 STT 21). Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level). Căn cứ: QĐ 3176/QĐ-BYT đọc cùng QĐ 1931/QĐ-BYT (áp dụng từ 01/07/2026) cho trường MUC_HUONG/SO_DANG_KY; QĐ 697/QĐ-BYT cho các cột bảng kê; VBHN 14/VBHN-BYT (hợp nhất TT 04/2017/TT-BYT với TT 50/2017/TT-BYT và TT 24/2025/TT-BYT) cho mức thanh toán TBYT; NĐ 188/2025/NĐ-CP là bối cảnh quyền lợi/ngoại lệ, không phải nguồn duy nhất của mọi trần dòng chi phí. English summary: Reusable BHYT cost information on Claim/EOB items and item details, and Invoice line items. Medication, procedure and service facts are represented on the corresponding financial line, not by placing this extension on the source clinical resource. On a medical-device package, each Claim/EOB item detail carries columns 5/6/8/9 losslessly, while columns 10–13 remain on the package item. `insuranceLineAmount` represents the insurance-eligible line amount (THANH_TIEN_BH/column 9), not the final BHYT fund allocation; on an EOB it aligns with adjudication `eligible`, while the fund allocation uses adjudication `benefit`.
Short	Thông tin chi phí BHYT — Insurance Cost Info Extension
Invariants	vn-insurance-cost-ratio-and-lexical: Các tỷ lệ phải nằm trong khoảng 0-100; chuỗi lexical gốc nếu có phải đi kèm paymentRatio; khoảng hiệu lực trần nếu có phải đi kèm paymentCeiling. Percentage values SHALL be within 0-100; a source lexical string SHALL accompany paymentRatio; a ceiling period SHALL accompany paymentCeiling. (extension.where(url = 'paymentRatio').value.ofType(decimal).all($this >= 0 and $this <= 100) and extension.where(url = 'servicePaymentRatio').value.ofType(decimal).all($this >= 0 and $this <= 100) and extension.where(url = 'benefitLevel').value.ofType(decimal).all($this >= 0 and $this <= 100) and (extension.where(url = 'paymentRatioSourceLexical').empty() or extension.where(url = 'paymentRatio').exists()) and (extension.where(url = 'paymentCeilingPeriod').empty() or extension.where(url = 'paymentCeiling').exists()))
2. Extension.extension:scope
Slice Name	scope
Short	Phạm vi BHYT (PHAM_VI): 1=trong DM, 2=ngoài DM, 3=NĐ 70/2015/NĐ-CP
Control	0..1
4. Extension.extension:scope.extension
Control	0..0
6. Extension.extension:scope.url
Fixed Value	`scope`
8. Extension.extension:scope.value[x]
Control	1..?
Binding	Unless not suitable, these codes SHALL be taken from Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet (extensible to `http://fhir.hl7.org.vn/core/ValueSet/vn-insurance-scope-vs`)
Type	CodeableConcept
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
10. Extension.extension:paymentRatio
Slice Name	paymentRatio
Definition	Tỷ lệ thanh toán BHYT của dòng (cột 8). Không bắt buộc trên mọi dòng: vắng mặt biểu thị dòng ngoài phạm vi BHYT; nếu cần truyền lý do không có giá trị, dùng Data Absent Reason (DAR). NGOẠI LỆ trên VNCoreCostStatementInvoice: dòng thuộc phân đoạn không có `coverage` phải khai `paymentRatio = 0` tường minh, KHÔNG dùng DAR và không để trống (QĐ 697/QĐ-BYT Phần Hai mục 2). The line's BHYT payment ratio (column 8). It is not mandatory on every line: absence denotes a line outside BHYT scope; use Data Absent Reason (DAR) when the reason for a missing value must be conveyed. EXCEPTION on VNCoreCostStatementInvoice: a line owned by a segment without Coverage SHALL declare paymentRatio = 0 explicitly, neither absent nor DAR.
Short	Tỷ lệ thanh toán BHYT (TYLE_TT) — VD: 100, 80, 50
Control	0..1
12. Extension.extension:paymentRatio.extension
Control	0..0
14. Extension.extension:paymentRatio.url
Fixed Value	`paymentRatio`
16. Extension.extension:paymentRatio.value[x]
Control	1..?
Type	decimal
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
18. Extension.extension:paymentRatioSourceLexical
Slice Name	paymentRatioSourceLexical
Definition	Giữ NGUYÊN chuỗi nhận từ chứng từ nguồn để đối soát và round-trip. Cần thiết vì hai nguồn không tương thích về kiểu: QĐ 697/QĐ-BYT ghi tỷ lệ dạng thập phân có dấu phẩy — dòng stent thứ ba trong mẫu bảng kê ghi `33,33` — trong khi QĐ 130/QĐ-BYT (chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT) quy định TYLE_TT_BH là số NGUYÊN dương độ dài 3. Chuẩn hoá sang decimal làm mất chuỗi gốc, còn ép về số nguyên làm mất giá trị. Trường này KHÔNG thay `paymentRatio`: bên tính toán luôn đọc `paymentRatio`.
Short	Chuỗi tỷ lệ nguyên gốc từ nguồn (vd `33,33`)
Control	0..1
20. Extension.extension:paymentRatioSourceLexical.extension
Control	0..0
22. Extension.extension:paymentRatioSourceLexical.url
Fixed Value	`paymentRatioSourceLexical`
24. Extension.extension:paymentRatioSourceLexical.value[x]
Control	1..?
Type	string
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
26. Extension.extension:benefitLevel
Slice Name	benefitLevel
Definition	Mức hưởng dùng trong dữ liệu đầu ra KCB. QĐ 1931/QĐ-BYT sửa QĐ 3176/QĐ-BYT, cho phép trường MUC_HUONG ở Bảng 2 và Bảng 3 có tối đa 4 ký tự từ 01/07/2026; giới hạn chuỗi này thuộc lớp xuất XML, không phải precision/cardinality của decimal FHIR.
Short	Mức hưởng BHYT (MUC_HUONG) — VD: 100, 80, 40
Control	0..1
28. Extension.extension:benefitLevel.extension
Control	0..0
30. Extension.extension:benefitLevel.url
Fixed Value	`benefitLevel`
32. Extension.extension:benefitLevel.value[x]
Control	1..?
Type	decimal
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
34. Extension.extension:paymentCeiling
Slice Name	paymentCeiling
Short	Mức trần thanh toán BHYT của dòng chi phí (T_TRANTT)
Control	0..1
36. Extension.extension:paymentCeiling.extension
Control	0..0
38. Extension.extension:paymentCeiling.url
Fixed Value	`paymentCeiling`
40. Extension.extension:paymentCeiling.value[x]
Definition	Mức thanh toán tối đa của quỹ BHYT đối với dòng chi phí DVKT/TBYT trong một lần thực hiện (T_TRANTT). Nguồn trực tiếp cho trần TBYT là TT 04/2017/TT-BYT đã được sửa bởi TT 24/2025/TT-BYT và hợp nhất tại VBHN 14/VBHN-BYT; NĐ 188/2025/NĐ-CP Điều 16 và NĐ 74/2025/NĐ-CP cung cấp các bối cảnh/ngoại lệ liên quan, không phải nguồn duy nhất của mọi trần. Chỉ ghi khi dòng có quy định mức thanh toán BHYT; ánh xạ trường T_TRANTT (Bảng 3 STT 21) theo QĐ 3176/QĐ-BYT.
Short	Trần thanh toán BHYT (VND)
Control	1..?
Type	Money
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
42. Extension.extension:paymentCeiling.value[x].currency
Control	1..?
Fixed Value	`VND`
44. Extension.extension:paymentCeilingPeriod
Slice Name	paymentCeilingPeriod
Definition	Khoảng thời gian mà giá trị `paymentCeiling` áp dụng. Cần thiết vì trần 45 tháng lương cơ sở là số tiền TÍNH RA từ mức lương cơ sở tại thời điểm, không phải hằng số: NĐ 161/2026/NĐ-CP Điều 3 khoản 2 đặt lương cơ sở 2.530.000 đồng/tháng từ 01/07/2026, nên trần tương ứng là 113.850.000 đồng. Một bảng kê lập trước mốc đó mang trần khác; không có khoảng hiệu lực thì không đối chiếu lại được.
Short	Khoảng hiệu lực của mức trần thanh toán
Control	0..1
46. Extension.extension:paymentCeilingPeriod.extension
Control	0..0
48. Extension.extension:paymentCeilingPeriod.url
Fixed Value	`paymentCeilingPeriod`
50. Extension.extension:paymentCeilingPeriod.value[x]
Control	1..?
Type	Period
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
52. Extension.extension:paymentCeilingPeriod.value[x].start
Control	1..?
54. Extension.extension:servicePaymentRatio
Slice Name	servicePaymentRatio
Definition	Tỷ lệ thanh toán của dịch vụ kỹ thuật, ngày giường hoặc tiền công khám (TYLE_TT_DV, cột 6; Bảng 3 STT 17) theo QĐ 3176/QĐ-BYT. Khác với paymentRatio (TYLE_TT_BH, cột 8; Bảng 3 STT 18), TYLE_TT_DV phản ánh mức tính giá dịch vụ, ví dụ nằm ghép 02 người ghi 50, nằm ghép từ 03 người ghi 33, giường 01 người ghi 100. Không bắt buộc trên mọi dòng; vắng mặt biểu thị dòng ngoài phạm vi BHYT hoặc cột không áp dụng, và dùng Data Absent Reason (DAR) khi cần phân biệt lý do. Tham gia công thức THANH_TIEN_BV = SO_LUONG × DON_GIA_BV × TYLE_TT_DV/100 (Bảng 3 STT 19) và THANH_TIEN_BH (Bảng 3 STT 20).
Short	Tỷ lệ thanh toán DVKT/giường/công khám (TYLE_TT_DV) — VD: 100, 50, 33
Control	0..1
56. Extension.extension:servicePaymentRatio.extension
Control	0..0
58. Extension.extension:servicePaymentRatio.url
Fixed Value	`servicePaymentRatio`
60. Extension.extension:servicePaymentRatio.value[x]
Control	1..?
Type	decimal
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
62. Extension.extension:insuranceUnitPrice
Slice Name	insuranceUnitPrice
Definition	Đơn giá dịch vụ kỹ thuật, VTYT, tiền giường bệnh, tiền công khám do quỹ BHYT thanh toán (DON_GIA_BH, cột 5; Bảng 3 STT 15) theo QĐ 3176/QĐ-BYT. Có thể khác đơn giá bệnh viện (DON_GIA_BV — Claim.item.unitPrice): khi VTYT có quy định mức thanh toán BHYT và DON_GIA_BV cao hơn mức thanh toán thì DON_GIA_BH = T_TRANTT (sub-extension paymentCeiling); không cao hơn thì DON_GIA_BH = DON_GIA_BV. Trường hợp VTYT tái sử dụng: DON_GIA_BH là giá thanh toán của 1 lần tái sử dụng. Không bắt buộc trên mọi dòng; vắng mặt biểu thị dòng ngoài phạm vi BHYT hoặc cột không áp dụng, và dùng Data Absent Reason (DAR) khi cần phân biệt lý do.
Short	Đơn giá do quỹ BHYT thanh toán (DON_GIA_BH)
Control	0..1
64. Extension.extension:insuranceUnitPrice.extension
Control	0..0
66. Extension.extension:insuranceUnitPrice.url
Fixed Value	`insuranceUnitPrice`
68. Extension.extension:insuranceUnitPrice.value[x]
Short	Đơn giá BHYT thanh toán (VND)
Control	1..?
Type	Money
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
70. Extension.extension:insuranceUnitPrice.value[x].currency
Control	1..?
Fixed Value	`VND`
72. Extension.extension:insuranceLineAmount
Slice Name	insuranceLineAmount
Definition	Giá trị AUTHORITATIVE của cột 9 bảng kê QĐ 697/QĐ-BYT (THANH_TIEN_BH), nhận từ chứng từ hoặc nguồn nghiệp vụ. TUYỆT ĐỐI KHÔNG suy ngược hay ghi đè từ số lượng × đơn giá × tỷ lệ: mẫu bảng kê QĐ 697/QĐ-BYT có dòng stent thứ ba với Đơn giá BH = 0 và tỷ lệ 33,33 nhưng Thành tiền BH = 12.000.000 đồng, vì stent thứ ba được thanh toán theo 1/3 chi phí giá mua vào và không quá 12.000.000 đồng chứ không theo công thức nhân. Công thức chỉ dùng để CẢNH BÁO đối soát trên những calculationBasis xác định.
Short	Thành tiền BH đủ điều kiện của dòng, cột 9 (THANH_TIEN_BH) — Eligible insurance line amount
Control	0..1
74. Extension.extension:insuranceLineAmount.extension
Control	0..0
76. Extension.extension:insuranceLineAmount.url
Fixed Value	`insuranceLineAmount`
78. Extension.extension:insuranceLineAmount.value[x]
Short	Thành tiền BH đủ điều kiện (VND) — Eligible insurance line amount
Control	1..?
Type	Money
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
80. Extension.extension:insuranceLineAmount.value[x].currency
Control	1..?
Fixed Value	`VND`
82. Extension.url
Fixed Value	`http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info`
84. Extension.value[x]
Control	0..0

Guidance on how to interpret the contents of this table can be foundhere

0. Extension
Definition	Extension tái sử dụng cho thông tin chi phí BHYT trên từng item (thuốc/DVKT/VTYT). Bao gồm: phạm vi BHYT (PHAM_VI), tỷ lệ thanh toán BHYT (TYLE_TT/TYLE_TT_BH), mức hưởng (MUC_HUONG), mức trần thanh toán BHYT (T_TRANTT), tỷ lệ thanh toán dịch vụ (TYLE_TT_DV), đơn giá BHYT (DON_GIA_BH) và thành tiền BHYT (THANH_TIEN_BH). Dùng trên Claim.item, Claim.item.detail, ExplanationOfBenefit.item, ExplanationOfBenefit.item.detail và Invoice.lineItem. Thông tin từ các resource lâm sàng hoặc dược được đưa vào dòng chi phí tương ứng; không gắn extension này trực tiếp lên những resource nguồn đó. Với thiết bị/vật tư, ưu tiên đặt trên Claim.item hoặc item.detail; không dùng trên DeviceUseStatement vì DeviceUseStatement là ghi nhận sử dụng lâm sàng. Theo QĐ 697/QĐ-BYT (các dòng hướng dẫn khoảng 389 và 407), component trong gói TBYT mang lossless các cột 5/6/8/9; chỉ các cột 10–13 được tính ở item tổng gói. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG; DON_GIA_BH (Bảng 3 STT 15), TYLE_TT_DV (Bảng 3 STT 17), THANH_TIEN_BH (Bảng 2 STT 21, Bảng 3 STT 20), T_TRANTT (Bảng 3 STT 21). Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level). Căn cứ: QĐ 3176/QĐ-BYT đọc cùng QĐ 1931/QĐ-BYT (áp dụng từ 01/07/2026) cho trường MUC_HUONG/SO_DANG_KY; QĐ 697/QĐ-BYT cho các cột bảng kê; VBHN 14/VBHN-BYT (hợp nhất TT 04/2017/TT-BYT với TT 50/2017/TT-BYT và TT 24/2025/TT-BYT) cho mức thanh toán TBYT; NĐ 188/2025/NĐ-CP là bối cảnh quyền lợi/ngoại lệ, không phải nguồn duy nhất của mọi trần dòng chi phí. English summary: Reusable BHYT cost information on Claim/EOB items and item details, and Invoice line items. Medication, procedure and service facts are represented on the corresponding financial line, not by placing this extension on the source clinical resource. On a medical-device package, each Claim/EOB item detail carries columns 5/6/8/9 losslessly, while columns 10–13 remain on the package item. `insuranceLineAmount` represents the insurance-eligible line amount (THANH_TIEN_BH/column 9), not the final BHYT fund allocation; on an EOB it aligns with adjudication `eligible`, while the fund allocation uses adjudication `benefit`.
Short	Thông tin chi phí BHYT — Insurance Cost Info Extension
Control	0..* This element is affected by the following invariants: ele-1
Is Modifier	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) vn-insurance-cost-ratio-and-lexical: Các tỷ lệ phải nằm trong khoảng 0-100; chuỗi lexical gốc nếu có phải đi kèm paymentRatio; khoảng hiệu lực trần nếu có phải đi kèm paymentCeiling. Percentage values SHALL be within 0-100; a source lexical string SHALL accompany paymentRatio; a ceiling period SHALL accompany paymentCeiling. (extension.where(url = 'paymentRatio').value.ofType(decimal).all($this >= 0 and $this <= 100) and extension.where(url = 'servicePaymentRatio').value.ofType(decimal).all($this >= 0 and $this <= 100) and extension.where(url = 'benefitLevel').value.ofType(decimal).all($this >= 0 and $this <= 100) and (extension.where(url = 'paymentRatioSourceLexical').empty() or extension.where(url = 'paymentRatio').exists()) and (extension.where(url = 'paymentCeilingPeriod').empty() or extension.where(url = 'paymentCeiling').exists()))
2. Extension.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
4. Extension.extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	Additional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
6. Extension.extension:scope
Slice Name	scope
Definition	An Extension
Short	Phạm vi BHYT (PHAM_VI): 1=trong DM, 2=ngoài DM, 3=NĐ 70/2015/NĐ-CP
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
8. Extension.extension:scope.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
10. Extension.extension:scope.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
12. Extension.extension:scope.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`scope`
14. Extension.extension:scope.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	1..1
Binding	Unless not suitable, these codes SHALL be taken from Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet (extensible to `http://fhir.hl7.org.vn/core/ValueSet/vn-insurance-scope-vs`)
Type	CodeableConcept
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
16. Extension.extension:paymentRatio
Slice Name	paymentRatio
Definition	Tỷ lệ thanh toán BHYT của dòng (cột 8). Không bắt buộc trên mọi dòng: vắng mặt biểu thị dòng ngoài phạm vi BHYT; nếu cần truyền lý do không có giá trị, dùng Data Absent Reason (DAR). NGOẠI LỆ trên VNCoreCostStatementInvoice: dòng thuộc phân đoạn không có `coverage` phải khai `paymentRatio = 0` tường minh, KHÔNG dùng DAR và không để trống (QĐ 697/QĐ-BYT Phần Hai mục 2). The line's BHYT payment ratio (column 8). It is not mandatory on every line: absence denotes a line outside BHYT scope; use Data Absent Reason (DAR) when the reason for a missing value must be conveyed. EXCEPTION on VNCoreCostStatementInvoice: a line owned by a segment without Coverage SHALL declare paymentRatio = 0 explicitly, neither absent nor DAR.
Short	Tỷ lệ thanh toán BHYT (TYLE_TT) — VD: 100, 80, 50
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
18. Extension.extension:paymentRatio.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
20. Extension.extension:paymentRatio.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
22. Extension.extension:paymentRatio.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`paymentRatio`
24. Extension.extension:paymentRatio.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	1..1
Type	decimal
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
26. Extension.extension:paymentRatioSourceLexical
Slice Name	paymentRatioSourceLexical
Definition	Giữ NGUYÊN chuỗi nhận từ chứng từ nguồn để đối soát và round-trip. Cần thiết vì hai nguồn không tương thích về kiểu: QĐ 697/QĐ-BYT ghi tỷ lệ dạng thập phân có dấu phẩy — dòng stent thứ ba trong mẫu bảng kê ghi `33,33` — trong khi QĐ 130/QĐ-BYT (chuỗi QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT) quy định TYLE_TT_BH là số NGUYÊN dương độ dài 3. Chuẩn hoá sang decimal làm mất chuỗi gốc, còn ép về số nguyên làm mất giá trị. Trường này KHÔNG thay `paymentRatio`: bên tính toán luôn đọc `paymentRatio`.
Short	Chuỗi tỷ lệ nguyên gốc từ nguồn (vd `33,33`)
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
28. Extension.extension:paymentRatioSourceLexical.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
30. Extension.extension:paymentRatioSourceLexical.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
32. Extension.extension:paymentRatioSourceLexical.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`paymentRatioSourceLexical`
34. Extension.extension:paymentRatioSourceLexical.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	1..1
Type	string
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
36. Extension.extension:benefitLevel
Slice Name	benefitLevel
Definition	Mức hưởng dùng trong dữ liệu đầu ra KCB. QĐ 1931/QĐ-BYT sửa QĐ 3176/QĐ-BYT, cho phép trường MUC_HUONG ở Bảng 2 và Bảng 3 có tối đa 4 ký tự từ 01/07/2026; giới hạn chuỗi này thuộc lớp xuất XML, không phải precision/cardinality của decimal FHIR.
Short	Mức hưởng BHYT (MUC_HUONG) — VD: 100, 80, 40
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
38. Extension.extension:benefitLevel.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
40. Extension.extension:benefitLevel.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
42. Extension.extension:benefitLevel.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`benefitLevel`
44. Extension.extension:benefitLevel.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	1..1
Type	decimal
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
46. Extension.extension:paymentCeiling
Slice Name	paymentCeiling
Definition	An Extension
Short	Mức trần thanh toán BHYT của dòng chi phí (T_TRANTT)
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
48. Extension.extension:paymentCeiling.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
50. Extension.extension:paymentCeiling.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
52. Extension.extension:paymentCeiling.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`paymentCeiling`
54. Extension.extension:paymentCeiling.value[x]
Definition	Mức thanh toán tối đa của quỹ BHYT đối với dòng chi phí DVKT/TBYT trong một lần thực hiện (T_TRANTT). Nguồn trực tiếp cho trần TBYT là TT 04/2017/TT-BYT đã được sửa bởi TT 24/2025/TT-BYT và hợp nhất tại VBHN 14/VBHN-BYT; NĐ 188/2025/NĐ-CP Điều 16 và NĐ 74/2025/NĐ-CP cung cấp các bối cảnh/ngoại lệ liên quan, không phải nguồn duy nhất của mọi trần. Chỉ ghi khi dòng có quy định mức thanh toán BHYT; ánh xạ trường T_TRANTT (Bảng 3 STT 21) theo QĐ 3176/QĐ-BYT.
Short	Trần thanh toán BHYT (VND)
Control	1..1
Type	Money
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
56. Extension.extension:paymentCeiling.value[x].id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
58. Extension.extension:paymentCeiling.value[x].extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	Additional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.value[x].extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
60. Extension.extension:paymentCeiling.value[x].value
Definition	Numerical value (with implicit precision).
Short	Numerical value (with implicit precision)
Comments	Monetary values have their own rules for handling precision (refer to standard accounting text books).
Control	0..1
Type	decimal
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	The amount of the currency. The value includes an implicit precision in the presentation of the value.
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
62. Extension.extension:paymentCeiling.value[x].currency
Definition	ISO 4217 Currency Code.
Short	ISO 4217 Currency Code
Control	1..1
Binding	The codes SHALL be taken from Currencies (required to `http://hl7.org/fhir/ValueSet/currencies\|4.0.1`) A code indicating the currency, taken from ISO 4217.
Type	code
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	A code indicating the currency, taken from ISO 4217.
Fixed Value	`VND`
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
64. Extension.extension:paymentCeilingPeriod
Slice Name	paymentCeilingPeriod
Definition	Khoảng thời gian mà giá trị `paymentCeiling` áp dụng. Cần thiết vì trần 45 tháng lương cơ sở là số tiền TÍNH RA từ mức lương cơ sở tại thời điểm, không phải hằng số: NĐ 161/2026/NĐ-CP Điều 3 khoản 2 đặt lương cơ sở 2.530.000 đồng/tháng từ 01/07/2026, nên trần tương ứng là 113.850.000 đồng. Một bảng kê lập trước mốc đó mang trần khác; không có khoảng hiệu lực thì không đối chiếu lại được.
Short	Khoảng hiệu lực của mức trần thanh toán
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
66. Extension.extension:paymentCeilingPeriod.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
68. Extension.extension:paymentCeilingPeriod.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
70. Extension.extension:paymentCeilingPeriod.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`paymentCeilingPeriod`
72. Extension.extension:paymentCeilingPeriod.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	1..1
Type	Period
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
74. Extension.extension:paymentCeilingPeriod.value[x].id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
76. Extension.extension:paymentCeilingPeriod.value[x].extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	Additional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.value[x].extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
78. Extension.extension:paymentCeilingPeriod.value[x].start
Definition	The start of the period. The boundary is inclusive.
Short	Starting time with inclusive boundary
Comments	If the low element is missing, the meaning is that the low boundary is not known.
Control	1..1 This element is affected by the following invariants: per-1
Type	dateTime
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
80. Extension.extension:paymentCeilingPeriod.value[x].end
Definition	The end of the period. If the end of the period is missing, it means no end was known or planned at the time the instance was created. The start may be in the past, and the end date in the future, which means that period is expected/planned to end at that time.
Short	End time with inclusive boundary, if not ongoing
Comments	The high value includes any matching date/time. i.e. 2012-02-03T10:00:00 is in a period that has an end value of 2012-02-03.
Control	0..1 This element is affected by the following invariants: per-1
Type	dateTime
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Meaning if Missing	If the end of the period is missing, it means that the period is ongoing
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
82. Extension.extension:servicePaymentRatio
Slice Name	servicePaymentRatio
Definition	Tỷ lệ thanh toán của dịch vụ kỹ thuật, ngày giường hoặc tiền công khám (TYLE_TT_DV, cột 6; Bảng 3 STT 17) theo QĐ 3176/QĐ-BYT. Khác với paymentRatio (TYLE_TT_BH, cột 8; Bảng 3 STT 18), TYLE_TT_DV phản ánh mức tính giá dịch vụ, ví dụ nằm ghép 02 người ghi 50, nằm ghép từ 03 người ghi 33, giường 01 người ghi 100. Không bắt buộc trên mọi dòng; vắng mặt biểu thị dòng ngoài phạm vi BHYT hoặc cột không áp dụng, và dùng Data Absent Reason (DAR) khi cần phân biệt lý do. Tham gia công thức THANH_TIEN_BV = SO_LUONG × DON_GIA_BV × TYLE_TT_DV/100 (Bảng 3 STT 19) và THANH_TIEN_BH (Bảng 3 STT 20).
Short	Tỷ lệ thanh toán DVKT/giường/công khám (TYLE_TT_DV) — VD: 100, 50, 33
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
84. Extension.extension:servicePaymentRatio.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
86. Extension.extension:servicePaymentRatio.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
88. Extension.extension:servicePaymentRatio.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`servicePaymentRatio`
90. Extension.extension:servicePaymentRatio.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	1..1
Type	decimal
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
92. Extension.extension:insuranceUnitPrice
Slice Name	insuranceUnitPrice
Definition	Đơn giá dịch vụ kỹ thuật, VTYT, tiền giường bệnh, tiền công khám do quỹ BHYT thanh toán (DON_GIA_BH, cột 5; Bảng 3 STT 15) theo QĐ 3176/QĐ-BYT. Có thể khác đơn giá bệnh viện (DON_GIA_BV — Claim.item.unitPrice): khi VTYT có quy định mức thanh toán BHYT và DON_GIA_BV cao hơn mức thanh toán thì DON_GIA_BH = T_TRANTT (sub-extension paymentCeiling); không cao hơn thì DON_GIA_BH = DON_GIA_BV. Trường hợp VTYT tái sử dụng: DON_GIA_BH là giá thanh toán của 1 lần tái sử dụng. Không bắt buộc trên mọi dòng; vắng mặt biểu thị dòng ngoài phạm vi BHYT hoặc cột không áp dụng, và dùng Data Absent Reason (DAR) khi cần phân biệt lý do.
Short	Đơn giá do quỹ BHYT thanh toán (DON_GIA_BH)
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
94. Extension.extension:insuranceUnitPrice.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
96. Extension.extension:insuranceUnitPrice.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
98. Extension.extension:insuranceUnitPrice.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`insuranceUnitPrice`
100. Extension.extension:insuranceUnitPrice.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Đơn giá BHYT thanh toán (VND)
Control	1..1
Type	Money
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
102. Extension.extension:insuranceUnitPrice.value[x].id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
104. Extension.extension:insuranceUnitPrice.value[x].extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	Additional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.value[x].extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
106. Extension.extension:insuranceUnitPrice.value[x].value
Definition	Numerical value (with implicit precision).
Short	Numerical value (with implicit precision)
Comments	Monetary values have their own rules for handling precision (refer to standard accounting text books).
Control	0..1
Type	decimal
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	The amount of the currency. The value includes an implicit precision in the presentation of the value.
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
108. Extension.extension:insuranceUnitPrice.value[x].currency
Definition	ISO 4217 Currency Code.
Short	ISO 4217 Currency Code
Control	1..1
Binding	The codes SHALL be taken from Currencies (required to `http://hl7.org/fhir/ValueSet/currencies\|4.0.1`) A code indicating the currency, taken from ISO 4217.
Type	code
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	A code indicating the currency, taken from ISO 4217.
Fixed Value	`VND`
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
110. Extension.extension:insuranceLineAmount
Slice Name	insuranceLineAmount
Definition	Giá trị AUTHORITATIVE của cột 9 bảng kê QĐ 697/QĐ-BYT (THANH_TIEN_BH), nhận từ chứng từ hoặc nguồn nghiệp vụ. TUYỆT ĐỐI KHÔNG suy ngược hay ghi đè từ số lượng × đơn giá × tỷ lệ: mẫu bảng kê QĐ 697/QĐ-BYT có dòng stent thứ ba với Đơn giá BH = 0 và tỷ lệ 33,33 nhưng Thành tiền BH = 12.000.000 đồng, vì stent thứ ba được thanh toán theo 1/3 chi phí giá mua vào và không quá 12.000.000 đồng chứ không theo công thức nhân. Công thức chỉ dùng để CẢNH BÁO đối soát trên những calculationBasis xác định.
Short	Thành tiền BH đủ điều kiện của dòng, cột 9 (THANH_TIEN_BH) — Eligible insurance line amount
Control	0..1
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
112. Extension.extension:insuranceLineAmount.id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
114. Extension.extension:insuranceLineAmount.extension
Definition	An Extension
Short	Extension
Control	0..0
Type	Extension
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
116. Extension.extension:insuranceLineAmount.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`insuranceLineAmount`
118. Extension.extension:insuranceLineAmount.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Thành tiền BH đủ điều kiện (VND) — Eligible insurance line amount
Control	1..1
Type	Money
[x] Note	SeeChoice of Data Typesfor further information about how to use [x]
Is Modifier	false
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
120. Extension.extension:insuranceLineAmount.value[x].id
Definition	Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short	Unique id for inter-element referencing
Control	0..1
Type	string
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
122. Extension.extension:insuranceLineAmount.value[x].extension
Definition	May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short	Additional content defined by implementations
Comments	There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control	0..*
Type	Extension
Is Modifier	false
Summary	false
Alternate Names	extensions, user content
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing	This element introduces a set of slices on `Extension.extension.value[x].extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
124. Extension.extension:insuranceLineAmount.value[x].value
Definition	Numerical value (with implicit precision).
Short	Numerical value (with implicit precision)
Comments	Monetary values have their own rules for handling precision (refer to standard accounting text books).
Control	0..1
Type	decimal
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	The amount of the currency. The value includes an implicit precision in the presentation of the value.
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
126. Extension.extension:insuranceLineAmount.value[x].currency
Definition	ISO 4217 Currency Code.
Short	ISO 4217 Currency Code
Control	1..1
Binding	The codes SHALL be taken from Currencies (required to `http://hl7.org/fhir/ValueSet/currencies\|4.0.1`) A code indicating the currency, taken from ISO 4217.
Type	code
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	true
Requirements	A code indicating the currency, taken from ISO 4217.
Fixed Value	`VND`
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
128. Extension.url
Definition	Source of the definition for the extension code - a logical name or a URL.
Short	identifies the meaning of the extension
Comments	The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Control	1..1
Type	uri
Is Modifier	false
XML Format	In the XML format, this property is represented as an attribute.
Summary	false
Fixed Value	`http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info`
130. Extension.value[x]
Definition	Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Short	Value of extension
Control	0..0
Type	Choice of: base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference, SampledData, Signature, Timing, ContactDetail, Contributor, DataRequirement, Expression, ParameterDefinition, RelatedArtifact, TriggerDefinition, UsageContext, Dosage, Meta
Is Modifier	false
Primitive Value	This primitive element may be present, or absent, or replaced by an extension
Summary	false
Invariants	ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)