Logical model cho bản tin (envelope) đồng bộ tập dữ liệu hồ sơ sức khỏe từ Bảo hiểm xã hội Việt Nam (bên phát tin, ví dụ sender_id = G12/VSS) về Cơ sở dữ liệu sức khỏe cá nhân của Bộ Y tế qua Trục dữ liệu Bộ Y tế (api.emrhub.vn). API: POST /api/platform/resource-sync/push. Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login, role=department). Định dạng JSON (UTF-8). service-type=100. Payload XML tuân theo mẫu QĐ 3176/QĐ-BYT (GIAMDINHHS). KHÁC với luồng BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ hồ sơ sức khỏe BHXH → CSDL sức khỏe cá nhân. INFORMATIVE / non-normative: mô hình ánh xạ transport envelope resource-sync (không phải FHIR resource normative) — mapping aid cho implementer. Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 03 (Phương án đồng bộ dữ liệu từ BHXH Việt Nam) — THAY Phụ lục 03 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. API OAuth2 + Bearer, POST /api/platform/resource-sync/push (service-type=100, txn_type=sync_ehr, msg_type=101/102), checksum RSASHA256.

HTTP headers của request

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

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.

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.

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).

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.

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.

Content-Type = application/json

Accept = /

Accept-Encoding = gzip,deflate,br

Authorization = Bearer + Access Token (lấy từ POST /api/auth/login, role=department)

service-type = 100 (Dịch vụ data sync vào Trục dữ liệu Bộ Y tế)

header - Thông tin header bản tin (JSON Object)

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

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.

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.

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).

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.

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.

version - Phiên bản hệ thống Trục dữ liệu BYT

sender_id - Mã định danh bên phát tin (ví dụ: G12/VSS — BHXH Việt Nam)

receiver_id - Mã bên nhận tin (ví dụ: TDLBYT)

txn_type - Loại giao dịch. Giá trị cố định: sync_ehr (đồng bộ tập dữ liệu hồ sơ sức khỏe theo QĐ 3176/QĐ-BYT)

msg_id - Mã giao dịch = sender_id + YY (2 ký tự năm) + MM (2 ký tự tháng) + DD (2 ký tự ngày) + UUIDv4 (không gạch)

msg_type - REQUEST cố định = 101 (thông điệp phát tin đồng bộ). Response dùng 102 (xem nhóm response bên dưới)

data_type - Định dạng file. Giá trị: xml/base64 (Phụ lục 03)

send_datetime - Thời điểm đẩy dữ liệu, Unix timestamp 13 số (ms). VĂN BẢN GỐC kiểu Long; mô hình hóa string vì vượt phạm vi FHIR R4 integer 32-bit (INFORMATIVE)

data - File dữ liệu (XML hồ sơ sức khỏe mẫu GIAMDINHHS QĐ 3176/QĐ-BYT) đã encode Base64. VĂN BẢN GỐC ghi Object ở bảng request nhưng phần checksum ghi STRING BASE64 (văn bản tự mâu thuẫn) — mô hình hóa string base64. Bắt buộc trong thực tế dù bảng gốc không đánh dấu 'x'

signature - Chữ ký số checksum RSASHA256 giữa header và data (bên phát tin tạo). Công thức: bỏ whitespace/newline → Uppercase(SHA256(header)) + '.' + Uppercase(SHA256(data)) → RSASHA256 bằng private key → Uppercase(base64). Bắt buộc trong thực tế dù bảng gốc không đánh dấu 'x'

Bản tin phản hồi từ Trục BYT (msg_type=102)

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

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.

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.

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).

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.

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.

version - Phiên bản hệ thống Trục dữ liệu BYT

sender_id (response) - Mã bên nhận-nay-phát (ví dụ TDLBYT)

receiver_id (response) - Mã bên phát tin gốc (ví dụ G12/VSS)

txn_type (response) = sync_ehr

msg_type (response) = 102

msg_id (response) - Mã giao dịch phía Trục (sender_id + YY+MM+DD + UUIDv4)

ref_msg_id - msg_id của bên phát tin gốc

send_datetime (response) - Unix timestamp 13 số

res_datetime - Ngày phản hồi (Unix timestamp 13 số)

res_code - Mã trạng thái tiếp nhận (CM_SUCCESS | CM_INVALID_REQUEST | PS_DS_RSA_SIGNATURE_INVALID/MISSING | PS_DS_CA_SIGNATURE_INVALID/MISSING | PS_DS_VERIFY_SUCCESS/FAIL | PS_DS_SAVE_SUCCESS/FAIL)

res_msg - Diễn giải trạng thái tiếp nhận

data.data_state - Mã trạng thái dữ liệu sau khi về kho

data.data_state_msg - Chi tiết trạng thái dữ liệu (vd 'Data is received')

data.message_check_ca - Trạng thái kiểm tra chữ ký số bản tin

data.message_notify - Trạng thái hệ thống với bản tin (vd 'Successfully inserted data to DATA LAKE')

signature (response) - Chữ ký RSASHA256 của bên nhận tin (Trục BYT)

Logical model cho bản tin (envelope) đồng bộ tập dữ liệu hồ sơ sức khỏe từ Bảo hiểm xã hội Việt Nam (bên phát tin, ví dụ sender_id = G12/VSS) về Cơ sở dữ liệu sức khỏe cá nhân của Bộ Y tế qua Trục dữ liệu Bộ Y tế (api.emrhub.vn). API: POST /api/platform/resource-sync/push. Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login, role=department). Định dạng JSON (UTF-8). service-type=100. Payload XML tuân theo mẫu QĐ 3176/QĐ-BYT (GIAMDINHHS). KHÁC với luồng BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ hồ sơ sức khỏe BHXH → CSDL sức khỏe cá nhân. INFORMATIVE / non-normative: mô hình ánh xạ transport envelope resource-sync (không phải FHIR resource normative) — mapping aid cho implementer. Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 03 (Phương án đồng bộ dữ liệu từ BHXH Việt Nam) — THAY Phụ lục 03 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. API OAuth2 + Bearer, POST /api/platform/resource-sync/push (service-type=100, txn_type=sync_ehr, msg_type=101/102), checksum RSASHA256.

HTTP headers của request

Content-Type = application/json

Accept = /

Accept-Encoding = gzip,deflate,br

Authorization = Bearer + Access Token (lấy từ POST /api/auth/login, role=department)

service-type = 100 (Dịch vụ data sync vào Trục dữ liệu Bộ Y tế)

header - Thông tin header bản tin (JSON Object)

version - Phiên bản hệ thống Trục dữ liệu BYT

sender_id - Mã định danh bên phát tin (ví dụ: G12/VSS — BHXH Việt Nam)

receiver_id - Mã bên nhận tin (ví dụ: TDLBYT)

txn_type - Loại giao dịch. Giá trị cố định: sync_ehr (đồng bộ tập dữ liệu hồ sơ sức khỏe theo QĐ 3176/QĐ-BYT)

msg_id - Mã giao dịch = sender_id + YY (2 ký tự năm) + MM (2 ký tự tháng) + DD (2 ký tự ngày) + UUIDv4 (không gạch)

msg_type - REQUEST cố định = 101 (thông điệp phát tin đồng bộ). Response dùng 102 (xem nhóm response bên dưới)

data_type - Định dạng file. Giá trị: xml/base64 (Phụ lục 03)

send_datetime - Thời điểm đẩy dữ liệu, Unix timestamp 13 số (ms). VĂN BẢN GỐC kiểu Long; mô hình hóa string vì vượt phạm vi FHIR R4 integer 32-bit (INFORMATIVE)

data - File dữ liệu (XML hồ sơ sức khỏe mẫu GIAMDINHHS QĐ 3176/QĐ-BYT) đã encode Base64. VĂN BẢN GỐC ghi Object ở bảng request nhưng phần checksum ghi STRING BASE64 (văn bản tự mâu thuẫn) — mô hình hóa string base64. Bắt buộc trong thực tế dù bảng gốc không đánh dấu 'x'

signature - Chữ ký số checksum RSASHA256 giữa header và data (bên phát tin tạo). Công thức: bỏ whitespace/newline → Uppercase(SHA256(header)) + '.' + Uppercase(SHA256(data)) → RSASHA256 bằng private key → Uppercase(base64). Bắt buộc trong thực tế dù bảng gốc không đánh dấu 'x'

Bản tin phản hồi từ Trục BYT (msg_type=102)

version - Phiên bản hệ thống Trục dữ liệu BYT

sender_id (response) - Mã bên nhận-nay-phát (ví dụ TDLBYT)

receiver_id (response) - Mã bên phát tin gốc (ví dụ G12/VSS)

txn_type (response) = sync_ehr

msg_type (response) = 102

msg_id (response) - Mã giao dịch phía Trục (sender_id + YY+MM+DD + UUIDv4)

ref_msg_id - msg_id của bên phát tin gốc

send_datetime (response) - Unix timestamp 13 số

res_datetime - Ngày phản hồi (Unix timestamp 13 số)

res_code - Mã trạng thái tiếp nhận (CM_SUCCESS | CM_INVALID_REQUEST | PS_DS_RSA_SIGNATURE_INVALID/MISSING | PS_DS_CA_SIGNATURE_INVALID/MISSING | PS_DS_VERIFY_SUCCESS/FAIL | PS_DS_SAVE_SUCCESS/FAIL)

res_msg - Diễn giải trạng thái tiếp nhận

data.data_state - Mã trạng thái dữ liệu sau khi về kho

data.data_state_msg - Chi tiết trạng thái dữ liệu (vd 'Data is received')

data.message_check_ca - Trạng thái kiểm tra chữ ký số bản tin

data.message_notify - Trạng thái hệ thống với bản tin (vd 'Successfully inserted data to DATA LAKE')

signature (response) - Chữ ký RSASHA256 của bên nhận tin (Trục BYT)

Logical model cho bản tin (envelope) đồng bộ tập dữ liệu hồ sơ sức khỏe từ Bảo hiểm xã hội Việt Nam (bên phát tin, ví dụ sender_id = G12/VSS) về Cơ sở dữ liệu sức khỏe cá nhân của Bộ Y tế qua Trục dữ liệu Bộ Y tế (api.emrhub.vn). API: POST /api/platform/resource-sync/push. Xác thực: OAuth2 + Bearer Token (lấy từ /api/auth/login, role=department). Định dạng JSON (UTF-8). service-type=100. Payload XML tuân theo mẫu QĐ 3176/QĐ-BYT (GIAMDINHHS). KHÁC với luồng BHYT Gateway thanh toán (gdbhyt.baohiemxahoi.gov.vn, XML 4210) — đây là surface đồng bộ hồ sơ sức khỏe BHXH → CSDL sức khỏe cá nhân. INFORMATIVE / non-normative: mô hình ánh xạ transport envelope resource-sync (không phải FHIR resource normative) — mapping aid cho implementer. Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 03 (Phương án đồng bộ dữ liệu từ BHXH Việt Nam) — THAY Phụ lục 03 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. API OAuth2 + Bearer, POST /api/platform/resource-sync/push (service-type=100, txn_type=sync_ehr, msg_type=101/102), checksum RSASHA256.

HTTP headers của request

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

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.

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.

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).

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.

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.

Content-Type = application/json

Accept = /

Accept-Encoding = gzip,deflate,br

Authorization = Bearer + Access Token (lấy từ POST /api/auth/login, role=department)

service-type = 100 (Dịch vụ data sync vào Trục dữ liệu Bộ Y tế)

header - Thông tin header bản tin (JSON Object)

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

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.

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.

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).

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.

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.

version - Phiên bản hệ thống Trục dữ liệu BYT

sender_id - Mã định danh bên phát tin (ví dụ: G12/VSS — BHXH Việt Nam)

receiver_id - Mã bên nhận tin (ví dụ: TDLBYT)

txn_type - Loại giao dịch. Giá trị cố định: sync_ehr (đồng bộ tập dữ liệu hồ sơ sức khỏe theo QĐ 3176/QĐ-BYT)

msg_id - Mã giao dịch = sender_id + YY (2 ký tự năm) + MM (2 ký tự tháng) + DD (2 ký tự ngày) + UUIDv4 (không gạch)

msg_type - REQUEST cố định = 101 (thông điệp phát tin đồng bộ). Response dùng 102 (xem nhóm response bên dưới)

data_type - Định dạng file. Giá trị: xml/base64 (Phụ lục 03)

send_datetime - Thời điểm đẩy dữ liệu, Unix timestamp 13 số (ms). VĂN BẢN GỐC kiểu Long; mô hình hóa string vì vượt phạm vi FHIR R4 integer 32-bit (INFORMATIVE)

data - File dữ liệu (XML hồ sơ sức khỏe mẫu GIAMDINHHS QĐ 3176/QĐ-BYT) đã encode Base64. VĂN BẢN GỐC ghi Object ở bảng request nhưng phần checksum ghi STRING BASE64 (văn bản tự mâu thuẫn) — mô hình hóa string base64. Bắt buộc trong thực tế dù bảng gốc không đánh dấu 'x'

signature - Chữ ký số checksum RSASHA256 giữa header và data (bên phát tin tạo). Công thức: bỏ whitespace/newline → Uppercase(SHA256(header)) + '.' + Uppercase(SHA256(data)) → RSASHA256 bằng private key → Uppercase(base64). Bắt buộc trong thực tế dù bảng gốc không đánh dấu 'x'

Bản tin phản hồi từ Trục BYT (msg_type=102)

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

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.

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.

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).

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.

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.

version - Phiên bản hệ thống Trục dữ liệu BYT

sender_id (response) - Mã bên nhận-nay-phát (ví dụ TDLBYT)

receiver_id (response) - Mã bên phát tin gốc (ví dụ G12/VSS)

txn_type (response) = sync_ehr

msg_type (response) = 102

msg_id (response) - Mã giao dịch phía Trục (sender_id + YY+MM+DD + UUIDv4)

ref_msg_id - msg_id của bên phát tin gốc

send_datetime (response) - Unix timestamp 13 số

res_datetime - Ngày phản hồi (Unix timestamp 13 số)

res_code - Mã trạng thái tiếp nhận (CM_SUCCESS | CM_INVALID_REQUEST | PS_DS_RSA_SIGNATURE_INVALID/MISSING | PS_DS_CA_SIGNATURE_INVALID/MISSING | PS_DS_VERIFY_SUCCESS/FAIL | PS_DS_SAVE_SUCCESS/FAIL)

res_msg - Diễn giải trạng thái tiếp nhận

data.data_state - Mã trạng thái dữ liệu sau khi về kho

data.data_state_msg - Chi tiết trạng thái dữ liệu (vd 'Data is received')

data.message_check_ca - Trạng thái kiểm tra chữ ký số bản tin

data.message_notify - Trạng thái hệ thống với bản tin (vd 'Successfully inserted data to DATA LAKE')

signature (response) - Chữ ký RSASHA256 của bên nhận tin (Trục BYT)