Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-07-31 |
{
"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/$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>\n</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>\n</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>\n</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>\n</div></div>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "QD-1332-VNeID"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "QD-1923-2023"
}
}
],
"url" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-generate-ips-summary",
"version" : "0.9.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-07-31T01:48:42+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" : "[email protected]"
}
]
},
{
"name" : "Omi HealthTech (OmiGroup)",
"telecom" : [
{
"system" : "url",
"value" : "https://omihealthtech.vn"
},
{
"system" : "url",
"value" : "https://omigroup.vn"
},
{
"system" : "email",
"value" : "[email protected]"
}
]
}
],
"description" : "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" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"affectsState" : false,
"code" : "summary",
"comment" : "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" : [
"Patient"
],
"system" : false,
"type" : true,
"instance" : true,
"parameter" : [
{
"name" : "identifier",
"use" : "in",
"min" : 0,
"max" : "1",
"documentation" : "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" : "string",
"searchType" : "token"
},
{
"name" : "profile",
"use" : "in",
"min" : 0,
"max" : "1",
"documentation" : "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" : "canonical"
},
{
"name" : "return",
"use" : "out",
"min" : 0,
"max" : "1",
"documentation" : "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" : "Bundle"
}
]
}