HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

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.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Mô hình logic: Khởi tạo Sổ sức khỏe điện tử — 20 trường người dân tự khai — Logical Model

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vnHealthBookSelfDeclarationLm Phiên bản: 0.9.0
Computable Name: VNHealthBookSelfDeclarationLM
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.158

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.

Usages:

  • This Logical Model is not used by any profiles in this Specification

You can also check for usages in the FHIR IG Statistics

Các dạng xem hình thức của nội dung hồ sơ

Mô tả profile, differential, snapshot và các biểu diễn liên quan.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. vnHealthBookSelfDeclarationLm 0..* Base Khởi tạo Sổ sức khỏe điện tử — 20 trường người dân tự khai — Logical Model
... thongTinChung 1..1 BackboneElement Nhóm thông tin chung của người khai (13 trường)
.... hoTen 1..1 string Họ và tên (bắt buộc)
.... ngaySinh 1..1 date Ngày sinh (bắt buộc)
.... gioiTinh 1..1 code Giới tính (bắt buộc)
.... danToc 0..1 CodeableConcept Dân tộc
.... quocTich 0..1 CodeableConcept Quốc tịch
.... ngheNghiep 0..1 CodeableConcept Nghề nghiệp
.... soDinhDanhCaNhan 1..1 string Số định danh cá nhân / số CCCD (bắt buộc)
.... maTheBHYT 0..1 string Mã thẻ bảo hiểm y tế
.... noiDangKyKCBBanDau 0..1 string Nơi đăng ký khám bệnh, chữa bệnh ban đầu
.... soDienThoai 1..1 string Số điện thoại (bắt buộc)
.... cuTruThonXomSoNha 0..1 string Nơi cư trú — thôn/xóm/số nhà
.... cuTruXaPhuong 0..1 CodeableConcept Nơi cư trú — xã/phường/đặc khu
.... cuTruTinhThanhPho 0..1 CodeableConcept Nơi cư trú — tỉnh/thành phố
... nguoiDaiDien 0..1 BackboneElement Người giám hộ, người chăm sóc chính hoặc người đại diện (khai khi có)
.... hoTen 0..1 string Họ và tên người đại diện
.... moiQuanHe 0..1 CodeableConcept Mối quan hệ với người khai
.... soDinhDanh 0..1 string Số định danh cá nhân của người đại diện
.... soDienThoai 0..1 string Số điện thoại của người đại diện
... thongTinYTe 0..1 BackboneElement Thông tin y tế cơ bản do người dân tự khai (5 trường)
.... nhomMauABO 0..1 CodeableConcept Nhóm máu ABO (tự khai)
.... chieuCao 0..1 Quantity Chiều cao (cm, tự khai)
.... canNang 0..1 Quantity Cân nặng (kg, tự khai)
.... tienSuBanThan 0..1 string Tiền sử bệnh của bản thân (tự khai, dạng văn bản)
.... tienSuGiaDinh 0..1 string Tiền sử bệnh gia đình (tự khai, dạng văn bản)

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. vnHealthBookSelfDeclarationLm 0..* Base Khởi tạo Sổ sức khỏe điện tử — 20 trường người dân tự khai — Logical Model
... thongTinChung 1..1 BackboneElement Nhóm thông tin chung của người khai (13 trường)
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... hoTen 1..1 string Họ và tên (bắt buộc)
.... ngaySinh 1..1 date Ngày sinh (bắt buộc)
.... gioiTinh 1..1 code Giới tính (bắt buộc)
.... danToc 0..1 CodeableConcept Dân tộc
.... quocTich 0..1 CodeableConcept Quốc tịch
.... ngheNghiep 0..1 CodeableConcept Nghề nghiệp
.... soDinhDanhCaNhan 1..1 string Số định danh cá nhân / số CCCD (bắt buộc)
.... maTheBHYT 0..1 string Mã thẻ bảo hiểm y tế
.... noiDangKyKCBBanDau 0..1 string Nơi đăng ký khám bệnh, chữa bệnh ban đầu
.... soDienThoai 1..1 string Số điện thoại (bắt buộc)
.... cuTruThonXomSoNha 0..1 string Nơi cư trú — thôn/xóm/số nhà
.... cuTruXaPhuong 0..1 CodeableConcept Nơi cư trú — xã/phường/đặc khu
.... cuTruTinhThanhPho 0..1 CodeableConcept Nơi cư trú — tỉnh/thành phố
... nguoiDaiDien 0..1 BackboneElement Người giám hộ, người chăm sóc chính hoặc người đại diện (khai khi có)
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... hoTen 0..1 string Họ và tên người đại diện
.... moiQuanHe 0..1 CodeableConcept Mối quan hệ với người khai
.... soDinhDanh 0..1 string Số định danh cá nhân của người đại diện
.... soDienThoai 0..1 string Số điện thoại của người đại diện
... thongTinYTe 0..1 BackboneElement Thông tin y tế cơ bản do người dân tự khai (5 trường)
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... nhomMauABO 0..1 CodeableConcept Nhóm máu ABO (tự khai)
.... chieuCao 0..1 Quantity Chiều cao (cm, tự khai)
.... canNang 0..1 Quantity Cân nặng (kg, tự khai)
.... tienSuBanThan 0..1 string Tiền sử bệnh của bản thân (tự khai, dạng văn bản)
.... tienSuGiaDinh 0..1 string Tiền sử bệnh gia đình (tự khai, dạng văn bản)

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
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()

Summary

Mandatory: 0 element(6 nested mandatory elements)

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. vnHealthBookSelfDeclarationLm 0..* Base Khởi tạo Sổ sức khỏe điện tử — 20 trường người dân tự khai — Logical Model
... thongTinChung 1..1 BackboneElement Nhóm thông tin chung của người khai (13 trường)
.... hoTen 1..1 string Họ và tên (bắt buộc)
.... ngaySinh 1..1 date Ngày sinh (bắt buộc)
.... gioiTinh 1..1 code Giới tính (bắt buộc)
.... danToc 0..1 CodeableConcept Dân tộc
.... quocTich 0..1 CodeableConcept Quốc tịch
.... ngheNghiep 0..1 CodeableConcept Nghề nghiệp
.... soDinhDanhCaNhan 1..1 string Số định danh cá nhân / số CCCD (bắt buộc)
.... maTheBHYT 0..1 string Mã thẻ bảo hiểm y tế
.... noiDangKyKCBBanDau 0..1 string Nơi đăng ký khám bệnh, chữa bệnh ban đầu
.... soDienThoai 1..1 string Số điện thoại (bắt buộc)
.... cuTruThonXomSoNha 0..1 string Nơi cư trú — thôn/xóm/số nhà
.... cuTruXaPhuong 0..1 CodeableConcept Nơi cư trú — xã/phường/đặc khu
.... cuTruTinhThanhPho 0..1 CodeableConcept Nơi cư trú — tỉnh/thành phố
... nguoiDaiDien 0..1 BackboneElement Người giám hộ, người chăm sóc chính hoặc người đại diện (khai khi có)
.... hoTen 0..1 string Họ và tên người đại diện
.... moiQuanHe 0..1 CodeableConcept Mối quan hệ với người khai
.... soDinhDanh 0..1 string Số định danh cá nhân của người đại diện
.... soDienThoai 0..1 string Số điện thoại của người đại diện
... thongTinYTe 0..1 BackboneElement Thông tin y tế cơ bản do người dân tự khai (5 trường)
.... nhomMauABO 0..1 CodeableConcept Nhóm máu ABO (tự khai)
.... chieuCao 0..1 Quantity Chiều cao (cm, tự khai)
.... canNang 0..1 Quantity Cân nặng (kg, tự khai)
.... tienSuBanThan 0..1 string Tiền sử bệnh của bản thân (tự khai, dạng văn bản)
.... tienSuGiaDinh 0..1 string Tiền sử bệnh gia đình (tự khai, dạng văn bản)

doco Documentation for this format

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. vnHealthBookSelfDeclarationLm 0..* Base Khởi tạo Sổ sức khỏe điện tử — 20 trường người dân tự khai — Logical Model
... thongTinChung 1..1 BackboneElement Nhóm thông tin chung của người khai (13 trường)
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... hoTen 1..1 string Họ và tên (bắt buộc)
.... ngaySinh 1..1 date Ngày sinh (bắt buộc)
.... gioiTinh 1..1 code Giới tính (bắt buộc)
.... danToc 0..1 CodeableConcept Dân tộc
.... quocTich 0..1 CodeableConcept Quốc tịch
.... ngheNghiep 0..1 CodeableConcept Nghề nghiệp
.... soDinhDanhCaNhan 1..1 string Số định danh cá nhân / số CCCD (bắt buộc)
.... maTheBHYT 0..1 string Mã thẻ bảo hiểm y tế
.... noiDangKyKCBBanDau 0..1 string Nơi đăng ký khám bệnh, chữa bệnh ban đầu
.... soDienThoai 1..1 string Số điện thoại (bắt buộc)
.... cuTruThonXomSoNha 0..1 string Nơi cư trú — thôn/xóm/số nhà
.... cuTruXaPhuong 0..1 CodeableConcept Nơi cư trú — xã/phường/đặc khu
.... cuTruTinhThanhPho 0..1 CodeableConcept Nơi cư trú — tỉnh/thành phố
... nguoiDaiDien 0..1 BackboneElement Người giám hộ, người chăm sóc chính hoặc người đại diện (khai khi có)
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... hoTen 0..1 string Họ và tên người đại diện
.... moiQuanHe 0..1 CodeableConcept Mối quan hệ với người khai
.... soDinhDanh 0..1 string Số định danh cá nhân của người đại diện
.... soDienThoai 0..1 string Số điện thoại của người đại diện
... thongTinYTe 0..1 BackboneElement Thông tin y tế cơ bản do người dân tự khai (5 trường)
.... @id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... nhomMauABO 0..1 CodeableConcept Nhóm máu ABO (tự khai)
.... chieuCao 0..1 Quantity Chiều cao (cm, tự khai)
.... canNang 0..1 Quantity Cân nặng (kg, tự khai)
.... tienSuBanThan 0..1 string Tiền sử bệnh của bản thân (tự khai, dạng văn bản)
.... tienSuGiaDinh 0..1 string Tiền sử bệnh gia đình (tự khai, dạng văn bản)

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
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()

Summary

Mandatory: 0 element(6 nested mandatory elements)

 

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