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ụ: Bundle nộp lượt cấp cứu (transaction)

Bundle ExampleBundleEmergencyTransaction of type transaction


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

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

Request:

PUT Patient/ExamplePatientNguyenVanAn

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

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

Request:

PUT Coverage/ExampleCoverageBHYTNew

Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterEmergency

Resource Encounter:

Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type Extension: Cấp cứu

Hình thức chuyển tuyến — Referral Mode Extension: Cấp cứu

Kết quả điều trị — Vietnam Treatment Outcome Extension: Đỡ

identifier: Mã lượt khám chữa bệnh/LK-2026-04-20-CC-0015

status: completed

class: emergency

type: Cấp cứu tai nạn giao thông

subject: Nguyễn Văn An

serviceProvider: Bệnh viện Chợ Rẫy — Khoa Cấp cứu

Diagnoses

-ConditionUse
*No display for Encounter.diagnosis.condition (reference: ->display: string (PrimitiveType/Bundle.entry[2].resource.diagnosis[0].condition[0].reference.display): native = string -> Gãy cổ xương đùi trái (S72.0) — tai nạn giao thông)Admission diagnosis

Request:

PUT Encounter/ExampleEncounterEmergency

Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Condition/ExampleConditionFemurFracture

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Gãy cổ xương đùi trái — tai nạn giao thông

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Cấp cứu,Đỡ; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-20-CC-0015; status = finished; class = emergency (v3 Code System ActCode#EMER); type = Khám bệnh; period = 2026-04-20 20:30:00+0700 --> 2026-04-21 06:00:00+0700; reasonCode =

onset: 2026-04-20 20:15:00+0700

recordedDate: 2026-04-20

Request:

PUT Condition/ExampleConditionFemurFracture

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

Resource Observation:

status: Final

category: Survey

code: Phân loại mức độ ưu tiên cấp cứu

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Cấp cứu,Đỡ; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-20-CC-0015; status = finished; class = emergency (v3 Code System ActCode#EMER); type = Khám bệnh; period = 2026-04-20 20:30:00+0700 --> 2026-04-21 06:00:00+0700; reasonCode =

effective: 2026-04-20 20:35:00+0700

performer: ĐD khoa Cấp cứu

value: Cấp độ 2 — Cấp cứu

Request:

PUT Observation/ExampleObservationTriageAcuity