Omi HealthTech · v0.6.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 134 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ủ 73 profiles · 139 CodeSystems · 144 ValueSets · 195 ví dụ và 6 ConceptMaps ưu tiên cho terminology/BHYT.

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

Phiên bản v0.6.0

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

VN Core v0.6.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.

73

Profiles

139

CodeSystems

144

ValueSets

210

Examples

134

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/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ử.

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Đ-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 16 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.

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/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ữ.

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

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".

Mở bản đồ đọc đầy đủ Bắt đầu với VN Core

38

bài kiến thức

134

văn bản đối chiếu

73

profiles VN Core

139

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ò

CIO bệnh viện

Roadmap, rủi ro, EMR và BHYT

Lập trình viên

API, payload, validation, Bundle

Bác sĩ và nghiệp vụ

Ý nghĩa dữ liệu, hồ sơ bệnh án, thuật ngữ

Cơ quan quản lý

Governance, pháp lý, dữ liệu nhạy cảm

Bài nổi bật

VN Core Deep Dive

Bản đồ artifact VN Core

Đọc 73 profiles, 139 CodeSystems, 144 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.

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à 132 nguồn.

v0.6.0 06/2026 Hiện hành

Quản lý chăm sóc + KSK liên thông + Tương tác quốc tế (IPS)

73 Profiles · 48 Extensions · 139 CodeSystems · 144 ValueSets

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 Q1/2027 Dự kiến

Gia cố pháp lý + chiều sâu liên thông + khám từ xa

Đào sâu quyền riêng tư/kiểm toán theo Luật 91/2025/QH15, NĐ 356/2025/NĐ-CP và Luật 116/2025/QH15; mở rộng ConceptMap YHCT/SNOMED, điều phối Task, đơn thuốc điện tử và khám từ xa. Các mốc pháp lý 2026 được xử lý bằng ngày hiệu lực rõ ràng.

v0.8.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.

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.

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.