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 bệnh án nội trú + xuất viện (document)

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

Document Content

Lý do nhập viện

Đau bụng vùng hố chậu phải dữ dội 6 giờ, kèm sốt 38.5°C, buồn nôn. Khám: phản ứng thành bụng (+), McBurney (+).

Chẩn đoán

Chẩn đoán xác định: K35.8 — Viêm ruột thừa cấp (ICD-10 VN per QĐ 4469/QĐ-BYT). Siêu âm: ruột thừa sưng to 12mm, có dịch quanh ruột thừa.

Phẫu thuật đã thực hiện

Phẫu thuật cắt ruột thừa nội soi ngày 10/4/2026. Gây mê toàn thân. Thời gian mổ 45 phút. Ruột thừa viêm mủ, chưa vỡ. Không biến chứng.

Thuốc điều trị

Ceftriaxone 2g tiêm tĩnh mạch 1 lần/ngày × 3 ngày (10–12/4). Paracetamol 500mg uống khi đau (PRN). Không phản ứng thuốc.

Khám thực thể trước xuất viện

Huyết áp 120/75 mmHg, mạch 76 lần/phút, nhiệt độ 36.7°C, SpO2 98%. Sinh hiệu ổn định trước xuất viện.

Tóm tắt ra viện

Tình trạng xuất viện: Ổn định. Vết mổ khô, sạch, không nhiễm trùng. Bụng mềm, nhu động ruột (+). Sinh hiệu ổn định: HA 120/75, mạch 76, nhiệt độ 36.7°C.
Hướng dẫn: Ăn mềm 3 ngày. Vệ sinh vết mổ bằng Betadine. Tái khám cắt chỉ sau 7 ngày (20/4/2026). Tái khám ngay nếu sốt >38°C hoặc đau bụng tăng.

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
  • 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 3 - 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 4 - 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 5 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/InlineEncounterInpatientAppendectomy

Resource Encounter:

Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type Extension: Cấp cứu

Hình thức chuyển tuyến — Referral Mode Extension: Đến khám

Kết quả điều trị — Vietnam Treatment Outcome Extension: Khỏi

Mã lượt khám — Encounter Code Extension: Mã lượt khám chữa bệnh/LK-2026-04-10-NKH-0087

status: completed

class: inpatient encounter

type: Nội trú phẫu thuật cấp cứu

subject: Nguyễn Văn An

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

participant

Diagnoses

-ConditionUse
*No display for Encounter.diagnosis.condition (reference: ->K35.8 — Viêm ruột thừa cấp)Admission diagnosis

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

Resource Condition:

clinicalStatus: Resolved

verificationStatus: Confirmed

category: Encounter Diagnosis

code: Viêm ruột thừa cấp

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Đến khám,Khỏi,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-10-NKH-0087; status = finished; class = inpatient encounter (ActCode#IMP); type = Điều trị nội trú; period = 2026-04-10 15:30:00+0700 --> 2026-04-13 09:00:00+0700

onset: 2026-04-10 09:00:00+0700

recordedDate: 2026-04-10

Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/Procedure/InlineProcedureAppendectomy

Resource Procedure:

Ngày y lệnh — Order Date Extension: 2026-04-10 15:45: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 = Cấp cứu,Đến khám,Khỏi,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-10-NKH-0087; status = finished; class = inpatient encounter (ActCode#IMP); type = Điều trị nội trú; period = 2026-04-10 15:30:00+0700 --> 2026-04-13 09:00:00+0700

Performers

-Actor
*BS CKII Nguyễn Thị Lan

bodySite: Ruột thừa

outcome: Thành công, không biến chứng

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

Resource MedicationRequest:

Số đăng ký thuốc (Visa) — Medication Registration Number: VN-15678-12

Ngày y lệnh — Order Date Extension: 2026-04-10 18:00:00+0700

status: Completed

intent: Order

category: Inpatient

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Đến khám,Khỏi,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-10-NKH-0087; status = finished; class = inpatient encounter (ActCode#IMP); type = Điều trị nội trú; period = 2026-04-10 15:30:00+0700 --> 2026-04-13 09:00:00+0700

authoredOn: 2026-04-10 18:00:00+0700

requester: BS CKII Nguyễn Thị Lan

dosageInstruction

sequence: 1

text: Tiêm tĩnh mạch 2g, 1 lần/ngày, pha trong NaCl 0.9% 100ml, truyền trong 30 phút

timing: Once per 1 day

route: Tiêm tĩnh mạch

DoseAndRates

-Dose[x]
*2 g (Details: UCUM codeg = 'g')

DispenseRequests

-Quantity
*3 lọ

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

Resource Observation:

status: Final

category: Vital Signs

code: Huyết áp lúc xuất viện

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Đến khám,Khỏi,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-10-NKH-0087; status = finished; class = inpatient encounter (ActCode#IMP); type = Điều trị nội trú; period = 2026-04-10 15:30:00+0700 --> 2026-04-13 09:00:00+0700

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

performer: BS CKII Nguyễn Thị Lan

note:

Sinh hiệu ổn định. Mạch 76 lần/phút, nhiệt độ 36.7°C, SpO2 98%. Đủ điều kiện xuất viện.

component

code: Huyết áp tâm thu

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

component

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

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

Entry 10 - fullUrl = http://fhir.hl7.org.vn/core/ServiceRequest/InlineServiceRequestFollowUp

Resource ServiceRequest:

status: Active

intent: Order

category: Khám chuyên khoa

code: No display for ServiceRequest.code (concept: )

subject: Nguyễn Văn An

encounter: Encounter: extension = Cấp cứu,Đến khám,Khỏi,Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-10-NKH-0087; status = finished; class = inpatient encounter (ActCode#IMP); type = Điều trị nội trú; period = 2026-04-10 15:30:00+0700 --> 2026-04-13 09:00:00+0700

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

authoredOn: 2026-04-13 09:00:00+0700

requester: BS CKII Nguyễn Thị Lan

note:

Tái khám kiểm tra vết mổ, cắt chỉ khâu da. Nếu sốt hoặc đau bụng tăng, tái khám ngay.