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.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

• Nội dung
• Mô tả chi tiết
• Ánh xạ
• Các ví dụ
• XML
• JSON
• TTL

Hồ sơ tài nguyên: Nhân viên y tế VN Core — VN Core Practitioner Profile

Profile Practitioner cho Việt Nam. Bao gồm identifier slicing (CCCD, GPHN hiện hành, CCHN chuyển tiếp), thông tin trình độ chuyên môn (qualification). Căn cứ:

• Luật KCB 2023 — Điều 19-27 — hành nghề KCB
• NĐ 96/2023/NĐ-CP — 30/12/2023 — hướng dẫn Luật KCB
• TT 32/2023/TT-BYT — 31/12/2023 — hướng dẫn phạm vi hành nghề và chuyên môn KCB
• NĐ 102/2025/NĐ-CP — 13/5/2025, hiệu lực 01/7/2025 — Điều 6 quy định số định danh cá nhân (CCCD 12 số) là mã định danh y tế của cá nhân, áp dụng cho cả Patient và nhân lực y tế
• TT 13/2025/TT-BYT — 06/6/2025 — bệnh án điện tử.

Pattern identifier:

• identifier[CCCD] = mã định danh y tế của nhân lực (theo NĐ 102/2025/NĐ-CP Điều 6) — primary key
• identifier[GPHN] = số Giấy phép hành nghề theo Luật KCB 2023 Điều 27. Cấu trúc {6 chữ số}/{mã cơ quan}-GPHN có trong TT 32/2023/TT-BYT Phụ lục XIX, nhưng profile vẫn bảo toàn nguyên chuỗi do cơ quan có thẩm quyền cấp và KHÔNG áp regex, vì bảng mã cơ quan của Phụ lục đó phản ánh cơ cấu 63 tỉnh trước NQ 202/2025/QH15 — xem giải thích đầy đủ tại identifier[GPHN] bên dưới
• identifier[CCHN] = số Chứng chỉ hành nghề cấp theo Luật KCB 40/2009/QH12. KHÔNG thuần lịch sử: theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2, CCHN được tiếp tục sử dụng NHƯ giấy phép hành nghề cho tới khi chuyển đổi
• Mỗi slice GPHN và CCHN mang extension practiceLicenseStatus (1..1) khai trạng thái pháp lý của chính credential đó, kèm phạm vi bị đình chỉ khi đình chỉ một phần. Hiệu lực KHÔNG suy từ period.end — xem VNPracticeLicenseStatusCS
• extension[practiceLicenseExemption] khai căn cứ miễn điều kiện giấy phép theo Luật 15/2023/QH15 Điều 19 khoản 2-4 (sinh viên thực hành, y tế thôn bản, huy động khẩn cấp, đoàn KCB nhân đạo nước ngoài, cấp cứu cộng đồng)

Chức danh pháp lý và nghĩa vụ giấy phép: qualification[RegulatedTitle] khai một trong 10 chức danh chuyên môn phải có giấy phép hành nghề (Luật 15/2023/QH15 Điều 26 khoản 1). Khai chức danh đó kích hoạt invariant vn-practitioner-regulated-title-license. Ngạch/hạng viên chức V.08 (VNPractitionerTitleCS) là trục khác, dùng ở PractitionerRole và KHÔNG kích hoạt invariant — xem ConceptMap vn-cm-practitioner-title-to-regulated-title.

Usages:

• Use this Profile: Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle
• Refer to this Profile: Dị ứng/Bất dung nạp VN Core — VN Core AllergyIntolerance Profile, Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile, Quyết định xử lý dựa trên căn cứ pháp lý — VN Core Legal-Basis Decision AuditEvent, Nhóm chăm sóc VN Core — VN Core CareTeam Profile... Show 34 more, Dòng chi phí phát sinh — VN Core ChargeItem, Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile, Nhận định lâm sàng VN Core — VN Core ClinicalImpression Profile, Giấy chứng sinh — VN Core Birth Certificate Composition, Thông báo vi phạm DLCN (Mẫu 08) — VN Core Breach Notification Composition Profile, Giấy khám sức khoẻ định kỳ VN Core — VN Core Health Checkup Composition Profile, Sổ Sức khoẻ điện tử VN Core — VN Core Health Record Summary (Patient Summary) Profile, Giấy chứng sinh mang thai hộ — VN Core Surrogacy Birth Certificate Composition, Bệnh án điện tử VN Core — VN Core Composition Profile, Chẩn đoán VN Core — VN Core Condition Profile, Đồng ý xử lý dữ liệu VN Core — VN Core Consent Profile, Bản ghi attestation bảng kê chi phí khám bệnh, chữa bệnh — VN Core Cost Statement Composition, Báo cáo Chẩn đoán hình ảnh VN Core — VN Core Imaging DiagnosticReport, Báo cáo cận lâm sàng VN Core — VN Core DiagnosticReport Profile, Tài liệu y tế VN Core — VN Core DocumentReference Profile, Lượt khám/nhập viện VN Core — VN Core Encounter Profile, Giải trình quyền lợi BHYT VN Core — VN Core ExplanationOfBenefit Profile, Nhóm đối tượng VN Core — VN Core Group Profile, Nghiên cứu CĐHA VN Core — VN Core Imaging Study Profile, Tiêm chủng — VN Core Immunization, Kết quả đo chỉ tiêu VN Core — VN Core MeasureReport Profile, Sử dụng/Cho dùng thuốc VN Core — VN Core Medication Administration Profile, Cấp phát thuốc VN Core — VN Core Medication Dispense Profile, Đơn thuốc VN Core — VN Core MedicationRequest Profile, Phân loại sức khoẻ VN Core — VN Core Observation Health Classification Profile, Xét nghiệm VN Core — VN Core Observation Laboratory Profile, Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile, Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile, Thủ thuật/DVKT VN Core — VN Core Procedure Profile, Lịch cung cấp dịch vụ VN Core — VN Core Schedule Profile, Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile, Mẫu bệnh phẩm VN Core — VN Core Specimen Profile, Công việc điều phối VN Core — VN Core Task Profile and Bằng chứng chuyển đổi giấy ↔ điện tử — Paper/Electronic Conversion Evidence Extension
• Examples for this Profile: Practitioner/ExamplePractitionerBSCKII, Practitioner/ExamplePractitionerCCCDBadFormat, Practitioner/ExamplePractitionerCCHNTransition, Practitioner/ExamplePractitionerExemptTrainee... Show 11 more, Practitioner/ExamplePractitionerMinimal, Practitioner/ExamplePractitionerNonRegulatedPublicHealth, Practitioner/ExamplePractitionerPartialSuspensionMissingDecision, Practitioner/ExamplePractitionerPartialSuspensionMissingScope, Practitioner/ExamplePractitionerPartiallySuspended, Practitioner/ExamplePractitionerRegulatedTitleExpiredGPHN, Practitioner/ExamplePractitionerRegulatedTitleNoCredential, Practitioner/ExamplePractitionerRegulatedTitleRevokedGPHN, Practitioner/ExamplePractitionerRenewalPending, Practitioner/ExamplePractitionerTrainee and Practitioner/ExamplePractitionerYHCT
• CapabilityStatements using this Profile: VN Core Data Requester CapabilityStatement, VN Core Data Responder CapabilityStatement and VN Core Server CapabilityStatement

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 hồ sơ

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

• Bảng phần tử chính
• Bảng Differential
• Bảng Snapshot
• Nghĩa vụ hỗ trợ
• Thống kê/Tham chiếu
• Tất cả

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Practitioner	C	0..*	Practitioner	A person with a formal responsibility in the provisioning of healthcare or related services Constraints: vn-practitioner-regulated-title-license
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣ	1..*	Identifier	Định danh NVYT (CCCD, GPHN, CCHN chuyển tiếp) Slice: Unordered, Open by value:system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
identifier:CCCD	SOΣC	0..1	Identifier	Số CCCD (Căn cước công dân) Constraints: vn-cccd-format Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCCD
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd
value	SΣ	1..1	string	The value that is unique Example General: 123456
identifier:GPHN	SOΣ	0..1	Identifier	Số GPHN nguyên văn do cơ quan có thẩm quyền cấp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của chính GPHN này (không suy từ period.end) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: GPHN
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gphn
value	SΣ	1..1	string	The value that is unique Example General: 123456
identifier:CCHN	SOΣ	0..1	Identifier	Số CCHN chuyển tiếp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của CCHN — cchn-transition-continued nếu đang dùng như GPHN theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCHN
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cchn
value	Σ	1..1	string	The value that is unique Example General: 123456
name	SOΣ	1..*	HumanName	Họ tên nhân viên y tế Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
use	?!Σ	0..1	code	usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name.
text	SΣ	0..1	string	Họ tên đầy đủ
family	SΣ	0..1	string	Họ
given	SΣ	0..*	string	Tên đệm và Tên This repeating element order: Given Names appear in the correct order for presenting the name
gender	SOΣ	0..1	code	Giới tính Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
Slices for qualification	SO	0..*	BackboneElement	Chức danh pháp lý và trình độ chuyên môn / học vị Slice: Unordered, Open by value:code.coding.system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
qualification:All Slices				Content/Rules for all slices
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		1..1	CodeableConcept	Coded representation of the qualification Binding: v2 table 0360, Version 2.7 (example): Specific qualification the practitioner has to provide a service.
qualification:RegulatedTitle	SO	0..1	BackboneElement	Chức danh chuyên môn phải có giấy phép hành nghề (tự khai) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet (required)
coding	SΣ	1..1	Coding	Code defined by a terminology system
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs
code	Σ	1..1	code	Symbol in syntax defined by the system
issuer		0..1	Reference(Organization)	Cơ quan cấp giấy phép hành nghề
qualification:Education	SO	0..*	BackboneElement	Trình độ chuyên môn / Học vị (BS, BS CKI, BS CKII, ThS, TS, PGS, GS...) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet (required)
coding	SΣ	1..1	Coding	Code defined by a terminology system
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-qualification-cs
code	Σ	1..1	code	Symbol in syntax defined by the system
issuer		0..1	Reference(Organization)	Cơ quan cấp (BYT, Sở YT, Trường ĐH)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)
Practitioner
Slices for extension
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:GPHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
identifier:CCHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for qualification	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:All Slices
qualification:RegulatedTitle	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:Education	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Practitioner.identifier:CCCD.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:CCCD.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.identifier:GPHN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:GPHN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.identifier:CCHN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:CCHN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.name.use	Base	required	NameUse	📍4.0.1	FHIR Std.
Practitioner.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Practitioner.qualification.​code	Base	example	v2 table 0360, Version 2.7	📦0360	FHIR Std.
Practitioner.qualification:RegulatedTitle.​code	Base	required	Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet	📦0.10.0	This IG
Practitioner.qualification:Education.​code	Base	required	Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Practitioner	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Practitioner	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Practitioner	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated	contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Practitioner	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Practitioner	A resource should have narrative for robust management	text.`div`.exists()
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-cccd-format	error	Practitioner.identifier:CCCD	Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
vn-practitioner-regulated-title-license	error	Practitioner	Practitioner tự khai một trong 10 chức danh phải có giấy phép hành nghề thì phải mang credential hành nghề còn giá trị — GPHN đang hiệu lực, đang chờ gia hạn hoặc bị đình chỉ một phần, hoặc CCHN chuyển tiếp. Miễn trừ theo Luật 15/2023/QH15 Điều 19 khoản 2-4 KHÔNG khai trên Practitioner nữa (SEM-B02, 13/08/2026 — mere presence từng bypass): người hành nghề theo diện miễn trừ biểu diễn bằng PractitionerRole + vn-ext-practice-license-exemption-role có cơ sở/thời hạn/người giám sát, và KHÔNG tự khai chức danh regulated ở tầng Practitioner khi chưa có credential. A Practitioner declaring a regulated title SHALL carry a valid practice credential; statutory exemptions live on PractitionerRole.	qualification.code.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs').empty() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gphn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'active' or code = 'renewal-pending-continued' or code = 'partially-suspended').exists() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/cchn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'cchn-transition-continued' or code = 'partially-suspended').exists()

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Practitioner	C	0..*	Practitioner	A person with a formal responsibility in the provisioning of healthcare or related services Constraints: vn-practitioner-regulated-title-license
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:practiceLicenseExemption		0..0	(Complex)	Căn cứ miễn điều kiện giấy phép hành nghề (Luật 15/2023/QH15 Điều 19 khoản 2-4) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-exemption
Slices for identifier	SO	1..*	Identifier	Định danh NVYT (CCCD, GPHN, CCHN chuyển tiếp) Slice: Unordered, Open by value:system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
identifier:CCCD	SOC	0..1	Identifier	Số CCCD (Căn cước công dân) Constraints: vn-cccd-format Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
type		0..1	CodeableConcept	Description of identifier Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCCD
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd
value	S	1..1	string	The value that is unique
identifier:GPHN	SO	0..1	Identifier	Số GPHN nguyên văn do cơ quan có thẩm quyền cấp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của chính GPHN này (không suy từ period.end) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
type		0..1	CodeableConcept	Description of identifier Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
code		1..1	code	Symbol in syntax defined by the system Fixed Value: GPHN
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gphn
value	S	1..1	string	The value that is unique
identifier:CCHN	SO	0..1	Identifier	Số CCHN chuyển tiếp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của CCHN — cchn-transition-continued nếu đang dùng như GPHN theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
type		0..1	CodeableConcept	Description of identifier Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCHN
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cchn
value		1..1	string	The value that is unique
name	SO	1..*	HumanName	Họ tên nhân viên y tế Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
text	S	0..1	string	Họ tên đầy đủ
family	S	0..1	string	Họ
given	S	0..*	string	Tên đệm và Tên
gender	SO	0..1	code	Giới tính Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
Slices for qualification	SO	0..*	BackboneElement	Chức danh pháp lý và trình độ chuyên môn / học vị Slice: Unordered, Open by value:code.coding.system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
qualification:RegulatedTitle	SO	0..1	BackboneElement	Chức danh chuyên môn phải có giấy phép hành nghề (tự khai) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet (required)
coding	S	1..1	Coding	Code defined by a terminology system
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs
code		1..1	code	Symbol in syntax defined by the system
issuer		0..1	Reference(Organization)	Cơ quan cấp giấy phép hành nghề
qualification:Education	SO	0..*	BackboneElement	Trình độ chuyên môn / Học vị (BS, BS CKI, BS CKII, ThS, TS, PGS, GS...) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet (required)
coding	S	1..1	Coding	Code defined by a terminology system
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-qualification-cs
code		1..1	code	Symbol in syntax defined by the system
issuer		0..1	Reference(Organization)	Cơ quan cấp (BYT, Sở YT, Trường ĐH)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)
Practitioner
Slices for extension
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:GPHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
identifier:CCHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for qualification	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:RegulatedTitle	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:Education	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Practitioner.qualification:RegulatedTitle.​code	Base	required	Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet	📦0.10.0	This IG
Practitioner.qualification:Education.​code	Base	required	Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
vn-cccd-format	error	Practitioner.identifier:CCCD	Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
vn-practitioner-regulated-title-license	error	Practitioner	Practitioner tự khai một trong 10 chức danh phải có giấy phép hành nghề thì phải mang credential hành nghề còn giá trị — GPHN đang hiệu lực, đang chờ gia hạn hoặc bị đình chỉ một phần, hoặc CCHN chuyển tiếp. Miễn trừ theo Luật 15/2023/QH15 Điều 19 khoản 2-4 KHÔNG khai trên Practitioner nữa (SEM-B02, 13/08/2026 — mere presence từng bypass): người hành nghề theo diện miễn trừ biểu diễn bằng PractitionerRole + vn-ext-practice-license-exemption-role có cơ sở/thời hạn/người giám sát, và KHÔNG tự khai chức danh regulated ở tầng Practitioner khi chưa có credential. A Practitioner declaring a regulated title SHALL carry a valid practice credential; statutory exemptions live on PractitionerRole.	qualification.code.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs').empty() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gphn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'active' or code = 'renewal-pending-continued' or code = 'partially-suspended').exists() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/cchn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'cchn-transition-continued' or code = 'partially-suspended').exists()

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Practitioner	C	0..*	Practitioner	A person with a formal responsibility in the provisioning of healthcare or related services Constraints: vn-practitioner-regulated-title-license
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣ	1..*	Identifier	Định danh NVYT (CCCD, GPHN, CCHN chuyển tiếp) Slice: Unordered, Open by value:system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
identifier:CCCD	SOΣC	0..1	Identifier	Số CCCD (Căn cước công dân) Constraints: vn-cccd-format Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCCD
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd
value	SΣ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:GPHN	SOΣ	0..1	Identifier	Số GPHN nguyên văn do cơ quan có thẩm quyền cấp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của chính GPHN này (không suy từ period.end) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: GPHN
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gphn
value	SΣ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:CCHN	SOΣ	0..1	Identifier	Số CCHN chuyển tiếp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của CCHN — cchn-transition-continued nếu đang dùng như GPHN theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCHN
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cchn
value	Σ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
active	Σ	0..1	boolean	Whether this practitioner's record is in active use
name	SOΣ	1..*	HumanName	Họ tên nhân viên y tế Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name.
text	SΣ	0..1	string	Họ tên đầy đủ
family	SΣ	0..1	string	Họ
given	SΣ	0..*	string	Tên đệm và Tên This repeating element order: Given Names appear in the correct order for presenting the name
prefix	Σ	0..*	string	Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name
suffix	Σ	0..*	string	Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name
period	Σ	0..1	Period	Time period when name was/is in use
telecom	Σ	0..*	ContactPoint	A contact detail for the practitioner (that apply to all roles)
address	Σ	0..*	Address	Address(es) of the practitioner that are not role specific (typically home address)
gender	SOΣ	0..1	code	Giới tính Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
birthDate	Σ	0..1	date	The date on which the practitioner was born
photo		0..*	Attachment	Image of the person
Slices for qualification	SO	0..*	BackboneElement	Chức danh pháp lý và trình độ chuyên môn / học vị Slice: Unordered, Open by value:code.coding.system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
qualification:All Slices				Content/Rules for all slices
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
identifier		0..*	Identifier	An identifier for this qualification for the practitioner
code		1..1	CodeableConcept	Coded representation of the qualification Binding: v2 table 0360, Version 2.7 (example): Specific qualification the practitioner has to provide a service.
period		0..1	Period	Period during which the qualification is valid
issuer		0..1	Reference(Organization)	Organization that regulates and issues the qualification
qualification:RegulatedTitle	SO	0..1	BackboneElement	Chức danh chuyên môn phải có giấy phép hành nghề (tự khai) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
identifier		0..*	Identifier	An identifier for this qualification for the practitioner
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet (required)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	SΣ	1..1	Coding	Code defined by a terminology system
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	1..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
text	Σ	0..1	string	Plain text representation of the concept
period		0..1	Period	Period during which the qualification is valid
issuer		0..1	Reference(Organization)	Cơ quan cấp giấy phép hành nghề
qualification:Education	SO	0..*	BackboneElement	Trình độ chuyên môn / Học vị (BS, BS CKI, BS CKII, ThS, TS, PGS, GS...) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
identifier		0..*	Identifier	An identifier for this qualification for the practitioner
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet (required)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	SΣ	1..1	Coding	Code defined by a terminology system
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-qualification-cs
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	1..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
text	Σ	0..1	string	Plain text representation of the concept
period		0..1	Period	Period during which the qualification is valid
issuer		0..1	Reference(Organization)	Cơ quan cấp (BYT, Sở YT, Trường ĐH)
communication		0..*	CodeableConcept	A language the practitioner can use in patient communication Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)
Practitioner
Slices for extension
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:GPHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
identifier:CCHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for qualification	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:All Slices
qualification:RegulatedTitle	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:Education	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Practitioner.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Practitioner.identifier:CCCD.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:CCCD.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.identifier:GPHN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:GPHN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.identifier:CCHN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:CCHN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.name.use	Base	required	NameUse	📍4.0.1	FHIR Std.
Practitioner.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Practitioner.qualification.​code	Base	example	v2 table 0360, Version 2.7	📦0360	FHIR Std.
Practitioner.qualification:RegulatedTitle.​code	Base	required	Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet	📦0.10.0	This IG
Practitioner.qualification:Education.​code	Base	required	Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet	📦0.10.0	This IG
Practitioner.communication	Base	preferred	Common Languages	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Practitioner	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Practitioner	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Practitioner	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated	contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Practitioner	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Practitioner	A resource should have narrative for robust management	text.`div`.exists()
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-cccd-format	error	Practitioner.identifier:CCCD	Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
vn-practitioner-regulated-title-license	error	Practitioner	Practitioner tự khai một trong 10 chức danh phải có giấy phép hành nghề thì phải mang credential hành nghề còn giá trị — GPHN đang hiệu lực, đang chờ gia hạn hoặc bị đình chỉ một phần, hoặc CCHN chuyển tiếp. Miễn trừ theo Luật 15/2023/QH15 Điều 19 khoản 2-4 KHÔNG khai trên Practitioner nữa (SEM-B02, 13/08/2026 — mere presence từng bypass): người hành nghề theo diện miễn trừ biểu diễn bằng PractitionerRole + vn-ext-practice-license-exemption-role có cơ sở/thời hạn/người giám sát, và KHÔNG tự khai chức danh regulated ở tầng Practitioner khi chưa có credential. A Practitioner declaring a regulated title SHALL carry a valid practice credential; statutory exemptions live on PractitionerRole.	qualification.code.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs').empty() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gphn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'active' or code = 'renewal-pending-continued' or code = 'partially-suspended').exists() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/cchn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'cchn-transition-continued' or code = 'partially-suspended').exists()

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)
Practitioner
Slices for extension
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:GPHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
identifier:CCHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for qualification	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:All Slices
qualification:RegulatedTitle	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:Education	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Documentation for this format

Summary

Mandatory: 2 elements(16 nested mandatory elements)
Must-Support: 20 elements
Fixed: 5 elements
Prohibited: 1 element

Extensions

This structure refers to these extensions:

• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-exemption
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the values of Practitioner.identifier
• The element 1 is sliced based on the values of Practitioner.qualification

Dạng xem phần tử chính

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Practitioner	C	0..*	Practitioner	A person with a formal responsibility in the provisioning of healthcare or related services Constraints: vn-practitioner-regulated-title-license
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣ	1..*	Identifier	Định danh NVYT (CCCD, GPHN, CCHN chuyển tiếp) Slice: Unordered, Open by value:system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
identifier:CCCD	SOΣC	0..1	Identifier	Số CCCD (Căn cước công dân) Constraints: vn-cccd-format Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCCD
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd
value	SΣ	1..1	string	The value that is unique Example General: 123456
identifier:GPHN	SOΣ	0..1	Identifier	Số GPHN nguyên văn do cơ quan có thẩm quyền cấp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của chính GPHN này (không suy từ period.end) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: GPHN
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gphn
value	SΣ	1..1	string	The value that is unique Example General: 123456
identifier:CCHN	SOΣ	0..1	Identifier	Số CCHN chuyển tiếp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của CCHN — cchn-transition-continued nếu đang dùng như GPHN theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCHN
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cchn
value	Σ	1..1	string	The value that is unique Example General: 123456
name	SOΣ	1..*	HumanName	Họ tên nhân viên y tế Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
use	?!Σ	0..1	code	usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name.
text	SΣ	0..1	string	Họ tên đầy đủ
family	SΣ	0..1	string	Họ
given	SΣ	0..*	string	Tên đệm và Tên This repeating element order: Given Names appear in the correct order for presenting the name
gender	SOΣ	0..1	code	Giới tính Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
Slices for qualification	SO	0..*	BackboneElement	Chức danh pháp lý và trình độ chuyên môn / học vị Slice: Unordered, Open by value:code.coding.system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
qualification:All Slices				Content/Rules for all slices
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code		1..1	CodeableConcept	Coded representation of the qualification Binding: v2 table 0360, Version 2.7 (example): Specific qualification the practitioner has to provide a service.
qualification:RegulatedTitle	SO	0..1	BackboneElement	Chức danh chuyên môn phải có giấy phép hành nghề (tự khai) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet (required)
coding	SΣ	1..1	Coding	Code defined by a terminology system
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs
code	Σ	1..1	code	Symbol in syntax defined by the system
issuer		0..1	Reference(Organization)	Cơ quan cấp giấy phép hành nghề
qualification:Education	SO	0..*	BackboneElement	Trình độ chuyên môn / Học vị (BS, BS CKI, BS CKII, ThS, TS, PGS, GS...) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet (required)
coding	SΣ	1..1	Coding	Code defined by a terminology system
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-qualification-cs
code	Σ	1..1	code	Symbol in syntax defined by the system
issuer		0..1	Reference(Organization)	Cơ quan cấp (BYT, Sở YT, Trường ĐH)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)
Practitioner
Slices for extension
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:GPHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
identifier:CCHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for qualification	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:All Slices
qualification:RegulatedTitle	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:Education	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Practitioner.identifier:CCCD.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:CCCD.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.identifier:GPHN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:GPHN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.identifier:CCHN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:CCHN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.name.use	Base	required	NameUse	📍4.0.1	FHIR Std.
Practitioner.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Practitioner.qualification.​code	Base	example	v2 table 0360, Version 2.7	📦0360	FHIR Std.
Practitioner.qualification:RegulatedTitle.​code	Base	required	Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet	📦0.10.0	This IG
Practitioner.qualification:Education.​code	Base	required	Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Practitioner	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Practitioner	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Practitioner	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated	contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Practitioner	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Practitioner	A resource should have narrative for robust management	text.`div`.exists()
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-cccd-format	error	Practitioner.identifier:CCCD	Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
vn-practitioner-regulated-title-license	error	Practitioner	Practitioner tự khai một trong 10 chức danh phải có giấy phép hành nghề thì phải mang credential hành nghề còn giá trị — GPHN đang hiệu lực, đang chờ gia hạn hoặc bị đình chỉ một phần, hoặc CCHN chuyển tiếp. Miễn trừ theo Luật 15/2023/QH15 Điều 19 khoản 2-4 KHÔNG khai trên Practitioner nữa (SEM-B02, 13/08/2026 — mere presence từng bypass): người hành nghề theo diện miễn trừ biểu diễn bằng PractitionerRole + vn-ext-practice-license-exemption-role có cơ sở/thời hạn/người giám sát, và KHÔNG tự khai chức danh regulated ở tầng Practitioner khi chưa có credential. A Practitioner declaring a regulated title SHALL carry a valid practice credential; statutory exemptions live on PractitionerRole.	qualification.code.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs').empty() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gphn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'active' or code = 'renewal-pending-continued' or code = 'partially-suspended').exists() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/cchn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'cchn-transition-continued' or code = 'partially-suspended').exists()

Dạng xem Differential

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Practitioner	C	0..*	Practitioner	A person with a formal responsibility in the provisioning of healthcare or related services Constraints: vn-practitioner-regulated-title-license
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:practiceLicenseExemption		0..0	(Complex)	Căn cứ miễn điều kiện giấy phép hành nghề (Luật 15/2023/QH15 Điều 19 khoản 2-4) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-exemption
Slices for identifier	SO	1..*	Identifier	Định danh NVYT (CCCD, GPHN, CCHN chuyển tiếp) Slice: Unordered, Open by value:system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
identifier:CCCD	SOC	0..1	Identifier	Số CCCD (Căn cước công dân) Constraints: vn-cccd-format Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
type		0..1	CodeableConcept	Description of identifier Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCCD
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd
value	S	1..1	string	The value that is unique
identifier:GPHN	SO	0..1	Identifier	Số GPHN nguyên văn do cơ quan có thẩm quyền cấp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của chính GPHN này (không suy từ period.end) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
type		0..1	CodeableConcept	Description of identifier Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
code		1..1	code	Symbol in syntax defined by the system Fixed Value: GPHN
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gphn
value	S	1..1	string	The value that is unique
identifier:CCHN	SO	0..1	Identifier	Số CCHN chuyển tiếp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của CCHN — cchn-transition-continued nếu đang dùng như GPHN theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
type		0..1	CodeableConcept	Description of identifier Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCHN
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cchn
value		1..1	string	The value that is unique
name	SO	1..*	HumanName	Họ tên nhân viên y tế Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
text	S	0..1	string	Họ tên đầy đủ
family	S	0..1	string	Họ
given	S	0..*	string	Tên đệm và Tên
gender	SO	0..1	code	Giới tính Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
Slices for qualification	SO	0..*	BackboneElement	Chức danh pháp lý và trình độ chuyên môn / học vị Slice: Unordered, Open by value:code.coding.system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
qualification:RegulatedTitle	SO	0..1	BackboneElement	Chức danh chuyên môn phải có giấy phép hành nghề (tự khai) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet (required)
coding	S	1..1	Coding	Code defined by a terminology system
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs
code		1..1	code	Symbol in syntax defined by the system
issuer		0..1	Reference(Organization)	Cơ quan cấp giấy phép hành nghề
qualification:Education	SO	0..*	BackboneElement	Trình độ chuyên môn / Học vị (BS, BS CKI, BS CKII, ThS, TS, PGS, GS...) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet (required)
coding	S	1..1	Coding	Code defined by a terminology system
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-qualification-cs
code		1..1	code	Symbol in syntax defined by the system
issuer		0..1	Reference(Organization)	Cơ quan cấp (BYT, Sở YT, Trường ĐH)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)
Practitioner
Slices for extension
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:GPHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
identifier:CCHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for qualification	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:RegulatedTitle	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:Education	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Practitioner.qualification:RegulatedTitle.​code	Base	required	Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet	📦0.10.0	This IG
Practitioner.qualification:Education.​code	Base	required	Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
vn-cccd-format	error	Practitioner.identifier:CCCD	Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
vn-practitioner-regulated-title-license	error	Practitioner	Practitioner tự khai một trong 10 chức danh phải có giấy phép hành nghề thì phải mang credential hành nghề còn giá trị — GPHN đang hiệu lực, đang chờ gia hạn hoặc bị đình chỉ một phần, hoặc CCHN chuyển tiếp. Miễn trừ theo Luật 15/2023/QH15 Điều 19 khoản 2-4 KHÔNG khai trên Practitioner nữa (SEM-B02, 13/08/2026 — mere presence từng bypass): người hành nghề theo diện miễn trừ biểu diễn bằng PractitionerRole + vn-ext-practice-license-exemption-role có cơ sở/thời hạn/người giám sát, và KHÔNG tự khai chức danh regulated ở tầng Practitioner khi chưa có credential. A Practitioner declaring a regulated title SHALL carry a valid practice credential; statutory exemptions live on PractitionerRole.	qualification.code.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs').empty() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gphn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'active' or code = 'renewal-pending-continued' or code = 'partially-suspended').exists() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/cchn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'cchn-transition-continued' or code = 'partially-suspended').exists()

Dạng xem SnapshotView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Practitioner	C	0..*	Practitioner	A person with a formal responsibility in the provisioning of healthcare or related services Constraints: vn-practitioner-regulated-title-license
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣ	1..*	Identifier	Định danh NVYT (CCCD, GPHN, CCHN chuyển tiếp) Slice: Unordered, Open by value:system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
identifier:CCCD	SOΣC	0..1	Identifier	Số CCCD (Căn cước công dân) Constraints: vn-cccd-format Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCCD
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cccd
value	SΣ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:GPHN	SOΣ	0..1	Identifier	Số GPHN nguyên văn do cơ quan có thẩm quyền cấp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của chính GPHN này (không suy từ period.end) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: GPHN
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/gphn
value	SΣ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:CCHN	SOΣ	0..1	Identifier	Số CCHN chuyển tiếp Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:practiceLicenseStatus	S	1..1	(Complex)	Trạng thái pháp lý của CCHN — cchn-transition-continued nếu đang dùng như GPHN theo NĐ 96/2023/NĐ-CP Điều 143 khoản 2 URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: CCHN
display		0..1	string	Representation defined by the system
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/cchn
value	Σ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
active	Σ	0..1	boolean	Whether this practitioner's record is in active use
name	SOΣ	1..*	HumanName	Họ tên nhân viên y tế Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): The use of a human name.
text	SΣ	0..1	string	Họ tên đầy đủ
family	SΣ	0..1	string	Họ
given	SΣ	0..*	string	Tên đệm và Tên This repeating element order: Given Names appear in the correct order for presenting the name
prefix	Σ	0..*	string	Parts that come before the name This repeating element order: Prefixes appear in the correct order for presenting the name
suffix	Σ	0..*	string	Parts that come after the name This repeating element order: Suffixes appear in the correct order for presenting the name
period	Σ	0..1	Period	Time period when name was/is in use
telecom	Σ	0..*	ContactPoint	A contact detail for the practitioner (that apply to all roles)
address	Σ	0..*	Address	Address(es) of the practitioner that are not role specific (typically home address)
gender	SOΣ	0..1	code	Giới tính Binding: AdministrativeGender (required): The gender of a person used for administrative purposes. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
birthDate	Σ	0..1	date	The date on which the practitioner was born
photo		0..*	Attachment	Image of the person
Slices for qualification	SO	0..*	BackboneElement	Chức danh pháp lý và trình độ chuyên môn / học vị Slice: Unordered, Open by value:code.coding.system Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
qualification:All Slices				Content/Rules for all slices
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
identifier		0..*	Identifier	An identifier for this qualification for the practitioner
code		1..1	CodeableConcept	Coded representation of the qualification Binding: v2 table 0360, Version 2.7 (example): Specific qualification the practitioner has to provide a service.
period		0..1	Period	Period during which the qualification is valid
issuer		0..1	Reference(Organization)	Organization that regulates and issues the qualification
qualification:RegulatedTitle	SO	0..1	BackboneElement	Chức danh chuyên môn phải có giấy phép hành nghề (tự khai) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
identifier		0..*	Identifier	An identifier for this qualification for the practitioner
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet (required)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	SΣ	1..1	Coding	Code defined by a terminology system
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	1..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
text	Σ	0..1	string	Plain text representation of the concept
period		0..1	Period	Period during which the qualification is valid
issuer		0..1	Reference(Organization)	Cơ quan cấp giấy phép hành nghề
qualification:Education	SO	0..*	BackboneElement	Trình độ chuyên môn / Học vị (BS, BS CKI, BS CKII, ThS, TS, PGS, GS...) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
identifier		0..*	Identifier	An identifier for this qualification for the practitioner
code	S	1..1	CodeableConcept	Coded representation of the qualification Binding: Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet (required)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	SΣ	1..1	Coding	Code defined by a terminology system
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-qualification-cs
version	Σ	0..1	string	Version of the system - if relevant
code	Σ	1..1	code	Symbol in syntax defined by the system
display	Σ	0..1	string	Representation defined by the system
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
text	Σ	0..1	string	Plain text representation of the concept
period		0..1	Period	Period during which the qualification is valid
issuer		0..1	Reference(Organization)	Cơ quan cấp (BYT, Sở YT, Trường ĐH)
communication		0..*	CodeableConcept	A language the practitioner can use in patient communication Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)
Practitioner
Slices for extension
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:GPHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
identifier:CCHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for qualification	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:All Slices
qualification:RegulatedTitle	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:Education	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Practitioner.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Practitioner.identifier:CCCD.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:CCCD.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.identifier:GPHN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:GPHN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.identifier:CCHN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Practitioner.identifier:CCHN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Practitioner.name.use	Base	required	NameUse	📍4.0.1	FHIR Std.
Practitioner.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Practitioner.qualification.​code	Base	example	v2 table 0360, Version 2.7	📦0360	FHIR Std.
Practitioner.qualification:RegulatedTitle.​code	Base	required	Chức danh chuyên môn phải có giấy phép hành nghề — Regulated Practitioner Titles ValueSet	📦0.10.0	This IG
Practitioner.qualification:Education.​code	Base	required	Trình độ chuyên môn y tế — VN Healthcare Qualification ValueSet	📦0.10.0	This IG
Practitioner.communication	Base	preferred	Common Languages	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Practitioner	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Practitioner	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Practitioner	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated	contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Practitioner	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Practitioner	A resource should have narrative for robust management	text.`div`.exists()
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-cccd-format	error	Practitioner.identifier:CCCD	Số định danh cá nhân/CCCD, khi có giá trị, phải đúng 12 chữ số (Luật Căn cước 2023, Điều 12)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{12}$')
vn-practitioner-regulated-title-license	error	Practitioner	Practitioner tự khai một trong 10 chức danh phải có giấy phép hành nghề thì phải mang credential hành nghề còn giá trị — GPHN đang hiệu lực, đang chờ gia hạn hoặc bị đình chỉ một phần, hoặc CCHN chuyển tiếp. Miễn trừ theo Luật 15/2023/QH15 Điều 19 khoản 2-4 KHÔNG khai trên Practitioner nữa (SEM-B02, 13/08/2026 — mere presence từng bypass): người hành nghề theo diện miễn trừ biểu diễn bằng PractitionerRole + vn-ext-practice-license-exemption-role có cơ sở/thời hạn/người giám sát, và KHÔNG tự khai chức danh regulated ở tầng Practitioner khi chưa có credential. A Practitioner declaring a regulated title SHALL carry a valid practice credential; statutory exemptions live on PractitionerRole.	qualification.code.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-regulated-practitioner-title-cs').empty() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gphn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'active' or code = 'renewal-pending-continued' or code = 'partially-suspended').exists() or identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/cchn' and value.exists()).extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status').extension.where(url = 'status').value.ofType(Coding).where(code = 'cchn-transition-continued' or code = 'partially-suspended').exists()

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)
Practitioner
Slices for extension
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
identifier:GPHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
identifier:CCHN	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for extension
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Slices for qualification	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:All Slices
qualification:RegulatedTitle	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
qualification:Education	SHALL:no-error & SHALL:handle	SHALL:populate-if-known
Documentation for this format

Summary

Mandatory: 2 elements(16 nested mandatory elements)
Must-Support: 20 elements
Fixed: 5 elements
Prohibited: 1 element

Extensions

This structure refers to these extensions:

• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-exemption
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-practice-license-status

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the values of Practitioner.identifier
• The element 1 is sliced based on the values of Practitioner.qualification