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

{
  "resourceType" : "OperationDefinition",
  "id" : "vn-generate-ips-summary",
  "language" : "vi",
  "text" : {
    "status" : "generated",
    "div" : "<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>\n</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>\n</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>\n</div></div>"
  },
  "url" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-generate-ips-summary",
  "version" : "0.6.0",
  "name" : "VNGenerateIPSSummary",
  "title" : "$summary — Sinh Sổ SKĐT bản IPS quốc tế (VN Core IPS Summary)",
  "status" : "draft",
  "kind" : "operation",
  "date" : "2026-06-14T00:18:08+07:00",
  "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" : "info@hl7.org.vn"
        }
      ]
    }
  ],
  "description" : "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" : "urn:iso:std:iso:3166",
          "code" : "VN",
          "display" : "Viet Nam"
        }
      ]
    }
  ],
  "affectsState" : false,
  "code" : "summary",
  "comment" : "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" : [
    "Patient"
  ],
  "system" : false,
  "type" : false,
  "instance" : true,
  "parameter" : [
    {
      "name" : "identifier",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "Định danh người bệnh (CCCD/số định danh) thay cho id logic nếu cần.",
      "type" : "Identifier"
    },
    {
      "name" : "return",
      "use" : "out",
      "min" : 1,
      "max" : "1",
      "documentation" : "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" : "Bundle"
    }
  ]
}