Mã lỗi gói dữ liệu
Ý nghĩa và cách xử lý từng mã lỗi khi đẩy XML 130SYT-GOI-003
XML không hợp lệTệp phải là XML well-formed, mã hoá UTF-8, không DTD/thực thể ngoài, kích cỡ trong giới hạn. Dạng chấp nhận: bao GIAMDINHHS/THONGTINHOSO/DANHSACHHOSO/HOSO/FILEHOSO (NOIDUNGFILE base64) hoặc XML phẳng từng bảng theo QĐ 3176.
Toàn bộ mã lỗi
| Mã | Ý nghĩa | Cách xử lý |
|---|---|---|
| SYT-GOI-001 | Thiếu MA_LK | Mỗi hồ sơ phải có thẻ MA_LK (mã liên kết đợt điều trị) trong Bảng 1. Kiểm dữ liệu kết xuất từ HIS. |
| SYT-GOI-002 | Mã cơ sở trong XML không khớp khoá API | Thẻ MACSKCB (hoặc MA_CSKCB trong Bảng 1) phải đúng mã cơ sở của khoá đang dùng. Kiểm cấu hình mã cơ sở trong HIS trước khi gửi lại. |
| SYT-GOI-003 | XML không hợp lệ | Tệp phải là XML well-formed, mã hoá UTF-8, không DTD/thực thể ngoài, kích cỡ trong giới hạn. Dạng chấp nhận: bao GIAMDINHHS/THONGTINHOSO/DANHSACHHOSO/HOSO/FILEHOSO (NOIDUNGFILE base64) hoặc XML phẳng từng bảng theo QĐ 3176. |
| SYT-GOI-004 | XML chứa DTD/thực thể ngoài | Cổng cấm DOCTYPE, thực thể ngoài (XXE) và thực thể lồng (XML bomb). Kết xuất XML thuần từ HIS, không kèm DTD. |
| SYT-GOI-005 | Gói vượt giới hạn kích cỡ | XML tối đa 200 MB, PDF tối đa 50 MB [tham số]. Tách gói theo ngày/khoa hoặc nén dữ liệu tại HIS trước khi kết xuất. |
| SYT-GOI-006 | Không nhận dạng được cấu trúc XML | Thẻ gốc phải là GIAMDINHHS (dạng bao) hoặc thẻ gốc bảng theo QĐ 3176 (TONG_HOP, CHI_TIET_THUOC, …). |
| SYT-GOI-007 | NOIDUNGFILE base64 hỏng | Nội dung FILEHOSO/NOIDUNGFILE phải là base64 hợp lệ của XML bảng. Kiểm bước mã hoá base64 trong HIS. |
| SYT-GOI-008 | Gói không có hồ sơ nào | DANHSACHHOSO phải có ít nhất một HOSO với FILEHOSO Bảng 1 (TONG_HOP). |
| SYT-GOI-009 | Thiếu hoặc sai khoá API | Gửi header X-Syt-Khoa: <tiền tố>.<khoá> do Sở cấp cho đơn vị. Khoá chỉ hiện một lần lúc tạo; nếu mất, đầu mối dữ liệu cơ sở tạo khoá mới trên Portal và thu hồi khoá cũ. |
| SYT-GOI-010 | Khoá API không có phạm vi này | Khoá cần phạm vi day-xml130 để đẩy XML, day-pdf để đẩy PDF. Đầu mối dữ liệu cơ sở tạo khoá với đủ phạm vi trên Portal. |
| SYT-GOI-011 | Tệp PDF không hợp lệ | Tệp phải bắt đầu bằng %PDF- và có kích cỡ trong giới hạn. Xuất lại từ HIS ở định dạng PDF chuẩn (không phải ảnh đổi đuôi). |
| SYT-GOI-012 | PDF chứa mã nhúng bị từ chối | PDF không được chứa JavaScript, hành động Launch hoặc mã nhúng (/JS, /JavaScript, /Launch). Xuất lại PDF ở chế độ tĩnh/PDF-A. |
| SYT-GOI-013 | Tên tệp hoặc mã không hợp lệ | Tên tệp/MA_LK chỉ gồm chữ, số, gạch ngang, gạch dưới, dấu chấm; không chứa đường dẫn (../, /, \). |
| SYT-GOI-014 | Không tìm thấy gói | Mã gói không tồn tại hoặc không thuộc đơn vị của khoá. Kiểm lại goi_id trả về lúc nhận (202). |
| SYT-GOI-015 | Nội dung rỗng | Thân yêu cầu không có dữ liệu. Gửi tệp XML/PDF trong thân yêu cầu (application/xml, application/pdf) hoặc phần multipart 'tep'. |
| SYT-GOI-016 | Khoá API hết hạn hoặc đã thu hồi | Đầu mối dữ liệu cơ sở tạo khoá mới trên Portal (/don-vi/khoa-api) và cập nhật vào HIS. |
| SYT-GOI-017 | Content-Type không được hỗ trợ | Dùng application/xml hoặc text/xml cho XML; application/pdf cho PDF; hoặc multipart/form-data với phần 'tep'. |
| SYT-GOI-018 | Chưa có hồ sơ XML tương ứng | Đẩy XML 130 (Bảng 1 có MA_LK) trước rồi mới đẩy PDF hồ sơ bệnh án cho MA_LK đó. |
| SYT-GOI-019 | Lỗi hệ thống khi xử lý gói | Gửi lại sau ít phút; nếu lặp lại, báo Sở kèm goi_id (không gửi nội dung gói qua email). |