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 - Local Development build (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-14 |
Biểu diễn XML của vnHealthCheckupDataSyncEnvelopeLm mô hình logic.
<StructureDefinition xmlns="http://hl7.org/fhir">
<id value="vnHealthCheckupDataSyncEnvelopeLm"/>
<language value="vi"/>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: StructureDefinition vnHealthCheckupDataSyncEnvelopeLm</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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm" title="Logical model cho bản tin (envelope) đồng bộ tự động tập dữ liệu khám sức khỏe định kỳ từ cơ sở KCB lên Cổng/Trục dữ liệu sức khỏe Bộ Y tế (api.emrhub.vn). API: POST /api/platform/data-sync/push.
Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login). Định dạng JSON (UTF-8).
KHÁC với luồng BHYT Gateway (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface liên thông KSK quốc gia.
**INFORMATIVE / non-normative**: đây là mô hình ánh xạ transport envelope (không phải FHIR resource normative). Các National Core IG (KR/JP) chỉ chuẩn hóa profile/search/capability RESTful; envelope được giữ làm mapping aid để implementer ánh xạ payload FHIR ↔ bản tin đồng bộ.
Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 02 đặc tả API.">vnHealthCheckupDataSyncEnvelopeLm</a><a name="vnHealthCheckupDataSyncEnvelopeLm"> </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 đồng bộ dữ liệu KSK lên Trục dữ liệu BYT — Logical Model (Phụ lục 02)</td></tr>
<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_bck11.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_datatype.gif" alt="." style="background-color: #F7F7F7; background-color: inherit" title="Data Type" class="hierarchy"/> <a href="StructureDefinition-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header" title="header - Thông tin header bản tin">header</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header"> </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#BackboneElement">BackboneElement</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">header - Thông tin header bản tin</td></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_bck110.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vline.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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header.version" title="version - Phiên bản hệ thống Trục dữ liệu BYT">version</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header.version"> </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">version - Phiên bản hệ thống Trục dữ liệu BYT</td></tr>
<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_bck110.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vline.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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header.senderId" title="sender_id - Mã định danh bên phát tin (13 số mã định danh CSKCB)">senderId</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header.senderId"> </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">sender_id - Mã định danh bên phát tin (13 số mã định danh CSKCB)</td></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_bck110.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vline.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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header.receiverId" title="receiver_id - Mã bên nhận tin (vd: TDLBYT)">receiverId</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header.receiverId"> </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">receiver_id - Mã bên nhận tin (vd: TDLBYT)</td></tr>
<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_bck110.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vline.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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header.txnType" title="txn_type - Loại giao dịch (snc_checkup: đồng bộ tập dữ liệu KSK định kỳ)">txnType</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header.txnType"> </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">txn_type - Loại giao dịch (snc_checkup: đồng bộ tập dữ liệu KSK định kỳ)</td></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_bck110.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vline.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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header.msgId" title="msg_id - Mã giao dịch = sender_id + YY + MM + NN + UUIDv4">msgId</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header.msgId"> </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">msg_id - Mã giao dịch = sender_id + YY + MM + NN + UUIDv4</td></tr>
<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_bck110.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vline.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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header.msgType" title="msg_type - 101: Thông điệp phát tin đồng bộ (request); 102: Trục đã nhận dữ liệu (response). service-type=100 (data sync)">msgType</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header.msgType"> </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">msg_type - 101: Thông điệp phát tin đồng bộ (request); 102: Trục đã nhận dữ liệu (response). service-type=100 (data sync)</td></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_bck110.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vline.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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header.dataType" title="data_type - Định dạng file (xml/base64, json/base64, png/base64, jpg/base64, pdf/base64)">dataType</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header.dataType"> </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">data_type - Định dạng file (xml/base64, json/base64, png/base64, jpg/base64, pdf/base64)</td></tr>
<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_bck100.png)" class="hierarchy"><img src="tbl_spacer.png" alt="." style="background-color: inherit" class="hierarchy"/><img src="tbl_vline.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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.header.sendDatetime" title="send_datetime - Thời điểm đẩy dữ liệu (Unix timestamp 13 số ms — dùng string vì vượt FHIR R4 integer 32-bit)">sendDatetime</a><a name="vnHealthCheckupDataSyncEnvelopeLm.header.sendDatetime"> </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">send_datetime - Thời điểm đẩy dữ liệu (Unix timestamp 13 số ms — dùng string vì vượt FHIR R4 integer 32-bit)</td></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_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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.data" title="data - File dữ liệu (XML/JSON) đã encode Base64">data</a><a name="vnHealthCheckupDataSyncEnvelopeLm.data"> </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">data - File dữ liệu (XML/JSON) đã encode Base64</td></tr>
<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-vnHealthCheckupDataSyncEnvelopeLm-definitions.html#vnHealthCheckupDataSyncEnvelopeLm.signature" title="signature - Chữ ký số checksum SHA256RSA giữa header và data (bên phát tin tạo)">signature</a><a name="vnHealthCheckupDataSyncEnvelopeLm.signature"> </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">signature - Chữ ký số checksum SHA256RSA giữa header và data (bên phát tin tạo)</td></tr>
<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>
</text>
<url
value="http://fhir.hl7.org.vn/core/StructureDefinition/vnHealthCheckupDataSyncEnvelopeLm"/>
<version value="0.6.0"/>
<name value="VNHealthCheckupDataSyncEnvelopeLM"/>
<title
value="Bản tin đồng bộ dữ liệu KSK lên Trục dữ liệu BYT — Logical Model (Phụ lục 02)"/>
<status value="draft"/>
<date value="2026-06-14T00:18:08+07:00"/>
<publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<contact>
<name value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="info@hl7.org.vn"/>
</telecom>
</contact>
<contact>
<name value="Omi HealthTech (OmiGroup)"/>
<telecom>
<system value="url"/>
<value value="https://omihealthtech.vn"/>
</telecom>
<telecom>
<system value="url"/>
<value value="https://omigroup.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="info@hl7.org.vn"/>
</telecom>
</contact>
<description
value="Logical model cho bản tin (envelope) đồng bộ tự động tập dữ liệu khám sức khỏe định kỳ từ cơ sở KCB lên Cổng/Trục dữ liệu sức khỏe Bộ Y tế (api.emrhub.vn). API: POST /api/platform/data-sync/push.
Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login). Định dạng JSON (UTF-8).
KHÁC với luồng BHYT Gateway (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface liên thông KSK quốc gia.
**INFORMATIVE / non-normative**: đây là mô hình ánh xạ transport envelope (không phải FHIR resource normative). Các National Core IG (KR/JP) chỉ chuẩn hóa profile/search/capability RESTful; envelope được giữ làm mapping aid để implementer ánh xạ payload FHIR ↔ bản tin đồng bộ.
Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 02 đặc tả API."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<fhirVersion value="4.0.1"/>
<mapping>
<identity value="vn-fhir"/>
<uri
value="http://fhir.hl7.org.vn/core/mapping/health-checkup-data-sync-fhir"/>
<name value="VN Core FHIR mapping"/>
<comment
value="Envelope vận chuyển; payload data (base64) là tập dữ liệu mẫu phiếu KSK (xem VNHealthCheckupDataSetLM). Export rules phải bảo toàn tên trường nguồn."/>
</mapping>
<kind value="logical"/>
<abstract value="false"/>
<type
value="http://fhir.hl7.org.vn/core/StructureDefinition/vnHealthCheckupDataSyncEnvelopeLm"/>
<baseDefinition value="http://hl7.org/fhir/StructureDefinition/Base"/>
<derivation value="specialization"/>
<snapshot>
<extension
url="http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version">
<valueString value="4.0.1"/>
</extension>
<element id="vnHealthCheckupDataSyncEnvelopeLm">
<path value="vnHealthCheckupDataSyncEnvelopeLm"/>
<short
value="Bản tin đồng bộ dữ liệu KSK lên Trục dữ liệu BYT — Logical Model (Phụ lục 02)"/>
<definition
value="Logical model cho bản tin (envelope) đồng bộ tự động tập dữ liệu khám sức khỏe định kỳ từ cơ sở KCB lên Cổng/Trục dữ liệu sức khỏe Bộ Y tế (api.emrhub.vn). API: POST /api/platform/data-sync/push.
Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login). Định dạng JSON (UTF-8).
KHÁC với luồng BHYT Gateway (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface liên thông KSK quốc gia.
**INFORMATIVE / non-normative**: đây là mô hình ánh xạ transport envelope (không phải FHIR resource normative). Các National Core IG (KR/JP) chỉ chuẩn hóa profile/search/capability RESTful; envelope được giữ làm mapping aid để implementer ánh xạ payload FHIR ↔ bản tin đồng bộ.
Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 02 đặc tả API."/>
<min value="0"/>
<max value="*"/>
<base>
<path value="Base"/>
<min value="0"/>
<max value="*"/>
</base>
<isModifier value="false"/>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header"/>
<short value="header - Thông tin header bản tin"/>
<definition value="header - Thông tin header bản tin"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="BackboneElement"/>
</type>
<constraint>
<key value="ele-1"/>
<severity value="error"/>
<human value="All FHIR elements must have a @value or children"/>
<expression
value="hasValue() or (children().count() > id.count())"/>
<xpath value="@value|f:*|h:div"/>
<source value="http://hl7.org/fhir/StructureDefinition/Element"/>
</constraint>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.id">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.id"/>
<representation value="xmlAttr"/>
<short value="Unique id for inter-element referencing"/>
<definition
value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces."/>
<min value="0"/>
<max value="1"/>
<base>
<path value="Element.id"/>
<min value="0"/>
<max value="1"/>
</base>
<type>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
<valueUrl value="string"/>
</extension>
<code value="http://hl7.org/fhirpath/System.String"/>
</type>
<isModifier value="false"/>
<isSummary value="false"/>
<mapping>
<identity value="rim"/>
<map value="n/a"/>
</mapping>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.extension">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.extension"/>
<slicing>
<discriminator>
<type value="value"/>
<path value="url"/>
</discriminator>
<description value="Extensions are always sliced by (at least) url"/>
<rules value="open"/>
</slicing>
<short value="Additional content defined by implementations"/>
<definition
value="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension."/>
<comment
value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone."/>
<alias value="extensions"/>
<alias value="user content"/>
<min value="0"/>
<max value="*"/>
<base>
<path value="Element.extension"/>
<min value="0"/>
<max value="*"/>
</base>
<type>
<code value="Extension"/>
</type>
<constraint>
<key value="ele-1"/>
<severity value="error"/>
<human value="All FHIR elements must have a @value or children"/>
<expression
value="hasValue() or (children().count() > id.count())"/>
<xpath value="@value|f:*|h:div"/>
<source value="http://hl7.org/fhir/StructureDefinition/Element"/>
</constraint>
<constraint>
<key value="ext-1"/>
<severity value="error"/>
<human value="Must have either extensions or value[x], not both"/>
<expression value="extension.exists() != value.exists()"/>
<xpath
value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])"/>
<source value="http://hl7.org/fhir/StructureDefinition/Extension"/>
</constraint>
<isModifier value="false"/>
<isSummary value="false"/>
<mapping>
<identity value="rim"/>
<map value="n/a"/>
</mapping>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.modifierExtension">
<path
value="vnHealthCheckupDataSyncEnvelopeLm.header.modifierExtension"/>
<short value="Extensions that cannot be ignored even if unrecognized"/>
<definition
value="May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.
Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself)."/>
<comment
value="There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone."/>
<requirements
value="Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension)."/>
<alias value="extensions"/>
<alias value="user content"/>
<alias value="modifiers"/>
<min value="0"/>
<max value="*"/>
<base>
<path value="BackboneElement.modifierExtension"/>
<min value="0"/>
<max value="*"/>
</base>
<type>
<code value="Extension"/>
</type>
<constraint>
<key value="ele-1"/>
<severity value="error"/>
<human value="All FHIR elements must have a @value or children"/>
<expression
value="hasValue() or (children().count() > id.count())"/>
<xpath value="@value|f:*|h:div"/>
<source value="http://hl7.org/fhir/StructureDefinition/Element"/>
</constraint>
<constraint>
<key value="ext-1"/>
<severity value="error"/>
<human value="Must have either extensions or value[x], not both"/>
<expression value="extension.exists() != value.exists()"/>
<xpath
value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])"/>
<source value="http://hl7.org/fhir/StructureDefinition/Extension"/>
</constraint>
<isModifier value="true"/>
<isModifierReason
value="Modifier extensions are expected to modify the meaning or interpretation of the element that contains them"/>
<isSummary value="true"/>
<mapping>
<identity value="rim"/>
<map value="N/A"/>
</mapping>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.version">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.version"/>
<short value="version - Phiên bản hệ thống Trục dữ liệu BYT"/>
<definition value="version - Phiên bản hệ thống Trục dữ liệu BYT"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.version"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.senderId">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.senderId"/>
<short
value="sender_id - Mã định danh bên phát tin (13 số mã định danh CSKCB)"/>
<definition
value="sender_id - Mã định danh bên phát tin (13 số mã định danh CSKCB)"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.senderId"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
<mapping>
<identity value="vn-fhir"/>
<map value="Organization.identifier[MaGtin].value (đơn vị phát tin)"/>
</mapping>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.receiverId">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.receiverId"/>
<short value="receiver_id - Mã bên nhận tin (vd: TDLBYT)"/>
<definition value="receiver_id - Mã bên nhận tin (vd: TDLBYT)"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.receiverId"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.txnType">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.txnType"/>
<short
value="txn_type - Loại giao dịch (snc_checkup: đồng bộ tập dữ liệu KSK định kỳ)"/>
<definition
value="txn_type - Loại giao dịch (snc_checkup: đồng bộ tập dữ liệu KSK định kỳ)"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.txnType"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.msgId">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.msgId"/>
<short
value="msg_id - Mã giao dịch = sender_id + YY + MM + NN + UUIDv4"/>
<definition
value="msg_id - Mã giao dịch = sender_id + YY + MM + NN + UUIDv4"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.msgId"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.msgType">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.msgType"/>
<short
value="msg_type - 101: Thông điệp phát tin đồng bộ (request); 102: Trục đã nhận dữ liệu (response). service-type=100 (data sync)"/>
<definition
value="msg_type - 101: Thông điệp phát tin đồng bộ (request); 102: Trục đã nhận dữ liệu (response). service-type=100 (data sync)"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.msgType"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.dataType">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.dataType"/>
<short
value="data_type - Định dạng file (xml/base64, json/base64, png/base64, jpg/base64, pdf/base64)"/>
<definition
value="data_type - Định dạng file (xml/base64, json/base64, png/base64, jpg/base64, pdf/base64)"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.dataType"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.sendDatetime">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.sendDatetime"/>
<short
value="send_datetime - Thời điểm đẩy dữ liệu (Unix timestamp 13 số ms — dùng string vì vượt FHIR R4 integer 32-bit)"/>
<definition
value="send_datetime - Thời điểm đẩy dữ liệu (Unix timestamp 13 số ms — dùng string vì vượt FHIR R4 integer 32-bit)"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.sendDatetime"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.data">
<path value="vnHealthCheckupDataSyncEnvelopeLm.data"/>
<short value="data - File dữ liệu (XML/JSON) đã encode Base64"/>
<definition value="data - File dữ liệu (XML/JSON) đã encode Base64"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.data"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
<mapping>
<identity value="vn-fhir"/>
<map
value="Bundle (document) chứa VNCoreCompositionHealthCheckup + Observation/Condition... được serialize và base64; hoặc payload XML/JSON gốc theo data_type"/>
</mapping>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.signature">
<path value="vnHealthCheckupDataSyncEnvelopeLm.signature"/>
<short
value="signature - Chữ ký số checksum SHA256RSA giữa header và data (bên phát tin tạo)"/>
<definition
value="signature - Chữ ký số checksum SHA256RSA giữa header và data (bên phát tin tạo)"/>
<min value="1"/>
<max value="1"/>
<base>
<path value="vnHealthCheckupDataSyncEnvelopeLm.signature"/>
<min value="1"/>
<max value="1"/>
</base>
<type>
<code value="string"/>
</type>
<mapping>
<identity value="vn-fhir"/>
<map value="Bundle.signature | Provenance.signature (SHA256RSA)"/>
</mapping>
</element>
</snapshot>
<differential>
<element id="vnHealthCheckupDataSyncEnvelopeLm">
<path value="vnHealthCheckupDataSyncEnvelopeLm"/>
<short
value="Bản tin đồng bộ dữ liệu KSK lên Trục dữ liệu BYT — Logical Model (Phụ lục 02)"/>
<definition
value="Logical model cho bản tin (envelope) đồng bộ tự động tập dữ liệu khám sức khỏe định kỳ từ cơ sở KCB lên Cổng/Trục dữ liệu sức khỏe Bộ Y tế (api.emrhub.vn). API: POST /api/platform/data-sync/push.
Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login). Định dạng JSON (UTF-8).
KHÁC với luồng BHYT Gateway (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface liên thông KSK quốc gia.
**INFORMATIVE / non-normative**: đây là mô hình ánh xạ transport envelope (không phải FHIR resource normative). Các National Core IG (KR/JP) chỉ chuẩn hóa profile/search/capability RESTful; envelope được giữ làm mapping aid để implementer ánh xạ payload FHIR ↔ bản tin đồng bộ.
Căn cứ: QĐ 1551/QĐ-BYT (31/5/2026) — Phụ lục 02 đặc tả API."/>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header"/>
<short value="header - Thông tin header bản tin"/>
<definition value="header - Thông tin header bản tin"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="BackboneElement"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.version">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.version"/>
<short value="version - Phiên bản hệ thống Trục dữ liệu BYT"/>
<definition value="version - Phiên bản hệ thống Trục dữ liệu BYT"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.senderId">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.senderId"/>
<short
value="sender_id - Mã định danh bên phát tin (13 số mã định danh CSKCB)"/>
<definition
value="sender_id - Mã định danh bên phát tin (13 số mã định danh CSKCB)"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
<mapping>
<identity value="vn-fhir"/>
<map value="Organization.identifier[MaGtin].value (đơn vị phát tin)"/>
</mapping>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.receiverId">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.receiverId"/>
<short value="receiver_id - Mã bên nhận tin (vd: TDLBYT)"/>
<definition value="receiver_id - Mã bên nhận tin (vd: TDLBYT)"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.txnType">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.txnType"/>
<short
value="txn_type - Loại giao dịch (snc_checkup: đồng bộ tập dữ liệu KSK định kỳ)"/>
<definition
value="txn_type - Loại giao dịch (snc_checkup: đồng bộ tập dữ liệu KSK định kỳ)"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.msgId">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.msgId"/>
<short
value="msg_id - Mã giao dịch = sender_id + YY + MM + NN + UUIDv4"/>
<definition
value="msg_id - Mã giao dịch = sender_id + YY + MM + NN + UUIDv4"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.msgType">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.msgType"/>
<short
value="msg_type - 101: Thông điệp phát tin đồng bộ (request); 102: Trục đã nhận dữ liệu (response). service-type=100 (data sync)"/>
<definition
value="msg_type - 101: Thông điệp phát tin đồng bộ (request); 102: Trục đã nhận dữ liệu (response). service-type=100 (data sync)"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.dataType">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.dataType"/>
<short
value="data_type - Định dạng file (xml/base64, json/base64, png/base64, jpg/base64, pdf/base64)"/>
<definition
value="data_type - Định dạng file (xml/base64, json/base64, png/base64, jpg/base64, pdf/base64)"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.header.sendDatetime">
<path value="vnHealthCheckupDataSyncEnvelopeLm.header.sendDatetime"/>
<short
value="send_datetime - Thời điểm đẩy dữ liệu (Unix timestamp 13 số ms — dùng string vì vượt FHIR R4 integer 32-bit)"/>
<definition
value="send_datetime - Thời điểm đẩy dữ liệu (Unix timestamp 13 số ms — dùng string vì vượt FHIR R4 integer 32-bit)"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.data">
<path value="vnHealthCheckupDataSyncEnvelopeLm.data"/>
<short value="data - File dữ liệu (XML/JSON) đã encode Base64"/>
<definition value="data - File dữ liệu (XML/JSON) đã encode Base64"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
<mapping>
<identity value="vn-fhir"/>
<map
value="Bundle (document) chứa VNCoreCompositionHealthCheckup + Observation/Condition... được serialize và base64; hoặc payload XML/JSON gốc theo data_type"/>
</mapping>
</element>
<element id="vnHealthCheckupDataSyncEnvelopeLm.signature">
<path value="vnHealthCheckupDataSyncEnvelopeLm.signature"/>
<short
value="signature - Chữ ký số checksum SHA256RSA giữa header và data (bên phát tin tạo)"/>
<definition
value="signature - Chữ ký số checksum SHA256RSA giữa header và data (bên phát tin tạo)"/>
<min value="1"/>
<max value="1"/>
<type>
<code value="string"/>
</type>
<mapping>
<identity value="vn-fhir"/>
<map value="Bundle.signature | Provenance.signature (SHA256RSA)"/>
</mapping>
</element>
</differential>
</StructureDefinition>