Vận chuyển
Đồng bộ trạng thái vận đơn
Lấy trạng thái và cước mới nhất của vận đơn từ hãng
Endpoint
POST /v1/shippingbillgateways/:id/syncremote
Quyền:
inventory.dispatchprocess
Hỏi hãng trạng thái hiện tại của vận đơn rồi cập nhật status, carrier_fee, carrier_fee_detail và trạng thái giao hàng của đơn bán tương ứng. Hubport cũng tự đồng bộ định kỳ và nhận webhook với các hãng hỗ trợ, nên thường chỉ cần gọi khi muốn cập nhật ngay.
ViettelPost
ViettelPost không có API tra trạng thái: trạng thái vận đơn ViettelPost chỉ cập nhật qua webhook, gọi đồng bộ không gọi ra hãng.
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID vận đơn |
Request Body
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty |
Response Schema
HTTP 200 - JSON Object
Shipping Bill Object sau khi đồng bộ.
HTTP 422
{ "error": ["error_tracking_code_required"] }Error Codes
| Mã lỗi | Mô tả |
|---|---|
error_role_not_available | Không có quyền inventory.dispatchprocess (HTTP 403) |
error_notfound | Vận đơn không tồn tại hoặc không thuộc công ty của bạn |
error_shipping_carrier_notfound | Carrier của vận đơn không tồn tại / khác công ty |
error_shipping_carrier_not_support_sync | Carrier không tích hợp API |
error_tracking_code_required | Vận đơn chưa có mã vận đơn (chưa đẩy sang hãng) |
error_not_supported | Hãng chưa hỗ trợ đồng bộ |
error_sync_remote_failed | Hãng không trả được trạng thái |
error_update_shipping_bill | Lỗi lưu vận đơn |