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

: Ví dụ: Thẻ BHYT format cũ (15 ký tự, trước 01/4/2021)

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


<Coverage xmlns="http://hl7.org/fhir">
  <id value="ExampleCoverageBHYTLegacy"/>
  <meta>
    <profile
             value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage"/>
  </meta>
  <language value="vi"/>
  <text>
    <status value="extensions"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Coverage ExampleCoverageBHYTLegacy</b></p><a name="ExampleCoverageBHYTLegacy"> </a><a name="hcExampleCoverageBHYTLegacy"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-vn-core-coverage.html">Thẻ BHYT VN Core — VN Core Coverage Profile</a></p></div><p><b>Loại đối tượng BHYT — Vietnam BHYT Card Type Extension</b>: <span title="Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-card-type-cs HT}">Người hưởng lương hưu, trợ cấp mất sức lao động hàng tháng</span></p><p><b>identifier</b>: <a href="NamingSystem-vn-bhyt-ns.html" title="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ử.">VNBHYT</a>/HT4790123456789</p><p><b>status</b>: Active</p><p><b>type</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/insurance-coverage-type medical}">Bảo hiểm y tế</span></p><p><b>beneficiary</b>: <a href="Patient-ExamplePatientMinimal.html">Trần Thị B</a></p><p><b>period</b>: 2020-01-01 --&gt; 2021-03-31</p><p><b>payor</b>: Bảo hiểm Xã hội Việt Nam</p></div>
  </text>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type">
    <valueCodeableConcept>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-card-type-cs"/>
        <code value="HT"/>
        <display
                 value="Người hưởng lương hưu, trợ cấp mất sức lao động hàng tháng"/>
      </coding>
    </valueCodeableConcept>
  </extension>
  <identifier>
    <system value="http://fhir.hl7.org.vn/core/sid/bhyt"/>
    <value value="HT4790123456789"/>
  </identifier>
  <status value="active"/>
  <type>
    <coding>
      <system
              value="http://terminology.hl7.org/CodeSystem/insurance-coverage-type"/>
      <code value="medical"/>
      <display value="Medical"/>
    </coding>
    <text value="Bảo hiểm y tế"/>
  </type>
  <beneficiary>🔗 
    <reference value="Patient/ExamplePatientMinimal"/>
    <display value="Trần Thị B"/>
  </beneficiary>
  <period>
    <start value="2020-01-01"/>
    <end value="2021-03-31"/>
  </period>
  <payor>
    <display value="Bảo hiểm Xã hội Việt Nam"/>
  </payor>
</Coverage>