HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Ví dụ Bundle: Ví dụ: Gói tài liệu IPS đầy đủ — 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ế/0791234567
  • Mã bệnh nhân nội bộ/BV-CR-2026-001234
  • Mã số bảo hiểm xã hội/0791234567
Contact Detail
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

International Patient Summary

Patient: Nguyễn Văn An. Allergies: Egg protein. Problems: Essential hypertension. Medications: Amlodipine 5mg daily.


Active Problems

Essential (primary) hypertension (ICD-10 I10), active.

Allergies and Intolerances

Egg protein allergy (SNOMED CT 213020009), high criticality.

Medication Summary

Amlodipine 5 mg once daily (current), for hypertension.

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ế/0791234567
  • Mã bệnh nhân nội bộ/BV-CR-2026-001234
  • Mã số bảo hiểm xã hội/0791234567
Contact Detail
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/ExampleAllergyIntoleranceFood

Resource AllergyIntolerance:

clinicalStatus: Active

verificationStatus: Confirmed

type: Allergy

category: Food

criticality: High Risk

code: Dị ứng trứng

patient: Nguyễn Văn An

recordedDate: 2026-04-20

reaction

substance: Trứng

manifestation: No display for AllergyIntolerance.reaction.manifestation (concept: Allergic angio-oedema), No display for AllergyIntolerance.reaction.manifestation (concept: Eruption)

description: Ăn trứng → phù mạch dị ứng và ban đỏ sau khoảng 30 phút, kèm ngứa dữ dội. Đã xảy ra 3 lần. Chưa có phản vệ nhưng cần theo dõi chặt.

severity: Moderate


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/MedicationStatement/ExampleMedicationStatementAmlodipine

Resource MedicationStatement:

status: active

status: recorded

subject: Nguyễn Văn An

effective: 2026-01-15 --> (ongoing)

dateAsserted: 2026-03-19

Dosages

-TextRoute
*Uống 1 viên 5mg, 1 lần/ngày, buổi sángUống

Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterOutpatient

Resource Encounter:

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


Entry 8 - 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: identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-03-19-NGT-0207; status = finished; class = ambulatory (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 9 - 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: identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-03-19-NGT-0207; status = finished; class = ambulatory (ActCode#AMB); period = 2026-03-19 08:30:00+0700 --> 2026-03-19 11:00:00+0700; reasonCode =

recordedDate: 2026-03-19


Entry 10 - 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: Từ 70 điểm trở lên

identifier: Giấy phép hoạt động cơ sở KCB/203/BYT-GPHĐ (use: official, period: 2014-07-08 --> (ongoing)), 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