Profile Comparison between http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient vs http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient

Messages

Metadata

Name	Value		Comments
abstract	false
baseDefinition	http://hl7.org/fhir/StructureDefinition/Patient
copyright	Căn cứ pháp lý Việt Nam: TT 13/2025/TT-BYT ngày 06/06/2025; Luật 26/2023/QH15 ngày 27/11/2023; Luật 91/2025/QH15 ngày 27/06/2025; Luật 25/2008/QH12 ngày 14/11/2008; Luật 51/2024/QH15 ngày 27/11/2024.	Căn cứ pháp lý Việt Nam: TT 13/2025/TT-BYT ngày 06/06/2025; Luật 26/2023/QH15 ngày 27/11/2023; Luật 91/2025/QH15 ngày 27/06/2025; Luật 25/2008/QH12 ngày 14/11/2008; Luật 51/2024/QH15 ngày 27/11/2024; NĐ 102/2025/NĐ-CP ngày 13/05/2025; QĐ 1332/QĐ-BYT (VNeID); TT 17/2024/TT-BCA (CCCD).	Values Differ
date	2026-03-23	2026-05-10	Values Differ
description	Profile Patient cho Việt Nam. Bao gồm identifier slicing (CCCD, BHYT, MRN), extensions dân tộc/nghề nghiệp, các extension chuẩn của HL7 cho nơi sinh/quốc tịch/tôn giáo, và ràng buộc địa chỉ theo VNCoreAddress. Căn cứ: - **TT 13/2025/TT-BYT** — 06/6/2025 — bệnh án điện tử phải gắn số định danh cá nhân - **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 là mã định danh y tế của cá nhân** (áp dụng cho cả Patient và nhân lực y tế) - **Luật 91/2025/QH15** — 26/6/2025 — dữ liệu định danh và dữ liệu y tế là dữ liệu cá nhân cần bảo vệ - **Luật Căn cước 2023 (Luật 26/2023/QH15)** — Điều 12: số định danh cá nhân là dãy 12 chữ số tự nhiên do CSDL quốc gia về dân cư xác lập - **Luật Hộ tịch 2014 (Luật 60/2014/QH13)** — Điều 14 Khoản 1: số định danh cá nhân được gắn vào giấy khai sinh khi đăng ký khai sinh (từ 01/01/2016, trẻ em VN sinh từ 2016 trở đi đã có số định danh cá nhân từ giấy khai sinh) - **Luật 25/2008/QH12** — 14/11/2008 — Luật Bảo hiểm y tế - **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, nền tảng dữ liệu thẻ BHYT. **Pattern identifier cho các trường hợp đặc biệt**: - **Trẻ em sinh từ 2016**: số định danh cá nhân từ giấy khai sinh = CCCD trong tương lai → dùng `identifier[CCCD]` - **Trẻ em sinh trước 2016 chưa cấp số định danh**: dùng `identifier[GKS]` (Giấy khai sinh) làm primary, kèm `data-absent-reason` cho `identifier[CCCD]` - **Người nước ngoài**: dùng `identifier[passport]` - **Người bệnh cấp cứu chưa rõ thân nhân**: data-absent-reason + `vn-ext-force-majeure-reason`
experimental
fhirVersion	4.0.1
jurisdiction
jurisdiction[0]	urn:iso:std:iso:3166#VN
kind	resource
name	VNCorePatient
publisher	Omi HealthTech / VN Core FHIR Community Initiative
purpose
status	draft
title	Bệnh nhân VN Core — VN Core Patient Profile
type	Patient
url	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient
version	0.5.0	0.5.1	Values Differ

Structure

Name	L Flags	L Card.	L Type	L Description & Constraints	R Flags	R Card.	R Type	R Description & Constraints	Comments
Patient	C	0..*	Patient	Information about an individual or animal receiving health care services Constraints: vn-patient-force-majeure-reason	C	0..*	Patient	Information about an individual or animal receiving health care services Constraints: vn-patient-force-majeure-reason
id	Σ	0..1	id	Logical id of this artifact	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding		0..1	code	Language of the resource content Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? 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		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		0..*	Resource	Contained, inline Resources
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url		0..*	Extension	Extension Slice: Unordered, Open by value:url
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SΣ	1..*	Identifier	Định danh bệnh nhân (CCCD, BHYT, MRN...) Slice: Unordered, Open by value:system	SΣ	1..*	Identifier	Định danh bệnh nhân (CCCD, BHYT, MRN...) Slice: Unordered, Open by value:system
active	?!Σ	0..1	boolean	Whether this patient's record is in active use	?!Σ	0..1	boolean	Whether this patient's record is in active use
name	SΣ	1..*	HumanName	Họ tên bệnh nhân	SΣ	1..*	HumanName	Họ tên bệnh nhân
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
Slices for extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url		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: ?? (required): The use of a human name.	?!Σ	0..1	code	usual | official | temp | nickname | anonymous | old | maiden Binding: ?? (required): The use of a human name.
text	SΣ	0..1	string	Họ tên đầy đủ (khuyến khích dùng cho tên VN)	SΣ	0..1	string	Họ tên đầy đủ (khuyến khích dùng cho tên VN)
family	SΣ	0..1	string	Họ	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	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	Σ	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	Σ	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	Σ	0..1	Period	Time period when name was/is in use
telecom	SΣ	0..*	ContactPoint	Thông tin liên lạc (SĐT, email)	SΣ	0..*	ContactPoint	Thông tin liên lạc (SĐT, email)
gender	SΣ	1..1	code	Giới tính Binding: ?? (required): The gender of a person used for administrative purposes.	SΣ	1..1	code	Giới tính Binding: ?? (required): The gender of a person used for administrative purposes.
birthDate	SΣ	1..1	date	Ngày sinh (bắt buộc theo TT 13/2025/TT-BYT ngày 06/06/2025 — dùng data-absent-reason nếu chưa rõ)	SΣ	1..1	date	Ngày sinh (bắt buộc theo TT 13/2025/TT-BYT ngày 06/06/2025 — dùng data-absent-reason nếu chưa rõ)
deceased[x]	?!Σ	0..1	boolean, dateTime	Indicates if the individual is deceased or not	?!Σ	0..1	boolean, dateTime	Indicates if the individual is deceased or not
address	SΣ	0..*	??	Địa chỉ theo ĐVHC mới (NQ 202/2025)	SΣ	0..*	??	Địa chỉ theo ĐVHC mới (NQ 202/2025)
maritalStatus		0..1	CodeableConcept	Marital (civil) status of a patient Binding: ?? (extensible): The domestic partnership status of a person.		0..1	CodeableConcept	Marital (civil) status of a patient Binding: ?? (extensible): The domestic partnership status of a person.
multipleBirth[x]		0..1	boolean, integer	Whether patient is part of a multiple birth		0..1	boolean, integer	Whether patient is part of a multiple birth
photo		0..*	Attachment	Image of the patient		0..*	Attachment	Image of the patient
contact	SC	0..*	BackboneElement	Người liên hệ/cha mẹ/người giám hộ	SC	0..*	BackboneElement	Người liên hệ/cha mẹ/người giám hộ
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
relationship	S	0..*	CodeableConcept	Quan hệ với bệnh nhân Binding: ?? (extensible): The nature of the relationship between a patient and a contact person for that patient.	S	0..*	CodeableConcept	Quan hệ với bệnh nhân Binding: ?? (extensible): The nature of the relationship between a patient and a contact person for that patient.
name	S	0..1	HumanName	Tên người liên hệ/người giám hộ	S	0..1	HumanName	Tên người liên hệ/người giám hộ
telecom	S	0..*	ContactPoint	Thông tin liên lạc của cha/mẹ/người giám hộ	S	0..*	ContactPoint	Thông tin liên lạc của cha/mẹ/người giám hộ
address		0..1	??	Địa chỉ người liên hệ/người giám hộ		0..1	??	Địa chỉ người liên hệ/người giám hộ
gender		0..1	code	male | female | other | unknown Binding: ?? (required): The gender of a person used for administrative purposes.		0..1	code	male | female | other | unknown Binding: ?? (required): The gender of a person used for administrative purposes.
organization	C	0..1	Reference(Organization)	Organization that is associated with the contact	C	0..1	Reference(Organization)	Organization that is associated with the contact
period		0..1	Period	The period during which this contact person or organization is valid to be contacted relating to this patient		0..1	Period	The period during which this contact person or organization is valid to be contacted relating to this patient
communication		0..*	BackboneElement	A language which may be used to communicate with the patient about his or her health		0..*	BackboneElement	A language which may be used to communicate with the patient about his or her health
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
language		1..1	CodeableConcept	The language which can be used to communicate with the patient about his or her health Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding		1..1	CodeableConcept	The language which can be used to communicate with the patient about his or her health Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding
preferred		0..1	boolean	Language preference indicator		0..1	boolean	Language preference indicator
generalPractitioner		0..*	Reference(Organization | Practitioner | PractitionerRole)	Patient's nominated primary care provider		0..*	Reference(Organization | Practitioner | PractitionerRole)	Patient's nominated primary care provider
managingOrganization	Σ	0..1	Reference(Organization)	Organization that is the custodian of the patient record	Σ	0..1	Reference(Organization)	Organization that is the custodian of the patient record
link	?!Σ	0..*	BackboneElement	Link to another patient resource that concerns the same actual person	?!Σ	0..*	BackboneElement	Link to another patient resource that concerns the same actual person
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
other	Σ	1..1	Reference(Patient | RelatedPerson)	The other patient or related person resource that the link refers to	Σ	1..1	Reference(Patient | RelatedPerson)	The other patient or related person resource that the link refers to
type	Σ	1..1	code	replaced-by | replaces | refer | seealso Binding: ?? (required): The type of link between this patient resource and another patient resource.	Σ	1..1	code	replaced-by | replaces | refer | seealso Binding: ?? (required): The type of link between this patient resource and another patient resource.
Documentation for this format