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

## : Gửi hồ sơ thanh toán BHYT — VN Submit BHYT Claim Operation

Draft tại thời điểm 2026-04-29

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

    <OperationDefinition xmlns="http://hl7.org/fhir">
      <id value="vn-submit-bhyt-claim"/>
      <language value="vi"/>
      <text>
        <status value="generated"/>
        <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationDefinition vn-submit-bhyt-claim</b></p><a name="vn-submit-bhyt-claim"> </a><a name="hcvn-submit-bhyt-claim"> </a><p>URL: [base]/Bundle/$submit-bhyt-claim</p><h3>Parameters</h3><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>resource</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></td><td/><td><div><p>Bundle hồ sơ thanh toán BHYT đã qua validation.</p>
    </div></td></tr><tr><td>IN</td><td>mode</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#code">code</a></td><td/><td><div><p>Chế độ gửi: test hoặc production.</p>
    </div></td></tr><tr><td>OUT</td><td>return</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/operationoutcome.html">OperationOutcome</a></td><td/><td><div><p>OperationOutcome hoặc phản hồi nghiệp vụ từ gateway.</p>
    </div></td></tr></table></div>
      </text>
      <url
           value="http://fhir.hl7.org.vn/core/OperationDefinition/vn-submit-bhyt-claim"/>
      <version value="0.5.0"/>
      <name value="VNSubmitBHYTClaim"/>
      <title value="Gửi hồ sơ thanh toán BHYT — VN Submit BHYT Claim Operation"/>
      <status value="draft"/>
      <kind value="operation"/>
      <date value="2026-04-29T14:58:55+07:00"/>
      <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="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="OperationDefinition cho phép đóng gói và gửi hồ sơ thanh toán BHYT lên Cổng giám định BHXH."/>
      <jurisdiction>
        <coding>
          <system value="urn:iso:std:iso:3166"/>
          <code value="VN"/>
          <display value="Viet Nam"/>
        </coding>
      </jurisdiction>
      <affectsState value="true"/>
      <code value="submit-bhyt-claim"/>
      <resource value="Bundle"/>
      <system value="false"/>
      <type value="true"/>
      <instance value="false"/>
      <parameter>
        <name value="resource"/>
        <use value="in"/>
        <min value="1"/>
        <max value="1"/>
        <documentation value="Bundle hồ sơ thanh toán BHYT đã qua validation."/>
        <type value="Bundle"/>
      </parameter>
      <parameter>
        <name value="mode"/>
        <use value="in"/>
        <min value="0"/>
        <max value="1"/>
        <documentation value="Chế độ gửi: test hoặc production."/>
        <type value="code"/>
      </parameter>
      <parameter>
        <name value="return"/>
        <use value="out"/>
        <min value="1"/>
        <max value="1"/>
        <documentation
                       value="OperationOutcome hoặc phản hồi nghiệp vụ từ gateway."/>
        <type value="OperationOutcome"/>
      </parameter>
    </OperationDefinition>