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ụ: Document Bundle Sổ Sức khỏe điện tử — Nguyễn Văn An

Document Subject

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

Document Content

Sổ Sức khỏe điện tử — Nguyễn Văn An

Tóm tắt: Tăng huyết áp, Đái tháo đường type 2. Dị ứng Penicillin. Đang điều trị Amlodipine. Phân loại sức khỏe gần nhất: Loại II.

Tiền sử dị ứng

Tiền sử bệnh tật

Thuốc điều trị

Tiền sử tiêm chủng

Kết quả xét nghiệm

Phẫu thuật, thủ thuật

Chỉ số theo dõi chính

Khám sức khỏe định kỳ

Khám sức khỏe định kỳ gần nhất: phân loại sức khỏe Loại I (Rất khoẻ). Hồ sơ Khám sức khỏe đầy đủ được lưu dưới dạng tài liệu KSK riêng (VNCoreCompositionHealthCheckup).

Additional Resources Included in Document

Entry 2 - 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

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

Resource Organization:

identifier: Mã cơ sở khám chữa bệnh/01234, Mã định danh cơ sở KCB 13 ký tự/8930000000019

active: true

name: Trung tâm Y tế khu vực Cầu Giấy

Entry 4 - fullUrl = http://fhir.hl7.org.vn/core/AllergyIntolerance/ExampleAllergyPenicillin

Resource AllergyIntolerance:

clinicalStatus: Active

verificationStatus: Confirmed

type: Allergy

category: Medication

criticality: High Risk

code: Dị ứng Penicillin

patient: Nguyễn Văn An

recordedDate: 2025-06-15

reaction

substance: Penicillin

manifestation: No display for AllergyIntolerance.reaction.manifestation (concept: Eruption), No display for AllergyIntolerance.reaction.manifestation (concept: Interstitial edema)

severity: Severe

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

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Problem List Item

code: Tăng huyết áp

subject: Nguyễn Văn An

recordedDate: 2026-03-19

Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/Condition/ExampleConditionDiabetes

Resource Condition:

clinicalStatus: Active

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Đái tháo đường type 2, chưa có biến chứng

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 =

onset: 2024-03-15

recordedDate: 2026-03-19

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

Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Immunization/ExampleImmunizationTCMR

Resource Immunization:

Loại chương trình tiêm chủng — Vietnam Immunization Program Type Extension: tcmr

status: Completed

vaccineCode: Vaccine phối hợp DPT-VGB-Hib mũi 1

lotNumber: TCMR-DPTVGBHIB-2026-001

patient: Nguyễn Minh Khôi

occurrence: 2026-08-15 09:00:00+0700

primarySource: true

performer

actor: Trạm Y tế phường Bến Thành

performer

actor: Trần Văn Minh

protocolApplied

series: DPT-VGB-Hib 3-dose primary series

targetDisease: Bạch hầu, Ho gà, Uốn ván, Viêm gan B, Bệnh do Hib

Entry 9 - 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

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

Resource Observation:

status: Final

category: Laboratory

code: HbA1c (Hemoglobin glycated)

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Cấp cứu,Đỡ; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-20-CC-0015; status = finished; class = emergency (v3 Code System ActCode#EMER); type = Khám bệnh; period = 2026-04-20 20:30:00+0700 --> 2026-04-21 06:00:00+0700; reasonCode =

effective: 2026-04-20 09:30:00+0700

performer: BS CKII Nguyễn Thị Lan

value: 7.2 % (Details: UCUM code% = '%')

interpretation: High

note:

HbA1c 7.2% — kiểm soát đường huyết chưa đạt mục tiêu (< 7.0% cho BN ĐTĐ per ADA 2026). Tương đương đường huyết trung bình ~8.6 mmol/L. Cần điều chỉnh phác đồ điều trị: xem xét tăng liều Metformin hoặc bổ sung thuốc nhóm GLP-1 RA / SGLT-2i. Tư vấn chế độ ăn, tăng cường vận động. Tái xét nghiệm HbA1c sau 3 tháng.

referenceRange

high: 5.7 % (Details: UCUM code% = '%')

text:

< 5.7% (bình thường)

referenceRange

low: 5.7 % (Details: UCUM code% = '%')

high: 6.4 % (Details: UCUM code% = '%')

text:

5.7 – 6.4% (tiền đái tháo đường)

referenceRange

low: 6.5 % (Details: UCUM code% = '%')

text:

≥ 6.5% (đái tháo đường)

Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/Procedure/ExampleProcedureAppendectomy

Resource Procedure:

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

status: Completed

code: Phẫu thuật cắt ruột thừa nội soi

subject: Nguyễn Văn An

encounter: Encounter: extension = Đúng tuyến,Khỏi; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-03-10-NTRU-0042; status = finished; class = inpatient encounter (v3 Code System ActCode#IMP); period = 2026-03-10 14:00:00+0700 --> 2026-03-17 10:00:00+0700; reasonCode =

bodySite: Ruột thừa

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

Resource Observation:

status: Final

category: Vital Signs

code: Huyết áp

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Cấp cứu,Đỡ; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-20-CC-0015; status = finished; class = emergency (v3 Code System ActCode#EMER); type = Khám bệnh; period = 2026-04-20 20:30:00+0700 --> 2026-04-21 06:00:00+0700; reasonCode =

effective: 2026-04-20 08:00:00+0700

performer: BS CKII Nguyễn Thị Lan

note:

THA độ 1 (ESC 2023). Cần theo dõi HA tại nhà 7 ngày trước khi quyết định dùng thuốc.

component

code: Huyết áp tâm thu

value: 145 mmHg (Details: UCUM codemm[Hg] = 'mm[Hg]')

interpretation: High

ReferenceRanges

-LowHighText
*90 mmHg (Details: UCUM codemm[Hg] = 'mm[Hg]')140 mmHg (Details: UCUM codemm[Hg] = 'mm[Hg]')

90–140 mmHg (bình thường)

component

code: Huyết áp tâm trương

value: 92 mmHg (Details: UCUM codemm[Hg] = 'mm[Hg]')

interpretation: High

ReferenceRanges

-LowHighText
*60 mmHg (Details: UCUM codemm[Hg] = 'mm[Hg]')90 mmHg (Details: UCUM codemm[Hg] = 'mm[Hg]')

60–90 mmHg (bình thường)

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

Resource Observation:

status: Final

category: Vital Signs

code: Chỉ số khối cơ thể (BMI)

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Cấp cứu,Đỡ; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-20-CC-0015; status = finished; class = emergency (v3 Code System ActCode#EMER); type = Khám bệnh; period = 2026-04-20 20:30:00+0700 --> 2026-04-21 06:00:00+0700; reasonCode =

effective: 2026-04-20 08:15:00+0700

performer: BS CKII Nguyễn Thị Lan

value: 26.3 kg/m2 (Details: UCUM codekg/m2 = 'kg/m2')

interpretation: High

note:

BMI 26.3 — béo phì độ I per tiêu chuẩn WHO khu vực Châu Á-Thái Bình Dương (ngưỡng VN: ≥ 23 thừa cân, ≥ 25 béo phì). Khuyến cáo giảm cân.

ReferenceRanges

-HighText
*22.9 kg/m2 (Details: UCUM codekg/m2 = 'kg/m2')

< 23.0 kg/m² (bình thường — tiêu chuẩn Châu Á)