Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
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	Khoá 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"
value[x]		0..0		Value of extension
Documentation for this format

Constraints

Id	Grade	Path(s)	Description	Expression
vn-coverage-benefit-stage-level-range	error	Extension	**NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới. Thay bằng `vn-ext-cost-statement-segment`.** Extension này sinh ra để gộp nhiều giai đoạn hưởng trên `Claim.insurance`. Từ 0.10.0, extension nghỉ dùng: một `Claim` có thể mang nhiều `insurance` khi đổi thẻ giữa đợt, còn giai đoạn thẻ/mức hưởng và các dòng chi phí chuyển sang bảng kê bằng `vn-ext-cost-statement-segment` trên Invoice. Không tạo Claim hoặc MA_LK mới chỉ vì đổi thẻ. `Claim.related` giữ cardinality tuỳ chọn và ngữ nghĩa FHIR, nhưng nằm ngoài cam kết hỗ trợ tối thiểu quốc gia. Extension thay thế có `coverage 0..1` để biểu diễn được người KHÔNG có thẻ BHYT (QĐ 697/QĐ-BYT Phần Hai). Chi tiết: ADR-0021. 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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
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	Khoá 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"
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	**NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới. Thay bằng `vn-ext-cost-statement-segment`.** Extension này sinh ra để gộp nhiều giai đoạn hưởng trên `Claim.insurance`. Từ 0.10.0, extension nghỉ dùng: một `Claim` có thể mang nhiều `insurance` khi đổi thẻ giữa đợt, còn giai đoạn thẻ/mức hưởng và các dòng chi phí chuyển sang bảng kê bằng `vn-ext-cost-statement-segment` trên Invoice. Không tạo Claim hoặc MA_LK mới chỉ vì đổi thẻ. `Claim.related` giữ cardinality tuỳ chọn và ngữ nghĩa FHIR, nhưng nằm ngoài cam kết hỗ trợ tối thiểu quốc gia. Extension thay thế có `coverage 0..1` để biểu diễn được người KHÔNG có thẻ BHYT (QĐ 697/QĐ-BYT Phần Hai). Chi tiết: ADR-0021. 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: NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới. Extension từng mang khoá, khoảng thời gian và mức hưởng của một giai đoạn trên Claim hoặc ExplanationOfBenefit. Dữ liệu mới dùng một Claim với nhiều insurance khi đổi thẻ giữa đợt; thứ tự thẻ nằm ở Claim.insurance.sequence, đúng một mục là focal, và không nối các thẻ bằng Claim.related. Giai đoạn thẻ/mức hưởng cùng các dòng chi phí chuyển sang vn-ext-cost-statement-segment trên Invoice. 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. RETIRED since 0.10.0 — do not use for new data. This extension formerly carried a benefit stage on Claim or ExplanationOfBenefit. New data uses multiple ordered Claim.insurance entries for a card change within one episode, exactly one focal entry, and no Claim.related link between the cards. Card/benefit stages and their cost lines move to vn-ext-cost-statement-segment on Invoice.

• 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.

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
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	Khoá 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"
value[x]		0..0		Value of extension
Documentation for this format

Constraints

Id	Grade	Path(s)	Description	Expression
vn-coverage-benefit-stage-level-range	error	Extension	**NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới. Thay bằng `vn-ext-cost-statement-segment`.** Extension này sinh ra để gộp nhiều giai đoạn hưởng trên `Claim.insurance`. Từ 0.10.0, extension nghỉ dùng: một `Claim` có thể mang nhiều `insurance` khi đổi thẻ giữa đợt, còn giai đoạn thẻ/mức hưởng và các dòng chi phí chuyển sang bảng kê bằng `vn-ext-cost-statement-segment` trên Invoice. Không tạo Claim hoặc MA_LK mới chỉ vì đổi thẻ. `Claim.related` giữ cardinality tuỳ chọn và ngữ nghĩa FHIR, nhưng nằm ngoài cam kết hỗ trợ tối thiểu quốc gia. Extension thay thế có `coverage 0..1` để biểu diễn được người KHÔNG có thẻ BHYT (QĐ 697/QĐ-BYT Phần Hai). Chi tiết: ADR-0021. 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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
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	Khoá 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"
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	**NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới. Thay bằng `vn-ext-cost-statement-segment`.** Extension này sinh ra để gộp nhiều giai đoạn hưởng trên `Claim.insurance`. Từ 0.10.0, extension nghỉ dùng: một `Claim` có thể mang nhiều `insurance` khi đổi thẻ giữa đợt, còn giai đoạn thẻ/mức hưởng và các dòng chi phí chuyển sang bảng kê bằng `vn-ext-cost-statement-segment` trên Invoice. Không tạo Claim hoặc MA_LK mới chỉ vì đổi thẻ. `Claim.related` giữ cardinality tuỳ chọn và ngữ nghĩa FHIR, nhưng nằm ngoài cam kết hỗ trợ tối thiểu quốc gia. Extension thay thế có `coverage 0..1` để biểu diễn được người KHÔNG có thẻ BHYT (QĐ 697/QĐ-BYT Phần Hai). Chi tiết: ADR-0021. 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: NGHỈ DÙNG từ 0.10.0 — không dùng cho dữ liệu mới. Extension từng mang khoá, khoảng thời gian và mức hưởng của một giai đoạn trên Claim hoặc ExplanationOfBenefit. Dữ liệu mới dùng một Claim với nhiều insurance khi đổi thẻ giữa đợt; thứ tự thẻ nằm ở Claim.insurance.sequence, đúng một mục là focal, và không nối các thẻ bằng Claim.related. Giai đoạn thẻ/mức hưởng cùng các dòng chi phí chuyển sang vn-ext-cost-statement-segment trên Invoice. 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. RETIRED since 0.10.0 — do not use for new data. This extension formerly carried a benefit stage on Claim or ExplanationOfBenefit. New data uses multiple ordered Claim.insurance entries for a card change within one episode, exactly one focal entry, and no Claim.related link between the cards. Card/benefit stages and their cost lines move to vn-ext-cost-statement-segment on Invoice.

• 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.