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

: Số thẻ Bảo hiểm Y tế (BHYT) — Vietnam Health Insurance Card Number

Draft tại thời điểm 2026-07-16

Bản thô xml | Tải xuống


<NamingSystem xmlns="http://hl7.org/fhir">
  <id value="vn-bhyt-ns"/>
  <language value="vi"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: NamingSystem vn-bhyt-ns</b></p><a name="vn-bhyt-ns"> </a><a name="hcvn-bhyt-ns"> </a><h3>Summary</h3><table class="grid"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-ns</td></tr><tr><td>Version</td><td>0.8.0</td></tr><tr><td>Name</td><td>VNBHYT</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>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):</p>
<ul>
<li>Mã số BHYT 10 chữ số (hiện hành, từ 01/4/2021) — TRÙNG GIÁ TRỊ với mã số BHXH</li>
<li>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ứ:</li>
<li><strong>Luật 51/2024/QH15</strong> — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025</li>
<li><strong>NĐ 188/2025/NĐ-CP</strong> — 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</li>
<li><strong>NĐ 164/2025/NĐ-CP</strong> — 29/6/2025 — giao dịch điện tử BHXH, tra cứu thẻ theo CCCD</li>
<li><strong>QĐ 3176/QĐ-BYT</strong> — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH</li>
<li>Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.</li>
</ul>
</div></td></tr><tr><td>Publisher</td><td>Omi HealthTech / VN Core FHIR Community Initiative</td></tr><tr><td>OID</td><td>2.25.161089673617632664299011809196868855799.31.5 (for OID based terminology systems)</td></tr></table><h3>Identifiers</h3><table class="grid"><tr><td><b>Type</b></td><td><b>Value</b></td><td><b>Preferred</b></td></tr><tr><td>URI</td><td>http://fhir.hl7.org.vn/core/sid/bhyt</td><td>true</td></tr></table></div>
  </text>
  <extension
             url="http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url">
    <valueUri value="http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-ns"/>
  </extension>
  <extension
             url="http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version">
    <valueString value="0.8.0"/>
  </extension>
  <name value="VNBHYT"/>
  <status value="draft"/>
  <kind value="identifier"/>
  <date value="2026-07-16"/>
  <publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/>
  <contact>
    <name value="Omi HealthTech / VN Core FHIR Community Initiative"/>
    <telecom>
      <system value="url"/>
      <value value="https://hl7.org.vn"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="info@hl7.org.vn"/>
    </telecom>
  </contact>
  <contact>
    <name value="Omi HealthTech (OmiGroup)"/>
    <telecom>
      <system value="url"/>
      <value value="https://omihealthtech.vn"/>
    </telecom>
    <telecom>
      <system value="url"/>
      <value value="https://omigroup.vn"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="info@hl7.org.vn"/>
    </telecom>
  </contact>
  <responsible value="Bảo hiểm Xã hội Việt Nam (BHXH VN)"/>
  <description
               value="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ử."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="VN"/>
      <display value="Viet Nam"/>
    </coding>
  </jurisdiction>
  <usage
         value="Dùng cho Patient.identifier[BHYT], Coverage.identifier[BHYT], Coverage.subscriberId. 2 format: mã số BHYT 10 số (hiện hành, trùng mã số BHXH) | 15 ký tự (legacy trước 01/4/2021). CCCD 12 số KHÔNG hợp lệ trong namespace này — dùng sid/cccd. FHIRPath: value.matches('^[0-9]{10}$') or value.matches('^[A-Z]{2}[0-9]{13}$')"/>
  <uniqueId>
    <type value="uri"/>
    <value value="http://fhir.hl7.org.vn/core/sid/bhyt"/>
    <preferred value="true"/>
  </uniqueId>
</NamingSystem>