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 ngoại trú (transaction)

Bundle ExampleBundleOutpatientTransaction 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/Condition/ExampleConditionPneumonia

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Viêm phổi, không xác định

bodySite: Phổi

subject: Nguyễn Văn An

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 =

recordedDate: 2026-03-19

Request:

PUT Condition/ExampleConditionPneumonia

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

Resource ServiceRequest:

status: Active

intent: Order

category: Xét nghiệm

priority: Routine

code: No display for ServiceRequest.code (concept: Fasting glucose [Mass/volume] in Serum or Plasma)

subject: Nguyễn Văn An

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-19 08:50:00+0700

requester: BS CKII Nguyễn Thị Lan

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

note:

BN có tiền sử gia đình ĐTĐ type 2. Kiểm tra HbA1c nếu glucose > 7.0 mmol/L.

patientInstruction: No display for ServiceRequest.patientInstruction (instruction[x]: Nhịn ăn ít nhất 8 giờ trước khi lấy máu xét nghiệm.)

Request:

PUT ServiceRequest/ExampleServiceRequestLabGlucose

Entry 6 - 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.

Request:

PUT Specimen/ExampleSpecimenSerumChemistry

Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Observation/ExampleObservationLabGlucose

Resource Observation:

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

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; 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 =

effective: 2026-03-19 09:20:00+0700

performer: BS CKII Nguyễn Thị Lan

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

interpretation: High

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

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

Request:

PUT Observation/ExampleObservationLabGlucose

Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/ExampleMedicationRequestAmoxicillin

Resource MedicationRequest:

Ngày y lệnh — Order Date Extension: 2026-03-19 09:30:00+0700

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

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

status: Active

intent: Order

category: Outpatient

subject: Nguyễn Văn An

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-19 09:30:00+0700

requester: BS CKII Nguyễn Thị Lan

insurance: Coverage: extension = Người lao động trong doanh nghiệp,->Bệnh viện Chợ Rẫy; identifier = http://fhir.hl7.org.vn/core/sid/bhyt#VNBHYT#001085012345; status = active; type = Medical; relationship = Self; period = 2025-08-01 --> 2026-07-31

note:

Bệnh nhân không dị ứng Penicillin. Tái khám sau 7 ngày nếu không đỡ.

dosageInstruction

sequence: 1

text: Uống 1 viên 500mg, 3 lần/ngày, sau ăn

timing: 3 per 1 day

route: Uống

DoseAndRates

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

dispenseRequest

quantity: 21 viên

ExpectedSupplyDurations

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

Request:

PUT MedicationRequest/ExampleMedicationRequestAmoxicillin