HL7 Vietnam VN Core FHIR Implementation Guide

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

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

Ví dụ Bundle: Ví dụ: Bundle đơn thuốc điện tử (ePrescription) — THA + ĐTĐ

Bundle ExampleBundleEPrescription of type collection


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
  • Tài khoản định danh điện tử VNeID/VNEID-001085012345
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/Practitioner/ExamplePractitionerBSCKII

Resource Practitioner:

identifier: Căn cước công dân/079175001234, Giấy phép hành nghề/79/GPHN-BYT-0001234, Chứng chỉ hành nghề/HCM-001234/BYT-CCHN

name: Nguyễn Thị Lan

gender: Female

Qualifications

-CodeIssuer
*Bác sĩ Chuyên khoa II — Nội khoaBộ Y tế

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

Resource Encounter:

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

Mã lượt khám — Encounter Code Extension: Mã lượt khám chữa bệnh/LK-2026-04-12-0203

status: completed

class: ambulatory

type: Tái khám ngoại trú — kiểm soát THA + ĐTĐ

subject: Nguyễn Văn An

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

diagnosis

condition: No display for Encounter.diagnosis.condition (reference: ->I10 — Tăng huyết áp)

use: Admission diagnosis

diagnosis

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

use: Comorbidity diagnosis


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

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Tăng huyết áp nguyên phát

subject: Nguyễn Văn An

encounter: Encounter: extension = Khám chữa bệnh ban đầu,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-12-0203; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-12 08:30:00+0700 --> 2026-04-12 09:30:00+0700

recordedDate: 2026-04-12


Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/Condition/InlineConditionDM2

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Đái tháo đường type 2, không biến chứng

subject: Nguyễn Văn An

encounter: Encounter: extension = Khám chữa bệnh ban đầu,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-12-0203; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-12 08:30:00+0700 --> 2026-04-12 09:30:00+0700

recordedDate: 2026-04-12


Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/Medication/InlineMedicationAmlodipine5mg

Resource Medication:

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

code: Amlodipine 5mg viên nén


Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Medication/InlineMedicationMetformin500mg

Resource Medication:

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

code: Metformin 500mg viên nén


Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Medication/InlineMedicationAspirin81mg

Resource Medication:

code: Aspirin 81mg viên nén bao phim tan trong ruột


Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/InlineMedRequestAmlodipine

Resource MedicationRequest:

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

Ngày y lệnh — Order Date Extension: 2026-04-12 09:00:00+0700

status: Active

intent: Order

category: Outpatient

subject: Nguyễn Văn An

encounter: Encounter: extension = Khám chữa bệnh ban đầu,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-12-0203; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-12 08:30:00+0700 --> 2026-04-12 09:30:00+0700

authoredOn: 2026-04-12 09:00:00+0700

requester: BS CKII Nguyễn Thị Lan

dosageInstruction

sequence: 1

text: Uống 1 viên 5mg, 1 lần/ngày, sáng sau ăn

timing: at breakfast, Once per 1 day

route: Uống

DoseAndRates

-Dose[x]
*5 mg (Details: UCUM codemg = 'mg')

dispenseRequest

numberOfRepeatsAllowed: 0

quantity: 30 viên

ExpectedSupplyDurations

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

Entry 10 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/InlineMedRequestMetformin

Resource MedicationRequest:

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

Ngày y lệnh — Order Date Extension: 2026-04-12 09:00:00+0700

status: Active

intent: Order

category: Outpatient

subject: Nguyễn Văn An

encounter: Encounter: extension = Khám chữa bệnh ban đầu,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-12-0203; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-12 08:30:00+0700 --> 2026-04-12 09:30:00+0700

authoredOn: 2026-04-12 09:00:00+0700

requester: BS CKII Nguyễn Thị Lan

dosageInstruction

sequence: 1

text: Uống 1 viên 500mg, 2 lần/ngày (sáng và tối), ngay sau ăn

timing: at breakfast, at dinner, 2 per 1 day

route: Uống

DoseAndRates

-Dose[x]
*500 mg (Details: UCUM codemg = 'mg')

dispenseRequest

numberOfRepeatsAllowed: 0

quantity: 60 viên

ExpectedSupplyDurations

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

Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/InlineMedRequestAspirin

Resource MedicationRequest:

Ngày y lệnh — Order Date Extension: 2026-04-12 09:00:00+0700

status: Active

intent: Order

category: Outpatient

subject: Nguyễn Văn An

encounter: Encounter: extension = Khám chữa bệnh ban đầu,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-12-0203; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-12 08:30:00+0700 --> 2026-04-12 09:30:00+0700

authoredOn: 2026-04-12 09:00:00+0700

requester: BS CKII Nguyễn Thị Lan

dosageInstruction

sequence: 1

text: Uống 1 viên 81mg, 1 lần/ngày, sáng sau ăn

timing: at breakfast, Once per 1 day

route: Uống

DoseAndRates

-Dose[x]
*81 mg (Details: UCUM codemg = 'mg')

dispenseRequest

numberOfRepeatsAllowed: 0

quantity: 30 viên

ExpectedSupplyDurations

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