VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft Viet Nam flag

VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile

Official URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role Version: 0.1.0
Draft as of 2026-03-20 Computable Name: VNCorePractitionerRole

Profile PractitionerRole cho Việt Nam. Liên kết Practitioner với Organization, ghi nhận chức danh nghề nghiệp (mã V.08) và chuyên khoa hành nghề. Căn cứ: Luật KCB 2023 Điều 42 (phạm vi hoạt động chuyên môn), TT 41/2025/TT-BYT (chức danh bác sĩ), TT 02/2025/TT-BYT (chức danh điều dưỡng), TT 32/2023/TT-BYT Điều 11 (phạm vi hành nghề theo chuyên khoa).

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... active SΣ 0..1 boolean Đang hoạt động
... practitioner SΣ 1..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile) Nhân viên y tế
... organization SΣ 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế nơi hành nghề
... code SΣ 0..* CodeableConcept Chức danh nghề nghiệp (mã V.08)
Binding: Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet (extensible)
... specialty SΣ 0..* CodeableConcept Chuyên khoa hành nghề
Binding: Chuyên khoa y tế — VN Medical Specialty ValueSet (extensible)
... location Σ 0..* Reference(Location) Khoa/Phòng

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.code Base extensible Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet 📦0.1.0 This IG
PractitionerRole.specialty Base extensible Chuyên khoa y tế — VN Medical Specialty ValueSet 📦0.1.0 This IG

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole 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()

This structure is derived from PractitionerRole

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... active S 0..1 boolean Đang hoạt động
... period 0..1 Period Thời gian hành nghề tại CSYT
... practitioner S 1..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile) Nhân viên y tế
... code S 0..* CodeableConcept Chức danh nghề nghiệp (mã V.08)
Binding: Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet (extensible)
... specialty S 0..* CodeableConcept Chuyên khoa hành nghề
Binding: Chuyên khoa y tế — VN Medical Specialty ValueSet (extensible)
... location 0..* Reference(Location) Khoa/Phòng

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
PractitionerRole.code Base extensible Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet 📦0.1.0 This IG
PractitionerRole.specialty Base extensible Chuyên khoa y tế — VN Medical Specialty ValueSet 📦0.1.0 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... 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
... 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
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier Business Identifiers that are specific to a role/location
... active SΣ 0..1 boolean Đang hoạt động
... period Σ 0..1 Period Thời gian hành nghề tại CSYT
... practitioner SΣ 1..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile) Nhân viên y tế
... organization SΣ 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế nơi hành nghề
... code SΣ 0..* CodeableConcept Chức danh nghề nghiệp (mã V.08)
Binding: Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet (extensible)
... specialty SΣ 0..* CodeableConcept Chuyên khoa hành nghề
Binding: Chuyên khoa y tế — VN Medical Specialty ValueSet (extensible)
... location Σ 0..* Reference(Location) Khoa/Phòng
... healthcareService 0..* Reference(HealthcareService) The list of healthcare services that this worker provides for this role's Organization/Location(s)
... telecom Σ 0..* ContactPoint Contact details that are specific to the role/location/service
... availableTime 0..* BackboneElement Times the Service Site is available
.... 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
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): The days of the week.
.... allDay 0..1 boolean Always available? e.g. 24 hour service
.... availableStartTime 0..1 time Opening time of day (ignored if allDay = true)
.... availableEndTime 0..1 time Closing time of day (ignored if allDay = true)
... notAvailable 0..* BackboneElement Not available during this time due to provided reason
.... 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
.... description 1..1 string Reason presented to the user explaining why time not available
.... during 0..1 Period Service not available from this date
... availabilityExceptions 0..1 string Description of availability exceptions
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the practitioner with this role

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.language Base preferred Common Languages 📍4.0.1 FHIR Std.
PractitionerRole.code Base extensible Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet 📦0.1.0 This IG
PractitionerRole.specialty Base extensible Chuyên khoa y tế — VN Medical Specialty ValueSet 📦0.1.0 This IG
PractitionerRole.availableTime.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole 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()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... active SΣ 0..1 boolean Đang hoạt động
... practitioner SΣ 1..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile) Nhân viên y tế
... organization SΣ 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế nơi hành nghề
... code SΣ 0..* CodeableConcept Chức danh nghề nghiệp (mã V.08)
Binding: Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet (extensible)
... specialty SΣ 0..* CodeableConcept Chuyên khoa hành nghề
Binding: Chuyên khoa y tế — VN Medical Specialty ValueSet (extensible)
... location Σ 0..* Reference(Location) Khoa/Phòng

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.code Base extensible Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet 📦0.1.0 This IG
PractitionerRole.specialty Base extensible Chuyên khoa y tế — VN Medical Specialty ValueSet 📦0.1.0 This IG

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole 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()

Differential View

This structure is derived from PractitionerRole

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... active S 0..1 boolean Đang hoạt động
... period 0..1 Period Thời gian hành nghề tại CSYT
... practitioner S 1..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile) Nhân viên y tế
... code S 0..* CodeableConcept Chức danh nghề nghiệp (mã V.08)
Binding: Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet (extensible)
... specialty S 0..* CodeableConcept Chuyên khoa hành nghề
Binding: Chuyên khoa y tế — VN Medical Specialty ValueSet (extensible)
... location 0..* Reference(Location) Khoa/Phòng

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
PractitionerRole.code Base extensible Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet 📦0.1.0 This IG
PractitionerRole.specialty Base extensible Chuyên khoa y tế — VN Medical Specialty ValueSet 📦0.1.0 This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... 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
... 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
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier Business Identifiers that are specific to a role/location
... active SΣ 0..1 boolean Đang hoạt động
... period Σ 0..1 Period Thời gian hành nghề tại CSYT
... practitioner SΣ 1..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile) Nhân viên y tế
... organization SΣ 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế nơi hành nghề
... code SΣ 0..* CodeableConcept Chức danh nghề nghiệp (mã V.08)
Binding: Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet (extensible)
... specialty SΣ 0..* CodeableConcept Chuyên khoa hành nghề
Binding: Chuyên khoa y tế — VN Medical Specialty ValueSet (extensible)
... location Σ 0..* Reference(Location) Khoa/Phòng
... healthcareService 0..* Reference(HealthcareService) The list of healthcare services that this worker provides for this role's Organization/Location(s)
... telecom Σ 0..* ContactPoint Contact details that are specific to the role/location/service
... availableTime 0..* BackboneElement Times the Service Site is available
.... 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
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): The days of the week.
.... allDay 0..1 boolean Always available? e.g. 24 hour service
.... availableStartTime 0..1 time Opening time of day (ignored if allDay = true)
.... availableEndTime 0..1 time Closing time of day (ignored if allDay = true)
... notAvailable 0..* BackboneElement Not available during this time due to provided reason
.... 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
.... description 1..1 string Reason presented to the user explaining why time not available
.... during 0..1 Period Service not available from this date
... availabilityExceptions 0..1 string Description of availability exceptions
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the practitioner with this role

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.language Base preferred Common Languages 📍4.0.1 FHIR Std.
PractitionerRole.code Base extensible Chức danh nghề nghiệp viên chức y tế — VN Healthcare Practitioner Title ValueSet 📦0.1.0 This IG
PractitionerRole.specialty Base extensible Chuyên khoa y tế — VN Medical Specialty ValueSet 📦0.1.0 This IG
PractitionerRole.availableTime.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole 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()

 

Other representations of profile: CSV, Excel, Schematron