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

## : 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ô json | Tải xuống

    {
      "resourceType" : "StructureMap",
      "id" : "vn-sm-bhyt-xml4-cls",
      "language" : "vi",
      "text" : {
        "status" : "generated",
        "div" : "<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\">\r\n<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;\r\n\r\n</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>\r\n\r\n<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>\r\n<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>\r\n\r\n<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>\r\n<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\"> {\r\n</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>\r\n  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>\r\n  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>\r\n  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>\r\n  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>\r\n  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>\r\n  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>\r\n  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>\r\n  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>\r\n<span style=\"color: navy\">}\r\n\r\n</span></pre></div>"
      },
      "url" : "http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml4-cls",
      "version" : "0.5.0",
      "name" : "BHYTXML4CLSLMStructureMap",
      "title" : "Bảng 4 cận lâm sàng BHYT — Logical Model — StructureMap",
      "status" : "draft",
      "experimental" : false,
      "date" : "2026-04-28",
      "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
      "contact" : [
        {
          "name" : "Omi HealthTech / VN Core FHIR Community Initiative",
          "telecom" : [
            {
              "system" : "url",
              "value" : "https://hl7.org.vn"
            },
            {
              "system" : "email",
              "value" : "info@hl7.org.vn"
            }
          ]
        },
        {
          "name" : "Omi HealthTech (OmiGroup)",
          "telecom" : [
            {
              "system" : "url",
              "value" : "https://omihealthtech.vn"
            },
            {
              "system" : "url",
              "value" : "https://omigroup.vn"
            },
            {
              "system" : "email",
              "value" : "healthtech@omigroup.vn"
            }
          ]
        }
      ],
      "description" : "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" : "urn:iso:std:iso:3166",
              "code" : "VN",
              "display" : "Viet Nam"
            }
          ]
        }
      ],
      "purpose" : "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" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
          "mode" : "source",
          "alias" : "BHYTSubmissionBundle",
          "documentation" : "FHIR-native source bundle profile used by the repository round-trip adapter."
        },
        {
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml4ClsLm",
          "mode" : "target",
          "alias" : "BHYTXML4CLSLM",
          "documentation" : "Bảng 4 cận lâm sàng BHYT — Logical Model"
        }
      ],
      "group" : [
        {
          "name" : "MapBHYTXML4CLSLM",
          "typeMode" : "none",
          "documentation" : "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" : "sourceBundle",
              "type" : "BHYTSubmissionBundle",
              "mode" : "source",
              "documentation" : "VN Core BHYT submission bundle."
            },
            {
              "name" : "targetRow",
              "type" : "BHYTXML4CLSLM",
              "mode" : "target",
              "documentation" : "Bảng 4 cận lâm sàng BHYT — Logical Model"
            }
          ],
          "rule" : [
            {
              "name" : "maLk",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "maLkSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "maLk"
                }
              ],
              "documentation" : "Target field: Mã liên kết hồ sơ FHIR path: VNCoreClaim.identifier[MALK].value"
            },
            {
              "name" : "stt",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "sttSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "stt"
                }
              ],
              "documentation" : "Target field: Số thứ tự dòng FHIR path: Derived export row order from VNCoreDiagnosticReport collection"
            },
            {
              "name" : "maDichVu",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "maDichVuSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "maDichVu"
                }
              ],
              "documentation" : "Target field: MA_DICH_VU - Mã dịch vụ cận lâm sàng FHIR path: VNCoreDiagnosticReport.code.coding.code"
            },
            {
              "name" : "maChiSo",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "maChiSoSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "maChiSo"
                }
              ],
              "documentation" : "Target field: MA_CHI_SO - Mã chỉ số cận lâm sàng FHIR path: VNCoreObservationLab.code.coding.code"
            },
            {
              "name" : "tenChiSo",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "tenChiSoSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "tenChiSo"
                }
              ],
              "documentation" : "Target field: TEN_CHI_SO - Tên chỉ số cận lâm sàng FHIR path: VNCoreObservationLab.code.text | VNCoreObservationLab.code.coding.display"
            },
            {
              "name" : "giaTri",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "giaTriSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "giaTri"
                }
              ],
              "documentation" : "Target field: GIA_TRI - Giá trị kết quả FHIR path: VNCoreObservationLab.value[x]"
            },
            {
              "name" : "donViDo",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "donViDoSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "donViDo"
                }
              ],
              "documentation" : "Target field: DON_VI_DO - Đơn vị đo FHIR path: VNCoreObservationLab.valueQuantity.unit | VNCoreObservationLab.valueQuantity.code"
            },
            {
              "name" : "ngayKq",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "ngayKqSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "ngayKq"
                }
              ],
              "documentation" : "Target field: NGAY_KQ - Ngày kết quả theo định dạng yyyyMMddHHmm FHIR path: VNCoreDiagnosticReport.issued | VNCoreObservationLab.effectiveDateTime"
            },
            {
              "name" : "maBsDocKq",
              "source" : [
                {
                  "context" : "sourceBundle",
                  "min" : 0,
                  "max" : "*",
                  "element" : "entry",
                  "variable" : "maBsDocKqSource"
                }
              ],
              "target" : [
                {
                  "context" : "targetRow",
                  "contextType" : "variable",
                  "element" : "maBsDocKq"
                }
              ],
              "documentation" : "Target field: MA_BS_DOC_KQ - Mã bác sĩ đọc kết quả FHIR path: VNCoreDiagnosticReport.resultsInterpreter.resolve().identifier.value | VNCorePractitioner.identifier.value"
            }
          ]
        }
      ]
    }