Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
NamingSystem: Số thẻ Bảo hiểm Y tế (BHYT) — Vietnam Health Insurance Card Number
Hệ thống định danh MÃ SỐ Bảo hiểm Y tế, do BHXH Việt Nam cấp.
Namespace này nhận đúng 2 format THẺ (0.8.0 — hậu kiểm toán Codex, thu hẹp từ 3):
- Mã số BHYT 10 chữ số (vận hành từ 01/4/2021; legacy/chuyển tiếp sau CV 1804/BHXH-QLT) — TRÙNG GIÁ TRỊ với mã số BHXH
- Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 (legacy)
CCCD/số định danh cá nhân KHÔNG thuộc namespace này: NĐ 188/2025/NĐ-CP (Mẫu số 3) tách cột
'Mã số BHYT' và 'Số CCCD' riêng — CCCD chỉ là KHOÁ TRA CỨU/XUẤT TRÌNH thay thẻ khi KCB,
biểu diễn bằng Patient.identifier[CCCD] (sid/cccd); trộn CCCD vào sid/bhyt gây nguy cơ
matching sai giữa hai trục định danh.
QUAN HỆ VỚI sid/bhxh: giá trị 10 chữ số của mã số BHYT trùng mã số BHXH — hai namespace
tồn tại song song theo NGỮ CẢNH NGHIỆP VỤ: số thẻ/quyền lợi BHYT (Coverage) dùng sid/bhyt;
sổ/quá trình tham gia BHXH dùng sid/bhxh (xem vn-bhxh-ns). Không suy diễn tự động hai chiều
khi chưa xác minh qua Cổng BHXH (NĐ 164/2025/NĐ-CP). CV 1804/BHXH-QLT chuyển khoá quản lý
người tham gia sang ĐDCN/CCCD từ 01/08/2025 nhưng vẫn cho phép mã 10 số trong giai đoạn
chuyển tiếp; điều này không biến CCCD thành một giá trị hợp lệ của sid/bhyt.
Căn cứ:
- Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
- NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT; Mẫu số 3 tách cột Mã số BHYT / Số CCCD
- NĐ 164/2025/NĐ-CP — 29/6/2025 — giao dịch điện tử BHXH, tra cứu thẻ theo CCCD
- CV 1804/BHXH-QLT — 04/8/2025 — chuyển khoá quản lý sang ĐDCN/CCCD, có giai đoạn chuyển tiếp
- QĐ 3176/QĐ-BYT — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH
- Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.
Summary
| Defining URL | http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-ns |
| Version | 0.10.0 |
| Name | VNBHYT |
| Status | draft |
| Definition | Hệ thống định danh MÃ SỐ Bảo hiểm Y tế, do BHXH Việt Nam cấp.
Namespace này nhận đúng 2 format THẺ (0.8.0 — hậu kiểm toán Codex, thu hẹp từ 3):
- Mã số BHYT 10 chữ số (vận hành từ 01/4/2021; legacy/chuyển tiếp sau CV 1804/BHXH-QLT) — TRÙNG GIÁ TRỊ với mã số BHXH
- Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 (legacy)
CCCD/số định danh cá nhân KHÔNG thuộc namespace này: NĐ 188/2025/NĐ-CP (Mẫu số 3) tách cột
'Mã số BHYT' và 'Số CCCD' riêng — CCCD chỉ là KHOÁ TRA CỨU/XUẤT TRÌNH thay thẻ khi KCB,
biểu diễn bằng Patient.identifier[CCCD] (sid/cccd); trộn CCCD vào sid/bhyt gây nguy cơ
matching sai giữa hai trục định danh.
QUAN HỆ VỚI sid/bhxh: giá trị 10 chữ số của mã số BHYT trùng mã số BHXH — hai namespace
tồn tại song song theo NGỮ CẢNH NGHIỆP VỤ: số thẻ/quyền lợi BHYT (Coverage) dùng sid/bhyt;
sổ/quá trình tham gia BHXH dùng sid/bhxh (xem vn-bhxh-ns). Không suy diễn tự động hai chiều
khi chưa xác minh qua Cổng BHXH (NĐ 164/2025/NĐ-CP). CV 1804/BHXH-QLT chuyển khoá quản lý
người tham gia sang ĐDCN/CCCD từ 01/08/2025 nhưng vẫn cho phép mã 10 số trong giai đoạn
chuyển tiếp; điều này không biến CCCD thành một giá trị hợp lệ của sid/bhyt.
Căn cứ:
- Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
- NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT; Mẫu số 3 tách cột Mã số BHYT / Số CCCD
- NĐ 164/2025/NĐ-CP — 29/6/2025 — giao dịch điện tử BHXH, tra cứu thẻ theo CCCD
- CV 1804/BHXH-QLT — 04/8/2025 — chuyển khoá quản lý sang ĐDCN/CCCD, có giai đoạn chuyển tiếp
- QĐ 3176/QĐ-BYT — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH
- Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.
|
| Publisher | Omi HealthTech / VN Core FHIR Community Initiative |
| OID | 2.25.161089673617632664299011809196868855799.31.6 (for OID based terminology systems) |
Identifiers
| Type | Value | Preferred |
| URI | http://fhir.hl7.org.vn/core/sid/bhyt | true |
