Vận chuyển
Duyệt hoàn / Phát tiếp (ViettelPost)
Xử lý đơn ViettelPost giao không thành công: duyệt hoàn về shop hoặc yêu cầu phát tiếp
Chỉ áp dụng cho vận đơn của carrier ViettelPost. Hãng khác trả error_not_supported.
Endpoint
POST /v1/shippingbillgateways/:id/approvereturn — Duyệt hoàn hàng về shop
POST /v1/shippingbillgateways/:id/redeliver — Yêu cầu phát tiếp (giao lại)
Quyền:
inventory.dispatchprocess
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 |
note | string | Không | Ghi chú gửi kèm cho hãng (tối đa 500 ký tự) |
Response Schema
HTTP 200 - JSON Object
Error Codes
| Mã lỗi | Mô tả |
|---|---|
error_notfound | Vận đơn không tồn tại hoặc không thuộc công ty của bạn (HTTP 422) |
error_shipping_carrier_notfound | Carrier của vận đơn không tồn tại / khác công ty (HTTP 422) |
error_not_supported | Carrier không phải ViettelPost (HTTP 422) |
error_vtp_update_order_failed | ViettelPost từ chối yêu cầu (HTTP 422) |
error_role_not_available | Không có quyền inventory.dispatchprocess (HTTP 403) |