Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Extension	C	0..*	Extension	Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status Constraints: vn-op-license-partial-scope, vn-op-license-suspension-period, vn-op-license-adverse-decision
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:status	S	1..1	Extension	Trạng thái hiện tại của giấy phép hoạt động
extension		0..0		Extension
url		1..1	uri	"status"
value[x]		1..1	Coding	Value of extension Binding: Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status ValueSet (required)
extension:effectivePeriod	S	0..1	Extension	Thời gian áp dụng trạng thái đình chỉ (Điều 55 khoản 2: 01-24 tháng)
extension		0..0		Extension
url		1..1	uri	"effectivePeriod"
value[x]		1..1	Period	Value of extension
extension:decisionIdentifier	S	0..1	Extension	Số quyết định đình chỉ hoặc thu hồi
extension		0..0		Extension
url		1..1	uri	"decisionIdentifier"
value[x]		1..1	Identifier	Value of extension
extension:decisionDate	S	0..1	Extension	Ngày ban hành quyết định
extension		0..0		Extension
url		1..1	uri	"decisionDate"
value[x]		1..1	date	Value of extension
extension:decisionAuthority	S	0..1	Extension	Cơ quan ban hành quyết định (thẩm quyền theo Điều 51)
extension		0..0		Extension
url		1..1	uri	"decisionAuthority"
value[x]		1..1	Reference(Organization)	Value of extension
extension:affectedScope	S	0..1	Extension	Phạm vi bị đình chỉ khi đình chỉ một phần
extension		0..0		Extension
url		1..1	uri	"affectedScope"
value[x]		1..1	string	Value of extension
extension:reason	S	0..1	Extension	Lý do bị đình chỉ hoặc bị thu hồi
extension		0..0		Extension
url		1..1	uri	"reason"
value[x]		1..1	string	Value of extension
extension:conditionForResumption	S	0..1	Extension	Điều kiện để được tiếp tục hoạt động (Điều 55 khoản 4)
extension		0..0		Extension
url		1..1	uri	"conditionForResumption"
value[x]		1..1	string	Value of extension
extension:sourceDocument	S	0..1	Extension	Quyết định hoặc tài liệu pháp lý nguồn
extension		0..0		Extension
url		1..1	uri	"sourceDocument"
value[x]		1..1	Reference(DocumentReference)	Value of extension
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-operating-license-status"
value[x]		0..0		Value of extension
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Extension.extension:status.​value[x]	Base	required	Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
vn-op-license-adverse-decision	error	Extension	Trạng thái khác `active` phải dẫn chiếu số quyết định hoặc tài liệu nguồn. A non-active status SHALL reference the decision number or a source document.	extension.where(url = 'status').value.ofType(Coding).where(code != 'active').empty() or extension.where(url = 'decisionIdentifier').value.ofType(Identifier).where(value.exists()).exists() or extension.where(url = 'sourceDocument').value.ofType(Reference).where(reference.exists()).exists()
vn-op-license-partial-scope	error	Extension	Giấy phép bị đình chỉ một phần phải chỉ rõ phạm vi bị đình chỉ. A partially suspended licence SHALL state the suspended scope.	extension.where(url = 'status').value.ofType(Coding).where(code = 'partially-suspended').empty() or extension.where(url = 'affectedScope').value.ofType(string).exists()
vn-op-license-suspension-period	error	Extension	Trạng thái đình chỉ phải có ngày bắt đầu và ngày kết thúc. A suspension SHALL carry both a start and an end date.	extension.where(url = 'status').value.ofType(Coding).where(code = 'partially-suspended' or code = 'fully-suspended').empty() or extension.where(url = 'effectivePeriod').value.ofType(Period).where(start.exists() and end.exists()).exists()

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Extension	C	0..*	Extension	Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status Constraints: vn-op-license-partial-scope, vn-op-license-suspension-period, vn-op-license-adverse-decision
id		0..1	string	Unique id for inter-element referencing
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:status	S	1..1	Extension	Trạng thái hiện tại của giấy phép hoạt động
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"status"
value[x]		1..1	Coding	Value of extension Binding: Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status ValueSet (required)
extension:effectivePeriod	S	0..1	Extension	Thời gian áp dụng trạng thái đình chỉ (Điều 55 khoản 2: 01-24 tháng)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"effectivePeriod"
value[x]		1..1	Period	Value of extension
extension:decisionIdentifier	S	0..1	Extension	Số quyết định đình chỉ hoặc thu hồi
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"decisionIdentifier"
value[x]		1..1	Identifier	Value of extension
extension:decisionDate	S	0..1	Extension	Ngày ban hành quyết định
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"decisionDate"
value[x]		1..1	date	Value of extension
extension:decisionAuthority	S	0..1	Extension	Cơ quan ban hành quyết định (thẩm quyền theo Điều 51)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"decisionAuthority"
value[x]		1..1	Reference(Organization)	Value of extension
extension:affectedScope	S	0..1	Extension	Phạm vi bị đình chỉ khi đình chỉ một phần
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"affectedScope"
value[x]		1..1	string	Value of extension
extension:reason	S	0..1	Extension	Lý do bị đình chỉ hoặc bị thu hồi
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"reason"
value[x]		1..1	string	Value of extension
extension:conditionForResumption	S	0..1	Extension	Điều kiện để được tiếp tục hoạt động (Điều 55 khoản 4)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"conditionForResumption"
value[x]		1..1	string	Value of extension
extension:sourceDocument	S	0..1	Extension	Quyết định hoặc tài liệu pháp lý nguồn
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"sourceDocument"
value[x]		1..1	Reference(DocumentReference)	Value of extension
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-operating-license-status"
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Extension.extension:status.​value[x]	Base	required	Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status 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()
vn-op-license-adverse-decision	error	Extension	Trạng thái khác `active` phải dẫn chiếu số quyết định hoặc tài liệu nguồn. A non-active status SHALL reference the decision number or a source document.	extension.where(url = 'status').value.ofType(Coding).where(code != 'active').empty() or extension.where(url = 'decisionIdentifier').value.ofType(Identifier).where(value.exists()).exists() or extension.where(url = 'sourceDocument').value.ofType(Reference).where(reference.exists()).exists()
vn-op-license-partial-scope	error	Extension	Giấy phép bị đình chỉ một phần phải chỉ rõ phạm vi bị đình chỉ. A partially suspended licence SHALL state the suspended scope.	extension.where(url = 'status').value.ofType(Coding).where(code = 'partially-suspended').empty() or extension.where(url = 'affectedScope').value.ofType(string).exists()
vn-op-license-suspension-period	error	Extension	Trạng thái đình chỉ phải có ngày bắt đầu và ngày kết thúc. A suspension SHALL carry both a start and an end date.	extension.where(url = 'status').value.ofType(Coding).where(code = 'partially-suspended' or code = 'fully-suspended').empty() or extension.where(url = 'effectivePeriod').value.ofType(Period).where(start.exists() and end.exists()).exists()

Summary

Complex Extension: Complex extension gắn TRỰC TIẾP vào Identifier của giấy phép hoạt động cơ sở KCB, mang trạng thái pháp lý và dữ liệu của quyết định đình chỉ/thu hồi. Vì sao gắn vào Identifier chứ không vào Organization: trạng thái này thuộc về CHÍNH credential đó. Một pháp nhân có nhiều địa điểm thì mỗi địa điểm một giấy phép riêng (Luật 15/2023/QH15 Điều 50 khoản 1) và có thể bị đình chỉ độc lập với nhau. Vì sao KHÔNG phải modifierExtension: Identifier kế thừa Element, không kế thừa BackboneElement, nên trong FHIR R4 nó không có modifierExtension. Extension này bổ sung thông tin về credential, không đảo ngược nghĩa của bất kỳ element nào — đặc biệt KHÔNG thay đổi nghĩa của Organization.active. Căn cứ: Luật 15/2023/QH15 Điều 50 (giấy phép không thời hạn), Điều 55 (đình chỉ một phần hoặc toàn bộ, thời hạn 01-24 tháng, điều kiện hoạt động trở lại), Điều 56 (thu hồi); NĐ 96/2023/NĐ-CP Điều 78 (nội dung bắt buộc của quyết định đình chỉ và quyết định thu hồi).

• status: Coding: An Extension
• effectivePeriod: Period: An Extension
• decisionIdentifier: Identifier: An Extension
• decisionDate: date: An Extension
• decisionAuthority: Reference: An Extension
• affectedScope: string: Ghi rõ phần phạm vi hoạt động chuyên môn bị đình chỉ. Dạng string vì NĐ 96/2023/NĐ-CP Điều 78 mô tả phạm vi bằng văn xuôi trong quyết định, không bằng bộ mã.
• reason: string: An Extension
• conditionForResumption: string: An Extension
• sourceDocument: Reference: An Extension

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Extension	C	0..*	Extension	Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status Constraints: vn-op-license-partial-scope, vn-op-license-suspension-period, vn-op-license-adverse-decision
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:status	S	1..1	Extension	Trạng thái hiện tại của giấy phép hoạt động
extension		0..0		Extension
url		1..1	uri	"status"
value[x]		1..1	Coding	Value of extension Binding: Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status ValueSet (required)
extension:effectivePeriod	S	0..1	Extension	Thời gian áp dụng trạng thái đình chỉ (Điều 55 khoản 2: 01-24 tháng)
extension		0..0		Extension
url		1..1	uri	"effectivePeriod"
value[x]		1..1	Period	Value of extension
extension:decisionIdentifier	S	0..1	Extension	Số quyết định đình chỉ hoặc thu hồi
extension		0..0		Extension
url		1..1	uri	"decisionIdentifier"
value[x]		1..1	Identifier	Value of extension
extension:decisionDate	S	0..1	Extension	Ngày ban hành quyết định
extension		0..0		Extension
url		1..1	uri	"decisionDate"
value[x]		1..1	date	Value of extension
extension:decisionAuthority	S	0..1	Extension	Cơ quan ban hành quyết định (thẩm quyền theo Điều 51)
extension		0..0		Extension
url		1..1	uri	"decisionAuthority"
value[x]		1..1	Reference(Organization)	Value of extension
extension:affectedScope	S	0..1	Extension	Phạm vi bị đình chỉ khi đình chỉ một phần
extension		0..0		Extension
url		1..1	uri	"affectedScope"
value[x]		1..1	string	Value of extension
extension:reason	S	0..1	Extension	Lý do bị đình chỉ hoặc bị thu hồi
extension		0..0		Extension
url		1..1	uri	"reason"
value[x]		1..1	string	Value of extension
extension:conditionForResumption	S	0..1	Extension	Điều kiện để được tiếp tục hoạt động (Điều 55 khoản 4)
extension		0..0		Extension
url		1..1	uri	"conditionForResumption"
value[x]		1..1	string	Value of extension
extension:sourceDocument	S	0..1	Extension	Quyết định hoặc tài liệu pháp lý nguồn
extension		0..0		Extension
url		1..1	uri	"sourceDocument"
value[x]		1..1	Reference(DocumentReference)	Value of extension
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-operating-license-status"
value[x]		0..0		Value of extension
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Extension.extension:status.​value[x]	Base	required	Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
vn-op-license-adverse-decision	error	Extension	Trạng thái khác `active` phải dẫn chiếu số quyết định hoặc tài liệu nguồn. A non-active status SHALL reference the decision number or a source document.	extension.where(url = 'status').value.ofType(Coding).where(code != 'active').empty() or extension.where(url = 'decisionIdentifier').value.ofType(Identifier).where(value.exists()).exists() or extension.where(url = 'sourceDocument').value.ofType(Reference).where(reference.exists()).exists()
vn-op-license-partial-scope	error	Extension	Giấy phép bị đình chỉ một phần phải chỉ rõ phạm vi bị đình chỉ. A partially suspended licence SHALL state the suspended scope.	extension.where(url = 'status').value.ofType(Coding).where(code = 'partially-suspended').empty() or extension.where(url = 'affectedScope').value.ofType(string).exists()
vn-op-license-suspension-period	error	Extension	Trạng thái đình chỉ phải có ngày bắt đầu và ngày kết thúc. A suspension SHALL carry both a start and an end date.	extension.where(url = 'status').value.ofType(Coding).where(code = 'partially-suspended' or code = 'fully-suspended').empty() or extension.where(url = 'effectivePeriod').value.ofType(Period).where(start.exists() and end.exists()).exists()

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Extension	C	0..*	Extension	Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status Constraints: vn-op-license-partial-scope, vn-op-license-suspension-period, vn-op-license-adverse-decision
id		0..1	string	Unique id for inter-element referencing
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
extension:status	S	1..1	Extension	Trạng thái hiện tại của giấy phép hoạt động
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"status"
value[x]		1..1	Coding	Value of extension Binding: Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status ValueSet (required)
extension:effectivePeriod	S	0..1	Extension	Thời gian áp dụng trạng thái đình chỉ (Điều 55 khoản 2: 01-24 tháng)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"effectivePeriod"
value[x]		1..1	Period	Value of extension
extension:decisionIdentifier	S	0..1	Extension	Số quyết định đình chỉ hoặc thu hồi
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"decisionIdentifier"
value[x]		1..1	Identifier	Value of extension
extension:decisionDate	S	0..1	Extension	Ngày ban hành quyết định
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"decisionDate"
value[x]		1..1	date	Value of extension
extension:decisionAuthority	S	0..1	Extension	Cơ quan ban hành quyết định (thẩm quyền theo Điều 51)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"decisionAuthority"
value[x]		1..1	Reference(Organization)	Value of extension
extension:affectedScope	S	0..1	Extension	Phạm vi bị đình chỉ khi đình chỉ một phần
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"affectedScope"
value[x]		1..1	string	Value of extension
extension:reason	S	0..1	Extension	Lý do bị đình chỉ hoặc bị thu hồi
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"reason"
value[x]		1..1	string	Value of extension
extension:conditionForResumption	S	0..1	Extension	Điều kiện để được tiếp tục hoạt động (Điều 55 khoản 4)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"conditionForResumption"
value[x]		1..1	string	Value of extension
extension:sourceDocument	S	0..1	Extension	Quyết định hoặc tài liệu pháp lý nguồn
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"sourceDocument"
value[x]		1..1	Reference(DocumentReference)	Value of extension
url		1..1	uri	"http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-operating-license-status"
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Extension.extension:status.​value[x]	Base	required	Trạng thái giấy phép hoạt động cơ sở KCB — KCB Operating License Status 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()
vn-op-license-adverse-decision	error	Extension	Trạng thái khác `active` phải dẫn chiếu số quyết định hoặc tài liệu nguồn. A non-active status SHALL reference the decision number or a source document.	extension.where(url = 'status').value.ofType(Coding).where(code != 'active').empty() or extension.where(url = 'decisionIdentifier').value.ofType(Identifier).where(value.exists()).exists() or extension.where(url = 'sourceDocument').value.ofType(Reference).where(reference.exists()).exists()
vn-op-license-partial-scope	error	Extension	Giấy phép bị đình chỉ một phần phải chỉ rõ phạm vi bị đình chỉ. A partially suspended licence SHALL state the suspended scope.	extension.where(url = 'status').value.ofType(Coding).where(code = 'partially-suspended').empty() or extension.where(url = 'affectedScope').value.ofType(string).exists()
vn-op-license-suspension-period	error	Extension	Trạng thái đình chỉ phải có ngày bắt đầu và ngày kết thúc. A suspension SHALL carry both a start and an end date.	extension.where(url = 'status').value.ofType(Coding).where(code = 'partially-suspended' or code = 'fully-suspended').empty() or extension.where(url = 'effectivePeriod').value.ofType(Period).where(start.exists() and end.exists()).exists()

Summary

Complex Extension: Complex extension gắn TRỰC TIẾP vào Identifier của giấy phép hoạt động cơ sở KCB, mang trạng thái pháp lý và dữ liệu của quyết định đình chỉ/thu hồi. Vì sao gắn vào Identifier chứ không vào Organization: trạng thái này thuộc về CHÍNH credential đó. Một pháp nhân có nhiều địa điểm thì mỗi địa điểm một giấy phép riêng (Luật 15/2023/QH15 Điều 50 khoản 1) và có thể bị đình chỉ độc lập với nhau. Vì sao KHÔNG phải modifierExtension: Identifier kế thừa Element, không kế thừa BackboneElement, nên trong FHIR R4 nó không có modifierExtension. Extension này bổ sung thông tin về credential, không đảo ngược nghĩa của bất kỳ element nào — đặc biệt KHÔNG thay đổi nghĩa của Organization.active. Căn cứ: Luật 15/2023/QH15 Điều 50 (giấy phép không thời hạn), Điều 55 (đình chỉ một phần hoặc toàn bộ, thời hạn 01-24 tháng, điều kiện hoạt động trở lại), Điều 56 (thu hồi); NĐ 96/2023/NĐ-CP Điều 78 (nội dung bắt buộc của quyết định đình chỉ và quyết định thu hồi).

• status: Coding: An Extension
• effectivePeriod: Period: An Extension
• decisionIdentifier: Identifier: An Extension
• decisionDate: date: An Extension
• decisionAuthority: Reference: An Extension
• affectedScope: string: Ghi rõ phần phạm vi hoạt động chuyên môn bị đình chỉ. Dạng string vì NĐ 96/2023/NĐ-CP Điều 78 mô tả phạm vi bằng văn xuôi trong quyết định, không bằng bộ mã.
• reason: string: An Extension
• conditionForResumption: string: An Extension
• sourceDocument: Reference: An Extension