VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft Viet Nam flag

VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Extension: Thông tin chi phí BHYT — Insurance Cost Info Extension

Official URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info Version: 0.1.0
Draft as of 2026-03-21 Computable Name: VNCoreExtInsuranceCostInfo

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 (TYLE_TT), mức hưởng (MUC_HUONG). Dùng trên: MedicationRequest, Procedure, DeviceUseStatement, Claim.item. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG. Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level).

Context of Use

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thông tin chi phí BHYT — Insurance Cost Info Extension
... Slices for extension Content/Rules for all slices
.... extension:scope 0..1 Extension Phạm vi BHYT (PHAM_VI): 1=trong DM, 2=ngoài DM, 3=NĐ 70
..... extension 0..0 Extension
..... url 1..1 uri "scope"
..... value[x] 0..1 CodeableConcept Value of extension
Binding: Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet (extensible)
.... extension:paymentRatio 0..1 Extension Tỷ lệ thanh toán BHYT (TYLE_TT) — VD: 100, 80, 50
..... extension 0..0 Extension
..... url 1..1 uri "paymentRatio"
..... value[x] 0..1 decimal Value of extension
.... extension:benefitLevel 0..1 Extension Mức hưởng BHYT (MUC_HUONG) — VD: 100, 80, 40
..... extension 0..0 Extension
..... url 1..1 uri "benefitLevel"
..... value[x] 0..1 decimal Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"
... value[x] 0..0 Value of extension

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thông tin chi phí BHYT — Insurance Cost Info Extension
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:scope 0..1 Extension Phạm vi BHYT (PHAM_VI): 1=trong DM, 2=ngoài DM, 3=NĐ 70
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "scope"
..... value[x] 0..1 CodeableConcept Value of extension
Binding: Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet (extensible)
.... extension:paymentRatio 0..1 Extension Tỷ lệ thanh toán BHYT (TYLE_TT) — VD: 100, 80, 50
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "paymentRatio"
..... value[x] 0..1 decimal Value of extension
.... extension:benefitLevel 0..1 Extension Mức hưởng BHYT (MUC_HUONG) — VD: 100, 80, 40
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "benefitLevel"
..... value[x] 0..1 decimal Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"

doco Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: 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 (TYLE_TT), mức hưởng (MUC_HUONG). Dùng trên: MedicationRequest, Procedure, DeviceUseStatement, Claim.item. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG. Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level).

  • scope: CodeableConcept: An Extension
  • paymentRatio: decimal: An Extension
  • benefitLevel: decimal: An Extension

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thông tin chi phí BHYT — Insurance Cost Info Extension
... Slices for extension Content/Rules for all slices
.... extension:scope 0..1 Extension Phạm vi BHYT (PHAM_VI): 1=trong DM, 2=ngoài DM, 3=NĐ 70
..... extension 0..0 Extension
..... url 1..1 uri "scope"
..... value[x] 0..1 CodeableConcept Value of extension
Binding: Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet (extensible)
.... extension:paymentRatio 0..1 Extension Tỷ lệ thanh toán BHYT (TYLE_TT) — VD: 100, 80, 50
..... extension 0..0 Extension
..... url 1..1 uri "paymentRatio"
..... value[x] 0..1 decimal Value of extension
.... extension:benefitLevel 0..1 Extension Mức hưởng BHYT (MUC_HUONG) — VD: 100, 80, 40
..... extension 0..0 Extension
..... url 1..1 uri "benefitLevel"
..... value[x] 0..1 decimal Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"
... value[x] 0..0 Value of extension

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension Thông tin chi phí BHYT — Insurance Cost Info Extension
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:scope 0..1 Extension Phạm vi BHYT (PHAM_VI): 1=trong DM, 2=ngoài DM, 3=NĐ 70
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "scope"
..... value[x] 0..1 CodeableConcept Value of extension
Binding: Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet (extensible)
.... extension:paymentRatio 0..1 Extension Tỷ lệ thanh toán BHYT (TYLE_TT) — VD: 100, 80, 50
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "paymentRatio"
..... value[x] 0..1 decimal Value of extension
.... extension:benefitLevel 0..1 Extension Mức hưởng BHYT (MUC_HUONG) — VD: 100, 80, 40
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "benefitLevel"
..... value[x] 0..1 decimal Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"

doco Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: 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 (TYLE_TT), mức hưởng (MUC_HUONG). Dùng trên: MedicationRequest, Procedure, DeviceUseStatement, Claim.item. Mapping XML 3176: PHAM_VI, TYLE_TT, MUC_HUONG. Nguồn thiết kế: OHP Data Processor (medication-pham-vi, medication-payment-ratio, medication-benefit-level).

  • scope: CodeableConcept: An Extension
  • paymentRatio: decimal: An Extension
  • benefitLevel: decimal: An Extension

 

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

Path Status Usage ValueSet Version Source
Extension.extension:scope.​value[x] Base extensible Phạm vi hưởng BHYT — Vietnam Insurance Scope ValueSet 📦0.1.0 This IG

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()