v2.logistics.ship_order

POST /api/v2/logistics/ship_order

Use this api to 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.

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/logistics/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_sn	string	True	201212DCXHJUIKJ	Shopee's unique identifier for an order.
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 get_shipping_parameter returns "pickup" under "info_needed". Developer should still include "pickup" field in the call even if "pickup" has empty value.
address_id	int64	True		The identity of address. Retrieved from v2.logistics.get_shipping_parameter.
pickup_time_id	string	False		The pickup time id. Retrieved from v2.logistics.get_shipping_parameter, you can only select one from the time_slot_list. Some logistics channels may not return any date or time for pickup time slots. In such cases, sellers can arrange shipment without selecting any time slot, and Shopee will arrange a suitable timing for these situations.
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 get_shipping_parameter returns "dropoff" under "info_needed". 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	int64	False	0	The identity of 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.
slug	string	False		The selected 3PL partner to drop-off parcels with.
non_integrated	object	False		Optional parameter when get_shipping_parameter 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.