HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Phần mở rộng: Giai đoạn hưởng bảo hiểm — Coverage Benefit Stage

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-benefit-stage Phiên bản: 0.9.0
Computable Name: VNCoreExtCoverageBenefitStage
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.112

Giai đoạn áp dụng một mức hưởng BHYT cụ thể trong một đợt khám bệnh, chữa bệnh. Extension mang khóa giai đoạn, khoảng thời gian và mức hưởng để một Claim hoặc ExplanationOfBenefit có thể biểu diễn trường hợp cùng một thẻ BHYT đổi mức hưởng trong đợt điều trị. Mỗi insurance vẫn đại diện cho một Coverage thực và có thể mang nhiều extension này; không lặp lại Coverage hoặc dùng focal = false chỉ để biểu diễn giai đoạn. Khóa sequence của extension độc lập với Claim.insurance.sequence, vốn chỉ giữ nghĩa thứ tự phối hợp quyền lợi (COB). Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [NĐ 188/2025/NĐ-CP] (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT.

A benefit stage identifies the period during which one BHYT benefit percentage applies within a healthcare episode. Each insurance entry continues to represent one real Coverage and may carry multiple instances of this extension; implementations do not repeat a Coverage or use focal = false merely to represent a stage. The extension sequence is independent from Claim.insurance.sequence, which retains its base coordination-of-benefits (COB) meaning.

Context of Use

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Các dạng xem hình thức của nội dung phần mở rộng

Mô tả profile, differential, snapshot và các biểu diễn liên quan.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Giai đoạn hưởng bảo hiểm — Coverage Benefit Stage
Constraints: vn-coverage-benefit-stage-level-range
... extension 3..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:sequence S 1..1 Extension Khóa thứ tự giai đoạn hưởng — Benefit-stage sequence key
..... extension 0..0 Extension
..... url 1..1 uri "sequence"
..... value[x] 1..1 positiveInt Value of extension
.... extension:period S 1..1 Extension Khoảng thời gian áp dụng mức hưởng — Benefit-stage period
..... extension 0..0 Extension
..... url 1..1 uri "period"
..... value[x] 1..1 Period Value of extension
...... start S 1..1 dateTime Starting time with inclusive boundary
...... end S 1..1 dateTime End time with inclusive boundary, if not ongoing
.... extension:benefitLevel S 1..1 Extension Mức hưởng BHYT từ 0 đến 100 — BHYT benefit level from 0 to 100
..... extension 0..0 Extension
..... url 1..1 uri "benefitLevel"
..... value[x] 1..1 decimal Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-benefit-stage"

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-coverage-benefit-stage-level-range error Extension Mức hưởng của giai đoạn phải nằm trong khoảng từ 0 đến 100 phần trăm. The benefit level for a coverage stage SHALL be between 0 and 100 percent. extension('benefitLevel').value >= 0 and extension('benefitLevel').value <= 100
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Giai đoạn hưởng bảo hiểm — Coverage Benefit Stage
Constraints: vn-coverage-benefit-stage-level-range
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 3..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:sequence S 1..1 Extension Khóa thứ tự giai đoạn hưởng — Benefit-stage sequence key
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "sequence"
..... value[x] 1..1 positiveInt Value of extension
.... extension:period S 1..1 Extension Khoảng thời gian áp dụng mức hưởng — Benefit-stage period
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "period"
..... value[x] 1..1 Period Value of extension
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... start SΣC 1..1 dateTime Starting time with inclusive boundary
...... end SΣC 1..1 dateTime End time with inclusive boundary, if not ongoing
.... extension:benefitLevel S 1..1 Extension Mức hưởng BHYT từ 0 đến 100 — BHYT benefit level from 0 to 100
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "benefitLevel"
..... value[x] 1..1 decimal Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-benefit-stage"

doco Documentation for this format

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()
vn-coverage-benefit-stage-level-range error Extension Mức hưởng của giai đoạn phải nằm trong khoảng từ 0 đến 100 phần trăm. The benefit level for a coverage stage SHALL be between 0 and 100 percent. extension('benefitLevel').value >= 0 and extension('benefitLevel').value <= 100

Summary

Complex Extension: Giai đoạn áp dụng một mức hưởng BHYT cụ thể trong một đợt khám bệnh, chữa bệnh. Extension mang khóa giai đoạn, khoảng thời gian và mức hưởng để một Claim hoặc ExplanationOfBenefit có thể biểu diễn trường hợp cùng một thẻ BHYT đổi mức hưởng trong đợt điều trị. Mỗi insurance vẫn đại diện cho một Coverage thực và có thể mang nhiều extension này; không lặp lại Coverage hoặc dùng focal = false chỉ để biểu diễn giai đoạn. Khóa sequence của extension độc lập với Claim.insurance.sequence, vốn chỉ giữ nghĩa thứ tự phối hợp quyền lợi (COB). Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [NĐ 188/2025/NĐ-CP] (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT. A benefit stage identifies the period during which one BHYT benefit percentage applies within a healthcare episode. Each insurance entry continues to represent one real Coverage and may carry multiple instances of this extension; implementations do not repeat a Coverage or use focal = false merely to represent a stage. The extension sequence is independent from Claim.insurance.sequence, which retains its base coordination-of-benefits (COB) meaning.

  • sequence: positiveInt: Số nguyên dương định danh duy nhất giai đoạn hưởng trong cùng Claim hoặc ExplanationOfBenefit. A positive integer that uniquely identifies the benefit stage within the containing Claim or ExplanationOfBenefit.
  • period: Period: Khoảng thời gian liên tục mà mức hưởng của giai đoạn có hiệu lực. The continuous period during which the stage benefit level applies.
  • benefitLevel: decimal: Tỷ lệ phần trăm mức hưởng BHYT áp dụng cho giai đoạn, trong khoảng 0..100. The BHYT benefit percentage applicable to the stage, constrained to 0..100.

Dạng xem DifferentialDifferential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Giai đoạn hưởng bảo hiểm — Coverage Benefit Stage
Constraints: vn-coverage-benefit-stage-level-range
... extension 3..* Extension Extension
... Slices for extension Content/Rules for all slices
.... extension:sequence S 1..1 Extension Khóa thứ tự giai đoạn hưởng — Benefit-stage sequence key
..... extension 0..0 Extension
..... url 1..1 uri "sequence"
..... value[x] 1..1 positiveInt Value of extension
.... extension:period S 1..1 Extension Khoảng thời gian áp dụng mức hưởng — Benefit-stage period
..... extension 0..0 Extension
..... url 1..1 uri "period"
..... value[x] 1..1 Period Value of extension
...... start S 1..1 dateTime Starting time with inclusive boundary
...... end S 1..1 dateTime End time with inclusive boundary, if not ongoing
.... extension:benefitLevel S 1..1 Extension Mức hưởng BHYT từ 0 đến 100 — BHYT benefit level from 0 to 100
..... extension 0..0 Extension
..... url 1..1 uri "benefitLevel"
..... value[x] 1..1 decimal Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-benefit-stage"

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-coverage-benefit-stage-level-range error Extension Mức hưởng của giai đoạn phải nằm trong khoảng từ 0 đến 100 phần trăm. The benefit level for a coverage stage SHALL be between 0 and 100 percent. extension('benefitLevel').value >= 0 and extension('benefitLevel').value <= 100

Dạng xem Snapshot

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension C 0..* Extension Giai đoạn hưởng bảo hiểm — Coverage Benefit Stage
Constraints: vn-coverage-benefit-stage-level-range
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 3..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:sequence S 1..1 Extension Khóa thứ tự giai đoạn hưởng — Benefit-stage sequence key
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "sequence"
..... value[x] 1..1 positiveInt Value of extension
.... extension:period S 1..1 Extension Khoảng thời gian áp dụng mức hưởng — Benefit-stage period
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "period"
..... value[x] 1..1 Period Value of extension
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... start SΣC 1..1 dateTime Starting time with inclusive boundary
...... end SΣC 1..1 dateTime End time with inclusive boundary, if not ongoing
.... extension:benefitLevel S 1..1 Extension Mức hưởng BHYT từ 0 đến 100 — BHYT benefit level from 0 to 100
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..0 Extension
Slice: Unordered, Open by value:url
..... url 1..1 uri "benefitLevel"
..... value[x] 1..1 decimal Value of extension
... url 1..1 uri "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-benefit-stage"

doco Documentation for this format

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()
vn-coverage-benefit-stage-level-range error Extension Mức hưởng của giai đoạn phải nằm trong khoảng từ 0 đến 100 phần trăm. The benefit level for a coverage stage SHALL be between 0 and 100 percent. extension('benefitLevel').value >= 0 and extension('benefitLevel').value <= 100

Summary

Complex Extension: Giai đoạn áp dụng một mức hưởng BHYT cụ thể trong một đợt khám bệnh, chữa bệnh. Extension mang khóa giai đoạn, khoảng thời gian và mức hưởng để một Claim hoặc ExplanationOfBenefit có thể biểu diễn trường hợp cùng một thẻ BHYT đổi mức hưởng trong đợt điều trị. Mỗi insurance vẫn đại diện cho một Coverage thực và có thể mang nhiều extension này; không lặp lại Coverage hoặc dùng focal = false chỉ để biểu diễn giai đoạn. Khóa sequence của extension độc lập với Claim.insurance.sequence, vốn chỉ giữ nghĩa thứ tự phối hợp quyền lợi (COB). Căn cứ: [QĐ 697/QĐ-BYT] (ban hành 19/03/2026, hiệu lực 19/03/2026) — Mẫu bảng kê chi phí KCB; [NĐ 188/2025/NĐ-CP] (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT. A benefit stage identifies the period during which one BHYT benefit percentage applies within a healthcare episode. Each insurance entry continues to represent one real Coverage and may carry multiple instances of this extension; implementations do not repeat a Coverage or use focal = false merely to represent a stage. The extension sequence is independent from Claim.insurance.sequence, which retains its base coordination-of-benefits (COB) meaning.

  • sequence: positiveInt: Số nguyên dương định danh duy nhất giai đoạn hưởng trong cùng Claim hoặc ExplanationOfBenefit. A positive integer that uniquely identifies the benefit stage within the containing Claim or ExplanationOfBenefit.
  • period: Period: Khoảng thời gian liên tục mà mức hưởng của giai đoạn có hiệu lực. The continuous period during which the stage benefit level applies.
  • benefitLevel: decimal: Tỷ lệ phần trăm mức hưởng BHYT áp dụng cho giai đoạn, trong khoảng 0..100. The BHYT benefit percentage applicable to the stage, constrained to 0..100.

 

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