HL7 Vietnam VN Core FHIR Implementation Guide

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

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.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

Language: vi

Profile: Gói trao đổi dữ liệu VN Core — VN Core Bundle Profile

Bundle ExampleBundleLabOrderResult of type collection

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

Resource Patient:

> Language: vi

> Profile: Bệnh nhân VN Core — VN Core Patient Profile

> 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) an.nguyen@email.vn Số 123 Nguyễn Huệ, Phường Bến Thành, Thành phố Hồ Chí Minh
> Dân tộc — Vietnam Ethnicity Extension | Kinh
> Patient Birth Place | Phường Ngọc Hà, Hà Nội
> Nghề nghiệp — Vietnam Occupation Extension | Nhà phân tích hệ thống
> Patient Religion | Công giáo
> Patient Citizenship: | code: Viet Nam

Entry 2 - fullUrl = http://fhir.hl7.org.vn/core/Practitioner/ExamplePractitionerBSCKII

Resource Practitioner:

> Language: vi

> Profile: Nhân viên y tế VN Core — VN Core Practitioner Profile

> 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

> - | Code | Issuer
> * | Bác sĩ Chuyên khoa II — Nội khoa | Bộ Y tế

Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationChoRay

Resource Organization:

> Language: vi

> Profile: Cơ sở y tế VN Core — VN Core Organization Profile

> 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

> - | Telecom | Address
> * | ph: 028 3855 4137 | 201B 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:

> Language: vi

> Profile: Lượt khám/nhập viện VN Core — VN Core Encounter Profile

> 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:

> Language: vi

> Profile: Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile

> 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:

> - Mẫu máu toàn phần chống đông EDTA
> - Mẫu huyết thanh xét nghiệm sinh hóa

> 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:

> Language: vi

> Profile: Mẫu bệnh phẩm VN Core — VN Core Specimen Profile

> 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:

> Language: vi

> Profile: Mẫu bệnh phẩm VN Core — VN Core Specimen Profile

> 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

> - | Collector | Collected[x] | Quantity | Method | BodySite
> * | BS CKII Nguyễn Thị Lan | 2026-03-19 09:00:00+0700 | 4 mL (Details: UCUM codemL = 'mL') | Lấy máu tĩnh mạch, ly tâm tách huyết thanh | No display for Specimen.collection.bodySite (concept: Left upper arm structure)

> ### Processings

> - | Description | Time[x]
> * | Ly tâm tách huyết thanh trước khi chạy xét nghiệm sinh hóa | 2026-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:

> Language: vi

> Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile

> 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

> - | Low | High | Text
> * | 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:

> Language: vi

> Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile

> 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

> - | Low | High | Text
> * | 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:

> Language: vi

> Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile

> 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

> - | Low | High | Text
> * | 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:

> Language: vi

> Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile

> 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

> - | Low | High | Text
> * | 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:

> Language: vi

> Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile

> 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

> - | Low | High | Text
> * | 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:

> Language: vi

> Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile

> 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

> - | Low | High | Text
> * | 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:

> Language: vi

> Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile

> 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

> - | Low | High | Text
> * | 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:

> Language: vi

> Profile: Báo cáo cận lâm sàng VN Core — VN Core DiagnosticReport Profile

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

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

> Report Details

> Code | Value | Reference Range | Flags | Note
> Bạch cầu (WBC) | 15.2 ×10⁹/L (Details: UCUM code10*9/L = '10*9/L') | 4.0 – 10.0 ×10⁹/L | Final, 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⁹/L | Final |
> Glucose máu lúc đói | 5.4 mmol/L (Details: UCUM codemmol/L = 'mmol/L') | 3.9 – 6.1 mmol/L | Final |
> Creatinine huyết thanh | 85 µ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/L | Final |

> 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:

> Language: vi

> Profile: Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile

> 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ờ.