HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

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: Mã số BHXH — Vietnam Social Insurance Number

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

Hệ thống định danh Mã số Bảo hiểm xã hội legacy (10 chữ số), do BHXH Việt Nam cấp. Gắn với sổ BHXH và dữ liệu lịch sử về quá trình tham gia BHXH/BHYT/BHTN. CV 1804/BHXH-QLT ngày 04/08/2025 quy định dùng ĐDCN/CCCD thay mã số BHXH từ 01/08/2025, đồng thời cho phép tiếp tục dùng mã 10 số trong giai đoạn hoàn thiện phần mềm. Vì vậy VN Core giữ sid/bhxh cho migration/interoperability nhưng không ghi CCCD vào namespace này; CCCD dùng sid/cccd. QUAN HỆ VỚI sid/bhyt: mã số BHYT 10 chữ số TRÙNG GIÁ TRỊ mã số BHXH — chọn namespace theo NGỮ CẢNH NGHIỆP VỤ: sổ/quá trình BHXH dùng sid/bhxh; số thẻ/quyền lợi BHYT (Coverage, Patient.identifier[BHYT]) dùng sid/bhyt (xem vn-bhyt-ns). Cùng giá trị xuất hiện ở cả hai namespace là HỢP LỆ và không phải trùng lặp dữ liệu. Căn cứ bổ sung:

  • Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
  • NĐ 164/2025/NĐ-CP — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH
  • CV 1804/BHXH-QLT — 04/8/2025 — chuyển khoá quản lý sang ĐDCN/CCCD, có giai đoạn chuyển tiếp.

Language: vi

Summary

Defining URLhttp://fhir.hl7.org.vn/core/NamingSystem/vn-bhxh-ns
Version0.10.0
NameVNBHXH
Statusdraft
Definition

Hệ thống định danh Mã số Bảo hiểm xã hội legacy (10 chữ số), do BHXH Việt Nam cấp. Gắn với sổ BHXH và dữ liệu lịch sử về quá trình tham gia BHXH/BHYT/BHTN. CV 1804/BHXH-QLT ngày 04/08/2025 quy định dùng ĐDCN/CCCD thay mã số BHXH từ 01/08/2025, đồng thời cho phép tiếp tục dùng mã 10 số trong giai đoạn hoàn thiện phần mềm. Vì vậy VN Core giữ sid/bhxh cho migration/interoperability nhưng không ghi CCCD vào namespace này; CCCD dùng sid/cccd. QUAN HỆ VỚI sid/bhyt: mã số BHYT 10 chữ số TRÙNG GIÁ TRỊ mã số BHXH — chọn namespace theo NGỮ CẢNH NGHIỆP VỤ: sổ/quá trình BHXH dùng sid/bhxh; số thẻ/quyền lợi BHYT (Coverage, Patient.identifier[BHYT]) dùng sid/bhyt (xem vn-bhyt-ns). Cùng giá trị xuất hiện ở cả hai namespace là HỢP LỆ và không phải trùng lặp dữ liệu. Căn cứ bổ sung:

  • Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
  • NĐ 164/2025/NĐ-CP — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH
  • CV 1804/BHXH-QLT — 04/8/2025 — chuyển khoá quản lý sang ĐDCN/CCCD, có giai đoạn chuyển tiếp.
PublisherOmi HealthTech / VN Core FHIR Community Initiative
OID2.25.161089673617632664299011809196868855799.31.1 (for OID based terminology systems)

Identifiers

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