VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft Viet Nam flag

VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.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 - XML Representation

Draft as of 2026-03-20

Raw xml | Download


<NamingSystem xmlns="http://hl7.org/fhir">
  <id value="vn-bhyt-ns"/>
  <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.1.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 Số thẻ Bảo hiểm Y tế, do BHXH Việt Nam cấp.
Hỗ trợ 3 format (hiện duy trì song song):</p>
<ul>
<li>CCCD 12 chữ số: hỗ trợ từ 15/8/2025 (NĐ 188/2025/NĐ-CP, hiệu lực 15/8/2025)</li>
<li>Mã số BHXH 10 chữ số: từ 01/4/2021</li>
<li>Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021
Bên triển khai cần xác minh chính sách BHXH hiện hành trước khi coi CCCD là mã BHYT duy nhất.
Căn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP, QĐ 3176/QĐ-BYT (29/10/2024).</li>
</ul>
</div></td></tr><tr><td>Publisher</td><td>HL7 Vietnam</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.1.0"/>
  </extension>
  <name value="VNBHYT"/>
  <status value="draft"/>
  <kind value="identifier"/>
  <date value="2026-03-20"/>
  <publisher value="HL7 Vietnam"/>
  <contact>
    <name value="HL7 Vietnam"/>
    <telecom>
      <system value="url"/>
      <value value="https://hl7.org.vn"/>
    </telecom>
    <telecom>
      <system value="email"/>
      <value value="[email protected]"/>
    </telecom>
  </contact>
  <responsible value="Bảo hiểm Xã hội Việt Nam (BHXH VN)"/>
  <description
               value="Hệ thống định danh Số thẻ Bảo hiểm Y tế, do BHXH Việt Nam cấp.
Hỗ trợ 3 format (hiện duy trì song song):
- CCCD 12 chữ số: hỗ trợ từ 15/8/2025 (NĐ 188/2025/NĐ-CP, hiệu lực 15/8/2025)
- Mã số BHXH 10 chữ số: từ 01/4/2021
- Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021
Bên triển khai cần xác minh chính sách BHXH hiện hành trước khi coi CCCD là mã BHYT duy nhất.
Căn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP, QĐ 3176/QĐ-BYT (29/10/2024)."/>
  <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, Coverage.subscriberId. 3 format: CCCD 12 số (mới nhất) | BHXH 10 số | 15 ký tự (cũ). FHIRPath: value.matches('^[0-9]{12}$') or 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>