VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Hồ sơ (Profiles)
Hồ sơ (Profiles)
Trang này liệt kê tất cả profiles trong VN Core FHIR IG phiên bản 0.1.0.
Tổng quan
VN Core IG định nghĩa 23 profiles trên FHIR R4 resources, chia thành 5 nhóm:
| Nhóm |
Profiles |
Số lượng |
| Hành chính (Administrative) |
Patient, Practitioner, PractitionerRole, Organization, Address |
5 |
| Lâm sàng (Clinical) |
Encounter, Condition, Observation (3: Lab, VitalSigns, YHCT), AllergyIntolerance, Procedure, MedicationRequest, Medication, ServiceRequest |
10 |
| Tài chính (Financial) |
Coverage, Claim, ClaimResponse, ExplanationOfBenefit |
4 |
| Tài liệu & CLS (Document & Diagnostics) |
DocumentReference, DiagnosticReport |
2 |
| Trang thiết bị (Device) |
Device, DeviceUseStatement |
2 |
Nhóm 1: Hành chính
VNCorePatient
| Hạng mục |
Giá trị |
| Resource gốc |
Patient |
| Mô tả |
Hồ sơ bệnh nhân Việt Nam với identifier CCCD, tên tiếng Việt, dân tộc, tôn giáo, nghề nghiệp, địa chỉ 2 cấp |
| Căn cứ |
TT 13/2025, Luật Căn cước 2023, 121/TCTK-PPCĐ, QĐ 34/2020/QĐ-TTg (VSCO) |
| Extensions |
vn-ext-ethnicity, vn-ext-religion, vn-ext-occupation, vn-ext-province, vn-ext-ward |
| Must Support |
identifier[CCCD], name, gender, birthDate, address |
| Examples |
Nguyễn Văn An (đầy đủ), Bệnh nhân tối thiểu |
VNCorePractitioner
| Hạng mục |
Giá trị |
| Resource gốc |
Practitioner |
| Mô tả |
Nhân viên y tế với CCHN, trình độ chuyên môn (BS, CKI, CKII, ThS, TS…) |
| Căn cứ |
Luật KCB 2023, TT 13/2025, NĐ 96/2023 |
| Binding |
qualification.code → VNQualificationVS (extensible) |
| Must Support |
identifier[CCHN], name, qualification |
| Examples |
BS CKII (đầy đủ), Bác sĩ tối thiểu |
VNCorePractitionerRole
| Hạng mục |
Giá trị |
| Resource gốc |
PractitionerRole |
| Mô tả |
Vai trò của nhân viên y tế tại cơ sở KCB, bao gồm chức danh nghề nghiệp V.08 và chuyên khoa |
| Căn cứ |
TT 41/2025, TT 02/2025 (chức danh V.08), TT 43/2013, TT 32/2023 (chuyên khoa) |
| Binding |
code → VNPractitionerRoleVS (extensible), specialty → VNSpecialtyVS (extensible, 47 mã, 8 nhóm) |
| Must Support |
practitioner, organization, code |
| Examples |
Bác sĩ nội khoa |
VNCoreOrganization
| Hạng mục |
Giá trị |
| Resource gốc |
Organization |
| Mô tả |
Cơ sở KCB với mã CSKCB, hạng BV, tuyến, loại hình |
| Căn cứ |
Luật KCB 2023, QĐ 3176 |
| Extensions |
vn-ext-org-rank, vn-ext-org-level, vn-ext-org-type |
| Must Support |
identifier[CSKCB], name, type |
| Examples |
BV Chợ Rẫy, Trạm Y tế |
VNCoreAddress
| Hạng mục |
Giá trị |
| Resource gốc |
Address |
| Mô tả |
Địa chỉ Việt Nam 2 cấp (tỉnh + xã) với backward-compatible huyện |
| Căn cứ |
NQ 202/2025 |
| Extensions |
vn-ext-province, vn-ext-ward |
| Ghi chú |
VNCoreAddress là datatype profile — minh họa qua Patient examples. Xem Nguyễn Văn An |
Nhóm 2: Lâm sàng
VNCoreEncounter
| Hạng mục |
Giá trị |
| Resource gốc |
Encounter |
| Mô tả |
Lượt khám/điều trị với tuyến KCB, loại KCB BHYT, kết quả điều trị |
| Căn cứ |
QĐ 3176/QĐ-BYT (29/10/2024), TT 13/2025, Luật BHYT |
| Extensions |
vn-ext-insurance-visit-type (trường MALYDO), vn-ext-treatment-outcome (trường KETQUA) |
| Must Support |
status, class, subject, period |
| Examples |
Khám ngoại trú, Nhập viện |
VNCoreCondition
VNCoreObservationLab
| Hạng mục |
Giá trị |
| Resource gốc |
Observation |
| Mô tả |
Kết quả xét nghiệm với mã LOINC VN |
| Căn cứ |
QĐ 1227/2025, TT 13/2025 |
| Must Support |
code, value[x], subject, status |
| Examples |
Glucose máu |
VNCoreObservationVitalSigns
| Hạng mục |
Giá trị |
| Resource gốc |
Observation |
| Mô tả |
Sinh hiệu (mạch, huyết áp, nhiệt độ, SpO2) |
| Căn cứ |
TT 13/2025 (bệnh án điện tử — phần sinh hiệu) |
| Must Support |
code, value[x], subject, status, effectiveDateTime |
| Examples |
Sinh hiệu |
VNCoreObservationYHCT
| Hạng mục |
Giá trị |
| Resource gốc |
Observation |
| Mô tả |
Quan sát Y học cổ truyền: lưỡi chẩn, mạch chẩn, triệu chứng YHCT |
| Căn cứ |
QĐ 2552/2025, QĐ 3080/2025 (YHCT Đợt 1 & 2) |
| Must Support |
code, value[x], subject, status |
| Examples |
Mạch chẩn |
VNCoreAllergyIntolerance
| Hạng mục |
Giá trị |
| Resource gốc |
AllergyIntolerance |
| Mô tả |
Tiền sử dị ứng với mã SNOMED CT VN |
| Căn cứ |
QĐ 2805/2025 (SNOMED CT VN — Allergy) |
| Must Support |
code, patient, clinicalStatus |
| Examples |
Dị ứng Penicillin |
VNCoreProcedure
| Hạng mục |
Giá trị |
| Resource gốc |
Procedure |
| Mô tả |
Thủ thuật/phẫu thuật với mã ICD-9-CM VN |
| Căn cứ |
QĐ 387/QĐ-BYT (2026), TT 23/2024 |
| Must Support |
code, subject, status |
| Examples |
Phẫu thuật cắt ruột thừa |
VNCoreMedicationRequest
| Hạng mục |
Giá trị |
| Resource gốc |
MedicationRequest |
| Mô tả |
Đơn thuốc điện tử (ePrescription) — ngoại trú, nội trú, cấp cứu. Mã hóa thuốc bằng ATC (WHO) hoặc SNOMED CT. Liên kết BHYT qua Coverage/Claim |
| Căn cứ |
TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 3176/QĐ-BYT (trường MA_THUOC), Luật Dược 2016 Điều 74 (kê đơn thuốc) |
| References |
subject → VNCorePatient, encounter → VNCoreEncounter, requester → VNCorePractitioner/PractitionerRole/Organization, insurance → VNCoreCoverage |
| Binding |
reasonCode → VNConditionCodeVS (extensible) |
| Must Support |
status, intent, medication[x], subject, authoredOn, requester, dosageInstruction |
| Examples |
Đơn thuốc Amoxicillin ngoại trú |
VNCoreMedication
| Hạng mục |
Giá trị |
| Resource gốc |
Medication |
| Mô tả |
Thông tin thuốc với mã ATC (WHO) và SNOMED CT |
| Căn cứ |
Luật Dược 2016, QĐ 3176/QĐ-BYT |
| Extensions |
vn-ext-med-registration-number (số đăng ký thuốc) |
| Must Support |
code, status |
| Examples |
Amoxicillin 500mg |
VNCoreServiceRequest
| Hạng mục |
Giá trị |
| Resource gốc |
ServiceRequest |
| Mô tả |
Yêu cầu dịch vụ kỹ thuật / cận lâm sàng: xét nghiệm, CĐHA, thăm dò chức năng, thủ thuật, phẫu thuật, khám chuyên khoa, phục hồi chức năng, YHCT |
| Căn cứ |
TT 13/2025/TT-BYT (bệnh án điện tử), TT 20/2014/TT-BYT + TT 39/2018/TT-BYT (danh mục DVKT), QĐ 3176/QĐ-BYT (trường MA_DVKT) |
| References |
subject → VNCorePatient, encounter → VNCoreEncounter, requester → VNCorePractitioner/PractitionerRole/Organization, reasonReference → VNCoreCondition/ObservationLab, insurance → VNCoreCoverage |
| Binding |
category → VNServiceRequestCategoryVS (extensible), code → VNProcedureCodeVS (extensible), reasonCode → VNConditionCodeVS (extensible), bodySite → VNBodySiteVS (preferred) |
| Must Support |
status, intent, category, code, subject, priority, occurrence[x], authoredOn, requester, reasonCode |
| Examples |
Yêu cầu XN đường huyết, Yêu cầu chụp X-quang ngực |
Nhóm 3: Tài chính
VNCoreCoverage
| Hạng mục |
Giá trị |
| Resource gốc |
Coverage |
| Mô tả |
Thẻ BHYT với 3 format (CCCD/BHXH/cũ), loại đối tượng, nơi ĐKKCB |
| Căn cứ |
Luật BHYT, NĐ 188/2025, QĐ 3176 |
| Extensions |
vn-ext-bhyt-card-type, vn-ext-primary-care-facility |
| Must Support |
identifier[BHYT], beneficiary, status, type |
| Ghi chú |
Số thẻ BHYT được model trong Coverage.identifier (chuẩn FHIR R4). subscriberId giữ lại cho backward-compatible nhưng không còn Must Support |
| Examples |
BHYT mới (CCCD), BHYT cũ (15 ký tự) |
VNCoreClaim
| Hạng mục |
Giá trị |
| Resource gốc |
Claim |
| Mô tả |
Yêu cầu thanh toán chi phí KCB BHYT. Mapping từ chuẩn dữ liệu XML 4210 → QĐ 130 → QĐ 3176. Bảng kê chi phí theo QĐ 697/QĐ-BYT (14 mã, 12 danh mục) |
| Căn cứ |
QĐ 3176/QĐ-BYT (29/10/2024), QĐ 697/QĐ-BYT (19/3/2026), NĐ 188/2025/NĐ-CP, Luật BHYT |
| References |
patient → VNCorePatient, provider → VNCoreOrganization/Practitioner, insurance.coverage → VNCoreCoverage |
| Binding |
diagnosis → VNConditionCodeVS (ICD-10 VN + YHCT), procedure → VNProcedureCodeVS (ICD-9-CM), item.category → VNCostCategoryVS (14 mã per QĐ 697) |
| Must Support |
status, type, use, patient, provider, insurance, diagnosis, item, total |
| Examples |
Thanh toán BHYT nội trú |
VNCoreClaimResponse
| Hạng mục |
Giá trị |
| Resource gốc |
ClaimResponse |
| Mô tả |
Phản hồi thanh toán BHYT từ cơ quan BHXH |
| Căn cứ |
QĐ 3176/QĐ-BYT, QĐ 697/QĐ-BYT |
| Must Support |
status, type, use, patient, outcome |
| Examples |
Phản hồi thanh toán BHYT |
VNCoreExplanationOfBenefit
| Hạng mục |
Giá trị |
| Resource gốc |
ExplanationOfBenefit |
| Mô tả |
Giải trình quyền lợi BHYT — tổng hợp chi phí, mức hưởng, đồng chi trả |
| Căn cứ |
QĐ 697/QĐ-BYT (19/3/2026), NĐ 188/2025/NĐ-CP |
| Must Support |
status, type, use, patient, outcome, insurance |
| Examples |
Giải trình quyền lợi BHYT |
Nhóm 4: Tài liệu & CLS
VNCoreDocumentReference
| Hạng mục |
Giá trị |
| Resource gốc |
DocumentReference |
| Mô tả |
Tài liệu y tế: bệnh án điện tử, phiếu kết quả XN, phim CĐHA, đơn thuốc, giấy chuyển viện |
| Căn cứ |
TT 13/2025/TT-BYT (bệnh án điện tử), NĐ 137/2024/NĐ-CP (chữ ký số), QĐ 1332/QĐ-BYT (Sổ SKĐT VNeID), Luật 91/2025 (BVDLCN) |
| References |
subject → VNCorePatient, author → VNCorePractitioner/Org, custodian → VNCoreOrganization, context.encounter → VNCoreEncounter |
| Must Support |
status, type, subject, author, custodian, content, content.attachment.contentType |
| Examples |
Bệnh án điện tử |
VNCoreDiagnosticReport
| Hạng mục |
Giá trị |
| Resource gốc |
DiagnosticReport |
| Mô tả |
Kết quả cận lâm sàng: xét nghiệm (XN), chẩn đoán hình ảnh (CĐHA), giải phẫu bệnh (GPB) |
| Căn cứ |
TT 13/2025/TT-BYT, QĐ 1227/2025 (CLS quốc gia) |
| Must Support |
status, code, subject, result, category |
| Examples |
Kết quả XN |
Nhóm 5: Trang thiết bị
VNCoreDevice
| Hạng mục |
Giá trị |
| Resource gốc |
Device |
| Mô tả |
Trang thiết bị y tế |
| Căn cứ |
NĐ 74/2025/NĐ-CP |
| Extensions |
vn-ext-device-insurance-scope (phạm vi BH TBYT) |
| Must Support |
type, status |
| Examples |
VTYT |
VNCoreDeviceUseStatement
| Hạng mục |
Giá trị |
| Resource gốc |
DeviceUseStatement |
| Mô tả |
Sử dụng TBYT cho bệnh nhân — ghi nhận việc sử dụng vật tư, thiết bị cho bệnh nhân |
| Căn cứ |
NĐ 74/2025/NĐ-CP |
| Must Support |
status, subject, device |
| Examples |
Sử dụng VTYT |
English Summary
VN Core IG v0.1.0 defines 23 FHIR R4 profiles across five groups: Administrative (Patient, Practitioner, PractitionerRole, Organization, Address), Clinical (Encounter, Condition, Observation Lab/VitalSigns/YHCT, AllergyIntolerance, Procedure, MedicationRequest, Medication, ServiceRequest), Financial (Coverage, Claim, ClaimResponse, ExplanationOfBenefit), Document & Diagnostics (DocumentReference, DiagnosticReport), and Device (Device, DeviceUseStatement). Each profile includes Vietnam-specific constraints, extensions, terminology bindings, and at least one example instance.
