Mục lục tài liệu
Nhật ký thay đổi tài liệu
Những gì đã thay đổi trong tài liệu này và vì sao, mới nhất trước.
- 2026-09-21
Hướng dẫn mới: tích hợp từ TMS, ERP hoặc WMS
Một hướng dẫn thứ sáu đã có mặt bên cạnh năm hướng dẫn trước. Hướng dẫn ánh xạ dữ liệu từ một TMS, một ERP hoặc một WMS vào đúng một nội dung gửi job tối ưu tuyến, kèm bảng đối chiếu tên trường trong nội dung job với tên cột của Mẫu dữ liệu Pilot.
- 2026-09-07
Sửa đơn vị đo, mẫu nội dung gửi job và ví dụ phản hồi
Kích thước và trọng lượng xe trước đây ghi sai là mét và tấn, trong khi cột lưu trữ thực tế là centimet và kilogam; mẫu nội dung gửi job dùng trong các hướng dẫn và trang tham chiếu đã được đổi sang số nguyên đúng đơn vị. Kích thước, trọng lượng và khoảng cách của đơn hàng nay cũng ghi rõ đơn vị. Ví dụ kết quả trả về đã sửa loại điểm dừng thành PICKUP_POINT và DROP_POINT, đổi thời lượng sang thang phút cho khớp quãng đường, và bọc lại trong đúng lớp phản hồi success, message, error_code, data. Điều kiện kích hoạt mã 409 JOB_ALREADY_PROCESSING cũng được ghi lại đúng hơn: nó kích hoạt ngay khi job được nhận để xử lý, điều này có thể xảy ra trong khi job vẫn còn báo QUEUED.
- 2026-09-04
Hoàn thiện thủ công các trường trong nội dung gửi job
Bản đặc tả chưa mô tả đầy đủ nội dung của POST jobs. Các trường external_reference, optimization_options, vehicles và orders đã được hoàn thiện thủ công từ mã nguồn hệ thống gốc, và được đánh dấu trên trang endpoint là hoàn thiện từ mã nguồn hệ thống gốc.
- 2026-09-04
Xác nhận các mã lỗi và mã xung đột
DUPLICATE_EXTERNAL_ID, ACTIVE_EXTERNAL_ID_CONFLICT và IDEMPOTENCY_CONFLICT nay đã được xác nhận trực tiếp trong mã nguồn tiện ích mở rộng. JOB_ALREADY_PROCESSING, RESULT_NOT_READY, RESULT_UNAVAILABLE và WEBHOOK_LIMIT_REACHED vẫn được ghi chú là lấy từ bản đặc tả, chưa được xác nhận trong mã nguồn.
- 2026-09-04
Xác nhận webhook chỉ gửi một lần
Việc gửi webhook tối ưu tuyến đường chỉ thực hiện một lần, không có cơ chế thử lại tự động. Khi gửi thất bại, việc chủ động hỏi lại trạng thái là phương án dự phòng, và có thể yêu cầu đội Route4Green gửi lại.
- 2026-09-04
Tài liệu hóa trường replaces_job_id
Việc gửi job nay đã có tài liệu cho trường tuỳ chọn replaces_job_id. Khi nêu tên một job còn ở trạng thái QUEUED, job đó sẽ tự động bị thay thế và chuyển sang CANCELLED. Đây là cách duy nhất một job đạt trạng thái CANCELLED, không có endpoint huỷ riêng.
- 2026-09-04
Sửa lại thứ tự các vị trí trong tour_mode
Mô tả được tạo tự động trên trang endpoint lập kế hoạch chuyến đi có từ trước và không còn đúng với cách hệ thống thực sự xử lý. Một ghi chú trên trang nhóm nay liệt kê đủ sáu vị trí của tour_mode theo đúng thứ tự hệ thống phân tích, với vị trí thứ sáu được ghi rõ là số phút chứ không phải cờ bật tắt.
- 2026-08-20
Lấy bản chụp OpenAPI
Tài liệu này được tạo từ một bản chụp OpenAPI đã được lưu và rà soát vào ngày 20 tháng 8 năm 2026. Bản chụp không tự động làm mới, nên một endpoint nội bộ mới ở hệ thống gốc sẽ không xuất hiện ở đây trừ khi có một lần cập nhật được rà soát riêng.