HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.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.8.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

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

Draft tại thời điểm 2026-07-17

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


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

<http://hl7.org/fhir/OperationDefinition/vn-generate-ips-summary> a fhir:OperationDefinition ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-generate-ips-summary"] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.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>"
  ] ;
  fhir:OperationDefinition.url [ fhir:value "http://fhir.hl7.org.vn/core/OperationDefinition/vn-generate-ips-summary"] ;
  fhir:OperationDefinition.version [ fhir:value "0.8.0"] ;
  fhir:OperationDefinition.name [ fhir:value "VNGenerateIPSSummary"] ;
  fhir:OperationDefinition.title [ fhir:value "$summary — Sinh Sổ SKĐT bản IPS quốc tế (VN Core IPS Summary)"] ;
  fhir:OperationDefinition.status [ fhir:value "draft"] ;
  fhir:OperationDefinition.kind [ fhir:value "operation"] ;
  fhir:OperationDefinition.date [ fhir:value "2026-07-17T17:54:50+00:00"^^xsd:dateTime] ;
  fhir:OperationDefinition.publisher [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative"] ;
  fhir:OperationDefinition.contact [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://hl7.org.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech (OmiGroup)" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omihealthtech.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omigroup.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ] ;
  fhir:OperationDefinition.description [ fhir: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/QĐ-BYT) → quốc tế (IPS). Tương thích `Patient/[id]/$summary` của HL7 IPS + HAPI FHIR IIpsGenerationStrategy."] ;
  fhir:OperationDefinition.jurisdiction [
     fhir:index -1 ;
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "urn:iso:std:iso:3166" ] ;
       fhir:Coding.code [ fhir:value "VN" ] ;
       fhir:Coding.display [ fhir:value "Viet Nam" ]
     ]
  ] ;
  fhir:OperationDefinition.affectsState [ fhir:value "false"^^xsd:boolean] ;
  fhir:OperationDefinition.code [ fhir:value "summary"] ;
  fhir:OperationDefinition.comment [ fhir: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."] ;
  fhir:OperationDefinition.resource [
     fhir:value "Patient" ;
     fhir:index -1
  ] ;
  fhir:OperationDefinition.system [ fhir:value "false"^^xsd:boolean] ;
  fhir:OperationDefinition.type [ fhir:value "false"^^xsd:boolean] ;
  fhir:OperationDefinition.instance [ fhir:value "true"^^xsd:boolean] ;
  fhir:OperationDefinition.parameter [
     fhir:index -1 ;
     fhir:OperationDefinition.parameter.name [ fhir:value "identifier" ] ;
     fhir:OperationDefinition.parameter.use [ fhir:value "in" ] ;
     fhir:OperationDefinition.parameter.min [ fhir:value "0"^^xsd:integer ] ;
     fhir:OperationDefinition.parameter.max [ fhir:value "1" ] ;
     fhir:OperationDefinition.parameter.documentation [ fhir:value "Định danh người bệnh (CCCD/số định danh) thay cho id logic nếu cần." ] ;
     fhir:OperationDefinition.parameter.type [ fhir:value "Identifier" ]
  ], [
     fhir:index -1 ;
     fhir:OperationDefinition.parameter.name [ fhir:value "return" ] ;
     fhir:OperationDefinition.parameter.use [ fhir:value "out" ] ;
     fhir:OperationDefinition.parameter.min [ fhir:value "1"^^xsd:integer ] ;
     fhir:OperationDefinition.parameter.max [ fhir:value "1" ] ;
     fhir:OperationDefinition.parameter.documentation [ fhir: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." ] ;
     fhir:OperationDefinition.parameter.type [ fhir:value "Bundle" ]
  ] .

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/OperationDefinition/vn-generate-ips-summary.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/OperationDefinition/vn-generate-ips-summary.ttl> .