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

Dữ liệu y tế trao đổi thống nhất bằng HL7 FHIR.

VN Core là Hướng dẫn Triển khai HL7 FHIR R4 trial-use do Omi HealthTech duy trì cho trao đổi dữ liệu y tế tại Việt Nam. Phiên bản v0.9.0 công bố 86 Profiles, 165 CodeSystems, 168 ValueSets, 227 thực thể ví dụ và 17 ConceptMaps; danh mục pháp lý gồm 209 mục đã đối chiếu, trong đó 170 mục đang có hiệu lực.

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

Phiên bản v0.9.0

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

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

86

Profiles

165

CodeSystems

168

ValueSets

249

Examples

209

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). Gói BHYT hiện có 16 logical models (Check-in và XML1–XML15), 3 OperationDefinitions và các ví dụ kiểm thử. Mỗi đội triển khai chỉ cần sử dụng đúng gói phù hợp.

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

03

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

Đưa an toàn dữ liệu và yêu cầu pháp lý vào quyết định thiết kế.

Vấn đề

Luật 91/2025/QH15 xếp dữ liệu y tế vào nhóm nhạy cảm; TT 13/2025/TT-BYT đặt lộ trình EMR và yêu cầu kết nối định danh. Mỗi luồng vẫn phải xác định vai trò, căn cứ xử lý, event matrix và kiểm soát phù hợp.

VN Core giải quyết

VN Core công bố profile trial-use cho Consent, AuditEvent và Provenance, cùng ma trận tham chiếu pháp lý và script kiểm tra kỹ thuật. Các artifact này hỗ trợ review nhưng không tự tạo ra hoặc chứng minh tuân thủ pháp luật.

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

209

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

86

profiles VN Core

165

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 86 profiles, 165 CodeSystems, 168 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ử

TT 13/2025/TT-BYT: mốc 30/9/2025 cho bệnh viện và 31/12/2026 cho các cơ sở KCB khác thuộc phạm vi lộ trình.

BHYT · QĐ 697/QĐ-BYT

FHIR và BHYT

Mô hình Claim/Coverage và đặc tả adapter có version cho schema đầu ra BHYT; không coi ConceptMap là phép đổi toàn bộ XML.

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à 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 Hoàn thà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

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 giai đoạn hiệu lực 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 Q3/2026 Hiện hành

Bảng kê chi tiết BHYT, quyết toán quý và siết ngữ nghĩa artifact

86 Profiles · 56 Extensions · 165 CodeSystems · 168 ValueSets

Bản minor có thay đổi phá vỡ tương thích, tập trung vào trục thanh toán BHYT: bảng kê chi phí chi tiết nhiều giai đoạn theo QĐ 697/QĐ-BYT và biên bản quyết toán quý Mẫu số 06/BH theo TT 12/2026/TT-BTC. 100% artifact (618/618) mang căn cứ pháp lý máy-đọc-được kèm cổng chặn thoái lui; kho pháp lý đạt 209 văn bản. Khép trọn 15/15 StructureMap bảng XML BHYT, đơn thuốc điện tử (hóa dược và y học cổ truyền), đặt lịch khám từ xa, nhật ký truy cập khẩn cấp theo IHE BALP. Breaking: gỡ extension vn-ext-encounter-code; v0.8.0 đóng băng nguyên trạng.

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. Bản này cũng là nơi mở bốn hạng mục phụ thuộc bằng chứng bên ngoài, mỗi hạng mục có điều kiện kích hoạt rõ: Subscription (khi có ≥1 cơ sở KCB hoặc bên chi trả nêu yêu cầu sự kiện cụ thể), bộ mã thuốc VNMedicationCodeVS và mô hình định danh thuốc đầy đủ (khi sandbox Cơ sở dữ liệu Dược cấp quyền truy cập danh mục drug_id), đặc tả trao đổi hồ sơ bệnh án điện tử với EMR HUB (khi Trung tâm Thông tin Y tế Quốc gia công bố API chính thức), và Bulk Data ở mức triển khai có kiểm thử (khi có máy chủ pilot).2.

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.