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

v2.logistics.get_shipping_parameter

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.get_shipping_parameter

Use this api to check if the package support pickup, dropoff, or non-integrated method. For pickup, will return addresses and pickup time id options. For dropoff, will return branch id, sender real name etc, depending on 3PL requirements. [Please call this API when packages meet: 1) fulfillment status is LOGISTICS_READY; or 2) fulfillment status is LOGISTICS_PICKUP_RETRY; or 3) fulfillment status is LOGISTICS_REQUEST_CREATED and meet Instant Order Reschedule Pickup conditions]

#

§2 Overview

Overview

FieldValue
ModuleLogistics
API typeShop
HTTP methodGET
Path/api/v2/logistics/get_shipping_parameter
Production URLhttps://partner.shopeemobile.com/api/v2/logistics/get_shipping_parameter
Sandbox URLhttps://partner.test-stable.shopeemobile.com/api/v2/logistics/get_shipping_parameter
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_numberstringNoOFG134731496217591Shopee'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.
#

§4 Response parameters

Response parameters

NameTypeRequiredSampleDescription
request_idstring2880a5a28510424eaa3288fd941fae2cThe 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.
responseobjectDetail informations you are querying.
response.info_neededobjectThe parameters required based on each specific order to Init. Must use the fields included under info_needed to call Init. 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.
response.info_needed.dropoffstring[][ ]Could contain 'branch_id', 'sender_real_name' or 'tracking_no'. If it contains 'branch_id', choose one to Init. If it contains 'sender_real_name' or 'tracking_no', should manually input these values in Init API. If it has empty value, developer should still include "dropoff" field in Init API.Could contain 'slug'.If it contains 'slug', to return selected 3PL partner only for TW C2C sellers to drop-off parcels with.
response.info_needed.pickupstring[]["address_id", "pickup_time_id"]Could contain 'address_id' and 'pickup_time_id'. Choose one address_id and its corresponding pickup_time_id to Init. If it has empty value, developer should still include "pickup" field in Init API.It could contains "tracking_number" returned from "info_need"for some channels, please also add it when init.
response.info_needed.non_integratedstring[]Could contain 'tracking_no'. If it contains 'tracking_no', should manually input these values in Init API. If it has empty value, developer should still include "non-integrated" field in Init API.
response.dropoffobjectLogistics information for dropoff mode order.
response.dropoff.branch_listobject[]List of available dropoff branches info.
response.dropoff.branch_list.branch_idintThe identity of logistics branch.
response.dropoff.branch_list.regionstringSGThe region of specify address.
response.dropoff.branch_list.statestringThe state of specify address.
response.dropoff.branch_list.citystringAsajayaThe city of specify address.
response.dropoff.branch_list.addressstringThe address description of specify address.
response.dropoff.branch_list.zipcodestringThe zipcode of specify address.
response.dropoff.branch_list.districtstringSarawakThe district of specify address.
response.dropoff.branch_list.townstringThe town of specify address.
response.dropoff.slug_listobject[]List of available TW 3PL drop-off partners.
response.dropoff.slug_list.slugstringThe identity of slug.
response.dropoff.slug_list.slug_namestringThe name of slug.
response.pickupobjectLogistics information for pickup mode order.
response.pickup.address_listobject[]List of available pickup address info.
response.pickup.address_list.address_idint64234The identity of address.
response.pickup.address_list.regionstringSGThe region of specify address.
response.pickup.address_list.statestringSarawakThe state of specify address.
response.pickup.address_list.citystringThe city of specify address.
response.pickup.address_list.districtstringThe district of specify address.
response.pickup.address_list.townstringhahaThe town of specify address.
response.pickup.address_list.addressstringThe address description of specify address.
response.pickup.address_list.zipcodestring50003The zipcode of specify address.
response.pickup.address_list.address_flagstring[]The flag of shop address, applicable values: default_address, pickup_address, return_address, current_address(only for multi-warehouse sellers)
response.pickup.address_list.time_slot_listobject[]List of pickup_time information corresponding to the address_id.; 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.
response.pickup.address_list.time_slot_list.datetimestamp1608103685The date of pickup time. In timestamp.
response.pickup.address_list.time_slot_list.time_textstringThe text description of pickup time. Only applicable for certain channels.
response.pickup.address_list.time_slot_list.pickup_time_idstringThe identity of pickuptime.
response.pickup.address_list.time_slot_list.flagsstring[]["recommended"]This field will have the value “recommended” for the time slot that Shopee suggests sellers choose.; While it is advisable for sellers to choose the recommended time slot, they can also choose other time slots that do not have the recommended flag.
#

§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 Java

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/logistics/get_shipping_parameter?access_token=access_token&timestamp=timestamp&sign=sign&shop_id=shop_id&partner_id=partner_id&order_sn=201214JASXYXY6")
.asString();
#

§8 PHP

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/logistics/get_shipping_parameter?access_token=access_token&order_sn=201214JASXYXY6&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 => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
#

§9 cURL

cURL

curl --location --request GET 'https://partner.shopeemobile.com/api/v2/logistics/get_shipping_parameter?shop_id=shop_id&partner_id=partner_id&order_sn=201214JASXYXY6&access_token=access_token&timestamp=timestamp&sign=sign' 
#

§10 Python

Python

import requests

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

payload={}
headers = {

}
response = requests.request("GET",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)
#

§11 Response sample

Response sample

#

§12 JSON

JSON

{
    "error": "",
    "message": "",
    "response": {
        "info_needed": {
            "dropoff": [],
            "pickup": [
                "address_id",
                "pickup_time_id"
            ]
        },
        "dropoff": null,
        "pickup": {
            "address_list": [
                {
                    "address_id": 123,
                    "region": "SG",
                    "state": "",
                    "city": "",
                    "district": "",
                    "town": "",
                    "address": "",
                    "zipcode": "40009",
                    "address_flag": [
                        "default_address",
                        "pickup_address",
                        "return_address"
                    ],
                    "time_slot_list": null
                },
                {
                    "address_id": 234,
                    "region": "SG",
                    "state": "",
                    "city": "",
                    "district": "",
                    "town": "",
                    "address": "hhh, #34",
                    "zipcode": "xxx",
                    "address_flag": [],
                    "time_slot_list": null
                }
            ]
        }
    },
    "request_id": "2880a5a28510424eaa3288fd941fae2c"
}
#

§13 Error example

Error example

#

§14 JSON

JSON

{
    "error": "error_not_found",
    "message": "Wrong parameters, detail: the order is not found.",
    "request_id": "44c2f2077941a5393c402cc42daf246e"
}
#

§15 Errors

Errors

ErrorDescriptionSolution
logistics.error_paramThe order is being allocated, please wait until the allocate is completed.
logistics.error_channel_existFail to find the fulfillment channel of this order.
error_not_foundWrong parameters, detail: {msg}.
error_paramWrong parameters, detail: {msg}.
error_permissionSorry you don't have the permission, detail: {msg}.
error_serverSystem error. Please try again later.
logistics.lack_of_invoice_dataPlease upload the invoice or verify the details of the document already submitted, which is currently flagged as invalid by SEFAZ. Correction is required to release the shipment.
common.invalid_shopShop id is invalid. Please check your shop.
logistics.package_number_not_existPlease request with package_number for this split order.
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_paramOFG list type is not TO_PROCESS
error_paramShipping parameters can only be obtained when package is ready to be shipped
error_paramThe information you queried is not found.
error_paramWrong parameters, detail: {msg}.
error_serverSomething wrong. Please try later.
error_shopshopid is invalid
logistics.no_available_time_slotNo available time slot
logistics.no_supported_dropoff_branchNo supported drop-off branch
logistics.no_supported_pickup_addressNo supported pickup address
logistics.no_valid_shipping_parametersNo valid shipping parameters. Please contact support
error_paramrequest not from gateway
error_statusThe order has been cancelled.
error_paramPackage cannot be rescheduled
error_otherRescheduling dependency error
#

§16 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.
#

§17 Update log

Update log

DateChange
2026-03-13Support getting shipping parameter for Instant Order Reschedule Pickup
2025-03-24Add “flags” response parameter under time_slot_list
2023-04-10add optional parameter package_number apply for split order.
2022-01-20update Dropoff slug_list and Dropoff description
#