Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Extension		0..*	Extension	Loại đối tượng BHYT — Vietnam BHYT Card Type Extension
extension		0..0		Extension
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type"
value[x]		1..1	CodeableConcept	Loại đối tượng BHYT Binding: Loại đối tượng BHYT phạm vi BHXH chung/cấp tỉnh — Vietnam General/Provincial BHYT Participant Type ValueSet (extensible)
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Extension.value[x]	Base	extensible	Loại đối tượng BHYT phạm vi BHXH chung/cấp tỉnh — Vietnam General/Provincial BHYT Participant Type ValueSet	📦0.10.0	This IG

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Extension		0..*	Extension	Loại đối tượng BHYT — Vietnam BHYT Card Type Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type"
value[x]		1..1	CodeableConcept	Loại đối tượng BHYT Binding: Loại đối tượng BHYT phạm vi BHXH chung/cấp tỉnh — Vietnam General/Provincial BHYT Participant Type ValueSet (extensible)
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Extension.value[x]	Base	extensible	Loại đối tượng BHYT phạm vi BHXH chung/cấp tỉnh — Vietnam General/Provincial BHYT Participant Type ValueSet	📦0.10.0	This IG

Constraints

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

Summary

Simple Extension with the type CodeableConcept: Mở rộng ghi nhận mã loại đối tượng tham gia bảo hiểm y tế (DN, HC, HN, TE, BT, CN, LH...). ValueSet đi kèm là snapshot 59 mã thuộc phạm vi BHXH chung/cấp tỉnh theo Phụ lục I CV 1804/BHXH-QLT; binding extensible cho phép mã sectoral có thẩm quyền của BHXH Quân đội/BHXH Công an Nhân dân. Mã nhóm được tra cứu từ cơ quan BHXH kèm danh mục nguồn và thời điểm. Hai ký tự đầu của mã thẻ 15 ký tự legacy không đủ để xác định nghĩa hiện hành. Khi đã xác minh danh mục Phụ lục C QĐ 3680/QĐ-BHXH, ghi bằng vn-bhyt-card-type-legacy-cs; nếu chưa xác minh được, giữ nguyên identifier và văn bản nguồn, không tự gán mã hiện hành. Không đồng nhất mã nhóm với toàn bộ giá trị MA_THE_BHYT trong chuẩn dữ liệu đầu ra hiện hành.

Mã đối tượng KHÔNG tự xác định mức quyền lợi, tỷ lệ cùng chi trả hoặc kết quả adjudication. Hệ thống phải dùng thông tin quyền lợi do Cổng BHXH trả về và pháp luật có hiệu lực tại thời điểm dịch vụ. Từ 01/01/2026, NQ 261/2025/QH15 Điều 2 khoản 1 điểm a và CV 38/BYT-BH ngày 06/01/2026 chuyển CN và người từ đủ 75 tuổi trở lên thuộc LH sang mã quyền lợi 2 (100% trong phạm vi được hưởng).

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Extension		0..*	Extension	Loại đối tượng BHYT — Vietnam BHYT Card Type Extension
extension		0..0		Extension
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type"
value[x]		1..1	CodeableConcept	Loại đối tượng BHYT Binding: Loại đối tượng BHYT phạm vi BHXH chung/cấp tỉnh — Vietnam General/Provincial BHYT Participant Type ValueSet (extensible)
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Extension.value[x]	Base	extensible	Loại đối tượng BHYT phạm vi BHXH chung/cấp tỉnh — Vietnam General/Provincial BHYT Participant Type ValueSet	📦0.10.0	This IG

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Extension		0..*	Extension	Loại đối tượng BHYT — Vietnam BHYT Card Type Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type"
value[x]		1..1	CodeableConcept	Loại đối tượng BHYT Binding: Loại đối tượng BHYT phạm vi BHXH chung/cấp tỉnh — Vietnam General/Provincial BHYT Participant Type ValueSet (extensible)
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Extension.value[x]	Base	extensible	Loại đối tượng BHYT phạm vi BHXH chung/cấp tỉnh — Vietnam General/Provincial BHYT Participant Type ValueSet	📦0.10.0	This IG

Constraints

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

Summary

Simple Extension with the type CodeableConcept: Mở rộng ghi nhận mã loại đối tượng tham gia bảo hiểm y tế (DN, HC, HN, TE, BT, CN, LH...). ValueSet đi kèm là snapshot 59 mã thuộc phạm vi BHXH chung/cấp tỉnh theo Phụ lục I CV 1804/BHXH-QLT; binding extensible cho phép mã sectoral có thẩm quyền của BHXH Quân đội/BHXH Công an Nhân dân. Mã nhóm được tra cứu từ cơ quan BHXH kèm danh mục nguồn và thời điểm. Hai ký tự đầu của mã thẻ 15 ký tự legacy không đủ để xác định nghĩa hiện hành. Khi đã xác minh danh mục Phụ lục C QĐ 3680/QĐ-BHXH, ghi bằng vn-bhyt-card-type-legacy-cs; nếu chưa xác minh được, giữ nguyên identifier và văn bản nguồn, không tự gán mã hiện hành. Không đồng nhất mã nhóm với toàn bộ giá trị MA_THE_BHYT trong chuẩn dữ liệu đầu ra hiện hành.

Mã đối tượng KHÔNG tự xác định mức quyền lợi, tỷ lệ cùng chi trả hoặc kết quả adjudication. Hệ thống phải dùng thông tin quyền lợi do Cổng BHXH trả về và pháp luật có hiệu lực tại thời điểm dịch vụ. Từ 01/01/2026, NQ 261/2025/QH15 Điều 2 khoản 1 điểm a và CV 38/BYT-BH ngày 06/01/2026 chuyển CN và người từ đủ 75 tuổi trở lên thuộc LH sang mã quyền lợi 2 (100% trong phạm vi được hưởng).