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

: Ví dụ: Đề nghị thanh toán BHYT cho khám sức khỏe định kỳ (hưởng 100%) — Example: insured periodic health check-up claim

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


<Claim xmlns="http://hl7.org/fhir">
  <id value="ExampleClaimHealthCheckupBHYT"/>
  <meta>
    <profile
             value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim"/>
  </meta>
  <language value="vi"/>
  <text>
    <status value="extensions"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Claim ExampleClaimHealthCheckupBHYT</b></p><a name="ExampleClaimHealthCheckupBHYT"> </a><a name="hcExampleClaimHealthCheckupBHYT"> </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-claim.html">Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile</a></p></div><blockquote><p><b>Tổng chi phí theo nhóm — Claim Cost Summary Extension</b></p><ul><li>totalInsurance: <span title="Vietnamese Dong">₫400.000</span> (VND)</li><li>totalPatientCopay: <span title="Vietnamese Dong">₫0</span> (VND)</li><li>totalPatientSelfPay: <span title="Vietnamese Dong">₫0</span> (VND)</li><li>totalOtherFund: <span title="Vietnamese Dong">₫0</span> (VND)</li></ul></blockquote><blockquote><p><b>Kỳ thanh toán — Claim Payment Period Extension</b></p><ul><li>year: 2026</li><li>month: 7</li></ul></blockquote><p><b>Phương thức thanh toán — Payment Method Extension</b>: <span title="Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-method-cs 1}">Phí dịch vụ (FFS)</span></p><p><b>identifier</b>: Mã liên kết hồ sơ BHYT/LK-2026-000512</p><p><b>status</b>: Active</p><p><b>type</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/claim-type professional}">Professional</span></p><p><b>subType</b>: <span title="Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-patient-visit-type-cs 1.1}">KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu</span></p><p><b>use</b>: Claim</p><p><b>patient</b>: <a href="Patient-ExamplePatientNguyenVanAn.html">Nguyễn Văn An</a></p><p><b>created</b>: 2026-07-20</p><p><b>provider</b>: <a href="Organization-ExampleOrganizationChoRay.html">Bệnh viện Chợ Rẫy</a></p><p><b>priority</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/processpriority normal}">Normal</span></p><h3>Diagnoses</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Sequence</b></td><td><b>Diagnosis[x]</b></td><td><b>Type</b></td></tr><tr><td style="display: none">*</td><td>1</td><td><span title="Codes:{http://hl7.org/fhir/sid/icd-10 Z00.0}">Khám sức khoẻ tổng quát</span></td><td><span title="Codes:{http://terminology.hl7.org/CodeSystem/ex-diagnosistype principal}">Principal Diagnosis</span></td></tr></table><h3>Insurances</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Sequence</b></td><td><b>Focal</b></td><td><b>Coverage</b></td></tr><tr><td style="display: none">*</td><td>1</td><td>true</td><td><a href="Coverage-ExampleCoverageBHYTNew.html">BHYT Nguyễn Văn An</a></td></tr></table><blockquote><p><b>item</b></p><blockquote><p><b>Thông tin chi phí BHYT — Insurance Cost Info Extension</b></p><ul><li>scope: <span title="Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs 1}">Trong phạm vi hưởng BHYT</span></li><li>paymentRatio: 100</li><li>benefitLevel: 100</li></ul></blockquote><p><b>sequence</b>: 1</p><p><b>category</b>: <span title="Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs 1}">Khám bệnh</span></p><p><b>productOrService</b>: <span title="Codes:">Khám sức khỏe định kỳ — khám lâm sàng tổng quát</span></p><h3>Nets</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style="display: none">*</td><td>150000</td><td>Vietnamese đồng</td></tr></table><p><b>encounter</b>: <a href="Encounter-ExampleEncounterHealthCheckup.html">Encounter: extension = Đúng tuyến; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-07-20-KSK-0031; status = finished; class = ambulatory (ActCode#AMB); type = Khám sức khoẻ định kỳ; period = 2026-07-20 08:00:00+0700 --&gt; 2026-07-20 10:30:00+0700; reasonCode = General medical examination</a></p></blockquote><blockquote><p><b>item</b></p><blockquote><p><b>Thông tin chi phí BHYT — Insurance Cost Info Extension</b></p><ul><li>scope: <span title="Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs 1}">Trong phạm vi hưởng BHYT</span></li><li>paymentRatio: 100</li><li>benefitLevel: 100</li></ul></blockquote><p><b>sequence</b>: 2</p><p><b>category</b>: <span title="Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs 3}">Xét nghiệm</span></p><p><b>productOrService</b>: <span title="Codes:">Xét nghiệm cơ bản đợt khám sức khỏe định kỳ (công thức máu, đường máu, chức năng gan thận)</span></p><h3>Nets</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style="display: none">*</td><td>250000</td><td>Vietnamese đồng</td></tr></table><p><b>encounter</b>: <a href="Encounter-ExampleEncounterHealthCheckup.html">Encounter: extension = Đúng tuyến; identifier = Mã lượt khám chữa bệnh: VNMaLuotKCB#LK-2026-07-20-KSK-0031; status = finished; class = ambulatory (ActCode#AMB); type = Khám sức khoẻ định kỳ; period = 2026-07-20 08:00:00+0700 --&gt; 2026-07-20 10:30:00+0700; reasonCode = General medical examination</a></p></blockquote><h3>Totals</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style="display: none">*</td><td>400000</td><td>Vietnamese đồng</td></tr></table></div>
  </text>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-cost-summary">
    <extension url="totalInsurance">
      <valueMoney>
        <value value="400000"/>
        <currency value="VND"/>
      </valueMoney>
    </extension>
    <extension url="totalPatientCopay">
      <valueMoney>
        <value value="0"/>
        <currency value="VND"/>
      </valueMoney>
    </extension>
    <extension url="totalPatientSelfPay">
      <valueMoney>
        <value value="0"/>
        <currency value="VND"/>
      </valueMoney>
    </extension>
    <extension url="totalOtherFund">
      <valueMoney>
        <value value="0"/>
        <currency value="VND"/>
      </valueMoney>
    </extension>
  </extension>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-payment-period">
    <extension url="year">
      <valueInteger value="2026"/>
    </extension>
    <extension url="month">
      <valueInteger value="7"/>
    </extension>
  </extension>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method">
    <valueCodeableConcept>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-method-cs"/>
        <code value="1"/>
        <display value="Phí dịch vụ (FFS)"/>
      </coding>
    </valueCodeableConcept>
  </extension>
  <identifier>
    <type>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs"/>
        <code value="MA_LK"/>
        <display value="Mã liên kết hồ sơ BHYT"/>
      </coding>
    </type>
    <system value="http://fhir.hl7.org.vn/core/sid/ma-lk"/>
    <value value="LK-2026-000512"/>
  </identifier>
  <status value="active"/>
  <type>
    <coding>
      <system value="http://terminology.hl7.org/CodeSystem/claim-type"/>
      <code value="professional"/>
      <display value="Professional"/>
    </coding>
  </type>
  <subType>
    <coding>
      <system
              value="http://fhir.hl7.org.vn/core/CodeSystem/vn-patient-visit-type-cs"/>
      <code value="1.1"/>
      <display value="KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu"/>
    </coding>
  </subType>
  <use value="claim"/>
  <patient>🔗 
    <reference value="Patient/ExamplePatientNguyenVanAn"/>
    <display value="Nguyễn Văn An"/>
  </patient>
  <created value="2026-07-20"/>
  <provider>🔗 
    <reference value="Organization/ExampleOrganizationChoRay"/>
    <display value="Bệnh viện Chợ Rẫy"/>
  </provider>
  <priority>
    <coding>
      <system value="http://terminology.hl7.org/CodeSystem/processpriority"/>
      <code value="normal"/>
      <display value="Normal"/>
    </coding>
  </priority>
  <diagnosis>
    <sequence value="1"/>
    <diagnosisCodeableConcept>
      <coding>
        <system value="http://hl7.org/fhir/sid/icd-10"/>
        <code value="Z00.0"/>
        <display value="General medical examination"/>
      </coding>
      <text value="Khám sức khoẻ tổng quát"/>
    </diagnosisCodeableConcept>
    <type>
      <coding>
        <system
                value="http://terminology.hl7.org/CodeSystem/ex-diagnosistype"/>
        <code value="principal"/>
        <display value="Principal Diagnosis"/>
      </coding>
    </type>
  </diagnosis>
  <insurance>
    <sequence value="1"/>
    <focal value="true"/>
    <coverage>🔗 
      <reference value="Coverage/ExampleCoverageBHYTNew"/>
      <display value="BHYT Nguyễn Văn An"/>
    </coverage>
  </insurance>
  <item>
    <extension
               url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info">
      <extension url="scope">
        <valueCodeableConcept>
          <coding>
            <system
                    value="http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs"/>
            <code value="1"/>
            <display value="Trong phạm vi hưởng BHYT"/>
          </coding>
        </valueCodeableConcept>
      </extension>
      <extension url="paymentRatio">
        <valueDecimal value="100"/>
      </extension>
      <extension url="benefitLevel">
        <valueDecimal value="100"/>
      </extension>
    </extension>
    <sequence value="1"/>
    <category>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs"/>
        <code value="1"/>
        <display value="Khám bệnh"/>
      </coding>
    </category>
    <productOrService>
      <text value="Khám sức khỏe định kỳ — khám lâm sàng tổng quát"/>
    </productOrService>
    <net>
      <value value="150000"/>
      <currency value="VND"/>
    </net>
    <encounter>🔗 
      <reference value="Encounter/ExampleEncounterHealthCheckup"/>
    </encounter>
  </item>
  <item>
    <extension
               url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info">
      <extension url="scope">
        <valueCodeableConcept>
          <coding>
            <system
                    value="http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs"/>
            <code value="1"/>
            <display value="Trong phạm vi hưởng BHYT"/>
          </coding>
        </valueCodeableConcept>
      </extension>
      <extension url="paymentRatio">
        <valueDecimal value="100"/>
      </extension>
      <extension url="benefitLevel">
        <valueDecimal value="100"/>
      </extension>
    </extension>
    <sequence value="2"/>
    <category>
      <coding>
        <system
                value="http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs"/>
        <code value="3"/>
        <display value="Xét nghiệm"/>
      </coding>
    </category>
    <productOrService>
      <text
            value="Xét nghiệm cơ bản đợt khám sức khỏe định kỳ (công thức máu, đường máu, chức năng gan thận)"/>
    </productOrService>
    <net>
      <value value="250000"/>
      <currency value="VND"/>
    </net>
    <encounter>🔗 
      <reference value="Encounter/ExampleEncounterHealthCheckup"/>
    </encounter>
  </item>
  <total>
    <value value="400000"/>
    <currency value="VND"/>
  </total>
</Claim>