HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Định danh hợp đồng KCB BHYT — BHYT Healthcare Contract Identifier

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

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


<NamingSystem xmlns="http://hl7.org/fhir">
  <id value="vn-bhyt-contract-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-contract-ns</b></p><a name="vn-bhyt-contract-ns"> </a><a name="hcvn-bhyt-contract-ns"> </a><h3>Summary</h3><table class="grid"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-contract-ns</td></tr><tr><td>Version</td><td>0.9.0</td></tr><tr><td>Name</td><td>VNBHYTContractNS</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>Hệ thống định danh VN Core cho hợp đồng khám bệnh, chữa bệnh BHYT giữa cơ quan BHXH và cơ sở KCB. Giá trị định danh phải duy nhất trong phạm vi thỏa thuận giữa các bên hoặc cơ quan cấp mã; NamingSystem này không khẳng định mã hợp đồng có tính duy nhất trên toàn quốc. / VN Core identifier system for BHYT healthcare contracts between a social-insurance authority and a healthcare provider. Identifier values SHALL be unique within the parties' agreement or assigning authority; this NamingSystem does not assert nationwide contract-number uniqueness.</p>
</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.3 (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-healthcare-contract</td><td>true</td></tr></table></div>
  </text>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
    <valueCoding>
      <system
              value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
      <code value="ND-188-2025"/>
    </valueCoding>
  </extension>
  <extension
             url="http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url">
    <valueUri
              value="http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-contract-ns"/>
  </extension>
  <extension
             url="http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version">
    <valueString value="0.9.0"/>
  </extension>
  <name value="VNBHYTContractNS"/>
  <status value="draft"/>
  <kind value="identifier"/>
  <date value="2026-07-20"/>
  <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="[email protected]"/>
    </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="[email protected]"/>
    </telecom>
  </contact>
  <responsible
               value="Cơ quan BHXH và cơ sở KCB ký hợp đồng / Contracting BHXH authority and healthcare provider"/>
  <description
               value="Hệ thống định danh VN Core cho hợp đồng khám bệnh, chữa bệnh BHYT giữa cơ quan BHXH và cơ sở KCB. Giá trị định danh phải duy nhất trong phạm vi thỏa thuận giữa các bên hoặc cơ quan cấp mã; NamingSystem này không khẳng định mã hợp đồng có tính duy nhất trên toàn quốc. / VN Core identifier system for BHYT healthcare contracts between a social-insurance authority and a healthcare provider. Identifier values SHALL be unique within the parties' agreement or assigning authority; this NamingSystem does not assert nationwide contract-number uniqueness."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="VN"/>
      <display value="Viet Nam"/>
    </coding>
  </jurisdiction>
  <usage
         value="Dùng cho contractIdentifier của VNCoreQuarterlyHealthcareCostSettlement. Bên cấp mã phải bảo đảm không trùng trong từng thỏa thuận và nên đưa phạm vi cơ quan/thỏa thuận vào value khi trao đổi qua nhiều thỏa thuận; không diễn giải URL này như bằng chứng về một sổ đăng ký hợp đồng quốc gia. / Used for VNCoreQuarterlyHealthcareCostSettlement.contractIdentifier. The assigner SHALL prevent duplicates within each agreement and SHOULD encode the authority/agreement scope in the value for cross-agreement exchange; the URL is not evidence of a national contract registry."/>
  <uniqueId>
    <type value="uri"/>
    <value value="http://fhir.hl7.org.vn/core/sid/bhyt-healthcare-contract"/>
    <preferred value="true"/>
  </uniqueId>
</NamingSystem>