HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.8.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

URL chính thức: http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-ns Phiên bản: 0.8.0
Computable Name: VNBHYT
Định danh khác: OID:2.25.161089673617632664299011809196868855799.31.5

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ố (hiện hành, từ 01/4/2021) — 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à KHÓA 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). 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
  • 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ử.

Language: vi

Summary

Defining URLhttp://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-ns
Version0.8.0
NameVNBHYT
Statusdraft
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ố (hiện hành, từ 01/4/2021) — 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à KHÓA 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). 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
  • 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ử.
PublisherOmi HealthTech / VN Core FHIR Community Initiative
OID2.25.161089673617632664299011809196868855799.31.5 (for OID based terminology systems)

Identifiers

TypeValuePreferred
URIhttp://fhir.hl7.org.vn/core/sid/bhyttrue