Vận chuyển
Đẩy vận đơn sang hãng
Tạo đơn tại hãng vận chuyển cho một vận đơn và nhận mã vận đơn
Endpoint
POST /v1/shippingbillgateways/:id/createremote
Quyền:
inventory.dispatchprocess
Gửi vận đơn sang hãng vận chuyển của carrier (GHN, ViettelPost, GHTK, J&T Express, Ahamove, BeDelivery...). Danh sách hàng gửi cho hãng lấy từ chi tiết phiếu xuất kho của vận đơn (tên sản phẩm, SKU, giá, khối lượng, số lượ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 |
Workflow & Logic
- Thành công: vận đơn được ghi
tracking_code,carrier_fee,carrier_fee_detail,gateway_identifier,gateway_status=5,statustheo trạng thái hãng trả về (mặc định1- chờ lấy hàng; vận đơn đã huỷ trước đó được tạo lại cũng về1). Đơn bán được cập nhật mã vận đơn và trạng thái "chờ lấy hàng". - Thất bại: vận đơn được ghi
gateway_status=7và lỗi vàogateway_log; đơn bán được đánh dấu "đẩy vận đơn thất bại" và trở về trạng thái đóng gói. - Carrier phải thuộc cùng công ty với vận đơn và có tích hợp API (
api_typekhác1).
Response Schema
HTTP 200 - JSON Object
Shipping Bill Object sau khi đẩy thành công.
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_shipping_carrier_not_support_sync | Carrier không tích hợp API (HTTP 422) |
error_fetch_product_receipt_detail_list | Không đọc được chi tiết phiếu xuất kho (HTTP 422) |
error_product_in_receipt_detail_empty | Phiếu xuất kho không có sản phẩm hợp lệ (HTTP 422) |
error_not_supported | Hãng chưa hỗ trợ tạo đơn qua API (HTTP 422) |
error_create_remote_failed | Hãng từ chối tạo đơn, không kèm lý do (HTTP 422) |
error_gateway_exception (...) | Lỗi khi gọi hãng (HTTP 422) |
error_update_shipping_bill | Lỗi lưu vận đơn (HTTP 422) |
error_role_not_available | Không có quyền inventory.dispatchprocess (HTTP 403) |
Lỗi chi tiết do hãng trả về (sai địa chỉ, vượt giới hạn COD/khối lượng...) được trả trong mảng error.
Ví dụ
curl -X POST "https://api.hubport.vn/v1/shippingbillgateways/3301/createremote" \
-H "Authorization: <JWT>" \
-H "Content-Type: application/json" \
-d '{ "company_id": 1001 }'