74
Profiles
Omi HealthTech · v0.8.0 · 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 172 văn bản pháp lý hiện hành (TT 13/2025/TT-BYT, NQ 202/2025/QH15, Luật 91/2025/QH15). Phủ 74 profiles · 153 CodeSystems · 156 ValueSets · 201 ví dụ và 12 ConceptMaps ưu tiên cho terminology/BHYT.
Phiên bản v0.8.0
Những gì Omi HealthTech đã xây dựng.
VN Core v0.8.0 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.
153
CodeSystems
156
ValueSets
222
Examples
172
Văn bản pháp lý
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/QH15), 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ử.
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Đ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT → QĐ 697/QĐ-BYT). 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 19 mô hình dữ liệu, 4 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.
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/TT-BYT) 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ữ.
Trung tâm kiến thức
Đọc HL7 như một lộ trình triển khai, không như một glossary rời rạc.
Thư viện 38 bài nối khái niệm HL7/FHIR với pháp lý Việt Nam, artifact VN Core, BHYT, EMR, VNeID và kiểm thử validator. Mỗi bài được viết theo nguyên tắc "chuẩn trước, nhanh sau".
38
bài kiến thức
172
văn bản đối chiếu
74
profiles VN Core
153
CodeSystems
Mô hình đọc 6 lớp
Từ chính sách đến dữ liệu validate được.
Đây là cách Omi tổ chức tri thức triển khai: bắt đầu bằng phạm vi pháp lý, đi qua workflow và artifact, kết thúc ở bundle/validator.
01
Chính sách
Phạm vi pháp lý, dữ liệu nhạy cảm, ranh giới trial-use
02
Workflow
EMR, BHYT, VNeID, chuyển tuyến, đơn thuốc
03
Resource
Patient, Encounter, Observation, Coverage, Claim, Bundle
04
Profile
Must Support, slicing, extension, invariant Việt Nam
05
Terminology
CodeSystem, ValueSet, NamingSystem, ConceptMap
06
Validation
Bundle, validator, sandbox, Working Group feedback
Đọc theo vai trò
Bài nổi bật
VN Core Deep Dive
Bản đồ artifact VN Core
Đọc 74 profiles, 153 CodeSystems, 156 ValueSets, bundles và validation như một hệ thống trước khi vào IG.
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.
EMR · TT 13/2025/TT-BYT
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), mốc hạn EMR toàn quốc 31/12/2026.
BHYT · QĐ 697/QĐ-BYT
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).
Mã chẩn đoán
ICD-10 Việt Nam
QĐ 4469/QĐ-BYT (2020) + QĐ 98/QĐ-BYT (2022 — bổ sung COVID-19). Bộ mã chẩn đoán chuẩn của Bộ Y tế.
Thuật ngữ lâm sàng
SNOMED CT tại Việt Nam
QĐ 2427/QĐ-BYT (Body Structure) + QĐ 2493/QĐ-BYT (Morphologic Abnormality) + QĐ 2805/QĐ-BYT (Allergy + Finding) — 3 đợt phát hành 2025.
Nền tảng pháp lý
Pháp lý 2025–2026 định hình từng quyết định thiết kế.
VN Core không thiết kế trong chân không. Mỗi profile, code system và quyết định kiến trúc đều bám sát pháp lý đang vận hành. Ba mốc dưới đây là trụ cột đang trực tiếp chi phối phiên bản hiện hành; 172 văn bản đầy đủ được rà soát ngày 16/07/2026.
Trụ cột chi phối thiết kế
- · EMR và liên thông bệnh án điện tử
- · Bảo vệ dữ liệu cá nhân và an toàn thông tin
- · Liên thông và thanh toán BHYT
07/2025
TT 13/2025/TT-BYT
Bệnh án điện tử trở thành nhu cầu trung tâm của liên thông y tế.
Tác động lên VN Core
EMR, định danh người bệnh và DocumentReference thành use case chính của VN Core.
01/2026
Luật 91/2025/QH15 + NĐ 356/2025/NĐ-CP
Dữ liệu y tế được đặt dưới yêu cầu bảo vệ dữ liệu cá nhân ở mức cao.
Tác động lên VN Core
Consent, AuditEvent và Provenance được thiết kế ngay từ bộ lõi, không phải bổ sung sau.
03/2026
QĐ 697/QĐ-BYT
Mẫu bảng kê chi phí KCB mới (12 nhóm chi phí, triển khai chính thức 01/07/2026).
Tác động lên VN Core
Định hình cấu trúc Claim/EOB và package liên thông BHYT (bhyt.submission).
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 dùng thử 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
Đợt 1 — Bản công bố công khai
Công bố công khai đầu tiên: nhân khẩu học, gói gửi BHYT, 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
Đợt 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.3 05/2026 Hoàn thành
Sẵn sàng QĐ 697/QĐ-BYT + thư viện pháp lý có cấu trúc + đóng góp CHC
Dòng 0.5 ổn định QĐ 697/QĐ-BYT, danh mục pháp lý và đóng góp thuộc phạm vi lõi cho CHC/TYT xã. Phạm vi chính: bảng kê chi phí 12 nhóm, dịch vụ y tế cơ bản TYT xã, vòng đời mã cơ sở, thiết bị và dấu hiệu hiệu lực trong tương lai; danh mục pháp lý công khai hiện hành là 134 nguồn.
v0.6.1 06/2026 Hoàn thành
Quản lý chăm sóc + KSK liên thông + Tương tác quốc tế (IPS)
Bản phát hành phụ dạng bổ sung, giữ nguyên canonical URL/package id. Trọng tâm: quản lý chăm sóc, KSK cấu trúc theo HL7 SDC, IPS/$summary để trao đổi quốc tế và QĐ 2919/QĐ-BYT; chi tiết kỹ thuật nằm ở changelog/IG.
v0.7.0 07/2026 Hoàn thành
Gia cố dữ liệu BHYT + kiểm toán phát hành + rollover pháp lý 07/2026
Bản gia cố sau kiểm toán hậu phát hành v0.6.1 (v0.6.1 rút lại): sửa nhóm lỗi tài chính BHYT và người ký giấy chuyển tuyến, operations đúng scope, gói bhyt.submission nhận đủ delta XML13–15, rollover trạng thái pháp lý chạm mốc 01/07/2026 và corpus 145 văn bản (rà soát bổ sung 8 văn bản đợt hiệu lực 01/07/2026); công bố đúng SemVer 3 breaking change tồn đọng kèm hướng dẫn migration. Phần chiều sâu liên thông/khám từ xa của kế hoạch 0.7.0 cũ chuyển sang chu kỳ v0.8.0.
v0.8.0 07/2026 Hiện hành
Tái cấu trúc dữ liệu KSK theo QĐ 2062/QĐ-BYT + gia cố hậu kiểm toán Codex
74 Profiles · 53 Extensions · 153 CodeSystems · 156 ValueSets
Bản minor có thay đổi phá vỡ tương thích: tái cấu trúc dữ liệu khám sức khỏe định kỳ theo QĐ 2062/QĐ-BYT (mẫu phiếu theo nhóm tuổi, danh mục đối tượng mở rộng, kênh liên thông mới) và đợt gia cố chất lượng sau hai vòng kiểm toán độc lập — chuẩn hóa viện dẫn pháp lý theo văn bản ban hành, tách kỷ nguyên terminology kèm bản đồ chuyển đổi, chính sách đặt tên bền vững (ADR-0017). v0.7.0 đóng băng nguyên trạng; kho pháp lý 172 văn bản. Chi tiết: Lịch sử thay đổi.
v0.9.0 Q2/2027 Dự kiến
Nền tảng & sử dụng thứ cấp + phản hồi triển khai
Mở năng lực nền tảng khi có phản hồi triển khai đủ điều kiện rà soát: Bulk Data, SMART-on-FHIR, báo cáo chất lượng, Subscription theo ca sử dụng, khử định danh và chốt kiểm soát Provenance. Phạm vi điều chỉnh theo bằng chứng triển khai và văn bản mới. Tiếp nhận phần chiều sâu liên thông (YHCT/SNOMED ConceptMap, Task, đơn thuốc điện tử, khám từ xa) dời từ kế hoạch chu kỳ trước. Gỡ hẳn extension vn-ext-encounter-code (retired từ v0.7.0 — dời từ kế hoạch v0.8.0 để kéo dài cửa sổ migration).
v1.0.0 Mục tiêu Q3/2027 Dự kiến
STU1 — Phiên bản ổn định, chuẩn bị quản trị chính thức
Mục tiêu ổn định sau khi báo cáo triển khai được công bố hoặc đủ điều kiện rà soát, kiểm thử tuân thủ theo phạm vi thống nhất và ConceptMap ưu tiên XML đầu ra KCB ↔ FHIR được kiểm tra hợp lệ theo phạm vi. Hồ sơ Affiliate chỉ chuẩn bị khi quản trị đủ điều kiện.
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.
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.