HL7 Vietnam VN Core FHIR Implementation Guide

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

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

Hồ sơ tài nguyên: Nhóm chăm sóc VN Core — VN Core CareTeam Profile

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-care-team Phiên bản: 0.6.0
Computable Name: VNCoreCareTeam

Bản quyền/Pháp lý: Căn cứ pháp lý Việt Nam: TT 13/2025/TT-BYT ngày 06/06/2025; Luật Khám bệnh, chữa bệnh 15/2023/QH15.

Profile CareTeam ghi nhận nhóm/đội ngũ chăm sóc người bệnh (bác sĩ điều trị, điều dưỡng chính, chuyên khoa phối hợp) trong quản lý bệnh mạn tính, chăm sóc đa chuyên khoa, hoặc một đợt chăm sóc (EpisodeOfCare). Khép bộ ba care-management: CarePlan → Goal → CareTeam. Căn cứ pháp lý:

  • TT 13/2025/TT-BYT — bệnh án điện tử (đội ngũ điều trị, chăm sóc).
  • Luật Khám bệnh, chữa bệnh 15/2023/QH15 — tổ chức KCB, vai trò người hành nghề. / VN Core CareTeam for the multidisciplinary care team caring for a patient.

Usages:

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.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam Planned participants in the coordination and delivery of care for a patient or group
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣ 1..1 code Trạng thái: proposed, active, suspended, inactive, entered-in-error
Binding: CareTeamStatus (required): Indicates the status of the care team.
... subject SΣ 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Người bệnh được nhóm chăm sóc
... encounter SΣ 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám/đợt khám liên quan
... period SΣ 0..1 Period Khoảng thời gian nhóm chăm sóc hoạt động
... participant SC 0..* BackboneElement Thành viên nhóm chăm sóc
Constraints: ctm-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... role SΣ 0..* CodeableConcept Vai trò trong nhóm (vd bác sĩ điều trị chính, điều dưỡng phụ trách)
Binding: ParticipantRoles (example): Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc.
.... member SΣ 0..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Bệnh nhân VN Core — VN Core Patient Profile | Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile | Cơ sở y tế VN Core — VN Core Organization Profile) Người/đơn vị tham gia chăm sóc
... reasonCode S 0..* CodeableConcept Lý do hình thành nhóm (vd quản lý bệnh mạn tính)
Binding: SNOMEDCTClinicalFindings (example): Indicates the reason for the care team.
... managingOrganization SΣ 0..* Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở KCB quản lý nhóm chăm sóc

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base example Participant Roles 📍4.0.1 FHIR Std.
CareTeam.reasonCode Base example SNOMED CT Clinical Findings 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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()

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam Planned participants in the coordination and delivery of care for a patient or group
... status S 1..1 code Trạng thái: proposed, active, suspended, inactive, entered-in-error
... name S 0..1 string Tên nhóm chăm sóc (vd Đội điều trị THA–ĐTĐ ngoại trú)
... subject S 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Người bệnh được nhóm chăm sóc
... period S 0..1 Period Khoảng thời gian nhóm chăm sóc hoạt động
... participant S 0..* BackboneElement Thành viên nhóm chăm sóc
.... role S 0..* CodeableConcept Vai trò trong nhóm (vd bác sĩ điều trị chính, điều dưỡng phụ trách)
.... member S 0..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Bệnh nhân VN Core — VN Core Patient Profile | Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile | Cơ sở y tế VN Core — VN Core Organization Profile) Người/đơn vị tham gia chăm sóc
... reasonCode S 0..* CodeableConcept Lý do hình thành nhóm (vd quản lý bệnh mạn tính)
... managingOrganization S 0..* Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở KCB quản lý nhóm chăm sóc

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam Planned participants in the coordination and delivery of care for a patient or group
... 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 External Ids for this team
... status ?!SΣ 1..1 code Trạng thái: proposed, active, suspended, inactive, entered-in-error
Binding: CareTeamStatus (required): Indicates the status of the care team.
... category Σ 0..* CodeableConcept Type of team
Binding: CareTeamCategory (example): Indicates the type of care team.
... name SΣ 0..1 string Tên nhóm chăm sóc (vd Đội điều trị THA–ĐTĐ ngoại trú)
... subject SΣ 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Người bệnh được nhóm chăm sóc
... encounter SΣ 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám/đợt khám liên quan
... period SΣ 0..1 Period Khoảng thời gian nhóm chăm sóc hoạt động
... participant SC 0..* BackboneElement Thành viên nhóm chăm sóc
Constraints: ctm-1
.... 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
.... role SΣ 0..* CodeableConcept Vai trò trong nhóm (vd bác sĩ điều trị chính, điều dưỡng phụ trách)
Binding: ParticipantRoles (example): Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc.
.... member SΣ 0..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Bệnh nhân VN Core — VN Core Patient Profile | Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile | Cơ sở y tế VN Core — VN Core Organization Profile) Người/đơn vị tham gia chăm sóc
.... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
.... period 0..1 Period Time period of participant
... reasonCode S 0..* CodeableConcept Lý do hình thành nhóm (vd quản lý bệnh mạn tính)
Binding: SNOMEDCTClinicalFindings (example): Indicates the reason for the care team.
... reasonReference 0..* Reference(Condition) Why the care team exists
... managingOrganization SΣ 0..* Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở KCB quản lý nhóm chăm sóc
... telecom 0..* ContactPoint A contact detail for the care team (that applies to all members)
... note 0..* Annotation Comments made about the CareTeam

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📍4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.category Base example Care Team category 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base example Participant Roles 📍4.0.1 FHIR Std.
CareTeam.reasonCode Base example SNOMED CT Clinical Findings 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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()

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam Planned participants in the coordination and delivery of care for a patient or group
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣ 1..1 code Trạng thái: proposed, active, suspended, inactive, entered-in-error
Binding: CareTeamStatus (required): Indicates the status of the care team.
... subject SΣ 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Người bệnh được nhóm chăm sóc
... encounter SΣ 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám/đợt khám liên quan
... period SΣ 0..1 Period Khoảng thời gian nhóm chăm sóc hoạt động
... participant SC 0..* BackboneElement Thành viên nhóm chăm sóc
Constraints: ctm-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... role SΣ 0..* CodeableConcept Vai trò trong nhóm (vd bác sĩ điều trị chính, điều dưỡng phụ trách)
Binding: ParticipantRoles (example): Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc.
.... member SΣ 0..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Bệnh nhân VN Core — VN Core Patient Profile | Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile | Cơ sở y tế VN Core — VN Core Organization Profile) Người/đơn vị tham gia chăm sóc
... reasonCode S 0..* CodeableConcept Lý do hình thành nhóm (vd quản lý bệnh mạn tính)
Binding: SNOMEDCTClinicalFindings (example): Indicates the reason for the care team.
... managingOrganization SΣ 0..* Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở KCB quản lý nhóm chăm sóc

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base example Participant Roles 📍4.0.1 FHIR Std.
CareTeam.reasonCode Base example SNOMED CT Clinical Findings 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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()

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam Planned participants in the coordination and delivery of care for a patient or group
... status S 1..1 code Trạng thái: proposed, active, suspended, inactive, entered-in-error
... name S 0..1 string Tên nhóm chăm sóc (vd Đội điều trị THA–ĐTĐ ngoại trú)
... subject S 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Người bệnh được nhóm chăm sóc
... period S 0..1 Period Khoảng thời gian nhóm chăm sóc hoạt động
... participant S 0..* BackboneElement Thành viên nhóm chăm sóc
.... role S 0..* CodeableConcept Vai trò trong nhóm (vd bác sĩ điều trị chính, điều dưỡng phụ trách)
.... member S 0..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Bệnh nhân VN Core — VN Core Patient Profile | Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile | Cơ sở y tế VN Core — VN Core Organization Profile) Người/đơn vị tham gia chăm sóc
... reasonCode S 0..* CodeableConcept Lý do hình thành nhóm (vd quản lý bệnh mạn tính)
... managingOrganization S 0..* Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở KCB quản lý nhóm chăm sóc

doco Documentation for this format

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam Planned participants in the coordination and delivery of care for a patient or group
... 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 External Ids for this team
... status ?!SΣ 1..1 code Trạng thái: proposed, active, suspended, inactive, entered-in-error
Binding: CareTeamStatus (required): Indicates the status of the care team.
... category Σ 0..* CodeableConcept Type of team
Binding: CareTeamCategory (example): Indicates the type of care team.
... name SΣ 0..1 string Tên nhóm chăm sóc (vd Đội điều trị THA–ĐTĐ ngoại trú)
... subject SΣ 1..1 Reference(Bệnh nhân VN Core — VN Core Patient Profile) Người bệnh được nhóm chăm sóc
... encounter SΣ 0..1 Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) Lượt khám/đợt khám liên quan
... period SΣ 0..1 Period Khoảng thời gian nhóm chăm sóc hoạt động
... participant SC 0..* BackboneElement Thành viên nhóm chăm sóc
Constraints: ctm-1
.... 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
.... role SΣ 0..* CodeableConcept Vai trò trong nhóm (vd bác sĩ điều trị chính, điều dưỡng phụ trách)
Binding: ParticipantRoles (example): Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc.
.... member SΣ 0..1 Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Bệnh nhân VN Core — VN Core Patient Profile | Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile | Cơ sở y tế VN Core — VN Core Organization Profile) Người/đơn vị tham gia chăm sóc
.... onBehalfOf Σ 0..1 Reference(Organization) Organization of the practitioner
.... period 0..1 Period Time period of participant
... reasonCode S 0..* CodeableConcept Lý do hình thành nhóm (vd quản lý bệnh mạn tính)
Binding: SNOMEDCTClinicalFindings (example): Indicates the reason for the care team.
... reasonReference 0..* Reference(Condition) Why the care team exists
... managingOrganization SΣ 0..* Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở KCB quản lý nhóm chăm sóc
... telecom 0..* ContactPoint A contact detail for the care team (that applies to all members)
... note 0..* Annotation Comments made about the CareTeam

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📍4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.category Base example Care Team category 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base example Participant Roles 📍4.0.1 FHIR Std.
CareTeam.reasonCode Base example SNOMED CT Clinical Findings 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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()

 

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