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ộ. Môi trường (PL02 mục 2): Cổng dữ liệu sức khỏe BYT — admin https://csdlksk.vn (sandbox https://sandbox.csdlksk.vn); Trục dữ liệu BYT — admin https://admin.emrhub.vn (sandbox https://admin-sandbox.emrhub.vn), API https://api.emrhub.vn (sandbox https://api-sandbox.emrhub.vn). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 02 (Hướng dẫn kết nối, liên thông dữ liệu) — THAY Phụ lục 02 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. API OAuth2 + Bearer, POST /api/platform/data-sync/push (service-type=100, msg_type=101/102, txn_type=sync_checkup), checksum RSASHA256. ĐÃ ĐỐI CHIẾU TOÀN VĂN PL02 ngày 23/07/2026 (file 'Phu luc 2-5.pdf' nhúng trong bản docx user cung cấp).

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 + Authorization Token (văn bản gọi 'Authorization Token'; lấy từ POST /api/auth/login — response cấp token/refresh_token/duration giây/role: facility=Cơ sở KCB, doh=Sở Y tế)

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 (13 số mã định danh CSKCB từ Cục KCB)

receiver_id - Mã bên nhận tin (vd: TDLBYT)

txn_type - Loại giao dịch. Giá trị cố định: sync_checkup (đồng bộ tập dữ liệu KSK định kỳ)

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). service-type=100

data_type - Định dạng file. Giá trị: xml/base64 HOẶC json/base64 (chỉ 2 giá trị này theo Phụ lục 02)

send_datetime - Thời điểm đẩy dữ liệu, Unix timestamp 13 số. 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/JSON) đã encode Base64 (STRING BASE64 theo quy tắc mục 4 PL02). 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 PL02 mục 4: A=Uppercase(SHA256(header)); B=Uppercase(SHA256(data)); C=A+'.'+B; SIGNATURE=Uppercase(RSASHA256(C, Private Key)). Quy tắc: bỏ whitespace/xuống dòng trước khi hash; header rỗng truyền {}; data là STRING BASE64. BYT cấp cặp khóa cho đơn vị; bản tin còn phải KÝ SỐ TỔ CHỨC trước khi gửi (Trục xác thực trước khi nhận). 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 (13 số mã định danh CSKCB)

txn_id - Mã giao dịch do Trục sinh = XX (2 ký tự dịch vụ) + '-' + sender_id + '-' + YY + MM + DD + UUIDv4 không gạch (cấu trúc KHÁC msg_id)

txn_type (response) = sync_checkup

msg_type (response) = 102 (Trục đã nhận dữ liệu và thực hiện đồng bộ)

msg_id (response) - sender_id + YY + MM + DD + UUIDv4 không gạch

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

send_datetime (response) - Ngày gửi của bên phát tin, Unix timestamp 13 số

res_datetime - Ngày phản hồi của bên nhận tin (Unix timestamp 13 số)

res_code - Mã trạng thái tiếp nhận, đủ 10 mã theo PL02: CM_SUCCESS | CM_INVALID_REQUEST | PS_DS_RSA_SIGNATURE_INVALID | PS_DS_RSA_SIGNATURE_MISSING | PS_DS_CA_SIGNATURE_INVALID | PS_DS_CA_SIGNATURE_MISSING | PS_DS_VERIFY_SUCCESS | PS_DS_VERIFY_FAIL | PS_DS_SAVE_SUCCESS | PS_DS_SAVE_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 (vd '0')

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 (vd 'Digitally signed XML data')

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 Trục BYT

Xác thực tài khoản liên thông (POST /api/auth/login) — INFORMATIVE, TRANSPORT-ONLY: username/password/token là thông tin phiên truyền tải, TUYỆT ĐỐI không persist vào FHIR store/clinical Bundle/log; quản lý trong lớp IAM của hệ thống gửi

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.

username - Tên đăng nhập tài khoản liên thông do Trục dữ liệu BYT cấp

password - Mật khẩu

data.token - Token gọi API nghiệp vụ (response)

data.refresh_token - Cấp lại token khi hết hiệu lực

data.duration - Thời gian hiệu lực token, đơn vị giây (VĂN BẢN GỐC kiểu Long)

data.role - Phân quyền: facility (Cơ sở KCB) | doh (Sở Y tế)

header.res_code - CM_SUCCESS | CM_AUTH_ACCOUNT_FAIL

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ộ. Môi trường (PL02 mục 2): Cổng dữ liệu sức khỏe BYT — admin https://csdlksk.vn (sandbox https://sandbox.csdlksk.vn); Trục dữ liệu BYT — admin https://admin.emrhub.vn (sandbox https://admin-sandbox.emrhub.vn), API https://api.emrhub.vn (sandbox https://api-sandbox.emrhub.vn). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 02 (Hướng dẫn kết nối, liên thông dữ liệu) — THAY Phụ lục 02 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. API OAuth2 + Bearer, POST /api/platform/data-sync/push (service-type=100, msg_type=101/102, txn_type=sync_checkup), checksum RSASHA256. ĐÃ ĐỐI CHIẾU TOÀN VĂN PL02 ngày 23/07/2026 (file 'Phu luc 2-5.pdf' nhúng trong bản docx user cung cấp).

HTTP headers của request

Content-Type = application/json

Accept = /

Accept-Encoding = gzip,deflate,br

Authorization = Bearer + Authorization Token (văn bản gọi 'Authorization Token'; lấy từ POST /api/auth/login — response cấp token/refresh_token/duration giây/role: facility=Cơ sở KCB, doh=Sở Y tế)

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 (13 số mã định danh CSKCB từ Cục KCB)

receiver_id - Mã bên nhận tin (vd: TDLBYT)

txn_type - Loại giao dịch. Giá trị cố định: sync_checkup (đồng bộ tập dữ liệu KSK định kỳ)

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). service-type=100

data_type - Định dạng file. Giá trị: xml/base64 HOẶC json/base64 (chỉ 2 giá trị này theo Phụ lục 02)

send_datetime - Thời điểm đẩy dữ liệu, Unix timestamp 13 số. 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/JSON) đã encode Base64 (STRING BASE64 theo quy tắc mục 4 PL02). 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 PL02 mục 4: A=Uppercase(SHA256(header)); B=Uppercase(SHA256(data)); C=A+'.'+B; SIGNATURE=Uppercase(RSASHA256(C, Private Key)). Quy tắc: bỏ whitespace/xuống dòng trước khi hash; header rỗng truyền {}; data là STRING BASE64. BYT cấp cặp khóa cho đơn vị; bản tin còn phải KÝ SỐ TỔ CHỨC trước khi gửi (Trục xác thực trước khi nhận). 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 (13 số mã định danh CSKCB)

txn_id - Mã giao dịch do Trục sinh = XX (2 ký tự dịch vụ) + '-' + sender_id + '-' + YY + MM + DD + UUIDv4 không gạch (cấu trúc KHÁC msg_id)

txn_type (response) = sync_checkup

msg_type (response) = 102 (Trục đã nhận dữ liệu và thực hiện đồng bộ)

msg_id (response) - sender_id + YY + MM + DD + UUIDv4 không gạch

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

send_datetime (response) - Ngày gửi của bên phát tin, Unix timestamp 13 số

res_datetime - Ngày phản hồi của bên nhận tin (Unix timestamp 13 số)

res_code - Mã trạng thái tiếp nhận, đủ 10 mã theo PL02: CM_SUCCESS | CM_INVALID_REQUEST | PS_DS_RSA_SIGNATURE_INVALID | PS_DS_RSA_SIGNATURE_MISSING | PS_DS_CA_SIGNATURE_INVALID | PS_DS_CA_SIGNATURE_MISSING | PS_DS_VERIFY_SUCCESS | PS_DS_VERIFY_FAIL | PS_DS_SAVE_SUCCESS | PS_DS_SAVE_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 (vd '0')

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 (vd 'Digitally signed XML data')

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 Trục BYT

Xác thực tài khoản liên thông (POST /api/auth/login) — INFORMATIVE, TRANSPORT-ONLY: username/password/token là thông tin phiên truyền tải, TUYỆT ĐỐI không persist vào FHIR store/clinical Bundle/log; quản lý trong lớp IAM của hệ thống gửi

username - Tên đăng nhập tài khoản liên thông do Trục dữ liệu BYT cấp

password - Mật khẩu

data.token - Token gọi API nghiệp vụ (response)

data.refresh_token - Cấp lại token khi hết hiệu lực

data.duration - Thời gian hiệu lực token, đơn vị giây (VĂN BẢN GỐC kiểu Long)

data.role - Phân quyền: facility (Cơ sở KCB) | doh (Sở Y tế)

header.res_code - CM_SUCCESS | CM_AUTH_ACCOUNT_FAIL

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ộ. Môi trường (PL02 mục 2): Cổng dữ liệu sức khỏe BYT — admin https://csdlksk.vn (sandbox https://sandbox.csdlksk.vn); Trục dữ liệu BYT — admin https://admin.emrhub.vn (sandbox https://admin-sandbox.emrhub.vn), API https://api.emrhub.vn (sandbox https://api-sandbox.emrhub.vn). Căn cứ: QĐ 2062/QĐ-BYT (07/7/2026) Phụ lục 02 (Hướng dẫn kết nối, liên thông dữ liệu) — THAY Phụ lục 02 QĐ 1551/QĐ-BYT (31/5/2026); đọc hợp nhất. API OAuth2 + Bearer, POST /api/platform/data-sync/push (service-type=100, msg_type=101/102, txn_type=sync_checkup), checksum RSASHA256. ĐÃ ĐỐI CHIẾU TOÀN VĂN PL02 ngày 23/07/2026 (file 'Phu luc 2-5.pdf' nhúng trong bản docx user cung cấp).

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 + Authorization Token (văn bản gọi 'Authorization Token'; lấy từ POST /api/auth/login — response cấp token/refresh_token/duration giây/role: facility=Cơ sở KCB, doh=Sở Y tế)

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 (13 số mã định danh CSKCB từ Cục KCB)

receiver_id - Mã bên nhận tin (vd: TDLBYT)

txn_type - Loại giao dịch. Giá trị cố định: sync_checkup (đồng bộ tập dữ liệu KSK định kỳ)

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). service-type=100

data_type - Định dạng file. Giá trị: xml/base64 HOẶC json/base64 (chỉ 2 giá trị này theo Phụ lục 02)

send_datetime - Thời điểm đẩy dữ liệu, Unix timestamp 13 số. 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/JSON) đã encode Base64 (STRING BASE64 theo quy tắc mục 4 PL02). 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 PL02 mục 4: A=Uppercase(SHA256(header)); B=Uppercase(SHA256(data)); C=A+'.'+B; SIGNATURE=Uppercase(RSASHA256(C, Private Key)). Quy tắc: bỏ whitespace/xuống dòng trước khi hash; header rỗng truyền {}; data là STRING BASE64. BYT cấp cặp khóa cho đơn vị; bản tin còn phải KÝ SỐ TỔ CHỨC trước khi gửi (Trục xác thực trước khi nhận). 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 (13 số mã định danh CSKCB)

txn_id - Mã giao dịch do Trục sinh = XX (2 ký tự dịch vụ) + '-' + sender_id + '-' + YY + MM + DD + UUIDv4 không gạch (cấu trúc KHÁC msg_id)

txn_type (response) = sync_checkup

msg_type (response) = 102 (Trục đã nhận dữ liệu và thực hiện đồng bộ)

msg_id (response) - sender_id + YY + MM + DD + UUIDv4 không gạch

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

send_datetime (response) - Ngày gửi của bên phát tin, Unix timestamp 13 số

res_datetime - Ngày phản hồi của bên nhận tin (Unix timestamp 13 số)

res_code - Mã trạng thái tiếp nhận, đủ 10 mã theo PL02: CM_SUCCESS | CM_INVALID_REQUEST | PS_DS_RSA_SIGNATURE_INVALID | PS_DS_RSA_SIGNATURE_MISSING | PS_DS_CA_SIGNATURE_INVALID | PS_DS_CA_SIGNATURE_MISSING | PS_DS_VERIFY_SUCCESS | PS_DS_VERIFY_FAIL | PS_DS_SAVE_SUCCESS | PS_DS_SAVE_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 (vd '0')

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 (vd 'Digitally signed XML data')

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 Trục BYT

Xác thực tài khoản liên thông (POST /api/auth/login) — INFORMATIVE, TRANSPORT-ONLY: username/password/token là thông tin phiên truyền tải, TUYỆT ĐỐI không persist vào FHIR store/clinical Bundle/log; quản lý trong lớp IAM của hệ thống gửi

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.

username - Tên đăng nhập tài khoản liên thông do Trục dữ liệu BYT cấp

password - Mật khẩu

data.token - Token gọi API nghiệp vụ (response)

data.refresh_token - Cấp lại token khi hết hiệu lực

data.duration - Thời gian hiệu lực token, đơn vị giây (VĂN BẢN GỐC kiểu Long)

data.role - Phân quyền: facility (Cơ sở KCB) | doh (Sở Y tế)

header.res_code - CM_SUCCESS | CM_AUTH_ACCOUNT_FAIL