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

Dịch Vụ Tạo Delivery Job

Trang này giải thích cách tạo delivery job bằng Fleet API và cách xác nhận liệu các job đã gửi có được tạo thành công hay không.

Từ Viết Tắt và Thuật Ngữ​

  • API: Giao diện Lập trình Ứng dụng.
  • ERP: Enterprise Resource Planning.
  • HTTP: Hypertext Transfer Protocol.

Nên Dùng Endpoint Nào?​

Vui lòng chọn theo khối lượng tạo job và nhu cầu xác nhận kết quả:

1) Bulk Upload Delivery Jobs​

Ý Nghĩa​

Gửi nhiều job trong một request, phù hợp khi cần đẩy số lượng lớn từ hệ thống ERP hoặc hệ thống điều phối.

Xác Nhận và Thông Báo​

Dịch vụ bulk upload hỗ trợ trường webhooks_url. Sau khi xử lý hoàn tất, Cartrack sẽ gửi webhook callback để hệ thống của quý khách xác nhận kết quả và đối soát các job đã được tạo. Để cấu hình webhook, xác thực chữ ký và hướng dẫn bảo mật, vui lòng xem Webhooks.

Mục Đích​

  • Phù hợp nhất cho các đợt nhập liệu giao hàng theo lịch hoặc khối lượng lớn.
  • Cung cấp quy trình xác nhận đáng tin cậy cho đội vận hành, thay vì giả định tất cả job đều được tạo thành công.
  • Giúp phát hiện nhanh các tình huống tạo thành công một phần.

Lưu Ý cho Developer​

  • Xử lý request này như một luồng bất đồng bộ.
  • Dùng webhook callback làm nguồn xác thực chính cho trạng thái xử lý cuối cùng.
  • Đối chiếu danh sách đã gửi với kết quả callback, rồi retry/escalation các job chưa được tạo.

2) Create a Delivery Job​

Ý Nghĩa​

Tạo một delivery job cho mỗi request và nhận phản hồi API ngay lập tức.

Xác Nhận và Lỗi​

Nếu job không thể tạo, API sẽ trả về HTTP status code khác 200 kèm thông báo lỗi phù hợp.

Mục Đích​

  • Phù hợp cho luồng tương tác khi người dùng tạo từng job.
  • Lỗi được hiển thị ngay để đội hỗ trợ hoặc điều phối xử lý kịp thời.

Lưu Ý cho Developer​

  • Kiểm tra HTTP response status cho mọi request.
  • Xử lý mọi phản hồi khác 200 như lỗi tạo job rõ ràng.
  • Ghi log và chuyển tiếp thông báo lỗi từ API để đội vận hành xử lý nhanh hơn.

Mẫu Tích Hợp Được Khuyến Nghị​

  1. Lưu reference phía client cho từng job đã gửi (từ ERP/dispatch).
  2. Dùng bulk upload với webhooks_url cho khối lượng lớn.
  3. Theo dõi callback và đối soát giữa job kỳ vọng và job đã được tạo.
  4. Xử lý mọi phản hồi khác 200 từ luồng tạo đơn lẻ như thất bại.
  5. Thực hiện retry hoặc escalation các job lỗi theo quy trình nội bộ.