Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Local Development build (v0.9.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-07-31

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/$summary</p><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#string">string</a><br/>(<a href="https://hl7.org/fhir/R4/search.html#token">token</a>)</td><td/><td><div><p>Token định danh người bệnh theo cú pháp <code>system|value</code> khi không dùng logical id. Khi gọi [base]/Patient/$summary, requestor phải truyền parameter này; máy chủ chỉ hỗ trợ các identifier system đã công bố.</p>
</div></td></tr><tr><td>IN</td><td>profile</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#canonical">canonical</a></td><td/><td><div><p>Canonical của Composition profile được yêu cầu cho patient summary. Máy chủ phải công bố các profile được hỗ trợ; nếu không hỗ trợ profile được yêu cầu, trả OperationOutcome phù hợp.</p>
</div></td></tr><tr><td>OUT</td><td>return</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/bundle.html">Bundle</a></td><td/><td><div><p>Document Bundle theo Composition profile được yêu cầu; mặc định triển khai VN Core trả <code>VNCoreBundleIPS</code>/<code>VNCoreCompositionIPS</code> khi đã công bố hỗ trợ. <code>Bundle.type</code> là <code>document</code>, entry đầu là Composition và các entry còn lại phải đáp ứng reference/profile/terminology rules áp dụng. Lỗi được trả bằng OperationOutcome theo FHIR Operations.</p>
</div></td></tr></table><div><p>Hỗ trợ [base]/Patient/[id]/$summary và [base]/Patient/$summary?identifier=[system]|[value]. Với type-level URL, requestor phải truyền identifier. Kết quả là snapshot hiện hành theo quy tắc chọn dữ liệu đã công bố; operation không mặc nhiên tạo hoặc lưu một bản IPS lịch sử.</p>
</div></div>
  </text>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
    <valueCoding>
      <system
              value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
      <code value="QD-1332-VNeID"/>
    </valueCoding>
  </extension>
  <extension
             url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
    <valueCoding>
      <system
              value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
      <code value="QD-1923-2023"/>
    </valueCoding>
  </extension>
  <url
       value="http://fhir.hl7.org.vn/core/OperationDefinition/vn-generate-ips-summary"/>
  <version value="0.9.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-07-31T01:48:42+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` trả về một IPS document Bundle cho một người bệnh từ dữ liệu mà máy chủ có quyền sử dụng, có thể bao gồm resource VN Core hoặc dữ liệu đã đồng bộ cho Sổ SKĐT. Đây là phép chuyển chiếu có kiểm soát sang profile IPS, không phải phép đổi mã tự động: mỗi mapping thuật ngữ và quy tắc chọn dữ liệu phải được version hóa, kiểm thử và công bố. OperationDefinition cục bộ này giữ code, hai URL và parameter contract của HL7 IPS `$summary`; canonical VN Core cho phép công bố thêm yêu cầu của triển khai Việt Nam."/>
  <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="Hỗ trợ [base]/Patient/[id]/$summary và [base]/Patient/$summary?identifier=[system]|[value]. Với type-level URL, requestor phải truyền identifier. Kết quả là snapshot hiện hành theo quy tắc chọn dữ liệu đã công bố; operation không mặc nhiên tạo hoặc lưu một bản IPS lịch sử."/>
  <resource value="Patient"/>
  <system value="false"/>
  <type value="true"/>
  <instance value="true"/>
  <parameter>
    <name value="identifier"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="Token định danh người bệnh theo cú pháp `system|value` khi không dùng logical id. Khi gọi [base]/Patient/$summary, requestor phải truyền parameter này; máy chủ chỉ hỗ trợ các identifier system đã công bố."/>
    <type value="string"/>
    <searchType value="token"/>
  </parameter>
  <parameter>
    <name value="profile"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="Canonical của Composition profile được yêu cầu cho patient summary. Máy chủ phải công bố các profile được hỗ trợ; nếu không hỗ trợ profile được yêu cầu, trả OperationOutcome phù hợp."/>
    <type value="canonical"/>
  </parameter>
  <parameter>
    <name value="return"/>
    <use value="out"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="Document Bundle theo Composition profile được yêu cầu; mặc định triển khai VN Core trả `VNCoreBundleIPS`/`VNCoreCompositionIPS` khi đã công bố hỗ trợ. `Bundle.type` là `document`, entry đầu là Composition và các entry còn lại phải đáp ứng reference/profile/terminology rules áp dụng. Lỗi được trả bằng OperationOutcome theo FHIR Operations."/>
    <type value="Bundle"/>
  </parameter>
</OperationDefinition>