HL7 Vietnam VN Core FHIR Implementation Guide

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

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## : Ví dụ: Thẻ BHYT format mới (CCCD 12 số, từ 01/8/2025)

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

    <Coverage xmlns="http://hl7.org/fhir">
      <id value="ExampleCoverageBHYTNew"/>
      <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 ExampleCoverageBHYTNew</b></p><a name="ExampleCoverageBHYTNew"> </a><a name="hcExampleCoverageBHYTNew"> </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 DN}">Người lao động trong doanh nghiệp</span></p><p><b>Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension</b>: <a href="Organization-ExampleOrganizationChoRay.html">Bệnh viện Chợ Rẫy</a></p><p><b>identifier</b>: <a href="NamingSystem-vn-bhyt-ns.html" title="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 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, hỗ trợ định danh BHYT 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>/001085012345</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>subscriber</b>: <a href="Patient-ExamplePatientNguyenVanAn.html">Nguyễn Văn An</a></p><p><b>beneficiary</b>: <a href="Patient-ExamplePatientNguyenVanAn.html">Nguyễn Văn An</a></p><p><b>relationship</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/subscriber-relationship self}">Self</span></p><p><b>period</b>: 2025-08-01 --&gt; 2026-07-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="DN"/>
            <display value="Người lao động trong doanh nghiệp"/>
          </coding>
        </valueCodeableConcept>
      </extension>
      <extension
                 url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-primary-care-facility">
        <valueReference>🔗
          <reference value="Organization/ExampleOrganizationChoRay"/>
          <identifier>
            <system value="http://fhir.hl7.org.vn/core/sid/ma-cskcb"/>
            <value value="79001"/>
          </identifier>
          <display value="Bệnh viện Chợ Rẫy"/>
        </valueReference>
      </extension>
      <identifier>
        <system value="http://fhir.hl7.org.vn/core/sid/bhyt"/>
        <value value="001085012345"/>
      </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>
      <subscriber>🔗
        <reference value="Patient/ExamplePatientNguyenVanAn"/>
        <display value="Nguyễn Văn An"/>
      </subscriber>
      <beneficiary>🔗
        <reference value="Patient/ExamplePatientNguyenVanAn"/>
        <display value="Nguyễn Văn An"/>
      </beneficiary>
      <relationship>
        <coding>
          <system
                  value="http://terminology.hl7.org/CodeSystem/subscriber-relationship"/>
          <code value="self"/>
          <display value="Self"/>
        </coding>
      </relationship>
      <period>
        <start value="2025-08-01"/>
        <end value="2026-07-31"/>
      </period>
      <payor>
        <display value="Bảo hiểm Xã hội Việt Nam"/>
      </payor>
    </Coverage>