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
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
| Draft tại thời điểm 2026-06-10 |
Biểu diễn TTL của vnHealthCheckupG12EnvelopeLm mô hình logic.
@prefix fhir: <http://hl7.org/fhir/> . @prefix owl: <http://www.w3.org/2002/07/owl#> . @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . # - resource ------------------------------------------------------------------- a fhir:StructureDefinition ; fhir:nodeRole fhir:treeRoot ; fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm"] ; # fhir:language [ fhir:v "vi"] ; # fhir:text [ fhir:status [ fhir:v "extensions" ] ; fhir:div [ fhir:v "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: StructureDefinition vnHealthCheckupG12EnvelopeLm</b></p><table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" style=\"border: 0px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top;\"><tr style=\"border: 1px #F0F0F0 solid; font-size: 11px; font-family: verdana; vertical-align: top\"><th style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; padding-top: 3px; padding-bottom: 3px\" class=\"hierarchy\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"The logical name of the element\">Name</a></th><th style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; padding-top: 3px; padding-bottom: 3px\" class=\"hierarchy\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Information about the use of the element\">Flags</a></th><th style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; padding-top: 3px; padding-bottom: 3px\" class=\"hierarchy\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Minimum and Maximum # of times the element can appear in the instance\">Card.</a></th><th style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; padding-top: 3px; padding-bottom: 3px; width: 100px\" class=\"hierarchy\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Reference to the type of the element\">Type</a></th><th style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; padding-top: 3px; padding-bottom: 3px\" class=\"hierarchy\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Additional information about the element\">Description & Constraints</a><span style=\"float: right\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/></a></span></th></tr><tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck1.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_element.gif\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Element\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm\" title=\"Logical model cho bản tin tiếp nhận dữ liệu khám bệnh từ Bảo hiểm xã hội Việt Nam, đồng bộ qua Trung tâm Dữ liệu Quốc gia (TTDLQG / NDOP — CP.NET) về CSDL sức khỏe Bộ Y tế. API: POST /api/integrate/v1/G12.#xA;Luồng: BHXH tạo XML (cấu trúc do TTDLQG cung cấp) → base64 → ký số (dịch vụ Ban Cơ yếu) → gửi qua AgentNode. Xác thực: API Key do TTDLQG cấp. X-Service = G12.#xA;KHÁC với BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ dữ liệu khám bệnh BHXH → CSDL sức khỏe cá nhân.#xA;**INFORMATIVE / non-normative**: mô hình ánh xạ transport envelope NDOP G12 (không phải FHIR resource normative) — mapping aid cho implementer.#xA;Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 03 đặc tả API.\">vnHealthCheckupG12EnvelopeLm</a><a name=\"vnHealthCheckupG12EnvelopeLm\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><span style=\"opacity: 0.5\">0</span><span style=\"opacity: 0.5\">..</span><span style=\"opacity: 0.5\">*</span></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://build.fhir.org/types.html#Base\">Base</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">Bản tin BHXH → TTDLQG (dịch vụ G12) — Logical Model (Phụ lục 03)</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.contentType\" title=\"content-type - application/json\">contentType</a><a name=\"vnHealthCheckupG12EnvelopeLm.contentType\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">content-type - application/json</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.authorization\" title=\"authorization - API Key do TTDLQG cấp\">authorization</a><a name=\"vnHealthCheckupG12EnvelopeLm.authorization\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">authorization - API Key do TTDLQG cấp</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.dataType\" title=\"data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ)\">dataType</a><a name=\"vnHealthCheckupG12EnvelopeLm.dataType\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ)</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.requestId\" title=\"request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống\">requestId</a><a name=\"vnHealthCheckupG12EnvelopeLm.requestId\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.requestTime\" title=\"request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout\">requestTime</a><a name=\"vnHealthCheckupG12EnvelopeLm.requestTime\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.xService\" title=\"X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12\">xService</a><a name=\"vnHealthCheckupG12EnvelopeLm.xService\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.fileName\" title=\"fileName - Tên bản tin đã ký số\">fileName</a><a name=\"vnHealthCheckupG12EnvelopeLm.fileName\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">fileName - Tên bản tin đã ký số</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.fileContent\" title=\"fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh)\">fileContent</a><a name=\"vnHealthCheckupG12EnvelopeLm.fileContent\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">1..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh)</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.statusCode\" title=\"statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG)\">statusCode</a><a name=\"vnHealthCheckupG12EnvelopeLm.statusCode\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">0..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG)</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: white\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck10.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: white; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.errorCode\" title=\"errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại\">errorCode</a><a name=\"vnHealthCheckupG12EnvelopeLm.errorCode\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">0..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: white; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại</td></tr>#xD;\n<tr style=\"border: 0px #F0F0F0 solid; padding:0px; vertical-align: top; background-color: #F7F7F7\"><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px; white-space: nowrap; background-image: url(tbl_bck00.png)\" class=\"hierarchy\"><img src=\"tbl_spacer.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin_end.png\" alt=\".\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\".\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <a href=\"StructureDefinition-vnHealthCheckupG12EnvelopeLm-definitions.html#vnHealthCheckupG12EnvelopeLm.responseTime\" title=\"responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss)\">responseTime</a><a name=\"vnHealthCheckupG12EnvelopeLm.responseTime\"> </a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"/><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">0..1</td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#string\">string</a></td><td style=\"vertical-align: top; text-align : var(--ig-left,left); background-color: #F7F7F7; border: 0px #F0F0F0 solid; padding:0px 4px 0px 4px\" class=\"hierarchy\">responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss)</td></tr>#xD;\n<tr><td colspan=\"5\" class=\"hierarchy\"><br/><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/> Documentation for this format</a></td></tr></table></div>"^^rdf:XMLLiteral ] ] ; # fhir:url [ fhir:v "http://fhir.hl7.org.vn/core/StructureDefinition/vnHealthCheckupG12EnvelopeLm"^^xsd:anyURI ; fhir:l <http://fhir.hl7.org.vn/core/StructureDefinition/vnHealthCheckupG12EnvelopeLm> ] ; # fhir:version [ fhir:v "0.6.0"] ; # fhir:name [ fhir:v "VNHealthCheckupG12EnvelopeLM"] ; # fhir:title [ fhir:v "Bản tin BHXH → TTDLQG (dịch vụ G12) — Logical Model (Phụ lục 03)"] ; # fhir:status [ fhir:v "draft"] ; # fhir:date [ fhir:v "2026-06-10T07:15:44+07:00"^^xsd:dateTime] ; # fhir:publisher [ fhir:v "Omi HealthTech / VN Core FHIR Community Initiative"] ; # fhir:contact ( [ fhir:name [ fhir:v "Omi HealthTech / VN Core FHIR Community Initiative" ] ; ( fhir:telecom [ fhir:system [ fhir:v "url" ] ; fhir:value [ fhir:v "https://hl7.org.vn" ] ] [ fhir:system [ fhir:v "email" ] ; fhir:value [ fhir:v "info@hl7.org.vn" ] ] ) ] [ fhir:name [ fhir:v "Omi HealthTech (OmiGroup)" ] ; ( fhir:telecom [ fhir:system [ fhir:v "url" ] ; fhir:value [ fhir:v "https://omihealthtech.vn" ] ] [ fhir:system [ fhir:v "url" ] ; fhir:value [ fhir:v "https://omigroup.vn" ] ] [ fhir:system [ fhir:v "email" ] ; fhir:value [ fhir:v "info@hl7.org.vn" ] ] ) ] ) ; # fhir:description [ fhir:v "Logical model cho bản tin tiếp nhận dữ liệu khám bệnh từ Bảo hiểm xã hội Việt Nam, đồng bộ qua Trung tâm Dữ liệu Quốc gia (TTDLQG / NDOP — CP.NET) về CSDL sức khỏe Bộ Y tế. API: POST /api/integrate/v1/G12.\nLuồng: BHXH tạo XML (cấu trúc do TTDLQG cung cấp) → base64 → ký số (dịch vụ Ban Cơ yếu) → gửi qua AgentNode. Xác thực: API Key do TTDLQG cấp. X-Service = G12.\nKHÁC với BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ dữ liệu khám bệnh BHXH → CSDL sức khỏe cá nhân.\n**INFORMATIVE / non-normative**: mô hình ánh xạ transport envelope NDOP G12 (không phải FHIR resource normative) — mapping aid cho implementer.\nCăn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 03 đặc tả API."] ; # fhir:jurisdiction ( [ ( fhir:coding [ fhir:system [ fhir:v "urn:iso:std:iso:3166"^^xsd:anyURI ; fhir:l <urn:iso:std:iso:3166> ] ; fhir:code [ fhir:v "VN" ] ; fhir:display [ fhir:v "Viet Nam" ] ] ) ] ) ; # fhir:fhirVersion [ fhir:v "4.0.1"] ; # fhir:mapping ( [ fhir:identity [ fhir:v "vn-fhir" ] ; fhir:uri [ fhir:v "http://fhir.hl7.org.vn/core/mapping/health-checkup-g12-fhir"^^xsd:anyURI ; fhir:l <http://fhir.hl7.org.vn/core/mapping/health-checkup-g12-fhir> ] ; fhir:name [ fhir:v "VN Core FHIR mapping" ] ; fhir:comment [ fhir:v "Envelope vận chuyển NDOP G12; fileContent (base64) là XML dữ liệu khám bệnh đã ký số. Export rules phải bảo toàn tên header và trường nguồn." ] ] ) ; # fhir:kind [ fhir:v "logical"] ; # fhir:abstract [ fhir:v false] ; # fhir:type [ fhir:v "http://fhir.hl7.org.vn/core/StructureDefinition/vnHealthCheckupG12EnvelopeLm"^^xsd:anyURI ; fhir:l <http://fhir.hl7.org.vn/core/StructureDefinition/vnHealthCheckupG12EnvelopeLm> ] ; # fhir:baseDefinition [ fhir:v "http://hl7.org/fhir/StructureDefinition/Base"^^xsd:anyURI ; fhir:l <http://hl7.org/fhir/StructureDefinition/Base> ] ; # fhir:derivation [ fhir:v "specialization"] ; # fhir:snapshot [ ( fhir:extension [ fhir:url [ fhir:v "http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version"^^xsd:anyURI ; fhir:l <http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version> ] ; fhir:value [ a fhir:String ; fhir:v "4.0.1" ] ] ) ; ( fhir:element [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm" ] ; fhir:short [ fhir:v "Bản tin BHXH → TTDLQG (dịch vụ G12) — Logical Model (Phụ lục 03)" ] ; fhir:definition [ fhir:v "Logical model cho bản tin tiếp nhận dữ liệu khám bệnh từ Bảo hiểm xã hội Việt Nam, đồng bộ qua Trung tâm Dữ liệu Quốc gia (TTDLQG / NDOP — CP.NET) về CSDL sức khỏe Bộ Y tế. API: POST /api/integrate/v1/G12.\nLuồng: BHXH tạo XML (cấu trúc do TTDLQG cung cấp) → base64 → ký số (dịch vụ Ban Cơ yếu) → gửi qua AgentNode. Xác thực: API Key do TTDLQG cấp. X-Service = G12.\nKHÁC với BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ dữ liệu khám bệnh BHXH → CSDL sức khỏe cá nhân.\n**INFORMATIVE / non-normative**: mô hình ánh xạ transport envelope NDOP G12 (không phải FHIR resource normative) — mapping aid cho implementer.\nCăn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 03 đặc tả API." ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "*" ] ; fhir:base [ fhir:path [ fhir:v "Base" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "*" ] ] ; fhir:isModifier [ fhir:v false ] ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.contentType" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.contentType" ] ; fhir:short [ fhir:v "content-type - application/json" ] ; fhir:definition [ fhir:v "content-type - application/json" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.contentType" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.authorization" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.authorization" ] ; fhir:short [ fhir:v "authorization - API Key do TTDLQG cấp" ] ; fhir:definition [ fhir:v "authorization - API Key do TTDLQG cấp" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.authorization" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.dataType" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.dataType" ] ; fhir:short [ fhir:v "data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ)" ] ; fhir:definition [ fhir:v "data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ)" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.dataType" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestId" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestId" ] ; fhir:short [ fhir:v "request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống" ] ; fhir:definition [ fhir:v "request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestId" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestTime" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestTime" ] ; fhir:short [ fhir:v "request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout" ] ; fhir:definition [ fhir:v "request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestTime" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.xService" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.xService" ] ; fhir:short [ fhir:v "X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12" ] ; fhir:definition [ fhir:v "X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.xService" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileName" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileName" ] ; fhir:short [ fhir:v "fileName - Tên bản tin đã ký số" ] ; fhir:definition [ fhir:v "fileName - Tên bản tin đã ký số" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileName" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileContent" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileContent" ] ; fhir:short [ fhir:v "fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh)" ] ; fhir:definition [ fhir:v "fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh)" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileContent" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ; ( fhir:mapping [ fhir:identity [ fhir:v "vn-fhir" ] ; fhir:map [ fhir:v "Bundle (document/collection) khám bệnh BHXH; hoặc payload XML 4210/3176 gốc base64" ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.statusCode" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.statusCode" ] ; fhir:short [ fhir:v "statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG)" ] ; fhir:definition [ fhir:v "statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG)" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.statusCode" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.errorCode" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.errorCode" ] ; fhir:short [ fhir:v "errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại" ] ; fhir:definition [ fhir:v "errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.errorCode" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.responseTime" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.responseTime" ] ; fhir:short [ fhir:v "responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss)" ] ; fhir:definition [ fhir:v "responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss)" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; fhir:base [ fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.responseTime" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] ) ] ; # fhir:differential [ ( fhir:element [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm" ] ; fhir:short [ fhir:v "Bản tin BHXH → TTDLQG (dịch vụ G12) — Logical Model (Phụ lục 03)" ] ; fhir:definition [ fhir:v "Logical model cho bản tin tiếp nhận dữ liệu khám bệnh từ Bảo hiểm xã hội Việt Nam, đồng bộ qua Trung tâm Dữ liệu Quốc gia (TTDLQG / NDOP — CP.NET) về CSDL sức khỏe Bộ Y tế. API: POST /api/integrate/v1/G12.\nLuồng: BHXH tạo XML (cấu trúc do TTDLQG cung cấp) → base64 → ký số (dịch vụ Ban Cơ yếu) → gửi qua AgentNode. Xác thực: API Key do TTDLQG cấp. X-Service = G12.\nKHÁC với BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ dữ liệu khám bệnh BHXH → CSDL sức khỏe cá nhân.\n**INFORMATIVE / non-normative**: mô hình ánh xạ transport envelope NDOP G12 (không phải FHIR resource normative) — mapping aid cho implementer.\nCăn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 03 đặc tả API." ] ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.contentType" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.contentType" ] ; fhir:short [ fhir:v "content-type - application/json" ] ; fhir:definition [ fhir:v "content-type - application/json" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.authorization" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.authorization" ] ; fhir:short [ fhir:v "authorization - API Key do TTDLQG cấp" ] ; fhir:definition [ fhir:v "authorization - API Key do TTDLQG cấp" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.dataType" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.dataType" ] ; fhir:short [ fhir:v "data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ)" ] ; fhir:definition [ fhir:v "data-type - Mã dịch vụ/loại dữ liệu (tham chiếu mục mã dịch vụ)" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestId" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestId" ] ; fhir:short [ fhir:v "request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống" ] ; fhir:definition [ fhir:v "request-id - Mã yêu cầu do hệ thống bộ/ngành tự sinh, duy nhất trên hệ thống" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestTime" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.requestTime" ] ; fhir:short [ fhir:v "request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout" ] ; fhir:definition [ fhir:v "request-time - Thời gian yêu cầu (ddMMyyyyHHmmss); lệch >2 phút so với hệ thống nền tảng coi là timeout" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.xService" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.xService" ] ; fhir:short [ fhir:v "X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12" ] ; fhir:definition [ fhir:v "X-Service - Mã định danh điện tử bộ/ngành. Đối với BHXH: G12" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileName" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileName" ] ; fhir:short [ fhir:v "fileName - Tên bản tin đã ký số" ] ; fhir:definition [ fhir:v "fileName - Tên bản tin đã ký số" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileContent" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.fileContent" ] ; fhir:short [ fhir:v "fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh)" ] ; fhir:definition [ fhir:v "fileContent - Giá trị base64 của dữ liệu XML đã ký số (bản tin khám bệnh)" ] ; fhir:min [ fhir:v "1"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ; ( fhir:mapping [ fhir:identity [ fhir:v "vn-fhir" ] ; fhir:map [ fhir:v "Bundle (document/collection) khám bệnh BHXH; hoặc payload XML 4210/3176 gốc base64" ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.statusCode" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.statusCode" ] ; fhir:short [ fhir:v "statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG)" ] ; fhir:definition [ fhir:v "statusCode (response) - 200 Thành công | 400 Lỗi (XML từ TTDLQG)" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.errorCode" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.errorCode" ] ; fhir:short [ fhir:v "errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại" ] ; fhir:definition [ fhir:v "errorCode (response) - Bỏ trống nếu thành công; mã lỗi nếu thất bại" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] [ fhir:id [ fhir:v "vnHealthCheckupG12EnvelopeLm.responseTime" ] ; fhir:path [ fhir:v "vnHealthCheckupG12EnvelopeLm.responseTime" ] ; fhir:short [ fhir:v "responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss)" ] ; fhir:definition [ fhir:v "responseTime (response) - Thời điểm phản hồi (ISO 8601 YYYY-MM-DDTHH:mm:ss)" ] ; fhir:min [ fhir:v "0"^^xsd:nonNegativeInteger ] ; fhir:max [ fhir:v "1" ] ; ( fhir:type [ fhir:code [ fhir:v "string"^^xsd:anyURI ; fhir:l fhir:string ] ] ) ] ) ] . #
IG © 2026+ Omi HealthTech / VN Core FHIR Community Initiative.
Package hl7.fhir.vn.core#0.6.0 based on FHIR 4.0.1.
Sinh ngày
2026-06-10
Liên kết: Mục lục |
Guide Map |
Báo cáo QA