快工助手跨境电商知识与商机助手

v2.logistics.update_shipping_order

Shopee 官方资料 · Shopee Open Platform 接口参考 · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.api_reference
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/api_doctopic/apitopic/developer

资料正文

§1 v2.logistics.update_shipping_order

For pickup method only, use this api to update pickup address and pickup time for packages meet: 1) package's fulfillment status is LOGISTICS_PICKUP_RETRY; or 2) package's fulfillment status is 'LOGISTICS_REQUEST_CREATED' and meets the Instant Order Reschedule Pickup conditions.

#

§2 Overview

Overview

FieldValue
ModuleLogistics
API typeShop
HTTP methodPOST
Path/api/v2/logistics/update_shipping_order
Production URLhttps://partner.shopeemobile.com/api/v2/logistics/update_shipping_order
Sandbox URLhttps://partner.test-stable.shopeemobile.com/api/v2/logistics/update_shipping_order
Rate limit[0, 0, 0]
PermissionERP System; Seller In House System; Order Management; Swam ERP
#

§3 Request parameters

Request parameters

NameTypeRequiredSampleDescription
order_snstringYes201214JASXYXY6Shopee's unique identifier for an order.
package_numberstringNoShopee'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.
pickupobjectYesRequired 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.
pickup.address_idint64Yes126194The identity of address. Retrieved from get_shipping_parameter.
pickup.pickup_time_idstringYes439291The pickup time id. Retrieved from get_shipping_parameter.
#

§4 Response parameters

Response parameters

NameTypeRequiredSampleDescription
request_idstring3dad66f43b8447d282ae6da36626c6b7The identifier for an API request for error tracking.
errorstringerror_authIndicate error type if hit error. Empty if no error happened.
messagestringInvalid access_token.Indicate error details if hit error. Empty if no error happened.
#

§5 Common parameters

Common parameters

NameTypeRequiredSampleDescription
partner_idint1Partner ID is assigned upon registration is successful. Required for all requests.
timestamptimestamp1610000000This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
shop_idint600000Shopee's unique identifier for a shop. Required param for most APIs.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature 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
#

§6 Request samples

Request samples

#

§7 Payload

Payload

{
	"order_sn": "201214JASXYXY6",
	"package_number": "-",
	"pickup": {
		"address_id": 126194,
		"pickup_time_id": "439291"
	}
}
#

§8 Java

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/logistics/update_shipping_order?partner_id=partner_id&sign=sign&access_token=access_token&timestamp=timestamp&shop_id=shop_id")
.header("Content-Type","application/json")
.body("{
   \"order_sn\": \"201214JASXYXY6\",
   \"package_number\": \"-\",
   \"pickup\": {
      \"address_id\": 126194,
      \"pickup_time_id\": \"439291\"
   }
}")
.asString();
#

§9 PHP

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/logistics/update_shipping_order?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "order_sn": "201214JASXYXY6",
    "package_number": "-",
    "pickup": {
        "address_id": 126194,
        "pickup_time_id": "439291"
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
#

§10 cURL

cURL

curl --location --request POST 'https://partner.shopeemobile.com/api/v2/logistics/update_shipping_order?partner_id=partner_id&sign=sign&access_token=access_token&timestamp=timestamp&shop_id=shop_id' \
--header 'Content-Type: application/json' \
--data-raw '{
   "order_sn": "201214JASXYXY6",
   "package_number": "-",
   "pickup": {
      "address_id": 126194,
      "pickup_time_id": "439291"
   }
}'
#

§11 Python

Python

import requests
import json

url = "https://partner.shopeemobile.com/api/v2/logistics/update_shipping_order?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp"

payload=json.dumps({
  "order_sn": "201214JASXYXY6",
  "package_number": "-",
  "pickup": {
    "address_id": 126194,
    "pickup_time_id": "439291"
  }
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.request("POST",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)
#

§12 Response sample

Response sample

#

§13 JSON

JSON

{
    "error": "",
    "message": "",
    "request_id": "3dad66f43b8447d282ae6da36626c6b7"
}
#

§14 Error example

Error example

#

§15 JSON

JSON

{
    "error": "logistics.update_shipping_order_no_param_change",
    "message": "You can’t update shipping with all the same parameters.",
    "request_id": "b3cb59c28de7e9dca43309fbe20f3a6b"
}
#

§16 Errors

Errors

ErrorDescriptionSolution
logistics.error_paramThe address is invalid. Please check the address.
logistics.error_paramThe address is invalid. Please check the address.
logistics.address_not_foundAddress is not found.
logistics.ADDRESS_NOT_SUPPORTAddress is not supported.
logistics.address_not_supportedAddress is not supported current operation.
logistics.error_paramThe order is being allocated, please wait until the allocate is completed.
logistics.block_buyer_nameBuyer name is prohibited.
logistics.business_process_errorBusiness process failed.
logistics.business_validation_errorBusiness validation failed.
logistics.buyer_address_not_foundBuyer address is not found.
logistics.error_paramPlease wait for buyer to reselect the delivery convenience store.
logistics.error_paramLogistic status is not supported.
logistics.cancel_not_allowedCancel is not allowed.
logistics.category_prohibitedThere are contraband goods in the order.
logistics.error_channel_existFail to find the fulfillment channel of this order.
logistics.error_paramDeliver address not support COD.
logistics.error_paramDelivery address do not support COD.
logistics.error_paramThis address do not support delivery.
logistics.error_paramDelivery address is not exist.
logistics.error_paramBuyer address is not exist.
logistics.error_paramDelivery store is not exist.
logistics.error_paramDelivery address is not completed.
logistics.error_addressAddress is invalid. Please check the address.
logistics.error_paramThe address is invalid. Please check the address.
logistics.error_limitThe batch request reach limit 50.
logistics.error_buyer_addressidBuyer addressid is invalid. Please check the buyer addressid.
logistics.error_paramThis order is not allowed to cancel.
logistics.error_cannot_cancel_logistic_txnCancel operation is not supported for current logistics txn.
logistics.error_paramError, please check the channel.
logistics.error_paramFast Escrow ID was not found !
logistics.error_paramCOD is currently not supported in the area. Please check Shopee Help Center for COD serviceable area.
logistics.error_connectionConnection to external system is failed.
logistics.error_consignmentFail to get consignment number.
logistics.error_consignment_no_acceptedConsignment number is not allow to update.
logistics.error_core_serverFail to call core server.
logistics.error_otherSystem error, please try again later.
logistics.error_paramSystem error, please try again later.
logistics.error_cutoff_timePickup time is not invalid. Please check the pickup time.
logistics.error_decimalReceive invalid decimal.
logistics.error_duplicate_consignmentConsignment number is duplicated.
logistics.error_duplicated_consignmentConsignment number is duplicate.
logistics.error_expiredOrder is expired.
logistics.error_failed_get_nearest_whs_idnFaile to get the nearest whsId.
logistics.error_not_existForder is not exist.
logistics.error_paramSystem error, please try again later.
logistics.error_formatContent format from external system is invalid. Please check the format.
logistics.error_paramSystem error, please try again later.
logistics.error_otherSystem error, please try again later.
logistics.error_invalid_channel_idChannel id is invalid. Please check the channel.
logistics.error_paramThe forder_ids should belong to one order/orderId and forderIds cannot be empty at the same time/parse forderId error.
logistics.error_paramSystem error, please try again later.
logistics.error_ipIp address: {ip} is deny.
logistics.error_otherSystem error, please try again later.
logistics.error_paramItems in the same bundle should be in the same parcel.
logistics.error_item_not_foundCan not find the item.
logistics.error_paramSystem error, please try again later.
logistics.error_loginfoLogistic info is invalid. Please check the logistic info.
logistics.error_logistic_txn_not_foundLogistics record is not found.
logistics.error_logistics_shop_require_pickup_addressPickup address is required.
logistics.error_limitCan not update order logistics in current status.
logistics.error_message_typeMessage type is invalid. Please check the message type.
logistics.error_methodOperation is not supported.
logistics.error_missing_cdtCdt settings is not found.
logistics.error_paramSeller address is invalid. Please check your address.
logistics.error_no_pickupPickup is not supported.
logistics.error_no_pickup_addressPickup address is missing.
error_not_foundWrong parameters, detail: {msg}.
logistics.error_operation_failedOperation failed.
logistics.error_order_contextOrder context is invalid. Please check the order context.
logistics.error_paramOrder list length exceeds limit.
logistics.error_paramSystem error, please try again later.
logistics.error_paramThis order is not allowed to cancel.
logistics.error_paramOrder is not exist.
logistics.error_order_not_foundOrder is not found.
logistics.error_paramThis order can not be splited.
logistics.error_paramOrder is not splittable.
logistics.error_paramParcels of this order can not be combined.
logistics.error_paramOrder/Forder can not update.
logistics.error_paramOrder has been shipped.
logistics.error_paramOrder has been splitted.
logistics.error_order_stateOperation is not allow with current order status.
logistics.error_paramThe order status is not ready to ship.
error_paramWrong parameters, detail: {msg}.
logistics.error_limitParcel count should not exceed limit.
logistics.error_paramSystem error, please try again later.
error_permissionSorry you don't have the permission, detail: {msg}.
logistics.error_phonePhone number is invalid. Please check the phone number.
logistics.error_pickup_timePickup time is invalid. Please check the pick up time.
logistics.error_paramThe buyer address is invalid. Please check the buyer address.
logistics.error_return_tracking_num_not_foundReturn tracking number is not found.
logistics.error_not_existAddress does not exist.
logistics.error_seller_never_apply_tracking_no_beforeHistory is not found.
logistics.error_sender_addressSender address is invalid. Please check the sender address.
error_serverSystem error. Please try again later.
logistics.error_set_asf_by_weightFail to set actual shipping fee.
logistics.error_set_seller_addressFail to set seller address.
logistics.error_paramSystem error, please try again later.
logistics.error_paramShop not found.
logistics.error_paramOnly support local warehouse, this shop do not support local warehouse.
logistics.error_paramThis shop do not support split parcels.
logistics.error_paramSystem error, please try again later.
logistics.error_paramSize setting error.
logistics.error_otherSystem error, please try again later.
logistics.error_stateCurrently, operation is not supported with current logistics record status.
logistics.error_statusOperation is not supported with current logistics record status.
logistics.error_store_not_foundStore is not found.
logistics.error_paramSystem error, please try again later.
logistics.error_otherSystem error, please try again later.
logistics.error_third_party_serverFailed to call external system.
logistics.error_paramSystem error, please try again later.
logistics.error_paramSystem error, please try again later.
logistics.error_timeoutTimeout to call external system.
logistics.error_tokenToken is invalid. Please check the token.
logistics.error_too_many_invoke_functionFailed to get lock.
logistics.error_traceno_requiredTrace number is required.
logistics.error_unknownUnknown exception, exception details is: {details}.
logistics.error_unsupportedOperation is not supported.
logistics.error_unsupported_addressAddress is not supported.
logistics.error_paramInvalid logistics channel. Please check the logictics channel.
logistics.error_paramThaipost do not support this country.
logistics.error_paramSystem error, please try again later.
logistics.error_updateFail to update.
logistics.error_update_logistic_unsupportedCurrently, logistics is not supported to update.
logistics.error_paramCan not update order logistics.
logistics.error_paramWarehouse address not supported.
logistics.error_otherSystem error, please try again later.
logistics.error_otherSystem error, please try again later.
logistics.error_zipcode_not_foundZipcode is not found.
logistics.feature_not_supportedFeature is not supported.
logistics.error_paramThe EMS tracking number must begin with “E”
logistics.error_paramThe EMS tracking number must end with “TH”
logistics.error_paramThe Registered Mail tracking number must begin with “E”, “R” or “O”
logistics.error_paramThe Registered Mail tracking number must end with “TH”
logistics.error_paramPlease fill in a valid tracking number (13 digits)
logistics.error_paramThe tracking number has been used by other orders, please fill in a valid one.
logistics.error_paramPlease fill in the tracking number (13 digits)
logistics.invalid_sizeSize is invalid. Please check the
logistics.error_dataStore status is unavailable,pending buyer update.
logistics.item_is_in_bundleChannel is not allow to disable due to there is item in the bundle.
logistics.logistic_order_is_locked_on_creatingFail to get the lock.
logistics.max dimension is limitedMax dimension or weight is limited.
logistics.error_paramPackage exceeds weight limit. Please adjust or contact Shopee CS for more info.
logistics.missing_cdtCdt settings is missing.
logistics.no buyer_storeBuyer store is missing.
logistics.no_proportionCan Not Found Proportion.
logistics.not_foundNot found.
logistics.order not foundRelative order is not found.
logistics.order_finalizedOrder is already in finalized status.
logistics.order_not_ready_to_updateThe order status is not ready to update.
logistics.package_not_existThe package is not exist.
logistics.parcel_amount_over_limitThe order amount is over limit.
logistics.pickup_whitelist_not_supportedPermission is deny for pickup.
logistics.error_otherPick up address not support COD.
logistics.error_paramPickup address do not support COD.
logistics.error_otherCan not support deliver address.
logistics.error_otherCan not support pick up address.
logistics.error_paramThis address do not support pickup.
logistics.pickup_address_unsupportedPickup address is not supported.
logistics.error_paramSystem error, please try again later.
logistics.price_errorThe price is invalid. Please check the price.
logistics.quantity_errorThe quantity is invalid. Please check the quantity.
logistics.RcvStoreId not foundReceiver storeid is not found.
logistics.error_paramSeller address is not completed.
logistics.seller_address_not_support_codCod pickup is not supported with the seller address.
logistics.error_paramSeller address is not exist. Please try other address.
logistics.error_paramSender address is not exist.
logistics.ship_order_need_address_pickup_timeParameter address_id and pickup_time_id are required.
logistics.ship_order_need_pacakge_numberPlease request with package_number for this split order.
logistics.ship_order_need_tracking_numberParameter tracking_number can not be null.
logistics.ship_order_not_need_pacakge_numberPlease don’t request with package_number for this unsplit order.
logistics.ship_order_only_support_one_typePlease select just one way to ship order: pickup or dropoff or non_integrated.
logistics.ship_order_pff_initYou can not ship warehouse order.
logistics.ship_order_pickup_time_invalidInvalid pickup time id. Please check the pick up time id.
logistics.ship_order_unsupport_pickupThis order does not support ship with pickup.
logistics.shop_not_foundShop is not found.
logistics.shop_not_support_wmsWms is not supported for the shop.
common.invalid_shopShop id is invalid. Please check your shop.
logistics.sls calculate failFail to calculate estimated shipping fee.
logistics.error_paramThe address is invalid. Please check the address.
logistics.error_paramLogistic status is not supported.
logistics.error_limitOrder status not support update logistics.
logistics.update_not_allowedCurrently, update is not allow.
logistics.update_shipping_order_no_param_changeYou can’t update shipping with all the same parameters.
logistics.can_not_update_combine_orderCan not update combine order through Open API, please use Shopee Seller Center instead.
logistics.invalid_address_versionSome addresses are no longer supported per new regulation, please update to avoid wrong fulfilment
error_networkInner http call failed
error_dataparse data failed
error_datadata not exist
error_paramparameter invalid
error_paramThe information you queried is not found.
error_paramWrong parameters, detail: {msg}.
error_serverSomething wrong. Please try later.
error_shopshopid is invalid
error_paramrequest not from gateway
error_paramPackage cannot be rescheduled
error_otherRescheduling dependency error
#

§17 Common errors

Common errors

ErrorDescriptionSolution
error_authpartner_id is invalid
error_authThe App is deleted, and you'll be unable to make any API call.
error_authApp developer’s permissions for authorizations have been restricted. If you’re a seller, contact the developer for more information. If you’re the developer, refer to the Open Platform Console for details.
error_paramThere is no partner_id in query.
error_paramInvalid partner_id.
error_paramno timestamp
error_paramInvalid timestamp
error_paramThere is no sign in query.
error_signWrong sign.
invalid_partner_idInvalid partner_id, please have a check.
error_authNo permission to current api.
error_api_call_restrictedThe App permission for api call have been restricted. If you’re a seller, contact the developer for more information. If you’re the developer, refer to the Open Platform Console for details.
api_suspendedThe API is offline. Please call v2 API instead.
error_limitThe total API call number made by your APP has reached the daily API call limit, please try again after 00: 00 (UTC+08:00)
error_rate_limitToo many requests. You have reached the rate limit. Please try again later.
source_ip_undeclaredRequest Source IP ({ip}) is undeclared. Please declare all your IP addresses in the Shopee Open Platform Console > App list > IP Address Whitelist
error_paramPermission denied. This API is currently offline or the request path is incorrect.
error_paramPartner_id is invalid, should be an integer between 0 and 4294967295.
error_paramno timestamp.
error_paramTimestamp is invalid, should be an integer between 0 and 4294967295.
error_paramTimestamp is expired.
error_partner_key_expiredYour API partner key has expired, please reset the Live API Partner Key in Console to get a new valid partner key to call open api.
error_api_permissionThis app type has no permission to this API.
error_paramThere is no access_token in query.
error_authInvalid access_token.
error_authInvalid partner_id or shopid.
shop_no_linkedPartner and shop has no linked.
shop_bannedThe shop account has been banned. Permissions for shop authorization and API calls have been suspended until the shop account is restored.
invalid_acceess_tokenInvalid access_token, please have a check.
partner_shop_no_linkInvalid partner_id or shop_id, please have a check.
error_ashop_api_permissionThe shop is Affiliate shop has no permission to call this API.
error_kyc_authNo permission. Please inform the seller to complete the Seller Registration on Shopee Seller Center first, then this shop can call for this API.
error_authSystem error, please try again later.
error_paramThere is no shop_id in query.
error_paramshop_id is invalid, should be an integer between 0 and 4294967295.
#

§18 Update log

Update log

DateChange
2026-03-13Support reschedule pickup for instant order
2025-11-20Set the format of address_id to int64.
2021-06-02Update the request parameters description.
#