Logical model đặc tả 20 trường dữ liệu do người dân TỰ KHAI khi khởi tạo Sổ sức khỏe điện tử trên ứng dụng VNeID, theo Quyết định 2062/QĐ-BYT (07/07/2026) Phụ lục 05 mục 5. Ba nhóm: thông tin chung (13 trường), người giám hộ hoặc người chăm sóc chính (4 trường, chỉ khi có), và thông tin y tế cơ bản (5 trường — tổng 22 mục dữ liệu trên 20 dòng danh mục vì phần cư trú gồm ba cấp).

CẢNH BÁO SỬ DỤNG — nguồn dữ liệu và mức tin cậy: phần hành chính được đối soát với Cơ sở dữ liệu quốc gia về dân cư, còn năm trường y tế (nhóm máu ABO, chiều cao, cân nặng, tiền sử bản thân, tiền sử gia đình) KHÔNG qua bất kỳ xác thực y khoa nào. Riêng nhóm máu tự khai TUYỆT ĐỐI không được dùng làm căn cứ cho quyết định lâm sàng hoặc truyền máu — phải xét nghiệm định nhóm máu tại cơ sở KCB. Mọi resource sinh ra từ nhóm dữ liệu này bắt buộc kèm Provenance đánh dấu nguồn tự khai (Provenance.agent.type = informant hoặc Observation.performer = Patient), và Observation phải mang status = preliminary cho tới khi được xác nhận bởi cơ sở y tế.

Người khai là chủ thể dữ liệu; cơ sở KCB chỉ hỗ trợ cập nhật, không thay thế vai trò khai báo. / Logical model for the 20 self-declared fields used to initialise the VNeID electronic health book per Appendix 05 of Decision 2062/QĐ-BYT. The five clinical fields carry no medical verification; self-declared ABO blood group must never drive clinical or transfusion decisions.

Nhóm thông tin chung của người khai (13 trường)

PL05 mục 5 phần I QĐ 2062/QĐ-BYT. Phần định danh và cư trú được đối soát với Cơ sở dữ liệu quốc gia về dân cư.

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Họ và tên (bắt buộc)

Ngày sinh (bắt buộc)

Giới tính (bắt buộc)

Ánh xạ sang administrative-gender qua vn-cm-gender-to-administrative-gender.

Dân tộc

Danh mục 54 dân tộc — VNEthnicityCS.

Quốc tịch

Nghề nghiệp

Danh mục nghề nghiệp VSCO 2020 — VNOccupationCS.

Số định danh cá nhân / số CCCD (bắt buộc)

12 chữ số. Đối soát với Cơ sở dữ liệu quốc gia về dân cư.

Mã thẻ bảo hiểm y tế

Nơi đăng ký khám bệnh, chữa bệnh ban đầu

Người dân khai theo tên cơ sở ghi trên thẻ; hệ thống phân giải sang mã CSKCB khi đối soát.

Số điện thoại (bắt buộc)

Nơi cư trú — thôn/xóm/số nhà

Nơi cư trú — xã/phường/đặc khu

Cấp xã là cấp hành chính thứ hai theo mô hình 2 cấp (NQ 202/2025/QH15, Luật 72/2025/QH15).

Nơi cư trú — tỉnh/thành phố

Người giám hộ, người chăm sóc chính hoặc người đại diện (khai khi có)

PL05 mục 5 phần II QĐ 2062/QĐ-BYT. Bắt buộc trên thực tế với trẻ em và người mất/hạn chế năng lực hành vi dân sự.

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Họ và tên người đại diện

Mối quan hệ với người khai

Số định danh cá nhân của người đại diện

Số điện thoại của người đại diện

Thông tin y tế cơ bản do người dân tự khai (5 trường)

PL05 mục 5 phần III QĐ 2062/QĐ-BYT. TOÀN BỘ nhóm này là dữ liệu tự khai, không qua xác thực y khoa: mọi resource sinh ra phải kèm Provenance nguồn tự khai và Observation mang status = preliminary cho tới khi cơ sở y tế xác nhận.

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Nhóm máu ABO (tự khai)

CẤM dùng cho quyết định lâm sàng hoặc truyền máu. Kết quả định nhóm máu phục vụ điều trị phải do cơ sở KCB xét nghiệm và ghi nhận bằng VNCoreObservationLab với performer là cơ sở xét nghiệm.

Chiều cao (cm, tự khai)

Cân nặng (kg, tự khai)

Tiền sử bệnh của bản thân (tự khai, dạng văn bản)

Người dân khai bằng ngôn ngữ tự nhiên; KHÔNG suy diễn thành mã ICD-10. Khi cơ sở KCB xác nhận mới tạo VNCoreCondition có mã.

Tiền sử bệnh gia đình (tự khai, dạng văn bản)

Không dùng FamilyMemberHistory khi chưa xác nhận quan hệ và chẩn đoán; giữ dạng văn bản tự khai.

Logical model đặc tả 20 trường dữ liệu do người dân TỰ KHAI khi khởi tạo Sổ sức khỏe điện tử trên ứng dụng VNeID, theo Quyết định 2062/QĐ-BYT (07/07/2026) Phụ lục 05 mục 5. Ba nhóm: thông tin chung (13 trường), người giám hộ hoặc người chăm sóc chính (4 trường, chỉ khi có), và thông tin y tế cơ bản (5 trường — tổng 22 mục dữ liệu trên 20 dòng danh mục vì phần cư trú gồm ba cấp).

CẢNH BÁO SỬ DỤNG — nguồn dữ liệu và mức tin cậy: phần hành chính được đối soát với Cơ sở dữ liệu quốc gia về dân cư, còn năm trường y tế (nhóm máu ABO, chiều cao, cân nặng, tiền sử bản thân, tiền sử gia đình) KHÔNG qua bất kỳ xác thực y khoa nào. Riêng nhóm máu tự khai TUYỆT ĐỐI không được dùng làm căn cứ cho quyết định lâm sàng hoặc truyền máu — phải xét nghiệm định nhóm máu tại cơ sở KCB. Mọi resource sinh ra từ nhóm dữ liệu này bắt buộc kèm Provenance đánh dấu nguồn tự khai (Provenance.agent.type = informant hoặc Observation.performer = Patient), và Observation phải mang status = preliminary cho tới khi được xác nhận bởi cơ sở y tế.

Người khai là chủ thể dữ liệu; cơ sở KCB chỉ hỗ trợ cập nhật, không thay thế vai trò khai báo. / Logical model for the 20 self-declared fields used to initialise the VNeID electronic health book per Appendix 05 of Decision 2062/QĐ-BYT. The five clinical fields carry no medical verification; self-declared ABO blood group must never drive clinical or transfusion decisions.

Nhóm thông tin chung của người khai (13 trường)

PL05 mục 5 phần I QĐ 2062/QĐ-BYT. Phần định danh và cư trú được đối soát với Cơ sở dữ liệu quốc gia về dân cư.

Họ và tên (bắt buộc)

Ngày sinh (bắt buộc)

Giới tính (bắt buộc)

Ánh xạ sang administrative-gender qua vn-cm-gender-to-administrative-gender.

Dân tộc

Danh mục 54 dân tộc — VNEthnicityCS.

Quốc tịch

Nghề nghiệp

Danh mục nghề nghiệp VSCO 2020 — VNOccupationCS.

Số định danh cá nhân / số CCCD (bắt buộc)

12 chữ số. Đối soát với Cơ sở dữ liệu quốc gia về dân cư.

Mã thẻ bảo hiểm y tế

Nơi đăng ký khám bệnh, chữa bệnh ban đầu

Người dân khai theo tên cơ sở ghi trên thẻ; hệ thống phân giải sang mã CSKCB khi đối soát.

Số điện thoại (bắt buộc)

Nơi cư trú — thôn/xóm/số nhà

Nơi cư trú — xã/phường/đặc khu

Cấp xã là cấp hành chính thứ hai theo mô hình 2 cấp (NQ 202/2025/QH15, Luật 72/2025/QH15).

Nơi cư trú — tỉnh/thành phố

Người giám hộ, người chăm sóc chính hoặc người đại diện (khai khi có)

PL05 mục 5 phần II QĐ 2062/QĐ-BYT. Bắt buộc trên thực tế với trẻ em và người mất/hạn chế năng lực hành vi dân sự.

Họ và tên người đại diện

Mối quan hệ với người khai

Số định danh cá nhân của người đại diện

Số điện thoại của người đại diện

Thông tin y tế cơ bản do người dân tự khai (5 trường)

PL05 mục 5 phần III QĐ 2062/QĐ-BYT. TOÀN BỘ nhóm này là dữ liệu tự khai, không qua xác thực y khoa: mọi resource sinh ra phải kèm Provenance nguồn tự khai và Observation mang status = preliminary cho tới khi cơ sở y tế xác nhận.

Nhóm máu ABO (tự khai)

CẤM dùng cho quyết định lâm sàng hoặc truyền máu. Kết quả định nhóm máu phục vụ điều trị phải do cơ sở KCB xét nghiệm và ghi nhận bằng VNCoreObservationLab với performer là cơ sở xét nghiệm.

Chiều cao (cm, tự khai)

Cân nặng (kg, tự khai)

Tiền sử bệnh của bản thân (tự khai, dạng văn bản)

Người dân khai bằng ngôn ngữ tự nhiên; KHÔNG suy diễn thành mã ICD-10. Khi cơ sở KCB xác nhận mới tạo VNCoreCondition có mã.

Tiền sử bệnh gia đình (tự khai, dạng văn bản)

Không dùng FamilyMemberHistory khi chưa xác nhận quan hệ và chẩn đoán; giữ dạng văn bản tự khai.

Logical model đặc tả 20 trường dữ liệu do người dân TỰ KHAI khi khởi tạo Sổ sức khỏe điện tử trên ứng dụng VNeID, theo Quyết định 2062/QĐ-BYT (07/07/2026) Phụ lục 05 mục 5. Ba nhóm: thông tin chung (13 trường), người giám hộ hoặc người chăm sóc chính (4 trường, chỉ khi có), và thông tin y tế cơ bản (5 trường — tổng 22 mục dữ liệu trên 20 dòng danh mục vì phần cư trú gồm ba cấp).

CẢNH BÁO SỬ DỤNG — nguồn dữ liệu và mức tin cậy: phần hành chính được đối soát với Cơ sở dữ liệu quốc gia về dân cư, còn năm trường y tế (nhóm máu ABO, chiều cao, cân nặng, tiền sử bản thân, tiền sử gia đình) KHÔNG qua bất kỳ xác thực y khoa nào. Riêng nhóm máu tự khai TUYỆT ĐỐI không được dùng làm căn cứ cho quyết định lâm sàng hoặc truyền máu — phải xét nghiệm định nhóm máu tại cơ sở KCB. Mọi resource sinh ra từ nhóm dữ liệu này bắt buộc kèm Provenance đánh dấu nguồn tự khai (Provenance.agent.type = informant hoặc Observation.performer = Patient), và Observation phải mang status = preliminary cho tới khi được xác nhận bởi cơ sở y tế.

Người khai là chủ thể dữ liệu; cơ sở KCB chỉ hỗ trợ cập nhật, không thay thế vai trò khai báo. / Logical model for the 20 self-declared fields used to initialise the VNeID electronic health book per Appendix 05 of Decision 2062/QĐ-BYT. The five clinical fields carry no medical verification; self-declared ABO blood group must never drive clinical or transfusion decisions.

Nhóm thông tin chung của người khai (13 trường)

PL05 mục 5 phần I QĐ 2062/QĐ-BYT. Phần định danh và cư trú được đối soát với Cơ sở dữ liệu quốc gia về dân cư.

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Họ và tên (bắt buộc)

Ngày sinh (bắt buộc)

Giới tính (bắt buộc)

Ánh xạ sang administrative-gender qua vn-cm-gender-to-administrative-gender.

Dân tộc

Danh mục 54 dân tộc — VNEthnicityCS.

Quốc tịch

Nghề nghiệp

Danh mục nghề nghiệp VSCO 2020 — VNOccupationCS.

Số định danh cá nhân / số CCCD (bắt buộc)

12 chữ số. Đối soát với Cơ sở dữ liệu quốc gia về dân cư.

Mã thẻ bảo hiểm y tế

Nơi đăng ký khám bệnh, chữa bệnh ban đầu

Người dân khai theo tên cơ sở ghi trên thẻ; hệ thống phân giải sang mã CSKCB khi đối soát.

Số điện thoại (bắt buộc)

Nơi cư trú — thôn/xóm/số nhà

Nơi cư trú — xã/phường/đặc khu

Cấp xã là cấp hành chính thứ hai theo mô hình 2 cấp (NQ 202/2025/QH15, Luật 72/2025/QH15).

Nơi cư trú — tỉnh/thành phố

Người giám hộ, người chăm sóc chính hoặc người đại diện (khai khi có)

PL05 mục 5 phần II QĐ 2062/QĐ-BYT. Bắt buộc trên thực tế với trẻ em và người mất/hạn chế năng lực hành vi dân sự.

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Họ và tên người đại diện

Mối quan hệ với người khai

Số định danh cá nhân của người đại diện

Số điện thoại của người đại diện

Thông tin y tế cơ bản do người dân tự khai (5 trường)

PL05 mục 5 phần III QĐ 2062/QĐ-BYT. TOÀN BỘ nhóm này là dữ liệu tự khai, không qua xác thực y khoa: mọi resource sinh ra phải kèm Provenance nguồn tự khai và Observation mang status = preliminary cho tới khi cơ sở y tế xác nhận.

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Nhóm máu ABO (tự khai)

CẤM dùng cho quyết định lâm sàng hoặc truyền máu. Kết quả định nhóm máu phục vụ điều trị phải do cơ sở KCB xét nghiệm và ghi nhận bằng VNCoreObservationLab với performer là cơ sở xét nghiệm.

Chiều cao (cm, tự khai)

Cân nặng (kg, tự khai)

Tiền sử bệnh của bản thân (tự khai, dạng văn bản)

Người dân khai bằng ngôn ngữ tự nhiên; KHÔNG suy diễn thành mã ICD-10. Khi cơ sở KCB xác nhận mới tạo VNCoreCondition có mã.

Tiền sử bệnh gia đình (tự khai, dạng văn bản)

Không dùng FamilyMemberHistory khi chưa xác nhận quan hệ và chẩn đoán; giữ dạng văn bản tự khai.