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

• Narrative Content
• XML
• JSON
• TTL

: Tìm kiếm thẻ BHYT theo số thẻ — VN Coverage BHYT Search Parameter - XML Representation

Draft as of 2026-03-21

Raw xml | Download

<SearchParameter xmlns="http://hl7.org/fhir">
  <id value="vn-sp-coverage-bhyt"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: SearchParameter vn-sp-coverage-bhyt</b></p><a name="vn-sp-coverage-bhyt"> </a><a name="hcvn-sp-coverage-bhyt"> </a><h2>VNSPCoverageBHYT</h2><p>Parameter <code>vn-bhyt-card</code>:<code>token</code></p><div><p>SearchParameter cho phép tìm kiếm Coverage theo số thẻ BHYT (trường identifier).
Hỗ trợ cả 3 format (duy trì song song): CCCD 12 số (từ 15/8/2025 per NĐ 188/2025), BHXH 10 số, legacy 15 ký tự.
Căn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP (hiệu lực 15/8/2025).
Ví dụ: GET [base]/Coverage?vn-bhyt-card=http://fhir.hl7.org.vn/core/sid/bhyt|001085012345</p>
</div><table class="grid"><tr><td>Resource</td><td><a href="http://hl7.org/fhir/R4/coverage.html">Coverage</a></td></tr><tr><td>Expression</td><td><code>Coverage.identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/bhyt')</code></td></tr><tr><td>Multiples</td><td><ul><li>multipleAnd: It's up to the server whether the parameter may repeat in order to specify multiple values that must all be true</li><li>multipleOr: It's up to the server whether the parameter can have multiple values (separated by comma) where at least one must be true</li></ul></td></tr></table></div>
  </text>
  <url
       value="http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-coverage-bhyt"/>
  <version value="0.1.0"/>
  <name value="VNSPCoverageBHYT"/>
  <status value="draft"/>
  <date value="2026-03-21"/>
  <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="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="healthtech@omigroup.vn"/>
    </telecom>
  </contact>
  <description
               value="SearchParameter cho phép tìm kiếm Coverage theo số thẻ BHYT (trường identifier).
Hỗ trợ cả 3 format (duy trì song song): CCCD 12 số (từ 15/8/2025 per NĐ 188/2025), BHXH 10 số, legacy 15 ký tự.
Căn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP (hiệu lực 15/8/2025).
Ví dụ: GET [base]/Coverage?vn-bhyt-card=http://fhir.hl7.org.vn/core/sid/bhyt|001085012345"/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="VN"/>
      <display value="Viet Nam"/>
    </coding>
  </jurisdiction>
  <code value="vn-bhyt-card"/>
  <base value="Coverage"/>
  <type value="token"/>
  <expression
              value="Coverage.identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/bhyt')"/>
</SearchParameter>