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 Viet Nam cờ

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

: Bảng 4 cận lâm sàng BHYT — Logical Model — StructureMap

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

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


<StructureMap xmlns="http://hl7.org/fhir">
  <id value="vn-sm-bhyt-xml4-cls"/>
  <language value="vi"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: StructureMap vn-sm-bhyt-xml4-cls</b></p><a name="vn-sm-bhyt-xml4-cls"> </a><a name="hcvn-sm-bhyt-xml4-cls"> </a><pre class="fml">
<b>map</b><span style="color: navy"> &quot;</span>http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml4-cls<span style="color: navy">&quot; = &quot;</span>BHYTXML4CLSLMStructureMap<span style="color: navy">&quot;

</span><span style="color: navy">// </span><span style="color: green">Generated StructureMap scaffold for Bảng 4 cận lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML4CLSLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.</span>

<b>uses</b><span style="color: navy"> &quot;</span><a href="StructureDefinition-vn-core-bhyt-submission-bundle.html" title="Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle">http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle</a><span style="color: navy">&quot; </span><b>alias </b>BHYTSubmissionBundle <b>as </b><b>source</b> <span style="color: navy">// </span><span style="color: green">FHIR-native source bundle profile used by the repository round-trip adapter.</span>
<b>uses</b><span style="color: navy"> &quot;</span><a href="StructureDefinition-bhytXml4ClsLm.html" title="Bảng 4 cận lâm sàng BHYT — Logical Model">http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml4ClsLm</a><span style="color: navy">&quot; </span><b>alias </b>BHYTXML4CLSLM <b>as </b><b>target</b> <span style="color: navy">// </span><span style="color: green">Bảng 4 cận lâm sàng BHYT — Logical Model</span>

<span style="color: navy">// </span><span style="color: green">Rows are derived from VNCoreDiagnosticReport and the linked VNCoreObservationLab results. Generated from logical-model `^mapping` annotations. Fields still missing a field-level `^mapping.map` entry remain outside this StructureMap and are tracked in `wiki/mappings/bhyt-output-data/machine/structuremap-coverage.json`.</span>
<b>group </b>MapBHYTXML4CLSLM<span style="color: navy">(</span><b>source</b> <span style="color: maroon">sourceBundle</span><span style="color: navy"> : </span>BHYTSubmissionBundle, <b>target</b> <span style="color: maroon">targetRow</span><span style="color: navy"> : </span>BHYTXML4CLSLM<span style="color: navy">)</span><span style="color: navy"> {
</span>  sourceBundle.entry<b> as </b><span style="color: maroon">maLkSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.maLk <i>&quot;maLk&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: Mã liên kết hồ sơ FHIR path: VNCoreClaim.identifier[MALK].value</span>
  sourceBundle.entry<b> as </b><span style="color: maroon">sttSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.stt <i>&quot;stt&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: Số thứ tự dòng FHIR path: Derived export row order from VNCoreDiagnosticReport collection</span>
  sourceBundle.entry<b> as </b><span style="color: maroon">maDichVuSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.maDichVu <i>&quot;maDichVu&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: MA_DICH_VU - Mã dịch vụ cận lâm sàng FHIR path: VNCoreDiagnosticReport.code.coding.code</span>
  sourceBundle.entry<b> as </b><span style="color: maroon">maChiSoSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.maChiSo <i>&quot;maChiSo&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: MA_CHI_SO - Mã chỉ số cận lâm sàng FHIR path: VNCoreObservationLab.code.coding.code</span>
  sourceBundle.entry<b> as </b><span style="color: maroon">tenChiSoSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.tenChiSo <i>&quot;tenChiSo&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: TEN_CHI_SO - Tên chỉ số cận lâm sàng FHIR path: VNCoreObservationLab.code.text | VNCoreObservationLab.code.coding.display</span>
  sourceBundle.entry<b> as </b><span style="color: maroon">giaTriSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.giaTri <i>&quot;giaTri&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: GIA_TRI - Giá trị kết quả FHIR path: VNCoreObservationLab.value[x]</span>
  sourceBundle.entry<b> as </b><span style="color: maroon">donViDoSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.donViDo <i>&quot;donViDo&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: DON_VI_DO - Đơn vị đo FHIR path: VNCoreObservationLab.valueQuantity.unit | VNCoreObservationLab.valueQuantity.code</span>
  sourceBundle.entry<b> as </b><span style="color: maroon">ngayKqSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.ngayKq <i>&quot;ngayKq&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: NGAY_KQ - Ngày kết quả theo định dạng yyyyMMddHHmm FHIR path: VNCoreDiagnosticReport.issued | VNCoreObservationLab.effectiveDateTime</span>
  sourceBundle.entry<b> as </b><span style="color: maroon">maBsDocKqSource</span><span style="color: navy"><b> -&gt; </b></span>targetRow.maBsDocKq <i>&quot;maBsDocKq&quot;</i><span style="color: navy">;</span> <span style="color: navy">// </span><span style="color: green">Target field: MA_BS_DOC_KQ - Mã bác sĩ đọc kết quả FHIR path: VNCoreDiagnosticReport.resultsInterpreter.resolve().identifier.value | VNCorePractitioner.identifier.value</span>
<span style="color: navy">}

</span></pre></div>
  </text>
  <url value="http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml4-cls"/>
  <version value="0.5.0"/>
  <name value="BHYTXML4CLSLMStructureMap"/>
  <title value="Bảng 4 cận lâm sàng BHYT — Logical Model — StructureMap"/>
  <status value="draft"/>
  <experimental value="false"/>
  <date value="2026-04-28"/>
  <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>
  <description
               value="Generated StructureMap scaffold for Bảng 4 cận lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML4CLSLM.fsh` and remain aligned with the Python BHYT round-trip export adapter."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="VN"/>
      <display value="Viet Nam"/>
    </coding>
  </jurisdiction>
  <purpose
           value="Publish canonical, reviewable FHIR-to-BHYT XML mapping artifacts for XML1-XML12 without duplicating field-level mapping semantics across FSH, wiki, and export code."/>
  <structure>
    <url
         value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle"/>
    <mode value="source"/>
    <alias value="BHYTSubmissionBundle"/>
    <documentation
                   value="FHIR-native source bundle profile used by the repository round-trip adapter."/>
  </structure>
  <structure>
    <url
         value="http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml4ClsLm"/>
    <mode value="target"/>
    <alias value="BHYTXML4CLSLM"/>
    <documentation value="Bảng 4 cận lâm sàng BHYT — Logical Model"/>
  </structure>
  <group>
    <name value="MapBHYTXML4CLSLM"/>
    <typeMode value="none"/>
    <documentation
                   value="Rows are derived from VNCoreDiagnosticReport and the linked VNCoreObservationLab results. Generated from logical-model `^mapping` annotations. Fields still missing a field-level `^mapping.map` entry remain outside this StructureMap and are tracked in `wiki/mappings/bhyt-output-data/machine/structuremap-coverage.json`."/>
    <input>
      <name value="sourceBundle"/>
      <type value="BHYTSubmissionBundle"/>
      <mode value="source"/>
      <documentation value="VN Core BHYT submission bundle."/>
    </input>
    <input>
      <name value="targetRow"/>
      <type value="BHYTXML4CLSLM"/>
      <mode value="target"/>
      <documentation value="Bảng 4 cận lâm sàng BHYT — Logical Model"/>
    </input>
    <rule>
      <name value="maLk"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="maLkSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="maLk"/>
      </target>
      <documentation
                     value="Target field: Mã liên kết hồ sơ FHIR path: VNCoreClaim.identifier[MALK].value"/>
    </rule>
    <rule>
      <name value="stt"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="sttSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="stt"/>
      </target>
      <documentation
                     value="Target field: Số thứ tự dòng FHIR path: Derived export row order from VNCoreDiagnosticReport collection"/>
    </rule>
    <rule>
      <name value="maDichVu"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="maDichVuSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="maDichVu"/>
      </target>
      <documentation
                     value="Target field: MA_DICH_VU - Mã dịch vụ cận lâm sàng FHIR path: VNCoreDiagnosticReport.code.coding.code"/>
    </rule>
    <rule>
      <name value="maChiSo"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="maChiSoSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="maChiSo"/>
      </target>
      <documentation
                     value="Target field: MA_CHI_SO - Mã chỉ số cận lâm sàng FHIR path: VNCoreObservationLab.code.coding.code"/>
    </rule>
    <rule>
      <name value="tenChiSo"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="tenChiSoSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="tenChiSo"/>
      </target>
      <documentation
                     value="Target field: TEN_CHI_SO - Tên chỉ số cận lâm sàng FHIR path: VNCoreObservationLab.code.text | VNCoreObservationLab.code.coding.display"/>
    </rule>
    <rule>
      <name value="giaTri"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="giaTriSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="giaTri"/>
      </target>
      <documentation
                     value="Target field: GIA_TRI - Giá trị kết quả FHIR path: VNCoreObservationLab.value[x]"/>
    </rule>
    <rule>
      <name value="donViDo"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="donViDoSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="donViDo"/>
      </target>
      <documentation
                     value="Target field: DON_VI_DO - Đơn vị đo FHIR path: VNCoreObservationLab.valueQuantity.unit | VNCoreObservationLab.valueQuantity.code"/>
    </rule>
    <rule>
      <name value="ngayKq"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="ngayKqSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="ngayKq"/>
      </target>
      <documentation
                     value="Target field: NGAY_KQ - Ngày kết quả theo định dạng yyyyMMddHHmm FHIR path: VNCoreDiagnosticReport.issued | VNCoreObservationLab.effectiveDateTime"/>
    </rule>
    <rule>
      <name value="maBsDocKq"/>
      <source>
        <context value="sourceBundle"/>
        <min value="0"/>
        <max value="*"/>
        <element value="entry"/>
        <variable value="maBsDocKqSource"/>
      </source>
      <target>
        <context value="targetRow"/>
        <contextType value="variable"/>
        <element value="maBsDocKq"/>
      </target>
      <documentation
                     value="Target field: MA_BS_DOC_KQ - Mã bác sĩ đọc kết quả FHIR path: VNCoreDiagnosticReport.resultsInterpreter.resolve().identifier.value | VNCorePractitioner.identifier.value"/>
    </rule>
  </group>
</StructureMap>