Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.6.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| URL chính thức: http://fhir.hl7.org.vn/core/ImplementationGuide/hl7.fhir.vn.core | Phiên bản: 0.6.0 | ||||
| Computable Name: VNCoreIG | |||||
VN Core là bộ Hướng dẫn Triển khai HL7 FHIR R4 cốt lõi cho liên thông dữ liệu y tế tại Việt Nam — phiên bản hiện hành v0.6.0.
Đây là bản nháp để cộng đồng rà soát do Omi HealthTech xây dựng. Phiên bản này chưa được cơ quan nhà nước phê duyệt chính thức. Cộng đồng y tế số Việt Nam được khuyến khích sử dụng thử nghiệm và gửi phản hồi qua [email protected].
VN Core FHIR Implementation Guide (IG) xác định lớp Profiles, Extensions, CodeSystems, ValueSets, NamingSystems, SearchParameters, CapabilityStatements và hướng dẫn cốt lõi cho việc trao đổi dữ liệu y tế tại Việt Nam theo HL7 FHIR R4 (4.0.1).
Phiên bản hiện hành được tổ chức theo nguyên tắc:
VN Core Base là lõi FHIR ổn định cho liên thông dùng chungBHYT Submission thành lớp riêng cho liên thông hồ sơ thanh toánMust Support, tìm kiếm, định danh, cơ sở pháp lý, bảo mật và tuân thủ theo vai trò| Artifact | Số lượng | Ghi chú |
|---|---|---|
Profiles |
73 | Bao gồm các profile lâm sàng, hành chính, tài chính, tài liệu và quản trị |
Extensions |
45 cục bộ + 3 chuẩn HL7 | Ưu tiên tái sử dụng extension chuẩn của HL7 cho Patient |
CodeSystems |
139 | Bao gồm các bộ mã nền tảng, BHYT, nghề nghiệp, địa chỉ và hỗ trợ validation |
ValueSets |
144 | Đi cùng các CodeSystem đang dùng trong IG |
NamingSystems |
32 | Bao gồm CCCD, BHYT, BHXH, GKS, GPHN, CCHN, CSKCB, MA_LK, MA_LUOT_KCB |
SearchParameters |
19 | Bao gồm các tham số nghiệp vụ hiện hành; VNeID chỉ còn là artifact lịch sử retired |
CapabilityStatements |
5 | 1 mức cơ sở + 4 theo từng vai trò triển khai |
OperationDefinitions |
4 | $validate-bhyt-claim, $submit-bhyt-claim, $reverse-bhyt-claim |
Examples |
210 tệp / 195 thực thể | Bao gồm positive và negative fixtures cho lớp BHYT Submission |
| Gói | Vai trò | Dùng khi nào |
|---|---|---|
hl7.fhir.vn.core |
Gói tổng hợp | Kiểm tra cục bộ, đào tạo, thử nghiệm nhanh và cài đặt trọn bộ |
hl7.fhir.vn.core.base |
Gói lõi ổn định | EMR, HIE, hồ sơ công dân, dữ liệu dùng chung và liên thông FHIR-native |
hl7.fhir.vn.bhyt.submission |
Gói liên thông hồ sơ thanh toán BHYT | Gateway, adapter, kiểm tra và ánh xạ hồ sơ thanh toán; phụ thuộc hl7.fhir.vn.core.base |
hl7.fhir.vn.terminology.clinical |
Gói thuật ngữ lâm sàng | ICD-10 VN, ICD-9-CM, SNOMED CT VN subset, CLS, LOINC, ConceptMap lâm sàng |
hl7.fhir.vn.terminology.traditional-medicine |
Gói thuật ngữ Y học cổ truyền | Toàn bộ bộ mã Y học cổ truyền hiện hành |
hl7.fhir.vn.device |
Gói thiết bị y tế | Danh pháp thiết bị, DeviceDefinition, regulatory workflow, UDI guidance, kiểm định, asset và procurement khi có use case |
Chi tiết xem tại Kiến trúc gói phát hành.
CCCD là định danh công dân chính; VNeID chỉ được giữ ở lớp ứng dụng người dân hoặc lớp tích hợp/xác thực.VN Core Base và BHYT Submission phải được tách ranh giới để ngữ nghĩa cốt lõi không bị chi phối bởi logic gửi nhận hồ sơ thanh toán.NamingSystems, CodeSystems và ValueSets được coi là hạ tầng của liên thông, không phải phần phụ lục.| Nếu cần | Nên bắt đầu từ |
|---|---|
| Cài thử, build cục bộ và tạo tài nguyên đầu tiên | Bắt đầu nhanh |
| Xác định gói, vai trò triển khai và mức yêu cầu tối thiểu | Tuân thủ theo vai trò triển khai |
Chốt định danh, system URI, trạng thái hiện hành/lịch sử/ngừng dùng |
Danh mục định danh |
| Chốt quy tắc triển khai chung cho tên, địa chỉ, định danh, Organization/Location | Hướng dẫn chung |
| Chốt hành vi tìm kiếm và kiểm tra hợp lệ | Hành vi tìm kiếm, Hướng dẫn kiểm tra hợp lệ |
| Tra cứu căn cứ pháp lý và nền tảng bảo mật | Cơ sở pháp lý, Bảo mật và quyền riêng tư |
| Mục | Nội dung |
|---|---|
| Bắt đầu nhanh | Quy trình cài thử, build và kiểm tra hợp lệ đầu tiên |
| Kiến trúc gói phát hành | Ranh giới của 5 gói và cách tiêu thụ |
| Tuân thủ theo vai trò triển khai | Ma trận vai trò, gói và CapabilityStatements |
| Hướng dẫn chung | Quy tắc chung cho tên, địa chỉ, định danh, Organization/Location |
| Danh mục định danh | Danh mục thực dụng của các NamingSystems |
| Hướng dẫn thuật ngữ | Cách dùng CodeSystems, ValueSets và gói thuật ngữ |
| Bảo mật và quyền riêng tư | Nền tảng pháp lý và kỹ thuật cho dữ liệu nhạy cảm |
| Ổn định và tuân thủ | Mô hình trưởng thành, mô hình tuân thủ và độ ổn định gói |
| Phát hành và quản trị | Ngưỡng phát hành và chính sách hiện hành / lịch sử / ngừng dùng |
| Tải xuống | Gói phát hành và các bộ định nghĩa |
| Lịch sử thay đổi | Delta theo từng phiên bản |
Ưu tiên trước thí điểm: Trước giai đoạn thí điểm, VN Core ưu tiên quản trị dữ liệu, định danh theo CCCD, EMR/HSSK, Đồng bộ BHYT, lớp ứng dụng người dân và tích hợp, LGSP/API facade và nền tảng an toàn trước khi mở rộng thêm phạm vi tài nguyên.
| Mốc | Trạng thái | Ghi chú |
|—|—|—|
| v0.3.0 | Lịch sử | 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 | Lịch sử | Bổ sung 6 profiles mới và cập nhật căn cứ pháp lý 2025-2026 |
| v0.5.3 | Lịch sử | 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 | Hiện hành | 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; 73 profiles, 139 CodeSystems, 144 ValueSets, 6 ConceptMaps |
| v0.7.0 | Dự kiến (Q1/2027) | Đà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 | Dự kiến (Q2/2027) | 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) | 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 |
Chi tiết lịch sử thay đổi xem tại Lịch sử thay đổi và Phát hành và quản trị.
VN Core được xây dựng và duy trì bởi Omi HealthTech. Nội dung được công bố dưới giấy phép CC-BY-4.0. Trang giới thiệu dự án, khung pháp lý và tài liệu kiến thức: hl7.org.vn.
Phiên bản 0.6.0 (Bản nháp để cộng đồng rà soát, 2026-06-04) là bản hiện hành. Đây là bản phát hành phụ dạng bổ sung, không đổi canonical URL, package id hoặc ngữ nghĩa tuân thủ lõi. Điểm mới nên đọc theo bốn cụm: quản lý chăm sóc, KSK có cấu trúc theo HL7 SDC, IPS/$summary để trao đổi quốc tế và QĐ 2919/QĐ-BYT. Quy mô hiện hành: 73 profiles, 48 extensions, 139 CodeSystems, 144 ValueSets, 6 ConceptMaps và danh mục pháp lý công khai 132 mục có nguồn đối chiếu; chi tiết kỹ thuật nằm ở Lịch sử thay đổi và Phát hành và quản trị.
| Kênh | Mục đích |
|---|---|
| [email protected] | Góp ý nội dung, phản biện pháp lý, đề xuất phạm vi |
| Kênh đóng góp kỹ thuật | Gửi đề xuất qua email; mọi thay đổi kỹ thuật cần truy vết, rà soát và căn cứ rõ trước khi merge |
Rà soát từ bệnh viện, nhà cung cấp HIS/EMR/LIS, chuyên gia y tế, người rà soát pháp lý và nhóm QA là đầu vào chính cho các vòng chỉnh sửa tiếp theo.
| Nếu cần | Nên đọc tiếp |
|---|---|
| Bắt đầu cài đặt và chạy thử tài nguyên đầu tiên | Bắt đầu nhanh |
| Hiểu kiến trúc 5 gói mô-đun và 1 gói tổng hợp | Kiến trúc gói phát hành |
| Xác định vai trò triển khai và CapabilityStatement | Tuân thủ theo vai trò |
| Tra cứu hồ sơ, phần mở rộng, thuật ngữ và định danh | Hồ sơ, Phần mở rộng, Thuật ngữ, Định danh |
| Tra cứu căn cứ pháp lý và nền tảng bảo mật | Cơ sở pháp lý, Bảo mật và quyền riêng tư |
This page is the canonical entry point for VN Core. The current 0.6.0 release (June 2026) is an additive minor release with no canonical URL, package-id, or core-conformance change. Its main focus areas are care management, HL7 SDC structured health-checkup capture, IPS/$summary interoperability, and QĐ 2919/QĐ-BYT. Current scope: 73 profiles, 48 extensions, 139 CodeSystems, 144 ValueSets, 6 ConceptMaps, and a 132-source public legal registry; technical detail lives in the changelog and release-governance pages. Built by Omi HealthTech under CC-BY-4.0.