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ụ: Document Bundle giấy khám sức khoẻ định kỳ (người 18+)

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

Khám thể lực

Kết luận và phân loại sức khoẻ

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/Practitioner/ExamplePractitionerBSCKII

Resource Practitioner:

identifier: Căn cước công dân/079175001234, Giấy phép hành nghề/001234/BYT-GPHN, Chứng chỉ hành nghề/HCM-001234/BYT-CCHN

name: Nguyễn Thị Lan

gender: Female

qualification

code: Bác sỹ

issuer: Bộ Y tế

qualification

code: Bác sĩ Chuyên khoa II — Nội khoa

issuer: Bộ Y tế

Entry 4 - 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 5 - fullUrl = http://fhir.hl7.org.vn/core/Observation/ExampleObservationVitalBodyHeight

Resource Observation:

status: Final

category: Vital Signs

code: Chiều cao

subject: Nguyễn Văn An

encounter: Encounter: extension = 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 (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 20:50:00+0700

performer: BS CKII Nguyễn Thị Lan

value: 168 cm (Details: UCUM codecm = 'cm')

Entry 6 - fullUrl = http://fhir.hl7.org.vn/core/Observation/ExampleObservationVitalWeight

Resource Observation:

status: Final

category: Vital Signs

code: Cân nặng

subject: Nguyễn Văn An

encounter: Encounter: extension = 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 (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 20:52:00+0700

performer: BS CKII Nguyễn Thị Lan

value: 65 kg (Details: UCUM codekg = 'kg')

Entry 7 - 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,Đỡ; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-20-CC-0015; status = finished; class = emergency (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 20:55: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 theo 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 Á)

Entry 8 - 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,Đỡ; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-04-20-CC-0015; status = finished; class = emergency (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 20:40: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 9 - fullUrl = http://fhir.hl7.org.vn/core/Observation/ExampleObservationVitalHeartRate

Resource Observation:

status: Final

category: Vital Signs

code: Mạch

subject: Nguyễn Văn An

encounter: Encounter: extension = 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 (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 20:41:00+0700

performer: BS CKII Nguyễn Thị Lan

value: 80 /min (Details: UCUM code/min = '/min')

ReferenceRanges

-LowHighText
*60 /min (Details: UCUM code/min = '/min')100 /min (Details: UCUM code/min = '/min')

60–100 lần/phút (người lớn, lúc nghỉ)

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

Resource Observation:

status: Final

category: Exam

code: Phân loại sức khoẻ (PHAN_LOAI_SK)

subject: Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)

effective: 2026-06-01

performer: Practitioner Nguyễn Thị Lan

value: Loại II — Khoẻ

Entry 11 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterEmergency

Resource Encounter:

Hình thức chuyển tuyến — Referral Mode Extension: Cấp cứu

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

identifier: Mã lượt khám chữa bệnh/LK-2026-04-20-CC-0015

status: completed

class: emergency

type: Cấp cứu tai nạn giao thông

subject: Nguyễn Văn An

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

Diagnoses

-ConditionUse
*No display for Encounter.diagnosis.condition (reference: ->display: string (PrimitiveType/Bundle.entry[10].resource.diagnosis[0].condition[0].reference.display): native = string -> Gãy cổ xương đùi trái (S72.0) — tai nạn giao thông)Admission diagnosis

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

Entry 13 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterHealthCheckup

Resource Encounter:

identifier: Mã lượt khám chữa bệnh/LK-2026-07-20-KSK-0031

status: completed

class: ambulatory

type: Khám sức khoẻ định kỳ

subject: Nguyễn Văn An

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

participant