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
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
Document Details
Language: vi
Profile: Document Bundle Sổ Sức khoẻ điện tử — VN Core Health Record Summary Bundle
Final Document at 2026-06-02 08:00:00+0700 by Organization Trung tâm Y tế khu vực Cầu Giấy for Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)
Document Subject
Language: vi
Nguyễn Văn An Male, DoB: 1985-03-15 ( Căn cước công dân: VNCCCD#001085012345)
| Other Ids: |
| ||
| Contact Detail |
| ||
| Dân tộc — Vietnam Ethnicity Extension | Kinh | ||
| Patient Birth Place | Phường Ngọc Hà, Hà Nội | ||
| Nghề nghiệp — Vietnam Occupation Extension | Nhà phân tích hệ thống | ||
| Patient Religion | Công giáo | ||
| Patient Citizenship: |
| ||
Document Content
Tóm tắt: Tăng huyết áp, Đái tháo đường type 2. Dị ứng trứng. Đang điều trị Amlodipine. Phân loại sức khoẻ gần nhất: Loại II.
Entry 2 - fullUrl = http://fhir.hl7.org.vn/core/Patient/ExamplePatientNguyenVanAn
Resource Patient:
Language: vi
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
- +84-00-0000-0001
- [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 Extension Kinh Patient Birth Place Phường Ngọc Hà, Hà Nội Nghề nghiệp — Vietnam Occupation Extension Nhà phân tích hệ thống Patient Religion Công giáo Patient Citizenship:
- code: Viet Nam
Entry 3 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationHealthCheckupFacility
Resource Organization:
Language: vi
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:
Language: vi
Profiles: Dị ứng/Bất dung nạp VN Core — VN Core AllergyIntolerance Profile, AllergyIntolerance (IPS)
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:
Language: vi
Profiles: Chẩn đoán VN Core — VN Core Condition Profile, Condition (IPS)
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:
Language: vi
Profile: Chẩn đoán lượt khám VN Core — VN Core Encounter Diagnosis Condition Profile
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
onset: 2024-03-15
recordedDate: 2026-03-19
Entry 7 - fullUrl = http://fhir.hl7.org.vn/core/MedicationRequest/ExampleMedicationRequestHypertension
Resource MedicationRequest:
Language: vi
Profile: Đơn thuốc ngoại trú VN Core — VN Core Outpatient Prescription Profile
Số đăng ký thuốc (Visa) — Medication Registration Number: VD-25123-18
groupIdentifier: VNPrescriptionCode/791790000126-C
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)
authoredOn: 2026-03-19
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 (Details: UCUM code{tablet} = '{tablet}') dispenseRequest
numberOfRepeatsAllowed: 0
quantity: 30 viên (Details: UCUM code{tablet} = '{tablet}')
ExpectedSupplyDurations
Value Unit System Code 30 ngày http://unitsofmeasure.org d Substitutions
Allowed[x] false
Entry 8 - fullUrl = http://fhir.hl7.org.vn/core/Immunization/ExampleImmunizationVoluntary
Resource Immunization:
Language: vi
Profile: Tiêm chủng — VN Core Immunization
Loại chương trình tiêm chủng — Vietnam Immunization Program Type Extension: dich-vu
status: Completed
vaccineCode: Vaccine cúm mùa
lotNumber: FLU-2026-VN-019
patient: Nguyễn Văn An
occurrence: 2026-05-15 14:30:00+0700
primarySource: true
performer
actor: Phòng khám đa khoa Minh Hoạ
performer
actor: Trần Văn Minh
Reactions
Date Reported 2026-03-02 true ProtocolApplieds
Series TargetDisease Annual influenza vaccination Cúm, không xác định được virus
Entry 9 - fullUrl = http://fhir.hl7.org.vn/core/Observation/ExampleObservationLabGlucose
Resource Observation:
Language: vi
Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile
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
effective: 2026-03-19 09:00: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 hoá
ReferenceRanges
Low High Text 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:
Language: vi
Profile: Xét nghiệm VN Core — VN Core Observation Laboratory Profile
status: Final
category: Laboratory
code: HbA1c (Hemoglobin glycated)
subject: Nguyễn Văn An
effective: 2026-04-20 22:00: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Đ theo 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:
Language: vi
Ngày y lệnh — Order Date Extension: 2026-03-12 07:30:00+0700
Phương pháp vô cảm — Anesthesia Method Extension: Gây mê
status: Completed
code: Phẫu thuật cắt ruột thừa nội soi
subject: Nguyễn Văn An
bodySite: Ruột thừa
Entry 12 - fullUrl = http://fhir.hl7.org.vn/core/Observation/ExampleObservationVitalBP
Resource Observation:
Language: vi
Profile: Huyết áp VN Core — VN Core Observation Blood Pressure Profile
status: Final
category: Vital Signs
code: Huyết áp
subject: Nguyễn Văn An
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
Low High Text 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
Low High Text 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:
Language: vi
Profile: Sinh hiệu VN Core — VN Core Observation Vital Signs Profile
status: Final
category: Vital Signs
code: Chỉ số khối cơ thể (BMI)
subject: Nguyễn Văn An
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
High Text 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 14 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterEmergency
Resource Encounter:
Language: vi
Profile: Lượt khám/nhập viện VN Core — VN Core Encounter Profile
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
Condition Use No display for Encounter.diagnosis.condition (reference: ->display: string (PrimitiveType/Bundle.entry[13].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 15 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterInpatient
Resource Encounter:
Language: vi
Profile: Lượt khám/nhập viện VN Core — VN Core Encounter Profile
Kết quả điều trị — Vietnam Treatment Outcome Extension: Khỏi
identifier: Mã lượt khám chữa bệnh/LK-2026-03-10-NTRU-0042
status: completed
class: inpatient encounter
subject: Nguyễn Văn An
serviceProvider: Bệnh viện Chợ Rẫy
Diagnoses
Condition Use No display for Encounter.diagnosis.condition (reference: ->Viêm ruột thừa cấp (K35.8)) Admission diagnosis
Entry 16 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterOutpatient
Resource Encounter:
Language: vi
Profile: Lượt khám/nhập viện VN Core — VN Core Encounter Profile
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 17 - fullUrl = http://fhir.hl7.org.vn/core/Medication/ExampleMedicationAmlodipine
Resource Medication:
Language: vi
code: Amlodipine 5mg viên nén
status: Active
Ingredients
IsActive true
Entry 18 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationPrivateClinic
Resource Organization:
Language: vi
Profile: Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile
Loại hình cơ sở y tế — Vietnam Organization Type Extension: Phòng khám
Cấp quản lý hành chính y tế — Vietnam Administrative Health Level Extension: Tỉnh
Tình trạng xếp hạng cơ sở y tế — Organization Rank Status Extension: Chưa xếp hạng
Cấp năng lực cơ sở KCB — Facility Care Level Extension: Cấp ban đầu
identifier: Giấy phép hoạt động cơ sở KCB/GPHD-VIDU-PK-0001 (use: official, period: 2025-07-01 --> (ongoing)), Mã cơ sở khám chữa bệnh/99997
active: true
type: Cơ sở khám chữa bệnh tư nhân
name: Phòng khám đa khoa Minh Hoạ
contact
telecom: ph: 024 3511 5678, [email protected], https://example.org/vn-core/private-clinic
address: Số 55 Phố Yên Lãng, Phường Văn Miếu - Quốc Tử Giám, Hà Nội
Entry 19 - fullUrl = http://fhir.hl7.org.vn/core/Practitioner/ExamplePractitionerBSCKII
Resource Practitioner:
Language: vi
Profile: Nhân viên y tế VN Core — VN Core Practitioner Profile
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 20 - fullUrl = http://fhir.hl7.org.vn/core/Practitioner/ExamplePractitionerMinimal
Resource Practitioner:
Language: vi
Profile: Nhân viên y tế VN Core — VN Core Practitioner Profile
identifier: Giấy phép hành nghề/005678/HCM-GPHN
name: Trần Văn Minh
Qualifications
Code Bác sỹ
Entry 21 - fullUrl = http://fhir.hl7.org.vn/core/ServiceRequest/ExampleServiceRequestLabGlucose
Resource ServiceRequest:
Language: vi
Profile: Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile
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
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 hoá
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.)
Entry 22 - fullUrl = http://fhir.hl7.org.vn/core/Specimen/ExampleSpecimenSerumChemistry
Resource Specimen:
Language: vi
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
Collector Collected[x] Quantity Method BodySite BS CKII Nguyễn Thị Lan 2026-03-19 09:00:00+0700 4 mL (Details: UCUM codemL = 'mL') Lấy máu tĩnh mạch, ly tâm tách huyết thanh No display for Specimen.collection.bodySite (concept: Left upper arm structure) Processings
Description Time[x] Ly tâm tách huyết thanh trước khi chạy xét nghiệm sinh hoá 2026-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 hoá máu.
Entry 23 - fullUrl = http://fhir.hl7.org.vn/core/Account/ExampleAccountInpatientEpisode
Resource Account:
Language: vi
Profile: Tài khoản viện phí — VN Core Account
identifier: Mã liên kết hồ sơ BHYT/LK-ITEMIZED-2026-0001
status: Inactive
type: patient billing account
name: Đợt nội trú 10/03–17/03/2026 — Ngoại tiêu hoá
subject: Nguyễn Văn An
servicePeriod: 2026-03-10 --> 2026-03-17
coverage
priority: 1
coverage
priority: 2
owner: Bệnh viện Chợ Rẫy
description:
Đã chốt bảng kê và gửi hồ sơ đề nghị thanh toán; tài khoản đóng sau khi quyết toán quý I/2026.
Guarantors
Party OnHold Nguyễn Văn An false
Entry 24 - fullUrl = http://fhir.hl7.org.vn/core/Condition/ExampleConditionAppendicitis
Resource Condition:
Language: vi
Profile: Chẩn đoán lượt khám VN Core — VN Core Encounter Diagnosis Condition Profile
clinicalStatus: Active
verificationStatus: Confirmed
category: Encounter Diagnosis
code: Viêm ruột thừa cấp
bodySite: Ruột thừa
subject: Nguyễn Văn An
recordedDate: 2026-03-10
Entry 25 - fullUrl = http://fhir.hl7.org.vn/core/Condition/ExampleConditionPneumonia
Resource Condition:
Language: vi
Profile: Chẩn đoán lượt khám VN Core — VN Core Encounter Diagnosis Condition Profile
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
recordedDate: 2026-03-19
Entry 26 - fullUrl = http://fhir.hl7.org.vn/core/Organization/ExampleOrganizationChoRay
Resource Organization:
Language: vi
Profile: Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile
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
Telecom Address ph: 028 3855 4137 201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh
Entry 27 - fullUrl = http://fhir.hl7.org.vn/core/Coverage/ExampleCoverageBHYTNew
Resource Coverage:
Language: vi
Loại đối tượng BHYT — Vietnam BHYT Card Type Extension: Người lao động trong doanh nghiệp nhà nước
Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension: Bệnh viện Chợ Rẫy
identifier: VNBHYT/0791234567
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
Entry 28 - fullUrl = http://fhir.hl7.org.vn/core/Coverage/ExampleCoverageBHYTReissued
Resource Coverage:
Language: vi
Loại đối tượng BHYT — Vietnam BHYT Card Type Extension: Cán bộ, công chức, viên chức
Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension: Bệnh viện Chợ Rẫy
identifier: VNBHYT/HC4790791234567
status: Active
type: Bảo hiểm y tế
subscriber: Nguyễn Văn An
beneficiary: Nguyễn Văn An
relationship: Self
period: 2026-03-15 --> 2027-03-14
Entry 29 - fullUrl = http://fhir.hl7.org.vn/core/Encounter/ExampleEncounterHealthCheckup
Resource Encounter:
Language: vi
Profile: Lượt khám/nhập viện VN Core — VN Core Encounter Profile
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