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 xét nghiệm CBC + Sinh hóa — kết quả bất thường WBC

Bundle ExampleBundleLabOrderResult 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/Organization/ExampleOrganizationChoRay

Resource Organization:

Loại hình cơ sở y tế — Vietnam Organization Type Extension: Bệnh viện

Cấp quản lý hành chính y tế — Vietnam Administrative Health Level Extension: Trung ương

Hạng cơ sở khám bệnh, chữa bệnh — Vietnam KCB Facility Rank Extension: Đặc biệt

Tình trạng xếp hạng cơ sở y tế — Organization Rank Status Extension: Đã xếp hạng

Cấp năng lực cơ sở KCB — Facility Care Level Extension: Cấp chuyên sâu

Dải điểm chất lượng cơ sở KCB — Quality Score Band Extension: Trên 70 điểm

identifier: Mã cơ sở khám chữa bệnh/79001

active: true

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

Contacts

-TelecomAddress
*ph: 028 3855 4137201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh

Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/InlineEncounterOutpatientLab

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-15-0318

status: completed

class: ambulatory

type: Khám ngoại trú — sốt + mệt mỏi, chỉ định XN tổng quát

subject: Nguyễn Văn An

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

participant


Entry 5 - fullUrl = http://fhir.hl7.org.vn/core/ServiceRequest/InlineServiceRequestCBCBiochem

Resource ServiceRequest:

status: Completed

intent: Order

category: Xét nghiệm

priority: Routine

code: No display for ServiceRequest.code (concept: CBC panel - Blood by Automated count)

orderDetail: No display for ServiceRequest.orderDetail ()

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

authoredOn: 2026-04-15 08:30:00+0700

requester: BS CKII Nguyễn Thị Lan

performer: Khoa Xét nghiệm — BV Chợ Rẫy

specimen:

note:

BN sốt 38.5°C, mệt mỏi, ăn kém 3 ngày. Không rõ ổ nhiễm trùng. Chỉ định XN tổng quát để định hướng chẩn đoán.

patientInstruction: No display for ServiceRequest.patientInstruction (instruction[x]: Nhịn ăn ít nhất 8 giờ trước khi lấy máu. Lấy máu tĩnh mạch khuỷu tay.)


Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/Specimen/ExampleSpecimenWholeBloodCBC

Resource Specimen:

identifier: VNSpecimenLocalIdNamingSystem/SP-20260420-0007

status: Available

type: Máu toàn phần chống đông EDTA

subject: Nguyễn Văn An

Collections

-Collected[x]
*2026-04-20 07:45:00+0700

note:

Mẫu máu toàn phần dùng cho công thức máu tự động.


Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Specimen/ExampleSpecimenSerumChemistry

Resource Specimen:

identifier: VNSpecimenLocalIdNamingSystem/SP-20260319-0001

accessionIdentifier: VNSpecimenLocalIdNamingSystem/XN-TN-20260319-0158

status: Available

type: Mẫu huyết thanh

subject: Nguyễn Văn An

receivedTime: 2026-03-19 09:05:00+0700

request: Yêu cầu xét nghiệm đường huyết lúc đói

Collections

-CollectorCollected[x]QuantityMethodBodySite
*BS CKII Nguyễn Thị Lan2026-03-19 09:00:00+07004 mL (Details: UCUM codemL = 'mL')Lấy máu tĩnh mạch, ly tâm tách huyết thanhNo display for Specimen.collection.bodySite (concept: Left upper arm structure)

Processings

-DescriptionTime[x]
*Ly tâm tách huyết thanh trước khi chạy xét nghiệm sinh hóa2026-03-19 09:10:00+0700

container

note:

Mẫu huyết thanh đạt chất lượng, không huyết tán, dùng cho nhóm xét nghiệm sinh hóa máu.


Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationWBC

Resource Observation:

basedOn: ServiceRequest CBC panel - Blood by Automated count

status: Final

category: Laboratory

code: Bạch cầu (WBC)

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

effective: 2026-04-15 09:00:00+0700

issued: 2026-04-15 10:30:00+0700

performer: Khoa Xét nghiệm — BV Chợ Rẫy

value: 15.2 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L')

interpretation: Cao

note:

Tăng bạch cầu (leukocytosis): WBC 15.2 × 10⁹/L. Gợi ý nhiễm trùng vi khuẩn cấp. Đề nghị CRP để đánh giá mức độ viêm.

specimen: Specimen: identifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#SP-20260420-0007; status = available; type = Whole blood; note = Mẫu máu toàn phần dùng cho công thức máu tự động.

ReferenceRanges

-LowHighText
*4 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L')10 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L')

4.0 – 10.0 ×10⁹/L


Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationRBC

Resource Observation:

basedOn: ServiceRequest CBC panel - Blood by Automated count

status: Final

category: Laboratory

code: Hồng cầu (RBC)

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

effective: 2026-04-15 09:00:00+0700

issued: 2026-04-15 10:30:00+0700

performer: Khoa Xét nghiệm — BV Chợ Rẫy

value: 4.8 ×10¹²/L (Details: UCUM code10*12/L = '10*12/L')

specimen: Specimen: identifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#SP-20260420-0007; status = available; type = Whole blood; note = Mẫu máu toàn phần dùng cho công thức máu tự động.

ReferenceRanges

-LowHighText
*4 ×10¹²/L (Details: UCUM code10*12/L = '10*12/L')5.5 ×10¹²/L (Details: UCUM code10*12/L = '10*12/L')

4.0 – 5.5 ×10¹²/L (nam)


Entry 10 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationHemoglobin

Resource Observation:

basedOn: ServiceRequest CBC panel - Blood by Automated count

status: Final

category: Laboratory

code: Hemoglobin (Hgb)

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

effective: 2026-04-15 09:00:00+0700

issued: 2026-04-15 10:30:00+0700

performer: Khoa Xét nghiệm — BV Chợ Rẫy

value: 145 g/L (Details: UCUM codeg/L = 'g/L')

specimen: Specimen: identifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#SP-20260420-0007; status = available; type = Whole blood; note = Mẫu máu toàn phần dùng cho công thức máu tự động.

ReferenceRanges

-LowHighText
*130 g/L (Details: UCUM codeg/L = 'g/L')170 g/L (Details: UCUM codeg/L = 'g/L')

130 – 170 g/L (nam)


Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationPlatelet

Resource Observation:

basedOn: ServiceRequest CBC panel - Blood by Automated count

status: Final

category: Laboratory

code: Tiểu cầu (PLT)

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

effective: 2026-04-15 09:00:00+0700

issued: 2026-04-15 10:30:00+0700

performer: Khoa Xét nghiệm — BV Chợ Rẫy

value: 250 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L')

specimen: Specimen: identifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#SP-20260420-0007; status = available; type = Whole blood; note = Mẫu máu toàn phần dùng cho công thức máu tự động.

ReferenceRanges

-LowHighText
*150 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L')400 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L')

150 – 400 ×10⁹/L


Entry 12 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationGlucoseLab

Resource Observation:

basedOn: ServiceRequest CBC panel - Blood by Automated count

status: Final

category: Laboratory

code: Glucose máu lúc đói

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

effective: 2026-04-15 09:00:00+0700

issued: 2026-04-15 10:30:00+0700

performer: Khoa Xét nghiệm — BV Chợ Rẫy

value: 5.4 mmol/L (Details: UCUM codemmol/L = 'mmol/L')

specimen: Specimen: identifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#SP-20260319-0001; accessionIdentifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#XN-TN-20260319-0158; status = available; type = Serum; receivedTime = 2026-03-19 09:05:00+0700; note = Mẫu huyết thanh đạt chất lượng, không huyết tán, dùng cho nhóm xét nghiệm sinh hóa máu.

ReferenceRanges

-LowHighText
*3.9 mmol/L (Details: UCUM codemmol/L = 'mmol/L')6.1 mmol/L (Details: UCUM codemmol/L = 'mmol/L')

3.9 – 6.1 mmol/L


Entry 13 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationCreatinine

Resource Observation:

basedOn: ServiceRequest CBC panel - Blood by Automated count

status: Final

category: Laboratory

code: Creatinine huyết thanh

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

effective: 2026-04-15 09:00:00+0700

issued: 2026-04-15 10:30:00+0700

performer: Khoa Xét nghiệm — BV Chợ Rẫy

value: 85 µmol/L (Details: UCUM codeumol/L = 'umol/L')

specimen: Specimen: identifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#SP-20260319-0001; accessionIdentifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#XN-TN-20260319-0158; status = available; type = Serum; receivedTime = 2026-03-19 09:05:00+0700; note = Mẫu huyết thanh đạt chất lượng, không huyết tán, dùng cho nhóm xét nghiệm sinh hóa máu.

ReferenceRanges

-LowHighText
*62 µmol/L (Details: UCUM codeumol/L = 'umol/L')106 µmol/L (Details: UCUM codeumol/L = 'umol/L')

62 – 106 µmol/L (nam)


Entry 14 - fullUrl = http://fhir.hl7.org.vn/core/Observation/InlineObservationALT

Resource Observation:

basedOn: ServiceRequest CBC panel - Blood by Automated count

status: Final

category: Laboratory

code: ALT (SGPT)

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

effective: 2026-04-15 09:00:00+0700

issued: 2026-04-15 10:30:00+0700

performer: Khoa Xét nghiệm — BV Chợ Rẫy

value: 32 U/L (Details: UCUM codeU/L = 'U/L')

specimen: Specimen: identifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#SP-20260319-0001; accessionIdentifier = http://fhir.hl7.org.vn/core/sid/specimen-local-id#VNSpecimenLocalIdNamingSystem#XN-TN-20260319-0158; status = available; type = Serum; receivedTime = 2026-03-19 09:05:00+0700; note = Mẫu huyết thanh đạt chất lượng, không huyết tán, dùng cho nhóm xét nghiệm sinh hóa máu.

ReferenceRanges

-LowHighText
*7 U/L (Details: UCUM codeU/L = 'U/L')56 U/L (Details: UCUM codeU/L = 'U/L')

7 – 56 U/L


Entry 15 - fullUrl = http://fhir.hl7.org.vn/core/DiagnosticReport/InlineDiagnosticReportCBCBiochem

Resource DiagnosticReport:

Xét nghiệm máu tổng quát — CBC + Sinh hóa cơ bản (Xét nghiệm)

SubjectNguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)
When For2026-04-15 09:00:00+0700
Reported2026-04-15 10:30:00+0700
Performer Khoa Xét nghiệm — BV Chợ Rẫy

Report Details

CodeValueReference RangeFlagsNote
Bạch cầu (WBC)15.2 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L')4.0 – 10.0 ×10⁹/LFinal, Cao

Tăng bạch cầu (leukocytosis): WBC 15.2 × 10⁹/L. Gợi ý nhiễm trùng vi khuẩn cấp. Đề nghị CRP để đánh giá mức độ viêm.

Hồng cầu (RBC)4.8 ×10¹²/L (Details: UCUM code10*12/L = '10*12/L')4.0 – 5.5 ×10¹²/L (nam)Final
Hemoglobin (Hgb)145 g/L (Details: UCUM codeg/L = 'g/L')130 – 170 g/L (nam)Final
Tiểu cầu (PLT)250 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L')150 – 400 ×10⁹/LFinal
Glucose máu lúc đói5.4 mmol/L (Details: UCUM codemmol/L = 'mmol/L')3.9 – 6.1 mmol/LFinal
Creatinine huyết thanh85 µmol/L (Details: UCUM codeumol/L = 'umol/L')62 – 106 µmol/L (nam)Final
ALT (SGPT)32 U/L (Details: UCUM codeU/L = 'U/L')7 – 56 U/LFinal

TĂNG BẠCH CẦU: WBC 15.2 ×10⁹/L (bình thường: 4.0–10.0). Gợi ý nhiễm trùng vi khuẩn cấp. Cần CRP và công thức bạch cầu để xác định loại nhiễm trùng. Các chỉ số còn lại (RBC, Hgb, PLT, Glucose, Creatinine, ALT) trong giới hạn bình thường — loại trừ thiếu máu, Dengue, suy thận, viêm gan cấp.

Coded Conclusions:

  • Tăng bạch cầu không đặc hiệu — gợi ý nhiễm trùng vi khuẩn

Entry 16 - fullUrl = http://fhir.hl7.org.vn/core/ServiceRequest/InlineServiceRequestCRP

Resource ServiceRequest:

status: Active

intent: Order

category: Xét nghiệm

priority: Urgent

code: No display for ServiceRequest.code (concept: C reactive protein [Mass/volume] in Serum or Plasma)

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-15-0318; status = finished; class = ambulatory (ActCode#AMB); type = Khám bệnh; period = 2026-04-15 08:00:00+0700 --> 2026-04-15 11:30:00+0700

authoredOn: 2026-04-15 11:00:00+0700

requester: BS CKII Nguyễn Thị Lan

performer: Khoa Xét nghiệm — BV Chợ Rẫy

specimen: Mẫu huyết thanh xét nghiệm sinh hóa

note:

Chỉ định bổ sung sau kết quả CBC: WBC = 15.2 × 10⁹/L (cao). Dùng cùng mẫu máu đã lấy lúc 09:00. Kết quả ưu tiên — trả trong 2 giờ.