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

• Nội dung narrative
• XML
• JSON
• TTL

: $summary — Sinh Sổ SKĐT bản IPS quốc tế (VN Core IPS Summary)

Draft tại thời điểm 2026-06-14

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

<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="vn-generate-ips-summary"/>
  <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-generate-ips-summary</b></p><a name="vn-generate-ips-summary"> </a><a name="hcvn-generate-ips-summary"> </a><p>URL: [base]/Patient/[id]/$summary</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>identifier</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#Identifier">Identifier</a></td><td/><td><div><p>Định danh người bệnh (CCCD/số định danh) thay cho id logic nếu cần.</p>
</div></td></tr><tr><td>OUT</td><td>return</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></td><td/><td><div><p>IPS document Bundle theo profile <code>VNCoreBundleIPS</code> (kế thừa <code>Bundle-uv-ips</code>): <code>type=document</code>, <code>entry[0]</code> là <code>VNCoreCompositionIPS</code>, kèm Patient + resource lâm sàng (mã SNOMED CT/ICD-10). Xem ví dụ <code>ExampleBundleIPSNguyenVanAn</code>. (R4 OperationDefinition không có <code>parameter.profile</code> để ràng buộc hình thức cho kiểu Bundle; profile <code>VNCoreBundleIPS</code> là hợp đồng kết quả.) Lỗi trả về <code>OperationOutcome</code> chuẩn FHIR.</p>
</div></td></tr></table><div><p>Gọi trên một Patient cụ thể: GET [base]/Patient/[id]/$summary. Server xây dựng IPS document Bundle (VNCoreCompositionIPS) bằng cách ánh xạ AllergyIntolerance/Condition/MedicationStatement... của VN Core sang IPS profile + mã SNOMED CT. Có thể cache/precompute (VNeID display projection) để chịu tải.</p>
</div></div>
  </text>
  <url
       value="http://fhir.hl7.org.vn/core/OperationDefinition/vn-generate-ips-summary"/>
  <version value="0.6.0"/>
  <name value="VNGenerateIPSSummary"/>
  <title
         value="$summary — Sinh Sổ SKĐT bản IPS quốc tế (VN Core IPS Summary)"/>
  <status value="draft"/>
  <kind value="operation"/>
  <date value="2026-06-14T00:18:08+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="info@hl7.org.vn"/>
    </telecom>
  </contact>
  <description
               value="Operation `$summary` sinh **bản tóm tắt sức khỏe theo chuẩn IPS** (International Patient Summary) cho một người bệnh, từ dữ liệu nội địa (Sổ SKĐT VNeID + các resource lâm sàng VN Core). Đầu ra là một **document Bundle** với `VNCoreCompositionIPS` ở entry đầu, các resource IPS-profiled (mã SNOMED CT qua VNSNOMEDSubsetCS). Đây là điểm projection của kiến trúc dual-profile: nội địa (QĐ 1332) → quốc tế (IPS). Tương thích `Patient/[id]/$summary` của HL7 IPS + HAPI FHIR IIpsGenerationStrategy."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="VN"/>
      <display value="Viet Nam"/>
    </coding>
  </jurisdiction>
  <affectsState value="false"/>
  <code value="summary"/>
  <comment
           value="Gọi trên một Patient cụ thể: GET [base]/Patient/[id]/$summary. Server xây dựng IPS document Bundle (VNCoreCompositionIPS) bằng cách ánh xạ AllergyIntolerance/Condition/MedicationStatement... của VN Core sang IPS profile + mã SNOMED CT. Có thể cache/precompute (VNeID display projection) để chịu tải."/>
  <resource value="Patient"/>
  <system value="false"/>
  <type value="false"/>
  <instance value="true"/>
  <parameter>
    <name value="identifier"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="Định danh người bệnh (CCCD/số định danh) thay cho id logic nếu cần."/>
    <type value="Identifier"/>
  </parameter>
  <parameter>
    <name value="return"/>
    <use value="out"/>
    <min value="1"/>
    <max value="1"/>
    <documentation
                   value="IPS document Bundle theo profile `VNCoreBundleIPS` (kế thừa `Bundle-uv-ips`): `type=document`, `entry[0]` là `VNCoreCompositionIPS`, kèm Patient + resource lâm sàng (mã SNOMED CT/ICD-10). Xem ví dụ `ExampleBundleIPSNguyenVanAn`. (R4 OperationDefinition không có `parameter.profile` để ràng buộc hình thức cho kiểu Bundle; profile `VNCoreBundleIPS` là hợp đồng kết quả.) Lỗi trả về `OperationOutcome` chuẩn FHIR."/>
    <type value="Bundle"/>
  </parameter>
</OperationDefinition>