HL7 Vietnam VN Core FHIR Implementation Guide

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

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

URL chính thức: http://fhir.hl7.org.vn/core/OperationDefinition/vn-generate-ips-summary Phiên bản: 0.6.0
Computable Name: VNGenerateIPSSummary

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.

Language: vi

URL: [base]/Patient/[id]/$summary

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INidentifier0..1Identifier

Định danh người bệnh (CCCD/số định danh) thay cho id logic nếu cần.

OUTreturn1..1Bundle

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.

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.