HL7 Vietnam VN Core FHIR Implementation Guide

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

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

Ví dụ Bundle: Ví dụ: Searchset Bundle Sổ SKĐT trên VNeID (tra cứu hồ sơ công dân)

Bundle ExampleBundleVNeIDHealthRecord of type searchset


Entry 1 - fullUrl = http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn

Search:Mode = match

Resource Patient:

Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)


Other Ids:
  • Thẻ bảo hiểm y tế/001085012345
  • Mã bệnh nhân nội bộ/BV-CR-2026-001234
  • Mã số bảo hiểm xã hội/0791234567
Contact Detail
  • ph: 0901234567(Mobile)
  • [email protected]
  • Số 123 Nguyễn Huệ, Phường Bến Thành, Thành phố Hồ Chí Minh
Dân tộc — Vietnam Ethnicity ExtensionKinh
Patient Birth PlacePhường Ngọc Hà, Hà Nội
Nghề nghiệp — Vietnam Occupation ExtensionNhà phân tích hệ thống
Patient ReligionCông giáo
Patient Citizenship:
  • code: Viet Nam

Entry 2 - fullUrl = http://fhir.hl7.org.vn/core/Composition/ExampleCompositionHealthCheckup

Search:Mode = include

Resource Composition:

identifier: VNMALK/KSK20260601000123

status: Final

type: Giấy khám sức khỏe định kỳ cho người đủ 18 tuổi trở lên

date: 2026-06-01

author: Practitioner Nguyễn Thị Lan

title: Giấy khám sức khỏe định kỳ cho người đủ 18 tuổi trở lên

Attesters

-ModeTimeParty
*Professional2026-06-01Practitioner Nguyễn Thị Lan

custodian: Organization Trung tâm Y tế khu vực Cầu Giấy


Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Coverage/ExampleCoverageBHYTNew

Search:Mode = include

Resource Coverage:

Loại đối tượng BHYT — Vietnam BHYT Card Type Extension: Người lao động trong doanh nghiệp

Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension: Bệnh viện Chợ Rẫy

identifier: VNBHYT/001085012345

status: Active

type: Bảo hiểm y tế

subscriber: Nguyễn Văn An

beneficiary: Nguyễn Văn An

relationship: Self

period: 2025-08-01 --> 2026-07-31


Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Consent/ExampleConsentHealthCheckupVNeID

Search:Mode = include

Resource Consent:

Participants

RoleDetails
PatientNguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)
ManagerOrganization Trung tâm Y tế khu vực Cầu Giấy
RuleTime PeriodWhoWhatdoco
.. permit
... deny
  • Period: 2026-06-01 --> 2027-06-01

doco Documentation for this format

Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/Observation/ExampleObservationHealthClassification

Search:Mode = include

Resource Observation:

status: Final

category: Exam

code: Phân loại sức khỏe (PHAN_LOAI_SK)

subject: Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)

effective: 2026-06-01

performer: Practitioner Nguyễn Thị Lan

value: Loại II — Khoẻ