Chuyển tới nội dung chính

Cập nhật hàng loạt đơn nhập - xuất từ vận hành

PUT 
/v1/tms/order-requests

Cập nhật từng phần một hoặc nhiều đơn nhập - xuất ở trạng thái NEW hoặc CONFIRMED. Body là mảng ở root (1–200 phần tử). Mỗi phần tử xử lý độc lập.

Mỗi phần tử bắt buộc: shown_code, username, và ít nhất một field cần thay đổi.

Field không được phép cập nhật: giống API cập nhật 1 đơn (zone, route.description, workflow, shipping_schedule.services). type chỉ dùng lookup, không patch. expenses được phép (partial upsert). route.name được phép khi tạo tuyến mới.

Quy tắc route (partial): pickup_place, warehouse XOR warehouses, dropoff_place, code, name → findOrCreate tuyến, gán OR/PLAN; ACTUAL pending stamp route.id. Hủy qua PUT: status cancel + reasons + expenses có expense_type.key = allowance_fee. Quy tắc details: đúng một phần tử; cập nhật dòng detail liên kết đầu tiên; có thể gồm container_pickup_date (Ngày đóng / trả hàng, ISO 8601) và container_type. Quy tắc contacts: thay thế danh sách hiện có; gửi [] để xóa; bỏ qua field thì không đổi.

Request​

Responses​

HTTP 200: batch đã xử lý (toàn bộ thành công hoặc một phần). Khi partial success, body có thêm error: string[] (cùng nội dung tóm tắt với data.error_items).