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 cấp phát thuốc (transaction)

Bundle ExampleBundlePharmacyDispenseTransaction 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/ExampleEncounterOutpatient

Resource Encounter:

Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type Extension: Khám chữa bệnh ban đầu

identifier: Mã lượt khám chữa bệnh/LK-2026-03-19-NGT-0207

status: completed

class: ambulatory

subject: Nguyễn Văn An

serviceProvider: Bệnh viện Chợ Rẫy

diagnosis

condition: No display for Encounter.diagnosis.condition (reference: ->Viêm phổi, không xác định J18.9)

use: Admission diagnosis

diagnosis

condition: No display for Encounter.diagnosis.condition (reference: ->Đái tháo đường type 2 E11.9)

use: Comorbidity diagnosis

Request:

PUT Encounter/ExampleEncounterOutpatient

Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/ExampleMedicationRequestHypertension

Resource MedicationRequest:

Số đăng ký thuốc (Visa) — Medication Registration Number: VD-25123-18

identifier: VNPrescriptionCode/79179000012603

status: Active

intent: Order

category: Outpatient

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

encounter: Encounter: extension = Khám chữa bệnh ban đầu; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-03-19-NGT-0207; status = finished; class = ambulatory (v3 Code System ActCode#AMB); period = 2026-03-19 08:30:00+0700 --> 2026-03-19 11:00:00+0700; reasonCode =

authoredOn: 2026-03-22

requester: Practitioner Nguyễn Thị Lan

dosageInstruction

sequence: 1

text: Uống 1 viên mỗi sáng, trước ăn

timing: Morning, Once per 1 day

route: Uống

DoseAndRates

-Dose[x]
*1 viên

dispenseRequest

numberOfRepeatsAllowed: 0

quantity: 30 viên

ExpectedSupplyDurations

-ValueUnitSystemCode
*30ngàyhttp://unitsofmeasure.orgd

Substitutions

-Allowed[x]
*false

Request:

PUT MedicationRequest/ExampleMedicationRequestHypertension

Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/MedicationDispense/ExampleMedicationDispenseOutpatientBHYT

Resource MedicationDispense:

Thông tin chi phí BHYT — Insurance Cost Info Extension

  • scope: Trong phạm vi hưởng BHYT
  • paymentRatio: 100
  • benefitLevel: 80

Số đăng ký thuốc (Visa) — Medication Registration Number: VD-25123-18

status: Completed

category: Outpatient

subject: Nguyễn Văn An

Performers

-Actor
*Khoa Dược — Bệnh viện Chợ Rẫy

authorizingPrescription: Đơn thuốc tăng huyết áp — Amlodipine 5mg

quantity: 30 viên

daysSupply: 30 ngày (Details: UCUM coded = 'd')

whenHandedOver: 2026-03-22 10:00:00+0700

dosageInstruction

sequence: 1

text: Uống 1 viên mỗi sáng, trước ăn

timing: Once per 1 day

route: Uống

DoseAndRates

-Dose[x]
*1 viên

Request:

PUT MedicationDispense/ExampleMedicationDispenseOutpatientBHYT