Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.6.0

HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Phần mở rộng: Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation				Phiên bản: 0.6.0	Làm nổi bật phần thay đổi?
					Computable Name: VNCoreExtOrgLifecycleRelation

Extension ghi nhận quan hệ vòng đời giữa cơ sở y tế hiện tại và một cơ sở khác khi mã/định danh cơ sở thay đổi do sáp nhập, chia tách, đổi tên hoặc thay mã (vd hệ quả của sắp xếp đơn vị hành chính theo NQ 202/2025/QH15). Generic cho mọi cơ sở y tế VN. Mỗi lần lặp mô tả MỘT quan hệ: loại quan hệ (relationType), cơ sở liên quan (target), thời điểm hiệu lực (period), căn cứ pháp lý (legalBasis) và các hạng mục được kế thừa (carryOver). Khi cơ sở tiền nhiệm đã giải thể và không còn Organization resource phân giải được, target có thể dùng Reference.identifier để tham chiếu logic theo mã CSKCB cũ. Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC) + NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế).

Context of Use

This extension may be used on the following element(s)

Element ID: Organization

Usage info

Usages:

Use this Extension: Cơ sở y tế VN Core — VN Core Organization Profile
Examples for this Extension: Trạm Y tế xã Phú Mỹ

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.

Bảng Differential
Bảng Snapshot
Thống kê/Tham chiếu
Tất cả

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension		0..*	Extension	Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:relationType	S	1..1	Extension	Loại quan hệ (tiền nhiệm/kế nhiệm/sáp nhập/tách)
extension		0..0		Extension
url		1..1	uri	"relationType"
value[x]		0..1	Coding	Value of extension Binding: Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet (required)
extension:target	S	1..1	Extension	Cơ sở liên quan (mã trước/sau)
extension		0..0		Extension
url		1..1	uri	"target"
value[x]		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Value of extension
extension:period		0..1	Extension	Khoảng/thời điểm hiệu lực của quan hệ
extension		0..0		Extension
url		1..1	uri	"period"
value[x]		0..1	Period	Value of extension
extension:legalBasis		0..*	Extension	Căn cứ pháp lý của thay đổi (vd QĐ sáp nhập)
extension		0..0		Extension
url		1..1	uri	"legalBasis"
value[x]		0..1	Coding	Value of extension Binding: Văn bản pháp lý VN — Vietnam Legal Document Reference VS (extensible)
extension:carryOver		0..*	Extension	Hạng mục được kế thừa (giấy phép, hợp đồng BHYT, ĐK KCB ban đầu...)
extension		0..0		Extension
url		1..1	uri	"carryOver"
value[x]		0..1	Coding	Value of extension Binding: Tập giá trị hạng mục kế thừa khi chuyển mã cơ sở — Organization Carry-over Item ValueSet (required)
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation"
value[x]		0..0		Value of extension
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Extension.extension:relationType.value[x]	Base	required	Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet	📦0.6.0	This IG
Extension.extension:legalBasis.value[x]	Base	extensible	Văn bản pháp lý VN — Vietnam Legal Document Reference VS	📦0.6.0	This IG
Extension.extension:carryOver.value[x]	Base	required	Tập giá trị hạng mục kế thừa khi chuyển mã cơ sở — Organization Carry-over Item ValueSet	📦0.6.0	This IG

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension		0..*	Extension	Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension
id		0..1	string	Unique id for inter-element referencing
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
extension:relationType	S	1..1	Extension	Loại quan hệ (tiền nhiệm/kế nhiệm/sáp nhập/tách)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"relationType"
value[x]		0..1	Coding	Value of extension Binding: Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet (required)
extension:target	S	1..1	Extension	Cơ sở liên quan (mã trước/sau)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"target"
value[x]		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Value of extension
extension:period		0..1	Extension	Khoảng/thời điểm hiệu lực của quan hệ
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]		0..1	Period	Value of extension
extension:legalBasis		0..*	Extension	Căn cứ pháp lý của thay đổi (vd QĐ sáp nhập)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"legalBasis"
value[x]		0..1	Coding	Value of extension Binding: Văn bản pháp lý VN — Vietnam Legal Document Reference VS (extensible)
extension:carryOver		0..*	Extension	Hạng mục được kế thừa (giấy phép, hợp đồng BHYT, ĐK KCB ban đầu...)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"carryOver"
value[x]		0..1	Coding	Value of extension Binding: Tập giá trị hạng mục kế thừa khi chuyển mã cơ sở — Organization Carry-over Item ValueSet (required)
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation"
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Extension.extension:relationType.value[x]	Base	required	Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet	📦0.6.0	This IG
Extension.extension:legalBasis.value[x]	Base	extensible	Văn bản pháp lý VN — Vietnam Legal Document Reference VS	📦0.6.0	This IG
Extension.extension:carryOver.value[x]	Base	required	Tập giá trị hạng mục kế thừa khi chuyển mã cơ sở — Organization Carry-over Item ValueSet	📦0.6.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

Complex Extension: Extension ghi nhận quan hệ vòng đời giữa cơ sở y tế hiện tại và một cơ sở khác khi mã/định danh cơ sở thay đổi do sáp nhập, chia tách, đổi tên hoặc thay mã (vd hệ quả của sắp xếp đơn vị hành chính theo NQ 202/2025/QH15). Generic cho mọi cơ sở y tế VN. Mỗi lần lặp mô tả MỘT quan hệ: loại quan hệ (relationType), cơ sở liên quan (target), thời điểm hiệu lực (period), căn cứ pháp lý (legalBasis) và các hạng mục được kế thừa (carryOver). Khi cơ sở tiền nhiệm đã giải thể và không còn Organization resource phân giải được, target có thể dùng Reference.identifier để tham chiếu logic theo mã CSKCB cũ. Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC) + NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế).

relationType: Coding: An Extension
target: Reference: An Extension
period: Period: An Extension
legalBasis: Coding: An Extension
carryOver: Coding: An Extension

Dạng xem DifferentialDifferential View

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension		0..*	Extension	Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:relationType	S	1..1	Extension	Loại quan hệ (tiền nhiệm/kế nhiệm/sáp nhập/tách)
extension		0..0		Extension
url		1..1	uri	"relationType"
value[x]		0..1	Coding	Value of extension Binding: Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet (required)
extension:target	S	1..1	Extension	Cơ sở liên quan (mã trước/sau)
extension		0..0		Extension
url		1..1	uri	"target"
value[x]		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Value of extension
extension:period		0..1	Extension	Khoảng/thời điểm hiệu lực của quan hệ
extension		0..0		Extension
url		1..1	uri	"period"
value[x]		0..1	Period	Value of extension
extension:legalBasis		0..*	Extension	Căn cứ pháp lý của thay đổi (vd QĐ sáp nhập)
extension		0..0		Extension
url		1..1	uri	"legalBasis"
value[x]		0..1	Coding	Value of extension Binding: Văn bản pháp lý VN — Vietnam Legal Document Reference VS (extensible)
extension:carryOver		0..*	Extension	Hạng mục được kế thừa (giấy phép, hợp đồng BHYT, ĐK KCB ban đầu...)
extension		0..0		Extension
url		1..1	uri	"carryOver"
value[x]		0..1	Coding	Value of extension Binding: Tập giá trị hạng mục kế thừa khi chuyển mã cơ sở — Organization Carry-over Item ValueSet (required)
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation"
value[x]		0..0		Value of extension
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Extension.extension:relationType.value[x]	Base	required	Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet	📦0.6.0	This IG
Extension.extension:legalBasis.value[x]	Base	extensible	Văn bản pháp lý VN — Vietnam Legal Document Reference VS	📦0.6.0	This IG
Extension.extension:carryOver.value[x]	Base	required	Tập giá trị hạng mục kế thừa khi chuyển mã cơ sở — Organization Carry-over Item ValueSet	📦0.6.0	This IG

Dạng xem Snapshot

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension		0..*	Extension	Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension
id		0..1	string	Unique id for inter-element referencing
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
extension:relationType	S	1..1	Extension	Loại quan hệ (tiền nhiệm/kế nhiệm/sáp nhập/tách)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"relationType"
value[x]		0..1	Coding	Value of extension Binding: Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet (required)
extension:target	S	1..1	Extension	Cơ sở liên quan (mã trước/sau)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"target"
value[x]		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Value of extension
extension:period		0..1	Extension	Khoảng/thời điểm hiệu lực của quan hệ
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]		0..1	Period	Value of extension
extension:legalBasis		0..*	Extension	Căn cứ pháp lý của thay đổi (vd QĐ sáp nhập)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"legalBasis"
value[x]		0..1	Coding	Value of extension Binding: Văn bản pháp lý VN — Vietnam Legal Document Reference VS (extensible)
extension:carryOver		0..*	Extension	Hạng mục được kế thừa (giấy phép, hợp đồng BHYT, ĐK KCB ban đầu...)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"carryOver"
value[x]		0..1	Coding	Value of extension Binding: Tập giá trị hạng mục kế thừa khi chuyển mã cơ sở — Organization Carry-over Item ValueSet (required)
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation"
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Extension.extension:relationType.value[x]	Base	required	Tập giá trị loại quan hệ vòng đời mã cơ sở y tế — Organization Lifecycle Relation Type ValueSet	📦0.6.0	This IG
Extension.extension:legalBasis.value[x]	Base	extensible	Văn bản pháp lý VN — Vietnam Legal Document Reference VS	📦0.6.0	This IG
Extension.extension:carryOver.value[x]	Base	required	Tập giá trị hạng mục kế thừa khi chuyển mã cơ sở — Organization Carry-over Item ValueSet	📦0.6.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

Complex Extension: Extension ghi nhận quan hệ vòng đời giữa cơ sở y tế hiện tại và một cơ sở khác khi mã/định danh cơ sở thay đổi do sáp nhập, chia tách, đổi tên hoặc thay mã (vd hệ quả của sắp xếp đơn vị hành chính theo NQ 202/2025/QH15). Generic cho mọi cơ sở y tế VN. Mỗi lần lặp mô tả MỘT quan hệ: loại quan hệ (relationType), cơ sở liên quan (target), thời điểm hiệu lực (period), căn cứ pháp lý (legalBasis) và các hạng mục được kế thừa (carryOver). Khi cơ sở tiền nhiệm đã giải thể và không còn Organization resource phân giải được, target có thể dùng Reference.identifier để tham chiếu logic theo mã CSKCB cũ. Căn cứ: NQ 202/2025/QH15 (sắp xếp ĐVHC) + NĐ 102/2025/NĐ-CP (CSDL quốc gia về y tế).

relationType: Coding: An Extension
target: Reference: An Extension
period: Period: An Extension
legalBasis: Coding: An Extension
carryOver: Coding: An Extension

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

IG © 2026+ Omi HealthTech / VN Core FHIR Community Initiative. Package hl7.fhir.vn.core#0.6.0 based on FHIR 4.0.1. Sinh ngày 2026-06-10
Liên kết: Mục lục | Guide Map | Báo cáo QA