v2.logistics.batch_ship_order

POST /api/v2/logistics/batch_ship_order

Use this api to batch initiate logistics including arrange pickup, dropoff or shipment for non-integrated logistic channels. Should call v2.logistics.get_shipping_parameter to fetch all required param first. It's recommended to initiate logistics one hour after the orders were placed since there is one-hour window buyer can cancel any order without request to seller.Only channel 90003 - Padrão in Brazil has the permission of this API.

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/logistics/batch_ship_order

Common Request Parameters

Name	Type	Sample	Description
partner_id	int	1	Partner ID is assigned upon registration is successful. Required for all requests.
timestamp	timestamp	1610000000	This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
shop_id	int	600000	Shopee's unique identifier for a shop. Required param for most APIs.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Request Parameters

Name	Type	Required	Sample	Description
order_list	object[]	True		The list of order.
order_sn	string	True	201212DCXHJUIKJ	Shopee's unique identifier for an order. Limit 150.
package_number	string	False		Shopee's unique identifier for the package under an order. You should't fill the field with empty string when there is't a package number.
pickup	object	False		Required parameter ONLY if GetParameterForInit returns "pickup" or if GetLogisticsInfo returns "pickup" under "info_needed" for the same order. Developer should still include "pickup" field in the call even if "pickup" has empty value.
address_id	int	False		The identity of address. Retrieved from shopee.logistics.GetAddress.
pickup_time_id	string	False		The pickup time id. Retrieved from shopee.logistics.GetTimeSlot.
tracking_number	string	False		Need input this field when "tracking_number" is returned from "info_need". Please note that this tracking number is assigned by third-party shipping carrier for item shipment.
dropoff	object	False		Required parameter ONLY if GetParameterForInit returns "dropoff" or if GetLogisticsInfo returns "dropoff" under "info_needed" for the same order. Developer should still include "dropoff" field in the call even if "dropoff" has empty value. For logistic_id 80003 and 80004, both Regular and JOB shipping methods are supported. If you choose Regular shipping method, please use "tracking_no" to call Init API. If you choose JOB shipping method, please use "sender_real_name" to call Init API. Note that only one of "tracking_no" and "sender_real_name" can be selected.
branch_id	int	False	0	The identity of branch. Retrieved from shopee.logistics.GetBranch branch.
sender_real_name	string	False		The real name of sender.
tracking_number	string	False		Need input this field when "tracking_number" is returned from "info_need". Please note that this tracking number is assigned by third-party shipping carrier for item shipment.
non_integrated	object	False		Optional parameter when GetParameterForInit returns "non-integrated" or GetLogisticsInfo returns "non-integrated" under "info_needed".
tracking_number	string	False		Optional parameter for non-integrated channel order. The tracking number assigned by the shipping carrier for item shipment.

Response Parameters

Name	Type	Sample	Description
request_id	string	3dad66f43b8447d282ae6da36626c6b7	The identifier for an API request for error tracking.
error	string	error_auth	Indicate error type if hit error. Empty if no error happened.
message	string	Invalid access_token.	Indicate error details if hit error. Empty if no error happened.
warning	object[]		Indicate warning message you should take care.
order_sn	string		Shopee's unique identifier for an order.
package_number	string		Shopee's unique identifier for the package under an order. You should't fill the field with empty string when there is't a package number.
response	object
result_list	object[]
order_sn	string		Shopee's unique identifier for an order.
package_number	string		Shopee's unique identifier for the package under an order.
fail_error	string		Indicate error type if one element hit error.
fail_message	string		Indicate error details if one element hit error.

, { "order_sn": "201212CXHQWEIKD" } ], "dropoff": { "tracking_no": "", "branch_id": 0, "sender_real_name": "" } }