v2.logistics.download_booking_shipping_document
POST /api/v2/logistics/download_booking_shipping_document
Sử dụng API này để tải xuống tài liệu vận chuyển. Bạn cần gọi v2.logistics.create_booking_shipping_document để tạo tác vụ tài liệu vận chuyển trước, sau đó gọi v2.logistics.get_booking_shipping_document_result để kiểm tra trạng thái tác vụ. Nếu trạng thái là READY, bạn có thể tải xuống tài liệu vận chuyển này.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/download_booking_shipping_document
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 | False | NORMAL_AIR_WAYBILL | Loại tài liệu vận chuyển. Các giá trị: NORMAL_AIR_WAYBILL,THERMAL_AIR_WAYBILL |
| booking_list | object[] | True | Danh sách các booking cần lấy. Giới hạn [1,50] | |
| booking_sn | string | True | 201201E81SYYKE | Mã định danh duy nhất của booking trên Shopee. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| waybill | file | Tệp vận đơn. |