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: Bệnh nhân VN Core — VN Core Patient Profile

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 — Điều 1 khoản 3 yêu cầu kết nối thông tin bệnh án điện tử với số định danh cá nhân của công dân Việt Nam và người nước ngoài đã được cấp tài khoản định danh điện tử; VN Core dùng số định danh cá nhân/CCCD làm khoá lõi ổn định khi có và mô hình hoá trường hợp chưa có bằng data-absent-reason cùng định danh thay thế
• 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.

Quy tắc định danh tối thiểu (invariant vn-patient-identifier-minimum): mỗi Patient phải có ít nhất một định danh dùng được — số định danh cá nhân/CCCD, hộ chiếu, hoặc giấy khai sinh. Nếu không có định danh quốc gia nào thì phải có mã bệnh nhân của cơ sở kèm lý do.

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) — không cần khai identifier[CCCD] rỗng
• Người nước ngoài: dùng identifier[HC] — không cần khai identifier[CCCD] rỗng
• Người bệnh cấp cứu chưa rõ thân nhân: identifier[MRN] của cơ sở + vn-ext-force-majeure-reason. Có thể ghi thêm data-absent-reason trên CCCD để cho biết đã hỏi nhưng không có; riêng DAR không thay thế cặp MRN + lý do và không tự thoả invariant

Từ 0.10.0, identifier[CCCD] là 0..1 MS thay vì 1..1: nghĩa vụ ghi CCCD khi biết được giữ bằng Must Support và invariant trên, nhưng không còn buộc tạo Identifier rỗng cho người thực sự không thuộc hệ CCCD (kiểm toán 31/07/2026 — analysis/77 mục B4).

Usages:

• Use this Profile: Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle
• Refer to this Profile: Tài khoản viện phí — VN Core Account, Sự cố y khoa — VN Core Adverse Event (Patient Safety), Sự cố bất lợi sau tiêm chủng — VN Core Adverse Event Post Immunization, Dị ứng/Bất dung nạp VN Core — VN Core AllergyIntolerance Profile... Show 48 more, 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, Kế hoạch chăm sóc VN Core — VN Core CarePlan Profile, Nhóm chăm sóc VN Core — VN Core CareTeam Profile, Dòng chi phí phát sinh — VN Core ChargeItem, Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile, 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, Nhóm đơn thuốc kết hợp VN Core — VN Core Combined Prescription Group 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, 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ảng kê chi phí khám bệnh, chữa bệnh — VN Core Cost Statement Invoice, Yêu cầu tra cứu quyền lợi BHYT VN Core — VN Core Coverage Eligibility Request Profile, Kết quả tra cứu quyền lợi BHYT VN Core — VN Core Coverage Eligibility Response Profile, Thẻ BHYT VN Core — VN Core Coverage Profile, Ghi nhận sử dụng VTYT VN Core — VN Core DeviceUseStatement Profile, Thiết bị y tế VN Core — VN Core Device Profile, 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, Đợt chăm sóc VN Core — VN Core EpisodeOfCare Profile, Giải trình quyền lợi BHYT VN Core — VN Core ExplanationOfBenefit Profile, Tiền sử gia đình VN Core — VN Core FamilyMemberHistory Profile, Mục tiêu điều trị VN Core — VN Core Goal 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, Tiền sử dùng thuốc VN Core — VN Core MedicationStatement 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, Phân loại ưu tiên cấp cứu VN Core — VN Core Triage Acuity Observation, Sinh hiệu VN Core — VN Core Observation Vital Signs Profile, Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile, Thủ thuật/DVKT VN Core — VN Core Procedure Profile, Kết quả phiếu khám sức khoẻ VN Core — VN Core QuestionnaireResponse Profile, Người liên quan/người giám hộ VN Core — VN Core RelatedPerson 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 and Công việc điều phối VN Core — VN Core Task Profile
• Examples for this Profile: Patient/ExampleAddressFull, Patient/ExampleBHYTSubmissionMissingCCCDInvalid, Patient/ExamplePatientAddressTextOnly, Patient/ExamplePatientBHXHBadFormat... Show 13 more, Patient/ExamplePatientChildDependent, Patient/ExamplePatientDARBypassNoReason, Patient/ExamplePatientDuplicateMRNMerged, Patient/ExamplePatientEmergencyTransferTwoMRN, Patient/ExamplePatientForeignPassport, Patient/ExamplePatientGKSIssuerNamespace, Patient/ExamplePatientGKSSharedNoAssigner, Patient/ExamplePatientMRNOnlyNoForceMajeure, Patient/ExamplePatientMRNWithoutAssigner, Patient/ExamplePatientMinimal, Patient/ExamplePatientNguyenVanAn, Patient/ExamplePatientSurrogacyNewborn and Patient/ExamplePatientUnknown
• CapabilityStatements using this Profile: VN Core BHYT Gateway Client CapabilityStatement, VN Core BHYT Gateway Server CapabilityStatement, VN Core Citizen App Client CapabilityStatement, VN Core Data Requester CapabilityStatement... Show 3 more, VN Core Data Responder CapabilityStatement, VN Core EMR Server 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
Patient	C	0..*	Patient	Information about an individual or animal receiving health care services Constraints: vn-patient-identifier-minimum, vn-patient-mrn-issuer-scoped, vn-patient-gks-issuer-scoped
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
extension:ethnicity	SO	0..1	CodeableConcept	Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:religion		0..1	(Complex)	Tôn giáo URL: http://hl7.org/fhir/StructureDefinition/patient-religion
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-religion"
value[x]		1..1	CodeableConcept	Value of extension Binding: Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet (required)
extension:occupation		0..1	CodeableConcept	Nghề nghiệp URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation Binding: Nghề nghiệp — VN Occupation ValueSet (extensible)
extension:citizenship		0..*	(Complex)	Quốc tịch URL: http://hl7.org/fhir/StructureDefinition/patient-citizenship
Slices for extension				Content/Rules for all slices
extension:code		0..1	Extension	Extension
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"code"
value[x]	SO	1..1	CodeableConcept	Mã quốc tịch Binding: Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship (required) Obligations Actor SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error Bên giám định BHYT (Adjudicator) SHALL:persist Bên giám định BHYT (Adjudicator)
extension:period		0..1	Extension	Extension
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"period"
value[x]		1..1	Period	Thời hạn quốc tịch (nếu có)
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-citizenship"
extension:birthPlace	SO	0..1	(Complex)	Nơi sinh URL: http://hl7.org/fhir/StructureDefinition/patient-birthPlace 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-birthPlace"
value[x]		1..1	VNCoreAddress	Value of extension
extension:forceMajeureReason		0..1	CodeableConcept	Lý do bất khả kháng khi chưa có định danh quốc gia URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason Binding: Lý do bất khả kháng thiếu CCCD — Vietnam Force Majeure Reason ValueSet (required)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣ	1..*	Identifier	Định danh bệnh nhân (CCCD, BHYT, MRN...) Slice: Unordered, Open by pattern:type 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:CCCD	SOΣC	0..1	Identifier	Số CCCD (Căn cước công dân) — ghi khi biết 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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	Số CCCD 12 chữ số Example General: 123456
identifier:BHYT	SOΣ	0..1	Identifier	Số thẻ BHYT 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: BHYT
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/bhyt
value	SΣC	1..1	string	Số thẻ BHYT Constraints: vn-bhyt-format Example General: 123456
identifier:BHXH	SOΣC	0..1	Identifier	Mã số BHXH Constraints: vn-bhxh-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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: BHXH
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/bhxh
value	SΣ	1..1	string	Mã số BHXH 10 chữ số Example General: 123456
identifier:GKS	SOΣ	0..1	Identifier	Số Giấy khai sinh 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: GKS
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	URI namespace số giấy khai sinh theo cơ quan đăng ký hộ tịch Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	Số Giấy khai sinh Example General: 123456
identifier:MRN	SOΣ	0..*	Identifier	Mã bệnh nhân (MRN) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: MRN
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	URI namespace MRN per-facility Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	Mã bệnh nhân nội bộ Example General: 123456
identifier:HC	SOΣ	0..1	Identifier	Số hộ chiếu 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: HC
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	URI namespace hộ chiếu theo quốc gia cấp Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	The value that is unique Example General: 123456
active	?!Σ	0..1	boolean	Whether this patient's record is in active use
name	SOΣ	1..*	HumanName	Họ tên bệnh nhân 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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 đủ (khuyến khích dùng cho tên VN)
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
telecom	SOΣ	0..*	ContactPoint	Thông tin liên lạc (SĐT, email) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
gender	SOΣ	1..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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
birthDate	SOΣ	1..1	date	Ngày sinh — quy tắc tuân thủ VN Core; dùng data-absent-reason nếu chưa rõ 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
deceased[x]	?!Σ	0..1		Tình trạng/thời điểm tử vong — ghi `deceasedDateTime` khi biết thời điểm
deceasedBoolean			boolean
deceasedDateTime			dateTime
address	SOΣ	0..*	VNCoreAddress	Địa chỉ theo ĐVHC mới (NQ 202/2025/QH15) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
contact	SOC	0..*	BackboneElement	Người liên hệ/cha mẹ/người giám hộ Constraints: pat-1 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
relationship	S	0..*	CodeableConcept	Quan hệ với bệnh nhân Binding: PatientContactRelationship (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ộ
telecom	S	0..*	ContactPoint	Thông tin liên lạc của cha/mẹ/người giám hộ
address		0..1	VNCoreAddress	Địa chỉ người liên hệ/người giám hộ
link	?!Σ	0..*	BackboneElement	Liên kết hồ sơ trùng sau khi xác minh danh tính
modifierExtension	?!Σ	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
type	Σ	1..1	code	replaced-by | replaces | refer | seealso Binding: LinkType (required): The type of link between this patient resource and another patient resource.
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Ứng dụng người dân (Citizen App)	Nguồn tạo hồ sơ lâm sàng (Document Source)	Bên gửi hồ sơ BHYT (Submitter)
Patient
Slices for extension
extension:ethnicity	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
extension:citizenship
Slices for extension
extension:code
value[x]				SHALL:no-error SHALL:persist			SHALL:populate-if-known
extension:birthPlace	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHYT	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHXH	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:GKS	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:MRN	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:HC	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
telecom	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
birthDate	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
contact	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Patient.extension:religion.​value[x]	Base	required	Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet	📦0.10.0	This IG
Patient.extension:citizenship.​extension:code.value[x]	Base	required	Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship	📦0.10.0	This IG
Patient.identifier:CCCD.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:CCCD.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:BHYT.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:BHYT.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:BHXH.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:BHXH.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:GKS.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:GKS.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:MRN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:MRN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:HC.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:HC.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.name.use	Base	required	NameUse	📍4.0.1	FHIR Std.
Patient.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.contact.relationship	Base	extensible	Patient Contact Relationship	📍4.0.1	FHIR Std.
Patient.link.type	Base	required	LinkType	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Patient	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Patient	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	Patient	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	Patient	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Patient	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()
pat-1	error	Patient.contact	SHALL at least contain a contact's details or a reference to an organization	name.exists() or telecom.exists() or address.exists() or organization.exists()
vn-bhxh-format	error	Patient.identifier:BHXH	Mã số BHXH, khi có giá trị, phải đúng 10 chữ số (mã số bảo hiểm xã hội do BHXH Việt Nam cấp)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{10}$')
vn-bhyt-format	warning	Patient.identifier:BHYT.value	Mã số BHYT phải theo 1 trong 2 format: (1) 10 chữ số = mã số BHYT hiện hành (từ 01/4/2021, trùng giá trị mã số BHXH), (2) 15 ký tự = 2 chữ + 13 số format cũ (trước 01/4/2021). CCCD 12 số KHÔNG hợp lệ ở ô này — CCCD là khoá tra cứu/xuất trình, biểu diễn ở sid/cccd. **Mức thực thi: cảnh báo, không phải lỗi** — hồ sơ chuyển đổi từ giai đoạn trước 01/4/2021 và một số luồng nhập liệu vẫn đặt CCCD vào ô này; cảnh báo giúp phát hiện để làm sạch mà không chặn luồng thanh toán đang chạy.	$this.empty() or $this.matches('^[0-9]{10}$') or $this.matches('^[A-Z]{2}[0-9]{13}$')
vn-cccd-format	error	Patient.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-patient-gks-issuer-scoped	error	Patient	Số Giấy khai sinh ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/gks) phải kèm `assigner` chỉ rõ cơ quan đăng ký hộ tịch cấp số. Cách đúng hơn là dùng URI riêng theo cơ quan cấp. A birth-certificate number recorded under the shared national placeholder URI SHALL name its issuing civil-registration authority; per-issuer namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gks').all(assigner.exists())
vn-patient-identifier-minimum	error	Patient	Phải có ít nhất một định danh dùng được: số định danh cá nhân/CCCD, hộ chiếu, hoặc giấy khai sinh — nhận diện theo `type` (CCCD/HC/GKS) nên hợp lệ với cả namespace theo quốc gia/cơ quan cấp, không chỉ URI dùng tạm. Có nhiều định danh hợp lệ đồng thời (ví dụ trẻ em có cả giấy khai sinh và số định danh cá nhân) vẫn thoả. Nếu không có định danh quốc gia nào (người bệnh cấp cứu chưa rõ nhân thân) thì phải có mã bệnh nhân của cơ sở KÈM lý do bất khả kháng (vn-ext-force-majeure-reason). Riêng data-absent-reason trên CCCD KHÔNG đủ để miễn: nó cho biết 'không có giá trị', không cho biết vì sao được phép không có	identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and (code='CCCD' or code='HC' or code='GKS')).exists() and value.hasValue()).exists() or (identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and code='MRN').exists() and value.hasValue()).exists() and extension.where(url='http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason').exists())
vn-patient-mrn-issuer-scoped	error	Patient	Mã bệnh nhân ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/mrn) phải kèm `assigner` chỉ rõ cơ sở cấp mã. Cách đúng hơn là mỗi cơ sở công bố URI riêng cho namespace MRN của mình. A medical record number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/mrn').all(assigner.exists())

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Patient	C	0..*	Patient	Information about an individual or animal receiving health care services Constraints: vn-patient-identifier-minimum, vn-patient-mrn-issuer-scoped, vn-patient-gks-issuer-scoped
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ethnicity	SO	0..1	CodeableConcept	Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:religion		0..1	(Complex)	Tôn giáo URL: http://hl7.org/fhir/StructureDefinition/patient-religion
value[x]		1..1	CodeableConcept	Value of extension Binding: Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet (required)
extension:occupation		0..1	CodeableConcept	Nghề nghiệp URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation Binding: Nghề nghiệp — VN Occupation ValueSet (extensible)
extension:citizenship		0..*	(Complex)	Quốc tịch URL: http://hl7.org/fhir/StructureDefinition/patient-citizenship
Slices for extension				Content/Rules for all slices
extension:code		0..1	Extension	Extension
value[x]	SO	1..1	CodeableConcept	Mã quốc tịch Binding: Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship (required) Obligations Actor SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error Bên giám định BHYT (Adjudicator) SHALL:persist Bên giám định BHYT (Adjudicator)
extension:period		0..1	Extension	Extension
value[x]		1..1	Period	Thời hạn quốc tịch (nếu có)
extension:birthPlace	SO	0..1	(Complex)	Nơi sinh URL: http://hl7.org/fhir/StructureDefinition/patient-birthPlace 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
value[x]		1..1	VNCoreAddress	Value of extension
extension:forceMajeureReason		0..1	CodeableConcept	Lý do bất khả kháng khi chưa có định danh quốc gia URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason Binding: Lý do bất khả kháng thiếu CCCD — Vietnam Force Majeure Reason ValueSet (required)
Slices for identifier	SO	1..*	Identifier	Định danh bệnh nhân (CCCD, BHYT, MRN...) Slice: Unordered, Open by pattern:type 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:CCCD	SOC	0..1	Identifier	Số CCCD (Căn cước công dân) — ghi khi biết 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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	Số CCCD 12 chữ số
identifier:BHYT	SO	0..1	Identifier	Số thẻ BHYT 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: BHYT
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/bhyt
value	SC	1..1	string	Số thẻ BHYT Constraints: vn-bhyt-format
identifier:BHXH	SOC	0..1	Identifier	Mã số BHXH Constraints: vn-bhxh-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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: BHXH
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/bhxh
value	S	1..1	string	Mã số BHXH 10 chữ số
identifier:GKS	SO	0..1	Identifier	Số Giấy khai sinh 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: GKS
system		1..1	uri	URI namespace số giấy khai sinh theo cơ quan đăng ký hộ tịch
value	S	1..1	string	Số Giấy khai sinh
identifier:MRN	SO	0..*	Identifier	Mã bệnh nhân (MRN) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: MRN
system		1..1	uri	URI namespace MRN per-facility
value	S	1..1	string	Mã bệnh nhân nội bộ
identifier:HC	SO	0..1	Identifier	Số hộ chiếu 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: HC
system		1..1	uri	URI namespace hộ chiếu theo quốc gia cấp
value	S	1..1	string	The value that is unique
name	SO	1..*	HumanName	Họ tên bệnh nhân 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
text	S	0..1	string	Họ tên đầy đủ (khuyến khích dùng cho tên VN)
family	S	0..1	string	Họ
given	S	0..*	string	Tên đệm và Tên
telecom	SO	0..*	ContactPoint	Thông tin liên lạc (SĐT, email) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
gender	SO	1..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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
birthDate	SO	1..1	date	Ngày sinh — quy tắc tuân thủ VN Core; dùng data-absent-reason nếu chưa rõ 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
deceased[x]		0..1	boolean, dateTime	Tình trạng/thời điểm tử vong — ghi `deceasedDateTime` khi biết thời điểm
address	SO	0..*	VNCoreAddress	Địa chỉ theo ĐVHC mới (NQ 202/2025/QH15) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
contact	SO	0..*	BackboneElement	Người liên hệ/cha mẹ/người giám hộ 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
relationship	S	0..*	CodeableConcept	Quan hệ với bệnh nhân
name	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ộ
address		0..1	VNCoreAddress	Địa chỉ người liên hệ/người giám hộ
link		0..*	BackboneElement	Liên kết hồ sơ trùng sau khi xác minh danh tính
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Ứng dụng người dân (Citizen App)	Nguồn tạo hồ sơ lâm sàng (Document Source)	Bên gửi hồ sơ BHYT (Submitter)
Patient
Slices for extension
extension:ethnicity	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
extension:citizenship
Slices for extension
extension:code
value[x]				SHALL:no-error SHALL:persist			SHALL:populate-if-known
extension:birthPlace	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHYT	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHXH	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:GKS	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:MRN	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:HC	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
telecom	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
birthDate	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
contact	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Patient.extension:religion.​value[x]	Base	required	Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet	📦0.10.0	This IG
Patient.extension:citizenship.​extension:code.value[x]	Base	required	Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
vn-bhxh-format	error	Patient.identifier:BHXH	Mã số BHXH, khi có giá trị, phải đúng 10 chữ số (mã số bảo hiểm xã hội do BHXH Việt Nam cấp)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{10}$')
vn-bhyt-format	warning	Patient.identifier:BHYT.value	Mã số BHYT phải theo 1 trong 2 format: (1) 10 chữ số = mã số BHYT hiện hành (từ 01/4/2021, trùng giá trị mã số BHXH), (2) 15 ký tự = 2 chữ + 13 số format cũ (trước 01/4/2021). CCCD 12 số KHÔNG hợp lệ ở ô này — CCCD là khoá tra cứu/xuất trình, biểu diễn ở sid/cccd. **Mức thực thi: cảnh báo, không phải lỗi** — hồ sơ chuyển đổi từ giai đoạn trước 01/4/2021 và một số luồng nhập liệu vẫn đặt CCCD vào ô này; cảnh báo giúp phát hiện để làm sạch mà không chặn luồng thanh toán đang chạy.	$this.empty() or $this.matches('^[0-9]{10}$') or $this.matches('^[A-Z]{2}[0-9]{13}$')
vn-cccd-format	error	Patient.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-patient-gks-issuer-scoped	error	Patient	Số Giấy khai sinh ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/gks) phải kèm `assigner` chỉ rõ cơ quan đăng ký hộ tịch cấp số. Cách đúng hơn là dùng URI riêng theo cơ quan cấp. A birth-certificate number recorded under the shared national placeholder URI SHALL name its issuing civil-registration authority; per-issuer namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gks').all(assigner.exists())
vn-patient-identifier-minimum	error	Patient	Phải có ít nhất một định danh dùng được: số định danh cá nhân/CCCD, hộ chiếu, hoặc giấy khai sinh — nhận diện theo `type` (CCCD/HC/GKS) nên hợp lệ với cả namespace theo quốc gia/cơ quan cấp, không chỉ URI dùng tạm. Có nhiều định danh hợp lệ đồng thời (ví dụ trẻ em có cả giấy khai sinh và số định danh cá nhân) vẫn thoả. Nếu không có định danh quốc gia nào (người bệnh cấp cứu chưa rõ nhân thân) thì phải có mã bệnh nhân của cơ sở KÈM lý do bất khả kháng (vn-ext-force-majeure-reason). Riêng data-absent-reason trên CCCD KHÔNG đủ để miễn: nó cho biết 'không có giá trị', không cho biết vì sao được phép không có	identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and (code='CCCD' or code='HC' or code='GKS')).exists() and value.hasValue()).exists() or (identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and code='MRN').exists() and value.hasValue()).exists() and extension.where(url='http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason').exists())
vn-patient-mrn-issuer-scoped	error	Patient	Mã bệnh nhân ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/mrn) phải kèm `assigner` chỉ rõ cơ sở cấp mã. Cách đúng hơn là mỗi cơ sở công bố URI riêng cho namespace MRN của mình. A medical record number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/mrn').all(assigner.exists())

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Patient	C	0..*	Patient	Information about an individual or animal receiving health care services Constraints: vn-patient-identifier-minimum, vn-patient-mrn-issuer-scoped, vn-patient-gks-issuer-scoped
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
extension:ethnicity	SO	0..1	CodeableConcept	Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:religion		0..1	(Complex)	Tôn giáo URL: http://hl7.org/fhir/StructureDefinition/patient-religion
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-religion"
value[x]		1..1	CodeableConcept	Value of extension Binding: Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet (required)
extension:occupation		0..1	CodeableConcept	Nghề nghiệp URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation Binding: Nghề nghiệp — VN Occupation ValueSet (extensible)
extension:citizenship		0..*	(Complex)	Quốc tịch URL: http://hl7.org/fhir/StructureDefinition/patient-citizenship
id		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
Slices for extension				Content/Rules for all slices
extension:code		0..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"code"
value[x]	SO	1..1	CodeableConcept	Mã quốc tịch Binding: Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship (required) Obligations Actor SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error Bên giám định BHYT (Adjudicator) SHALL:persist Bên giám định BHYT (Adjudicator)
extension:period		0..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"period"
value[x]		1..1	Period	Thời hạn quốc tịch (nếu có)
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-citizenship"
extension:birthPlace	SO	0..1	(Complex)	Nơi sinh URL: http://hl7.org/fhir/StructureDefinition/patient-birthPlace 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-birthPlace"
value[x]		1..1	VNCoreAddress	Value of extension
extension:forceMajeureReason		0..1	CodeableConcept	Lý do bất khả kháng khi chưa có định danh quốc gia URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason Binding: Lý do bất khả kháng thiếu CCCD — Vietnam Force Majeure Reason ValueSet (required)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣ	1..*	Identifier	Định danh bệnh nhân (CCCD, BHYT, MRN...) Slice: Unordered, Open by pattern:type 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:CCCD	SOΣC	0..1	Identifier	Số CCCD (Căn cước công dân) — ghi khi biết 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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	Số CCCD 12 chữ số 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:BHYT	SOΣ	0..1	Identifier	Số thẻ BHYT 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: BHYT
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/bhyt
value	SΣC	1..1	string	Số thẻ BHYT Constraints: vn-bhyt-format 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:BHXH	SOΣC	0..1	Identifier	Mã số BHXH Constraints: vn-bhxh-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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: BHXH
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/bhxh
value	SΣ	1..1	string	Mã số BHXH 10 chữ số 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:GKS	SOΣ	0..1	Identifier	Số Giấy khai sinh 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: GKS
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	URI namespace số giấy khai sinh theo cơ quan đăng ký hộ tịch Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	Số Giấy khai sinh 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:MRN	SOΣ	0..*	Identifier	Mã bệnh nhân (MRN) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: MRN
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	URI namespace MRN per-facility Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	Mã bệnh nhân nội bộ 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:HC	SOΣ	0..1	Identifier	Số hộ chiếu 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: HC
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	URI namespace hộ chiếu theo quốc gia cấp Example General: http://www.acme.com/identifiers/patient
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)
active	?!Σ	0..1	boolean	Whether this patient's record is in active use
name	SOΣ	1..*	HumanName	Họ tên bệnh nhân 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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 đủ (khuyến khích dùng cho tên VN)
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	SOΣ	0..*	ContactPoint	Thông tin liên lạc (SĐT, email) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
gender	SOΣ	1..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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
birthDate	SOΣ	1..1	date	Ngày sinh — quy tắc tuân thủ VN Core; dùng data-absent-reason nếu chưa rõ 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
deceased[x]	?!Σ	0..1		Tình trạng/thời điểm tử vong — ghi `deceasedDateTime` khi biết thời điểm
deceasedBoolean			boolean
deceasedDateTime			dateTime
address	SOΣ	0..*	VNCoreAddress	Địa chỉ theo ĐVHC mới (NQ 202/2025/QH15) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
maritalStatus		0..1	CodeableConcept	Marital (civil) status of a patient Binding: Marital Status Codes (extensible): The domestic partnership status of a person.
multipleBirth[x]		0..1		Whether patient is part of a multiple birth
multipleBirthBoolean			boolean
multipleBirthInteger			integer
photo		0..*	Attachment	Image of the patient
contact	SOC	0..*	BackboneElement	Người liên hệ/cha mẹ/người giám hộ Constraints: pat-1 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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
relationship	S	0..*	CodeableConcept	Quan hệ với bệnh nhân Binding: PatientContactRelationship (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ộ
telecom	S	0..*	ContactPoint	Thông tin liên lạc của cha/mẹ/người giám hộ
address		0..1	VNCoreAddress	Địa chỉ người liên hệ/người giám hộ
gender		0..1	code	male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
organization	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
communication		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
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	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: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
preferred		0..1	boolean	Language preference indicator
generalPractitioner		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
link	?!Σ	0..*	BackboneElement	Liên kết hồ sơ trùng sau khi xác minh danh tính
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
other	Σ	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: LinkType (required): The type of link between this patient resource and another patient resource.
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Ứng dụng người dân (Citizen App)	Nguồn tạo hồ sơ lâm sàng (Document Source)	Bên gửi hồ sơ BHYT (Submitter)
Patient
Slices for extension
extension:ethnicity	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
extension:citizenship
Slices for extension
extension:code
value[x]				SHALL:no-error SHALL:persist			SHALL:populate-if-known
extension:birthPlace	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHYT	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHXH	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:GKS	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:MRN	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:HC	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
telecom	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
birthDate	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
contact	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Patient.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Patient.extension:religion.​value[x]	Base	required	Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet	📦0.10.0	This IG
Patient.extension:citizenship.​extension:code.value[x]	Base	required	Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship	📦0.10.0	This IG
Patient.identifier:CCCD.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:CCCD.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:BHYT.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:BHYT.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:BHXH.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:BHXH.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:GKS.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:GKS.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:MRN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:MRN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:HC.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:HC.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.name.use	Base	required	NameUse	📍4.0.1	FHIR Std.
Patient.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.maritalStatus	Base	extensible	MaritalStatus	📍4.0.1	FHIR Std.
Patient.contact.relationship	Base	extensible	Patient Contact Relationship	📍4.0.1	FHIR Std.
Patient.contact.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.communication.​language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Patient.link.type	Base	required	LinkType	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Patient	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Patient	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	Patient	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	Patient	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Patient	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()
pat-1	error	Patient.contact	SHALL at least contain a contact's details or a reference to an organization	name.exists() or telecom.exists() or address.exists() or organization.exists()
vn-bhxh-format	error	Patient.identifier:BHXH	Mã số BHXH, khi có giá trị, phải đúng 10 chữ số (mã số bảo hiểm xã hội do BHXH Việt Nam cấp)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{10}$')
vn-bhyt-format	warning	Patient.identifier:BHYT.value	Mã số BHYT phải theo 1 trong 2 format: (1) 10 chữ số = mã số BHYT hiện hành (từ 01/4/2021, trùng giá trị mã số BHXH), (2) 15 ký tự = 2 chữ + 13 số format cũ (trước 01/4/2021). CCCD 12 số KHÔNG hợp lệ ở ô này — CCCD là khoá tra cứu/xuất trình, biểu diễn ở sid/cccd. **Mức thực thi: cảnh báo, không phải lỗi** — hồ sơ chuyển đổi từ giai đoạn trước 01/4/2021 và một số luồng nhập liệu vẫn đặt CCCD vào ô này; cảnh báo giúp phát hiện để làm sạch mà không chặn luồng thanh toán đang chạy.	$this.empty() or $this.matches('^[0-9]{10}$') or $this.matches('^[A-Z]{2}[0-9]{13}$')
vn-cccd-format	error	Patient.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-patient-gks-issuer-scoped	error	Patient	Số Giấy khai sinh ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/gks) phải kèm `assigner` chỉ rõ cơ quan đăng ký hộ tịch cấp số. Cách đúng hơn là dùng URI riêng theo cơ quan cấp. A birth-certificate number recorded under the shared national placeholder URI SHALL name its issuing civil-registration authority; per-issuer namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gks').all(assigner.exists())
vn-patient-identifier-minimum	error	Patient	Phải có ít nhất một định danh dùng được: số định danh cá nhân/CCCD, hộ chiếu, hoặc giấy khai sinh — nhận diện theo `type` (CCCD/HC/GKS) nên hợp lệ với cả namespace theo quốc gia/cơ quan cấp, không chỉ URI dùng tạm. Có nhiều định danh hợp lệ đồng thời (ví dụ trẻ em có cả giấy khai sinh và số định danh cá nhân) vẫn thoả. Nếu không có định danh quốc gia nào (người bệnh cấp cứu chưa rõ nhân thân) thì phải có mã bệnh nhân của cơ sở KÈM lý do bất khả kháng (vn-ext-force-majeure-reason). Riêng data-absent-reason trên CCCD KHÔNG đủ để miễn: nó cho biết 'không có giá trị', không cho biết vì sao được phép không có	identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and (code='CCCD' or code='HC' or code='GKS')).exists() and value.hasValue()).exists() or (identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and code='MRN').exists() and value.hasValue()).exists() and extension.where(url='http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason').exists())
vn-patient-mrn-issuer-scoped	error	Patient	Mã bệnh nhân ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/mrn) phải kèm `assigner` chỉ rõ cơ sở cấp mã. Cách đúng hơn là mỗi cơ sở công bố URI riêng cho namespace MRN của mình. A medical record number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/mrn').all(assigner.exists())

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Ứng dụng người dân (Citizen App)	Nguồn tạo hồ sơ lâm sàng (Document Source)	Bên gửi hồ sơ BHYT (Submitter)
Patient
Slices for extension
extension:ethnicity	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
extension:citizenship
Slices for extension
extension:code
value[x]				SHALL:no-error SHALL:persist			SHALL:populate-if-known
extension:birthPlace	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHYT	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHXH	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:GKS	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:MRN	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:HC	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
telecom	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
birthDate	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
contact	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Summary

Mandatory: 4 elements(18 nested mandatory elements)
Must-Support: 28 elements
Fixed: 3 elements

Structures

This structure refers to these other structures:

• Địa chỉ VN Core — VN Core Address Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address)

Extensions

This structure refers to these extensions:

• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity
• http://hl7.org/fhir/StructureDefinition/patient-religion|5.3.0
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation
• http://hl7.org/fhir/StructureDefinition/patient-citizenship|5.3.0
• http://hl7.org/fhir/StructureDefinition/patient-birthPlace|5.3.0
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason

Slices

This structure defines the following Slices:

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

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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Patient	C	0..*	Patient	Information about an individual or animal receiving health care services Constraints: vn-patient-identifier-minimum, vn-patient-mrn-issuer-scoped, vn-patient-gks-issuer-scoped
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
extension:ethnicity	SO	0..1	CodeableConcept	Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:religion		0..1	(Complex)	Tôn giáo URL: http://hl7.org/fhir/StructureDefinition/patient-religion
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-religion"
value[x]		1..1	CodeableConcept	Value of extension Binding: Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet (required)
extension:occupation		0..1	CodeableConcept	Nghề nghiệp URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation Binding: Nghề nghiệp — VN Occupation ValueSet (extensible)
extension:citizenship		0..*	(Complex)	Quốc tịch URL: http://hl7.org/fhir/StructureDefinition/patient-citizenship
Slices for extension				Content/Rules for all slices
extension:code		0..1	Extension	Extension
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"code"
value[x]	SO	1..1	CodeableConcept	Mã quốc tịch Binding: Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship (required) Obligations Actor SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error Bên giám định BHYT (Adjudicator) SHALL:persist Bên giám định BHYT (Adjudicator)
extension:period		0..1	Extension	Extension
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"period"
value[x]		1..1	Period	Thời hạn quốc tịch (nếu có)
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-citizenship"
extension:birthPlace	SO	0..1	(Complex)	Nơi sinh URL: http://hl7.org/fhir/StructureDefinition/patient-birthPlace 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-birthPlace"
value[x]		1..1	VNCoreAddress	Value of extension
extension:forceMajeureReason		0..1	CodeableConcept	Lý do bất khả kháng khi chưa có định danh quốc gia URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason Binding: Lý do bất khả kháng thiếu CCCD — Vietnam Force Majeure Reason ValueSet (required)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣ	1..*	Identifier	Định danh bệnh nhân (CCCD, BHYT, MRN...) Slice: Unordered, Open by pattern:type 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:CCCD	SOΣC	0..1	Identifier	Số CCCD (Căn cước công dân) — ghi khi biết 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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	Số CCCD 12 chữ số Example General: 123456
identifier:BHYT	SOΣ	0..1	Identifier	Số thẻ BHYT 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: BHYT
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/bhyt
value	SΣC	1..1	string	Số thẻ BHYT Constraints: vn-bhyt-format Example General: 123456
identifier:BHXH	SOΣC	0..1	Identifier	Mã số BHXH Constraints: vn-bhxh-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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: BHXH
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/bhxh
value	SΣ	1..1	string	Mã số BHXH 10 chữ số Example General: 123456
identifier:GKS	SOΣ	0..1	Identifier	Số Giấy khai sinh 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: GKS
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	URI namespace số giấy khai sinh theo cơ quan đăng ký hộ tịch Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	Số Giấy khai sinh Example General: 123456
identifier:MRN	SOΣ	0..*	Identifier	Mã bệnh nhân (MRN) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: MRN
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	URI namespace MRN per-facility Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	Mã bệnh nhân nội bộ Example General: 123456
identifier:HC	SOΣ	0..1	Identifier	Số hộ chiếu 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..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: HC
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	URI namespace hộ chiếu theo quốc gia cấp Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	The value that is unique Example General: 123456
active	?!Σ	0..1	boolean	Whether this patient's record is in active use
name	SOΣ	1..*	HumanName	Họ tên bệnh nhân 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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 đủ (khuyến khích dùng cho tên VN)
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
telecom	SOΣ	0..*	ContactPoint	Thông tin liên lạc (SĐT, email) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
gender	SOΣ	1..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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
birthDate	SOΣ	1..1	date	Ngày sinh — quy tắc tuân thủ VN Core; dùng data-absent-reason nếu chưa rõ 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
deceased[x]	?!Σ	0..1		Tình trạng/thời điểm tử vong — ghi `deceasedDateTime` khi biết thời điểm
deceasedBoolean			boolean
deceasedDateTime			dateTime
address	SOΣ	0..*	VNCoreAddress	Địa chỉ theo ĐVHC mới (NQ 202/2025/QH15) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
contact	SOC	0..*	BackboneElement	Người liên hệ/cha mẹ/người giám hộ Constraints: pat-1 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
relationship	S	0..*	CodeableConcept	Quan hệ với bệnh nhân Binding: PatientContactRelationship (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ộ
telecom	S	0..*	ContactPoint	Thông tin liên lạc của cha/mẹ/người giám hộ
address		0..1	VNCoreAddress	Địa chỉ người liên hệ/người giám hộ
link	?!Σ	0..*	BackboneElement	Liên kết hồ sơ trùng sau khi xác minh danh tính
modifierExtension	?!Σ	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
type	Σ	1..1	code	replaced-by | replaces | refer | seealso Binding: LinkType (required): The type of link between this patient resource and another patient resource.
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Ứng dụng người dân (Citizen App)	Nguồn tạo hồ sơ lâm sàng (Document Source)	Bên gửi hồ sơ BHYT (Submitter)
Patient
Slices for extension
extension:ethnicity	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
extension:citizenship
Slices for extension
extension:code
value[x]				SHALL:no-error SHALL:persist			SHALL:populate-if-known
extension:birthPlace	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHYT	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHXH	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:GKS	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:MRN	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:HC	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
telecom	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
birthDate	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
contact	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Patient.extension:religion.​value[x]	Base	required	Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet	📦0.10.0	This IG
Patient.extension:citizenship.​extension:code.value[x]	Base	required	Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship	📦0.10.0	This IG
Patient.identifier:CCCD.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:CCCD.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:BHYT.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:BHYT.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:BHXH.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:BHXH.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:GKS.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:GKS.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:MRN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:MRN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:HC.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:HC.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.name.use	Base	required	NameUse	📍4.0.1	FHIR Std.
Patient.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.contact.relationship	Base	extensible	Patient Contact Relationship	📍4.0.1	FHIR Std.
Patient.link.type	Base	required	LinkType	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Patient	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Patient	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	Patient	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	Patient	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Patient	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()
pat-1	error	Patient.contact	SHALL at least contain a contact's details or a reference to an organization	name.exists() or telecom.exists() or address.exists() or organization.exists()
vn-bhxh-format	error	Patient.identifier:BHXH	Mã số BHXH, khi có giá trị, phải đúng 10 chữ số (mã số bảo hiểm xã hội do BHXH Việt Nam cấp)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{10}$')
vn-bhyt-format	warning	Patient.identifier:BHYT.value	Mã số BHYT phải theo 1 trong 2 format: (1) 10 chữ số = mã số BHYT hiện hành (từ 01/4/2021, trùng giá trị mã số BHXH), (2) 15 ký tự = 2 chữ + 13 số format cũ (trước 01/4/2021). CCCD 12 số KHÔNG hợp lệ ở ô này — CCCD là khoá tra cứu/xuất trình, biểu diễn ở sid/cccd. **Mức thực thi: cảnh báo, không phải lỗi** — hồ sơ chuyển đổi từ giai đoạn trước 01/4/2021 và một số luồng nhập liệu vẫn đặt CCCD vào ô này; cảnh báo giúp phát hiện để làm sạch mà không chặn luồng thanh toán đang chạy.	$this.empty() or $this.matches('^[0-9]{10}$') or $this.matches('^[A-Z]{2}[0-9]{13}$')
vn-cccd-format	error	Patient.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-patient-gks-issuer-scoped	error	Patient	Số Giấy khai sinh ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/gks) phải kèm `assigner` chỉ rõ cơ quan đăng ký hộ tịch cấp số. Cách đúng hơn là dùng URI riêng theo cơ quan cấp. A birth-certificate number recorded under the shared national placeholder URI SHALL name its issuing civil-registration authority; per-issuer namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gks').all(assigner.exists())
vn-patient-identifier-minimum	error	Patient	Phải có ít nhất một định danh dùng được: số định danh cá nhân/CCCD, hộ chiếu, hoặc giấy khai sinh — nhận diện theo `type` (CCCD/HC/GKS) nên hợp lệ với cả namespace theo quốc gia/cơ quan cấp, không chỉ URI dùng tạm. Có nhiều định danh hợp lệ đồng thời (ví dụ trẻ em có cả giấy khai sinh và số định danh cá nhân) vẫn thoả. Nếu không có định danh quốc gia nào (người bệnh cấp cứu chưa rõ nhân thân) thì phải có mã bệnh nhân của cơ sở KÈM lý do bất khả kháng (vn-ext-force-majeure-reason). Riêng data-absent-reason trên CCCD KHÔNG đủ để miễn: nó cho biết 'không có giá trị', không cho biết vì sao được phép không có	identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and (code='CCCD' or code='HC' or code='GKS')).exists() and value.hasValue()).exists() or (identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and code='MRN').exists() and value.hasValue()).exists() and extension.where(url='http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason').exists())
vn-patient-mrn-issuer-scoped	error	Patient	Mã bệnh nhân ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/mrn) phải kèm `assigner` chỉ rõ cơ sở cấp mã. Cách đúng hơn là mỗi cơ sở công bố URI riêng cho namespace MRN của mình. A medical record number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/mrn').all(assigner.exists())

Dạng xem Differential

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Patient	C	0..*	Patient	Information about an individual or animal receiving health care services Constraints: vn-patient-identifier-minimum, vn-patient-mrn-issuer-scoped, vn-patient-gks-issuer-scoped
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:ethnicity	SO	0..1	CodeableConcept	Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:religion		0..1	(Complex)	Tôn giáo URL: http://hl7.org/fhir/StructureDefinition/patient-religion
value[x]		1..1	CodeableConcept	Value of extension Binding: Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet (required)
extension:occupation		0..1	CodeableConcept	Nghề nghiệp URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation Binding: Nghề nghiệp — VN Occupation ValueSet (extensible)
extension:citizenship		0..*	(Complex)	Quốc tịch URL: http://hl7.org/fhir/StructureDefinition/patient-citizenship
Slices for extension				Content/Rules for all slices
extension:code		0..1	Extension	Extension
value[x]	SO	1..1	CodeableConcept	Mã quốc tịch Binding: Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship (required) Obligations Actor SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error Bên giám định BHYT (Adjudicator) SHALL:persist Bên giám định BHYT (Adjudicator)
extension:period		0..1	Extension	Extension
value[x]		1..1	Period	Thời hạn quốc tịch (nếu có)
extension:birthPlace	SO	0..1	(Complex)	Nơi sinh URL: http://hl7.org/fhir/StructureDefinition/patient-birthPlace 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
value[x]		1..1	VNCoreAddress	Value of extension
extension:forceMajeureReason		0..1	CodeableConcept	Lý do bất khả kháng khi chưa có định danh quốc gia URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason Binding: Lý do bất khả kháng thiếu CCCD — Vietnam Force Majeure Reason ValueSet (required)
Slices for identifier	SO	1..*	Identifier	Định danh bệnh nhân (CCCD, BHYT, MRN...) Slice: Unordered, Open by pattern:type 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:CCCD	SOC	0..1	Identifier	Số CCCD (Căn cước công dân) — ghi khi biết 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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	Số CCCD 12 chữ số
identifier:BHYT	SO	0..1	Identifier	Số thẻ BHYT 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: BHYT
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/bhyt
value	SC	1..1	string	Số thẻ BHYT Constraints: vn-bhyt-format
identifier:BHXH	SOC	0..1	Identifier	Mã số BHXH Constraints: vn-bhxh-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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: BHXH
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/bhxh
value	S	1..1	string	Mã số BHXH 10 chữ số
identifier:GKS	SO	0..1	Identifier	Số Giấy khai sinh 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: GKS
system		1..1	uri	URI namespace số giấy khai sinh theo cơ quan đăng ký hộ tịch
value	S	1..1	string	Số Giấy khai sinh
identifier:MRN	SO	0..*	Identifier	Mã bệnh nhân (MRN) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: MRN
system		1..1	uri	URI namespace MRN per-facility
value	S	1..1	string	Mã bệnh nhân nội bộ
identifier:HC	SO	0..1	Identifier	Số hộ chiếu 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		1..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: HC
system		1..1	uri	URI namespace hộ chiếu theo quốc gia cấp
value	S	1..1	string	The value that is unique
name	SO	1..*	HumanName	Họ tên bệnh nhân 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
text	S	0..1	string	Họ tên đầy đủ (khuyến khích dùng cho tên VN)
family	S	0..1	string	Họ
given	S	0..*	string	Tên đệm và Tên
telecom	SO	0..*	ContactPoint	Thông tin liên lạc (SĐT, email) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
gender	SO	1..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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
birthDate	SO	1..1	date	Ngày sinh — quy tắc tuân thủ VN Core; dùng data-absent-reason nếu chưa rõ 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
deceased[x]		0..1	boolean, dateTime	Tình trạng/thời điểm tử vong — ghi `deceasedDateTime` khi biết thời điểm
address	SO	0..*	VNCoreAddress	Địa chỉ theo ĐVHC mới (NQ 202/2025/QH15) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
contact	SO	0..*	BackboneElement	Người liên hệ/cha mẹ/người giám hộ 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
relationship	S	0..*	CodeableConcept	Quan hệ với bệnh nhân
name	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ộ
address		0..1	VNCoreAddress	Địa chỉ người liên hệ/người giám hộ
link		0..*	BackboneElement	Liên kết hồ sơ trùng sau khi xác minh danh tính
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Ứng dụng người dân (Citizen App)	Nguồn tạo hồ sơ lâm sàng (Document Source)	Bên gửi hồ sơ BHYT (Submitter)
Patient
Slices for extension
extension:ethnicity	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
extension:citizenship
Slices for extension
extension:code
value[x]				SHALL:no-error SHALL:persist			SHALL:populate-if-known
extension:birthPlace	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHYT	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHXH	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:GKS	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:MRN	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:HC	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
telecom	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
birthDate	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
contact	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Patient.extension:religion.​value[x]	Base	required	Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet	📦0.10.0	This IG
Patient.extension:citizenship.​extension:code.value[x]	Base	required	Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
vn-bhxh-format	error	Patient.identifier:BHXH	Mã số BHXH, khi có giá trị, phải đúng 10 chữ số (mã số bảo hiểm xã hội do BHXH Việt Nam cấp)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{10}$')
vn-bhyt-format	warning	Patient.identifier:BHYT.value	Mã số BHYT phải theo 1 trong 2 format: (1) 10 chữ số = mã số BHYT hiện hành (từ 01/4/2021, trùng giá trị mã số BHXH), (2) 15 ký tự = 2 chữ + 13 số format cũ (trước 01/4/2021). CCCD 12 số KHÔNG hợp lệ ở ô này — CCCD là khoá tra cứu/xuất trình, biểu diễn ở sid/cccd. **Mức thực thi: cảnh báo, không phải lỗi** — hồ sơ chuyển đổi từ giai đoạn trước 01/4/2021 và một số luồng nhập liệu vẫn đặt CCCD vào ô này; cảnh báo giúp phát hiện để làm sạch mà không chặn luồng thanh toán đang chạy.	$this.empty() or $this.matches('^[0-9]{10}$') or $this.matches('^[A-Z]{2}[0-9]{13}$')
vn-cccd-format	error	Patient.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-patient-gks-issuer-scoped	error	Patient	Số Giấy khai sinh ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/gks) phải kèm `assigner` chỉ rõ cơ quan đăng ký hộ tịch cấp số. Cách đúng hơn là dùng URI riêng theo cơ quan cấp. A birth-certificate number recorded under the shared national placeholder URI SHALL name its issuing civil-registration authority; per-issuer namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gks').all(assigner.exists())
vn-patient-identifier-minimum	error	Patient	Phải có ít nhất một định danh dùng được: số định danh cá nhân/CCCD, hộ chiếu, hoặc giấy khai sinh — nhận diện theo `type` (CCCD/HC/GKS) nên hợp lệ với cả namespace theo quốc gia/cơ quan cấp, không chỉ URI dùng tạm. Có nhiều định danh hợp lệ đồng thời (ví dụ trẻ em có cả giấy khai sinh và số định danh cá nhân) vẫn thoả. Nếu không có định danh quốc gia nào (người bệnh cấp cứu chưa rõ nhân thân) thì phải có mã bệnh nhân của cơ sở KÈM lý do bất khả kháng (vn-ext-force-majeure-reason). Riêng data-absent-reason trên CCCD KHÔNG đủ để miễn: nó cho biết 'không có giá trị', không cho biết vì sao được phép không có	identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and (code='CCCD' or code='HC' or code='GKS')).exists() and value.hasValue()).exists() or (identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and code='MRN').exists() and value.hasValue()).exists() and extension.where(url='http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason').exists())
vn-patient-mrn-issuer-scoped	error	Patient	Mã bệnh nhân ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/mrn) phải kèm `assigner` chỉ rõ cơ sở cấp mã. Cách đúng hơn là mỗi cơ sở công bố URI riêng cho namespace MRN của mình. A medical record number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/mrn').all(assigner.exists())

Dạng xem SnapshotView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Patient	C	0..*	Patient	Information about an individual or animal receiving health care services Constraints: vn-patient-identifier-minimum, vn-patient-mrn-issuer-scoped, vn-patient-gks-issuer-scoped
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
extension:ethnicity	SO	0..1	CodeableConcept	Dân tộc URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity Binding: Danh mục Dân tộc Việt Nam — Vietnam Ethnicity ValueSet (required) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:religion		0..1	(Complex)	Tôn giáo URL: http://hl7.org/fhir/StructureDefinition/patient-religion
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-religion"
value[x]		1..1	CodeableConcept	Value of extension Binding: Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet (required)
extension:occupation		0..1	CodeableConcept	Nghề nghiệp URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation Binding: Nghề nghiệp — VN Occupation ValueSet (extensible)
extension:citizenship		0..*	(Complex)	Quốc tịch URL: http://hl7.org/fhir/StructureDefinition/patient-citizenship
id		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
Slices for extension				Content/Rules for all slices
extension:code		0..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"code"
value[x]	SO	1..1	CodeableConcept	Mã quốc tịch Binding: Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship (required) Obligations Actor SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error Bên giám định BHYT (Adjudicator) SHALL:persist Bên giám định BHYT (Adjudicator)
extension:period		0..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"period"
value[x]		1..1	Period	Thời hạn quốc tịch (nếu có)
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-citizenship"
extension:birthPlace	SO	0..1	(Complex)	Nơi sinh URL: http://hl7.org/fhir/StructureDefinition/patient-birthPlace 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-birthPlace"
value[x]		1..1	VNCoreAddress	Value of extension
extension:forceMajeureReason		0..1	CodeableConcept	Lý do bất khả kháng khi chưa có định danh quốc gia URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason Binding: Lý do bất khả kháng thiếu CCCD — Vietnam Force Majeure Reason ValueSet (required)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣ	1..*	Identifier	Định danh bệnh nhân (CCCD, BHYT, MRN...) Slice: Unordered, Open by pattern:type 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:CCCD	SOΣC	0..1	Identifier	Số CCCD (Căn cước công dân) — ghi khi biết 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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	Số CCCD 12 chữ số 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:BHYT	SOΣ	0..1	Identifier	Số thẻ BHYT 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: BHYT
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/bhyt
value	SΣC	1..1	string	Số thẻ BHYT Constraints: vn-bhyt-format 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:BHXH	SOΣC	0..1	Identifier	Mã số BHXH Constraints: vn-bhxh-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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: BHXH
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/bhxh
value	SΣ	1..1	string	Mã số BHXH 10 chữ số 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:GKS	SOΣ	0..1	Identifier	Số Giấy khai sinh 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: GKS
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	URI namespace số giấy khai sinh theo cơ quan đăng ký hộ tịch Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	Số Giấy khai sinh 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:MRN	SOΣ	0..*	Identifier	Mã bệnh nhân (MRN) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: MRN
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	URI namespace MRN per-facility Example General: http://www.acme.com/identifiers/patient
value	SΣ	1..1	string	Mã bệnh nhân nội bộ 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:HC	SOΣ	0..1	Identifier	Số hộ chiếu 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	1..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: HC
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	URI namespace hộ chiếu theo quốc gia cấp Example General: http://www.acme.com/identifiers/patient
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)
active	?!Σ	0..1	boolean	Whether this patient's record is in active use
name	SOΣ	1..*	HumanName	Họ tên bệnh nhân 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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 đủ (khuyến khích dùng cho tên VN)
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	SOΣ	0..*	ContactPoint	Thông tin liên lạc (SĐT, email) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
gender	SOΣ	1..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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
birthDate	SOΣ	1..1	date	Ngày sinh — quy tắc tuân thủ VN Core; dùng data-absent-reason nếu chưa rõ 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHOULD:display Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
deceased[x]	?!Σ	0..1		Tình trạng/thời điểm tử vong — ghi `deceasedDateTime` khi biết thời điểm
deceasedBoolean			boolean
deceasedDateTime			dateTime
address	SOΣ	0..*	VNCoreAddress	Địa chỉ theo ĐVHC mới (NQ 202/2025/QH15) 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
maritalStatus		0..1	CodeableConcept	Marital (civil) status of a patient Binding: Marital Status Codes (extensible): The domestic partnership status of a person.
multipleBirth[x]		0..1		Whether patient is part of a multiple birth
multipleBirthBoolean			boolean
multipleBirthInteger			integer
photo		0..*	Attachment	Image of the patient
contact	SOC	0..*	BackboneElement	Người liên hệ/cha mẹ/người giám hộ Constraints: pat-1 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) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository) SHALL:no-error & SHALL:handle Ứng dụng người dân (Citizen App) SHALL:populate-if-known Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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
relationship	S	0..*	CodeableConcept	Quan hệ với bệnh nhân Binding: PatientContactRelationship (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ộ
telecom	S	0..*	ContactPoint	Thông tin liên lạc của cha/mẹ/người giám hộ
address		0..1	VNCoreAddress	Địa chỉ người liên hệ/người giám hộ
gender		0..1	code	male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
organization	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
communication		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
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	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: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
preferred		0..1	boolean	Language preference indicator
generalPractitioner		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
link	?!Σ	0..*	BackboneElement	Liên kết hồ sơ trùng sau khi xác minh danh tính
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
other	Σ	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: LinkType (required): The type of link between this patient resource and another patient resource.
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Ứng dụng người dân (Citizen App)	Nguồn tạo hồ sơ lâm sàng (Document Source)	Bên gửi hồ sơ BHYT (Submitter)
Patient
Slices for extension
extension:ethnicity	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
extension:citizenship
Slices for extension
extension:code
value[x]				SHALL:no-error SHALL:persist			SHALL:populate-if-known
extension:birthPlace	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHYT	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHXH	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:GKS	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:MRN	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:HC	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
telecom	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
birthDate	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
contact	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Patient.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Patient.extension:religion.​value[x]	Base	required	Danh mục Tôn giáo Việt Nam — Vietnam Religion ValueSet	📦0.10.0	This IG
Patient.extension:citizenship.​extension:code.value[x]	Base	required	Quốc tịch theo ISO 3166-1 alpha-2 — Country ValueSet for Patient Citizenship	📦0.10.0	This IG
Patient.identifier:CCCD.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:CCCD.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:BHYT.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:BHYT.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:BHXH.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:BHXH.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:GKS.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:GKS.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:MRN.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:MRN.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.identifier:HC.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:HC.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.name.use	Base	required	NameUse	📍4.0.1	FHIR Std.
Patient.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.maritalStatus	Base	extensible	MaritalStatus	📍4.0.1	FHIR Std.
Patient.contact.relationship	Base	extensible	Patient Contact Relationship	📍4.0.1	FHIR Std.
Patient.contact.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.communication.​language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Patient.link.type	Base	required	LinkType	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Patient	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Patient	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	Patient	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	Patient	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Patient	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()
pat-1	error	Patient.contact	SHALL at least contain a contact's details or a reference to an organization	name.exists() or telecom.exists() or address.exists() or organization.exists()
vn-bhxh-format	error	Patient.identifier:BHXH	Mã số BHXH, khi có giá trị, phải đúng 10 chữ số (mã số bảo hiểm xã hội do BHXH Việt Nam cấp)	value.empty() or value.extension.where(url='http://hl7.org/fhir/StructureDefinition/data-absent-reason').exists() or value.matches('^[0-9]{10}$')
vn-bhyt-format	warning	Patient.identifier:BHYT.value	Mã số BHYT phải theo 1 trong 2 format: (1) 10 chữ số = mã số BHYT hiện hành (từ 01/4/2021, trùng giá trị mã số BHXH), (2) 15 ký tự = 2 chữ + 13 số format cũ (trước 01/4/2021). CCCD 12 số KHÔNG hợp lệ ở ô này — CCCD là khoá tra cứu/xuất trình, biểu diễn ở sid/cccd. **Mức thực thi: cảnh báo, không phải lỗi** — hồ sơ chuyển đổi từ giai đoạn trước 01/4/2021 và một số luồng nhập liệu vẫn đặt CCCD vào ô này; cảnh báo giúp phát hiện để làm sạch mà không chặn luồng thanh toán đang chạy.	$this.empty() or $this.matches('^[0-9]{10}$') or $this.matches('^[A-Z]{2}[0-9]{13}$')
vn-cccd-format	error	Patient.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-patient-gks-issuer-scoped	error	Patient	Số Giấy khai sinh ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/gks) phải kèm `assigner` chỉ rõ cơ quan đăng ký hộ tịch cấp số. Cách đúng hơn là dùng URI riêng theo cơ quan cấp. A birth-certificate number recorded under the shared national placeholder URI SHALL name its issuing civil-registration authority; per-issuer namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/gks').all(assigner.exists())
vn-patient-identifier-minimum	error	Patient	Phải có ít nhất một định danh dùng được: số định danh cá nhân/CCCD, hộ chiếu, hoặc giấy khai sinh — nhận diện theo `type` (CCCD/HC/GKS) nên hợp lệ với cả namespace theo quốc gia/cơ quan cấp, không chỉ URI dùng tạm. Có nhiều định danh hợp lệ đồng thời (ví dụ trẻ em có cả giấy khai sinh và số định danh cá nhân) vẫn thoả. Nếu không có định danh quốc gia nào (người bệnh cấp cứu chưa rõ nhân thân) thì phải có mã bệnh nhân của cơ sở KÈM lý do bất khả kháng (vn-ext-force-majeure-reason). Riêng data-absent-reason trên CCCD KHÔNG đủ để miễn: nó cho biết 'không có giá trị', không cho biết vì sao được phép không có	identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and (code='CCCD' or code='HC' or code='GKS')).exists() and value.hasValue()).exists() or (identifier.where(type.coding.where(system='http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs' and code='MRN').exists() and value.hasValue()).exists() and extension.where(url='http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason').exists())
vn-patient-mrn-issuer-scoped	error	Patient	Mã bệnh nhân ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/mrn) phải kèm `assigner` chỉ rõ cơ sở cấp mã. Cách đúng hơn là mỗi cơ sở công bố URI riêng cho namespace MRN của mình. A medical record number recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/mrn').all(assigner.exists())

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Ứng dụng người dân (Citizen App)	Nguồn tạo hồ sơ lâm sàng (Document Source)	Bên gửi hồ sơ BHYT (Submitter)
Patient
Slices for extension
extension:ethnicity	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
extension:citizenship
Slices for extension
extension:code
value[x]				SHALL:no-error SHALL:persist			SHALL:populate-if-known
extension:birthPlace	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:CCCD	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHYT	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:BHXH	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:GKS	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:MRN	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
identifier:HC	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
telecom	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
gender	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
birthDate	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle SHOULD:display	SHALL:populate-if-known	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
contact	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Summary

Mandatory: 4 elements(18 nested mandatory elements)
Must-Support: 28 elements
Fixed: 3 elements

Structures

This structure refers to these other structures:

• Địa chỉ VN Core — VN Core Address Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address)

Extensions

This structure refers to these extensions:

• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ethnicity
• http://hl7.org/fhir/StructureDefinition/patient-religion|5.3.0
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-occupation
• http://hl7.org/fhir/StructureDefinition/patient-citizenship|5.3.0
• http://hl7.org/fhir/StructureDefinition/patient-birthPlace|5.3.0
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-force-majeure-reason

Slices

This structure defines the following Slices:

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