v2.logistics.create_shipping_document_job
POST /api/v2/logistics/create_shipping_document_job
API này tạo tác vụ tài liệu vận chuyển cho các tài liệu được chọn. Hệ thống tiếp nhận yêu cầu và trả về ID tác vụ cùng với thông tin thành công và thất bại.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/create_shipping_document_job
Tham số chung
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền truy cập của bạn. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của cửa hàng trên Shopee. Bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, shop_id và partner_key thông qua thuật toán HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| shipping_document_type | string | True | THERMAL_UNPACKAGED_LABEL | Loại tài liệu vận chuyển. Các giá trị: THERMAL_UNPACKAGED_LABEL |
| unpackaged_sku_requests | object[] | False | Danh sách SKU chưa đóng gói cần tạo nhãn. Lưu ý: unpackaged_sku_requests và package_list không thể điền đồng thời, vui lòng chọn một. | |
| unpackaged_sku_id | string | False | 844091087_11192347 | ID SKU chưa đóng gói của phân loại hàng. |
| quantity | int64 | False | 10 | Số lượng bản sao nhãn được tạo (tối đa 600 trên tất cả SKU được yêu cầu). |
| package_list | string[] | False | Danh sách Số gói hàng cần tạo nhãn (tối đa 600). Lưu ý: unpackaged_sku_requests và package_list không thể điền đồng thời, vui lòng chọn một. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| request_id | string | 5551ce8db5314c70a362dfe33544f074 | Mã định danh của yêu cầu API để theo dõi lỗi. |
| error | string | error_auth | Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. |
| message | string | Invalid access_token | Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| job_id | string | SDK0001_a86148a97a6e04ce2ed468968de344b7 | ID tác vụ được tạo, dùng để theo dõi trạng thái và tải xuống tài liệu vận chuyển. |
| success_id_list | string[] | ["844091087_11192347"] | Danh sách Số gói hàng hoặc ID SKU chưa đóng gói tạo tài liệu vận chuyển thành công. |
| fail_list | object[] | Danh sách Số gói hàng hoặc SKU chưa đóng gói tạo tài liệu vận chuyển thất bại. | |
| id | string | 844091087_11192342 | Số gói hàng hoặc ID SKU chưa đóng gói bị thất bại. |
| fail_error | string | error_param | Cho biết loại lỗi nếu một phần tử gặp lỗi. |
| fail_message | string | Wrong parameters, detail: This Unpackaged SKU ID is not eligible for printing. Reason: Invalid SKU ID. | Cho biết chi tiết lỗi nếu một phần tử gặp lỗi. |