Triển khai
Ba lộ trình cụ thể để đưa VN Core vào thực tế.
Bệnh viện, vendor, và cơ quan nhà nước có ba xuất phát điểm khác nhau. Trang này ghi lại playbook tham khảo cho từng nhóm — gắn trực tiếp với deadline TT 13/2025, QĐ 697/QĐ-BYT và Luật 91/2025/QH15.
Playbook · Bệnh viện / Cơ sở KCB
Đáp ứng EMR và liên thông BHYT đúng lộ trình pháp lý
VN Core giúp bệnh viện chuẩn hóa dữ liệu nhân khẩu học, lượt khám, chẩn đoán, dược, cận lâm sàng và thanh toán BHYT trên nền FHIR R4 — song hành cùng format XML 4210/3176 đang sử dụng, thay vì thay thế ngay.
Các bước chính
-
Tháng 1
Khảo sát và mapping dữ liệu
Rà soát các hệ thống đang dùng (HIS, EMR, LIS, PACS). Đối chiếu trường dữ liệu hiện có với Patient, Encounter, Condition, Observation, Claim theo VN Core.
Output: Bản mapping HIS ↔ FHIR + danh sách gap dữ liệu
-
Tháng 2–3
Thí điểm nhân khẩu học và lượt khám
Dựng FHIR endpoint nội bộ (HAPI FHIR hoặc tương đương) và push Patient/Encounter từ HIS. Dùng CCCD làm identifier chính; bổ sung BHXH, BHYT theo ngữ cảnh.
Output: Pilot 1–2 khoa với Patient + Encounter theo VN Core
-
Tháng 4–5
Mở rộng Lab, CĐHA, Dược
Push DiagnosticReport (Lab/Imaging), Observation (kết quả xét nghiệm), MedicationDispense. Mapping với bộ mã QĐ 1227/QĐ-BYT (chỉ số cận lâm sàng) và SNOMED CT VN.
Output: Pilot toàn khoa KCB có đầy đủ lab + dược
-
Tháng 6
Đồng bộ BHYT và bảng kê chi phí
Tạo Coverage (thẻ BHYT), Claim và ExplanationOfBenefit theo QĐ 3176/QĐ-BYT. Chuẩn bị bảng kê chi phí 12 nhóm theo QĐ 697/QĐ-BYT (hiệu lực pháp lý 19/03/2026, hạn triển khai phần mềm 01/07/2026).
Output: Liên thông BHXH qua cả XML 4210 và FHIR Claim/EOB
-
Tháng 7+
Conformance và rollout toàn viện
Chạy validation theo CapabilityStatement, ký kết Consent/AuditEvent theo Luật 91/2025, mở rộng sang YHCT (QĐ 2552 + QĐ 3080) và SNOMED CT VN đầy đủ.
Sai lầm thường gặp
- Dùng VNeID làm identifier người bệnh: sai — VNeID chỉ ở lớp ứng dụng người dân, CCCD mới là identifier lõi.
- Bỏ luôn XML 4210 để chuyển sang FHIR: rủi ro — hiện chưa có văn bản thay thế chính thức, nên chạy song song.
- Dùng danh mục 63 tỉnh cũ: sai — NQ 202/2025 quy định 34 tỉnh/TP, bỏ cấp huyện từ 01/07/2025.
- Bỏ qua DPIA và Consent: vi phạm NĐ 356/2025/NĐ-CP và Luật 91/2025/QH15 (hiệu lực 01/01/2026).
Playbook · Vendor HIS / EMR / LIS / Middleware
Rút ngắn thời gian tích hợp với nhiều bệnh viện bằng một ngôn ngữ dữ liệu chung
Khi bệnh viện đòi hỏi liên thông FHIR theo VN Core, vendor có hai lựa chọn: viết adapter riêng cho mỗi khách hàng, hoặc chuẩn hóa một lần theo VN Core và tái sử dụng. Tùy chọn thứ hai là định hướng bền vững.
Các bước chính
-
Tuần 1–2
Thiết lập môi trường dev
Dựng HAPI FHIR hoặc Azure FHIR Service. Cài SUSHI + IG Publisher. Clone VN Core IG và build thành công trên máy dev.
Output: Môi trường dev chạy được VN Core IG
-
Tuần 3–4
Triển khai layer tương thích
Thiết kế adapter chuyển HIS native schema → FHIR resources theo VN Core. Ưu tiên Patient, Encounter, Observation trước.
Output: Adapter Patient + Encounter passing validation
-
Tháng 2–3
Conformance và validation
Chạy FHIR Validator với VN Core IG. Xử lý tất cả errors; chấp nhận warnings có lý do rõ ràng. Tích hợp CI để validate mỗi commit.
Output: CI green cho toàn bộ resource coverage
-
Tháng 4+
Triển khai tại khách hàng
Pilot với 1–2 bệnh viện khách hàng. Thu thập feedback về edge case, viết implementation report. Đóng góp ngược về VN Core IG qua issue/PR.
Sai lầm thường gặp
- Hardcode danh mục tỉnh/xã: sai — danh mục ĐVHC thay đổi (NQ 202/2025); phải dùng CodeSystem của VN Core để update được.
- Chỉ validate local: không phát hiện thiếu Must Support. Luôn chạy FHIR Validator chính thức với VN Core IG.
- Bỏ qua Extensions VN: các trường như dân tộc, thẻ BHYT, tuyến KCB là đặc thù VN — không thể dùng US Core thay thế.
- Tạo profile riêng của vendor song song VN Core: phân mảnh hệ sinh thái; nên góp ý vào VN Core qua cộng đồng.
Playbook · Cơ quan nhà nước / BYT / BHXH / Sở Y tế
Điều phối chuẩn dữ liệu liên thông trên quy mô ngành
VN Core là sáng kiến cộng đồng mở, chưa phải tiêu chuẩn quốc gia chính thức. Các cơ quan có thể tham khảo để xây dựng hướng dẫn kỹ thuật, bổ trợ XML 4210, hoặc tài liệu hóa các quyết định sắp ban hành (Consent, EMR interoperability).
Các bước chính
-
Giai đoạn 1
Tham khảo và phản biện
Đội ngũ kỹ thuật của Cục/Sở xem xét VN Core IG, xác nhận khớp thực tế nghiệp vụ, gửi phản biện qua kênh chính thức.
-
Giai đoạn 2
Pilot phối hợp
Chọn 3–5 bệnh viện công (cả tuyến TW và tuyến xã theo mô hình 2 cấp mới) để pilot VN Core. BHXH tham gia thử Claim/EOB.
-
Giai đoạn 3
Chính thức hóa từng phần
Đưa các mảng phù hợp vào thông tư/quyết định (ví dụ: nhân khẩu học, thẻ BHYT, mã cận lâm sàng). Giữ tính tương thích ngược với XML 4210/3176.
-
Giai đoạn 4
Hỗ trợ thành lập HL7 Vietnam
Công nhận HL7 Vietnam là tổ chức thành viên chính thức của HL7 International; chuyển giao quyền quản trị VN Core cho HL7 Vietnam khi đủ điều kiện.
Sai lầm thường gặp
- Ban hành standard trước khi có pilot thực tế: rủi ro mismatch với nghiệp vụ. VN Core ưu tiên pilot trước, chuẩn hóa sau.
- Khóa cứng vào một vendor duy nhất: VN Core mở theo CC-BY-4.0, bất kỳ vendor nào cũng triển khai được.
- Bỏ qua interoperability quốc tế: VN Core dựa trên FHIR R4 của HL7 International, giữ khả năng trao đổi với JP Core, KR Core, US Core.
Tài nguyên tham khảo
Bước tiếp theo
Cần trao đổi về lộ trình cụ thể cho tổ chức của bạn?
Đội ngũ Omi HealthTech sẵn sàng chia sẻ kinh nghiệm triển khai FHIR tại Việt Nam, Nhật Bản, Hàn Quốc và đồng hành trong giai đoạn khởi đầu.