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.
Lộ trình
Sản phẩm bám sát pháp lý, pháp lý định hình sản phẩm.
Mỗi phiên bản VN Core ra đời gắn với một đợt thay đổi pháp lý. Trang này tổng hợp toàn bộ cột mốc sản phẩm, các VBPL chi phối thiết kế, và quy tắc phát hành để các đội triển khai có thể lập kế hoạch đồng bộ.
Lộ trình sản phẩm
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
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.
Pháp lý chi phối thiết kế
07/2024 TT 17/2024/TT-BCA
Căn cứ cho số định danh cá nhân/CCCD và quy tắc validation định danh công dân.
Ảnh hưởng: Identifier slicing trong VNCorePatient.
10/2024 TT 23/2024/TT-BYT
Danh mục kỹ thuật hiện hành thay TT 43/2013/TT-BYT — định hình lại phân loại dịch vụ kỹ thuật.
Ảnh hưởng: CodeSystem DVKT, ValueSet dịch vụ.
12/2024 QĐ 4152/QĐ-BYT
Kiến trúc số Bộ Y tế chuyển sang khung 3.0, nhấn mạnh dữ liệu dùng chung.
Ảnh hưởng: Định hướng architecture của VN Core.
06/2025 QĐ 2010/QĐ-BYT
54 mã khoa/phòng dùng chung — nền tảng cho VNCoreOrganizationDepartment.
Ảnh hưởng: CodeSystem vn-department-cs.
07/2025 NQ 202/2025/QH15 + TT 13/2025/TT-BYT + NĐ 163/2025/NĐ-CP
Mô hình 34 tỉnh, yêu cầu và lộ trình bệnh án điện tử, NĐ 163/2025/NĐ-CP thay NĐ 54/2017/NĐ-CP về Luật Dược.
Ảnh hưởng: CodeSystem ĐVHC 2 cấp, tài liệu EMR và Medication profiles.
07-08/2025 QĐ 2427/QĐ-BYT + QĐ 2493/QĐ-BYT
SNOMED CT Việt Nam Đợt 1 (Body Structure) và Đợt 2 (Morphologic Abnormality).
Ảnh hưởng: ConceptMap SNOMED CT VN cho BodySite.
11/2025 QĐ 3516/QĐ-BYT
Chiến lược chuyển đổi số đẩy trọng tâm về dữ liệu, CCCD và EMR/HSSK.
Ảnh hưởng: Priority profiles hướng đến EMR và HSSK.
01/2026 Luật 91/2025/QH15 + NĐ 356/2025/NĐ-CP
Dữ liệu y tế thuộc phạm vi dữ liệu cá nhân nhạy cảm; biện pháp kiểm soát phụ thuộc vai trò, mục đích và căn cứ xử lý.
Ảnh hưởng: Hướng dẫn security/privacy và các profile Consent, AuditEvent, Provenance khi use case yêu cầu.
03/2026 QĐ 697/QĐ-BYT + QĐ 586/QĐ-BYT
Mẫu bảng kê chi phí KCB mới (12 nhóm; hiệu lực 19/03/2026, chuyển tiếp phần mềm hoàn tất 01/07/2026) và kế hoạch EMR toàn quốc 2026.
Ảnh hưởng: Claim/EOB restructure, bảng kê 12 nhóm.
Chính sách phát hành
Semantic versioning, có tính đến thực tế pháp lý VN.
VN Core tuân thủ semver nhưng bổ sung một nhánh "legal-patch" để phản ứng nhanh với văn bản mới. Bản vá pháp lý không kéo theo breaking change về cấu trúc, nhưng có thể thay đổi binding hoặc mã code.
major Theo cổng quản trị
Bản chính (x.0.0)
Breaking change về profile, terminology hoặc canonical contract. Chỉ phát hành sau phân tích tác động, review cộng đồng, migration guide và release candidate đạt tiêu chí nghiệm thu.
minor Theo scope đã duyệt
Bản phụ (x.y.0)
Thay đổi tương thích ngược như thêm artifact hoặc mở rộng phạm vi đã được review. Không ấn định lịch cố định khi chưa đạt tiêu chí chất lượng và governance.
patch Khi cần
Bản vá (x.y.z)
Sửa lỗi và tài liệu không tạo bất tương thích. Mọi thay đổi conformance phải được phân loại theo tác động, không chỉ theo loại file.
legal Sau đánh giá VBPL
Bản cập nhật pháp lý
Văn bản mới được đánh giá hiệu lực, phạm vi và tác động trước khi thay đổi IG. Loại version được chọn theo mức tương thích, không mặc định mọi cập nhật pháp lý là patch.
Về phiên bản 1.0.0
Phiên bản 1.0.0 chỉ nên phát hành sau khi có implementation report từ các CSKCB thí điểm được công bố hoặc đủ điều kiện review, conformance testing đầy đủ, và các đặc tả mapping/transform ưu tiên cho XML đầu ra KCB theo QĐ 3176/QĐ-BYT được validate theo phạm vi đã thống nhất; ConceptMap trong phạm vi này chỉ dùng cho các trường mã hóa. Đây cũng là mốc chuẩn bị nền tảng kỹ thuật cho hồ sơ HL7 Affiliate Việt Nam nếu governance đủ điều kiện.