Omi HealthTech · v0.5.1 · FHIR R4 · CC-BY-4.0

Bộ lõi HL7 FHIR căn cứ pháp lý cho y tế Việt Nam.

Omi HealthTech xây dựng và công bố VN Core — bộ Hướng dẫn Triển khai HL7 FHIR R4 cho y tế Việt Nam, bám sát 101 văn bản pháp lý hiện hành (TT 13/2025, NQ 202/2025, Luật 91/2025). Phủ 52 profiles · 71 CodeSystems · 76 ValueSets · 158 ví dụ và toàn bộ mapping XML 4210 cho BHYT.

Khám phá kiến thức FHIR Bắt đầu với IG kỹ thuật

Phiên bản v0.5.1

Những gì Omi HealthTech đã xây dựng.

VN Core v0.5.1 là kết quả của quá trình nghiên cứu pháp lý, phân tích nghiệp vụ y tế và thiết kế kỹ thuật FHIR. Toàn bộ được công bố mở theo giấy phép CC-BY-4.0.

52

Profiles

71

CodeSystems

76

ValueSets

131

Examples

101

Văn bản pháp lý

Xem artifacts Tải xuống

Giải pháp theo nhóm triển khai

Được thiết kế cho ba nhóm triển khai chính.

01

Cho đội HIS, EMR và HSSK

Dữ liệu nền thống nhất, giảm thời gian tích hợp.

Vấn đề

Hiện tại, mỗi hệ thống HIS/EMR biểu diễn người bệnh, lượt khám và kết quả xét nghiệm theo cách riêng. Khi cần trao đổi dữ liệu, đội kỹ thuật phải viết ánh xạ riêng cho từng đầu mối.

VN Core giải quyết

VN Core định nghĩa sẵn cách biểu diễn chuẩn cho CCCD, địa chỉ 2 cấp (34 tỉnh + xã theo NQ 202/2025), thông tin nền bệnh nhân, chẩn đoán ICD-10 VN, kết quả xét nghiệm và tài liệu bệnh án điện tử.

Profiles và Must Support Tuân thủ theo vai trò

02

Cho đội gateway và tích hợp BHYT

Lõi FHIR tách riêng khỏi lớp liên thông bảo hiểm.

Vấn đề

Quy tắc thanh toán BHYT thay đổi liên tục (QĐ 130 → QĐ 4750 → QĐ 3176 → QĐ 697). Nếu trộn logic bảo hiểm vào mô hình dữ liệu chung, mỗi đợt cập nhật sẽ phá vỡ toàn bộ hệ thống.

VN Core giải quyết

VN Core tách riêng gói lõi (core.base) và gói liên thông BHYT (bhyt.submission) với 13 mô hình dữ liệu, 3 thao tác nghiệp vụ và bộ ví dụ chuyển đổi khứ hồi. Mỗi đội triển khai chỉ cần sử dụng đúng gói phù hợp.

Kiến trúc 5 gói phát hành BHYT Submission

03

Cho đội QA, pháp lý và quản lý dự án

An toàn dữ liệu và tuân thủ pháp lý ngay từ thiết kế.

Vấn đề

Luật BVDLCN (91/2025) coi dữ liệu y tế là nhạy cảm. Bệnh án điện tử (TT 13/2025) bắt buộc liên thông. Nếu consent, audit và truy vết chỉ được bổ sung sau, chi phí sửa sẽ rất lớn.

VN Core giải quyết

VN Core tích hợp Consent, AuditEvent và Provenance ngay trong bộ lõi. Ma trận pháp lý ánh xạ từng văn bản đến từng nhóm tài nguyên. Bộ script kiểm tra tự động giúp đội triển khai và đội pháp lý nói chung một ngôn ngữ.

Bảo mật và quyền riêng tư Cơ sở pháp lý

Trung tâm kiến thức

Trước khi triển khai, cần hiểu nền tảng.

Trung tâm kiến thức tổng hợp các bài giải thích về HL7, FHIR, các bộ mã thuật ngữ và khung pháp lý y tế Việt Nam — viết cho người triển khai HIS, EMR, gateway BHYT và đội QA/pháp lý.

Nền tảng

FHIR là gì?

RESTful API, JSON/XML, 146 Resources — chuẩn dữ liệu y tế của HL7 International, nền tảng cho VN Core.

Đọc bài

EMR · TT 13/2025

FHIR trong bệnh án điện tử

Liên thông EMR theo TT 13/2025/TT-BYT (hiệu lực 21/7/2025), deadline EMR toàn quốc 31/12/2026.

Đọc bài

BHYT · QĐ 697

FHIR và BHYT

Mapping XML 4210 sang FHIR Claim/Coverage; chuẩn bị cho mẫu bảng kê chi phí KCB mới (QĐ 697/QĐ-BYT).

Đọc bài

Mã chẩn đoán

ICD-10 Việt Nam

QĐ 4469/QĐ-BYT (2020) + QĐ 98 (2022 — bổ sung COVID-19). Bộ mã chẩn đoán chuẩn của Bộ Y tế.

Đọc bài

Thuật ngữ lâm sàng

SNOMED CT tại Việt Nam

QĐ 2427 (Body Structure) + QĐ 2493 (Morphologic Abnormality) + QĐ 2805 (Allergy + Finding) — 3 đợt phát hành 2025.

Đọc bài

FAQ tổng hợp

Câu hỏi thường gặp

Giải đáp các câu hỏi phổ biến về FHIR, VN Core, BHYT, EMR, kiến trúc package và khung pháp lý.

Đọc bài

Xem 30 bài kiến thức đầy đủ

Lộ trình sản phẩm

Phát hành theo nhịp pháp lý, không theo nhịp tính năng.

Mỗi phiên bản VN Core ra đời gắn với một đợt thay đổi pháp lý. Omi HealthTech theo dõi liên tục và cập nhật để bộ lõi phản ánh đúng khung vận hành hiện hành.

v0.1.0 03/2026 Hoàn thành

Dự thảo cộng đồng khởi điểm

Nền tảng ban đầu cho Profiles, Extensions, bộ mã và ví dụ dữ liệu.

v0.2.0 03/2026 Hoàn thành

Rà soát nội bộ

Củng cố quy tắc tuân thủ, cách công bố và chuẩn bị trước khi công bố rộng rãi.

v0.3.0 03/2026 Hoàn thành

Wave 1 — Bản công bố công khai

Công bố công khai đầu tiên: nhân khẩu học, BHYT Submission, thuật ngữ nền tảng và các kịch bản ngoại trú.

v0.4.0 04/2026 Hoàn thành

Wave 2 — Mở rộng CĐHA, Dược, Thiết bị, Khoa phòng

Bổ sung 6 profiles mới và cập nhật căn cứ pháp lý 2025-2026.

v0.5.1 05/2026 Hiện hành

Sẵn sàng QĐ 697 + structured legal reference

52 Profiles, 47 Extensions, 71 CodeSystems, 76 ValueSets; Bảng kê chi phí 12 nhóm theo QĐ 697/QĐ-BYT (deadline 01/07/2026), VNLegalDocumentRefCS 101 văn bản, device cluster hardening (registration number, class A/B/C/D), audit tooling và future-effective marker.

v0.6.0 Q3/2026 Kế tiếp

Consent + AuditEvent + nội trú/chuyển tuyến

Hardening Consent + AuditEvent theo Luật 91/2025 (BVDLCN) và NĐ 356/2025; mở rộng kịch bản nội trú, chuyển tuyến, cấp cứu; YHCT mapping (QĐ 2552 + QĐ 3080) đầy đủ; ePrescription workflow theo TT 26/2025.

v0.7.0 Q1/2027 Dự kiến

Phủ EMR toàn quốc & SNOMED Đợt 3

Bám deadline TT 13/2025 (100% CSKCB EMR trước 31/12/2026; ngừng bệnh án giấy 01/01/2027); SNOMED CT VN Đợt 3 (QĐ 2805 Allergy + Finding); secondary-use data access và FHIR Bulk Data ($export); SMART-on-FHIR App Launch guidance.

v0.8.0 Q2/2027 Dự kiến

Bảo trì theo phản hồi thí điểm

Điều chỉnh theo phản hồi thực tế từ ≥5 CSKCB thí điểm, các đợt cập nhật pháp lý và nhu cầu vận hành phát sinh; AI-ready data, de-identification và provenance guardrails.

v1.0.0 Mục tiêu Q3/2027 Dự kiến

STU1 — Phiên bản ổn định, sẵn sàng HL7 Affiliate

Implementation reports từ ≥5 pilot sites, conformance testing đầy đủ, ConceptMap XML đầu ra KCB (QĐ 3176/QĐ-BYT, 12 loại XML1-XML12) ↔ FHIR hoàn chỉnh; nền tảng kỹ thuật cho hồ sơ HL7 Affiliate Việt Nam; sẵn sàng adoption rộng rãi.

Xem lộ trình đầy đủ Quy tắc phát hành (IG kỹ thuật)

Hợp tác cùng Omi

VN Core cần cộng đồng để đi từ bản thử nghiệm sang thực tế.

Omi HealthTech đã xây dựng nền tảng kỹ thuật. Bước tiếp theo là thí điểm, phản biện và hoàn thiện cùng những người sẽ sử dụng VN Core trong thực tế hàng ngày.

Liên hệ hợp tác

Bệnh viện và cơ sở KCB

Thí điểm VN Core trong hệ thống EMR/HIS đang vận hành, góp ý từ thực tế lâm sàng.

Nhà cung cấp HIS, EMR, LIS

Tích hợp VN Core vào sản phẩm, đóng góp profiles và ví dụ dữ liệu từ triển khai thực tế.

Chuyên gia y tế và thuật ngữ

Rà soát bộ mã, kiểm tra tính chính xác lâm sàng và đề xuất bổ sung phạm vi.

Cơ quan quản lý y tế và tổ chức quốc tế

Bộ Y tế, Trung tâm Thông tin Y tế Quốc gia, các bộ ban ngành liên quan và tổ chức quốc tế cùng đánh giá, phản biện và định hướng chuẩn dữ liệu y tế quốc gia.