v2.logistics.update_channel

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

来自 Shopee 官方资料快照 · 2026-09-06 12:13:20

打开官方原文 ↗

当前资料结构化阅读页
固定快照已留存，可追溯
官方原文可核对

查看技术与溯源信息

平台 / profile: Shopee / profile.shopee.api_reference
语言: en-US
发布版本: cn-20260909-2
标签: zhuge/sourceplatform/shopeeaudience/developercategory/api_doctopic/apitopic/developer

资料正文

§1 v2.logistics.update_channel

Use this api to update shop level logistics channel's configuration.

§2 Overview

Overview

Field	Value
Module	Logistics
API type	Shop
HTTP method	POST
Path	/api/v2/logistics/update_channel
Production URL	https://partner.shopeemobile.com/api/v2/logistics/update_channel
Sandbox URL	https://partner.test-stable.shopeemobile.com/api/v2/logistics/update_channel
Rate limit	[0, 0, 0]
Permission	ERP System; Seller In House System; Order Management; Swam ERP

§3 Request parameters

Request parameters

Name	Type	Required	Sample	Description
logistics_channel_id	int64	Yes	14623	The identity of logistic channel.
enabled	boolean	No	true	Whether to enable this logistic channel.
cod_enabled	boolean	No	true	Whether to enable COD for this logistic channel. Only COD supported channels are applicable.
auto_call_driver_setting	object	No
auto_call_driver_setting.auto_call_driver_enabled	boolean	No	true	Whether to enable Auto Call Driver for this logistic channel.
auto_call_driver_setting.preparation_time	int32	No	10	Used to set the Preparation Time for this channel, in minutes. Required when auto_call_driver_enabled = true.; Note: Please ensure the passed preparation_time value falls within the preparation_time_limit range returned by v2.logistics.get_channel_list.

§4 Response parameters

Response parameters

Name	Type	Sample	Description
request_id	string	df17f35abb4244938b22a675211dc99c	The identifier of the 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.
response	object		Detail informations you are querying.
response.shop_id	int64	123123	Shopee's unique identifier for a shop.
response.enabled	boolean	true	Whether this logistic channel is enabled.
response.cod_enabled	boolean	false	Whether COD is enabled for this channel.
response.logistics_channel_id	int64	14623	The identity of logistic channel.
response.updated_channels	object[]		List of channels that are updated in the operation (inclusive of dependent logistics channels)
response.updated_channels.channel_id	int64	80025	Logistics channel ID
response.updated_channels.channel_display_name	string	channel Anteraja	Logistics channel name
response.updated_channels.unsupport_warehouse	object[]		List details of unsupported warehouses
response.updated_channels.unsupport_warehouse.warehouse_id	int64	78	Unsupported warehouse ID
response.updated_channels.unsupport_warehouse.warehouse_name	string	ID_WHS_03	Unsupported warehouse name
response.is_multi_warehouse	boolean	false
response.auto_call_driver_setting	object
response.auto_call_driver_setting.auto_call_driver_enabled	boolean	true	Indicate whether Auto Call Driver is currently enabled for this channel.
response.auto_call_driver_setting.preparation_time	int32	10	The current valid preparation time for this channel, in minutes.

§5 Common parameters

Common 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

§6 Request samples

Request samples

§7 Payload

Payload

{
	"logistics_channel_id": 14623,
	"enabled": true,
	"cod_enabled": true
}

§8 Java

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/logistics/update_channel?shop_id=shop_id&partner_id=partner_id&sign=sign&access_token=access_token&timestamp=timestamp")
.header("Content-Type","application/json")
.body("{
   \"cod_enabled\": true,
   \"enabled\": true,
   \"logistics_channel_id\": 14623,
   \"preferred\": true
}")
.asString();

§9 PHP

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/logistics/update_channel?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 => '{
    "cod_enabled": true,
    "enabled": true,
    "logistics_channel_id": 14623,
    "preferred": true
}',
  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_channel?partner_id=partner_id&sign=sign&access_token=access_token&timestamp=timestamp&shop_id=shop_id' \
--header 'Content-Type: application/json' \
--data-raw '{
   "cod_enabled": true,
   "enabled": true,
   "logistics_channel_id": 14623,
   "preferred": true
}'

§11 Python

Python

import requests
import json

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

payload=json.dumps({
  "cod_enabled": True,
  "enabled": True,
  "logistics_channel_id": 14623,
  "preferred": True
})
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

{
	"request_id": "df17f35abb4244938b22a675211dc99c",
	"error": "error_auth",
	"message": "Invalid access_token.",
	"response": {
		"shop_id": 123123,
		"enabled": true,
		"cod_enabled": false,
		"logistics_channel_id": 14623,
                "is_multi_warehouse": true,
		"update_channels": [{
			"channel_id": 1000,
			"channel_display_name": "",
			"unsupport_warehouse": [{
				"warehouse_id": 1,
				"warehouse_name": "abc"
			}]
		}]
	}

}

§14 Error example

Error example

§15 JSON

JSON

{
    "error": "logistics.error_param",
    "message": "Invalid logistics_channel_id. Please check the logistics_channel_id.",
    "request_id": "c955f5939580785debf7aaec62ec8d07"
}

§16 Errors

Errors

Error	Description	Solution
error_param	Seller or Channel does not support Auto-Call.
error_param	Invalid Auto-Call setting param.
error_param	Invalid Seller preparation time.
error_param	Shipping options of Direct Shop will follow Local Shop.
logistics_error	Channel is invalid. Please check the channel id.
error_not_found	Wrong parameters, detail: {msg}.
error_param	Wrong parameters, detail: {msg}.
error_permission	Sorry you don't have the permission, detail: {msg}.
error_server	System error. Please try again later.
logistics.has_item_in_bundle	channel is not allow to disable due to there is item in the bundle
logistics.error_param	Invalid logistics_channel_id. Please check the logistics_channel_id.
error	no supported warehouse address
logistics_error	This channel is now related to SPX Hemat channel (80029), to enable or disable it please update SPX Hemat channel instead
logistics.compulsory_channel_rule	{parent_channel} cannot be modified. Please enable at least 1 of the following channel(s) first: {seller channel name list}
logistics.dependent_block_rule	{parent_channel} cannot be turned off due to dependent block rule. Please disable all the following channel(s) before proceed: {seller channel name list}
logistics.minimum_activation_rule	{parent_channel} cannot be turned off. Please enable at least 1 of the following channel(s): {seller channel name list}
logistics.address_miss_long_lat	Address miss long lat.
logistics.require_pickup_address	Please go to set pickup address first.
logistics.not_allow_to_update_channel	You are not allowed to enable or disable channel.
common.invalid_shop	Shop id is invalid. Please check your shop.
logistics_error	Sorry that this masked channel can't be enabled.
logistics_error	Sorry that this masked channel can't be enabled.
logistics_error	Sorry that this channel can’t be disabled since it is force enabled.
logistics_error	Sorry that this channel can't be enabled since it doesn’t pass the validation (whitelist validation / exclusive validation / serviceable validation ).
logistics_error	Sorry that this masked channel can't be preferred.
logistics_error	Sorry that this channel can't be enabled(disabled)/preferred/ COD enabled(COD disabled).
error_network	Inner http call failed
error_data	parse data failed
error_data	data not exist
error_param	parameter invalid
error_param	The information you queried is not found.
error_param	Wrong parameters, detail: {msg}.
error_server	Something wrong. Please try later.
error_shop	shopid is invalid
error_param	request not from gateway

§17 Common errors

Common errors

Error	Description	Solution
error_auth	partner_id is invalid
error_auth	The App is deleted, and you'll be unable to make any API call.
error_auth	App 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_param	There is no partner_id in query.
error_param	Invalid partner_id.
error_param	no timestamp
error_param	Invalid timestamp
error_param	There is no sign in query.
error_sign	Wrong sign.
invalid_partner_id	Invalid partner_id, please have a check.
error_auth	No permission to current api.
error_api_call_restricted	The 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_suspended	The API is offline. Please call v2 API instead.
error_limit	The 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_limit	Too many requests. You have reached the rate limit. Please try again later.
source_ip_undeclared	Request Source IP ({ip}) is undeclared. Please declare all your IP addresses in the Shopee Open Platform Console > App list > IP Address Whitelist
error_param	Permission denied. This API is currently offline or the request path is incorrect.
error_param	Partner_id is invalid, should be an integer between 0 and 4294967295.
error_param	no timestamp.
error_param	Timestamp is invalid, should be an integer between 0 and 4294967295.
error_param	Timestamp is expired.
error_partner_key_expired	Your 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_permission	This app type has no permission to this API.
error_param	There is no access_token in query.
error_auth	Invalid access_token.
error_auth	Invalid partner_id or shopid.
shop_no_linked	Partner and shop has no linked.
shop_banned	The shop account has been banned. Permissions for shop authorization and API calls have been suspended until the shop account is restored.
invalid_acceess_token	Invalid access_token, please have a check.
partner_shop_no_link	Invalid partner_id or shop_id, please have a check.
error_ashop_api_permission	The shop is Affiliate shop has no permission to call this API.
error_kyc_auth	No permission. Please inform the seller to complete the Seller Registration on Shopee Seller Center first, then this shop can call for this API.
error_auth	System error, please try again later.
error_param	There is no shop_id in query.
error_param	shop_id is invalid, should be an integer between 0 and 4294967295.

§18 Update log

Update log

Date	Change
2026-04-09	Add auto_call_driver_setting request and response parameters
2023-09-27	sunset the request parameters "preferred" since "Preferred channel setting is no longer supported".

这条内容对你有帮助吗？