淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
mutiple_product_update_list	SynchronizeProductRequestDto []	必须		最大列表长度：20	The product list, in which the price needs to be updated. Maximum length:20
└ product_id Number 必须 1000005237852 product id multiple_sku_update_list SynchronizeSkuRequestDto [] 必须 The sku list, in which the inventory needs to be updated within the same product id └ price String 必须 19.99 price of an sku └ discount_price String 可选 14.99 discount_price of an sku. If not set, the discount_price will be erased. └ sku_code String 必须 123abc sku code multi_country_price_configuration MultiCountryPriceConfigurationDto 可选 multi country price configuration └ price_type String 可选 absolute Currently supporting only absolute. Please test carefully before uploading products. country_price_list SingleCountryPriceDto [] 可选 Price list for different countries └ ship_to_country String 可选 FR Currently supporting RU US CA ES FR UK NL IL BR CL AU UA BY JP TH SG KR ID MY PH VN IT DE SA AE PL TR sku_price_by_country_list SingleSkuPriceByCountryDto [] 可选 Sku price list under the same ship_to_country └ sku_code String 可选 abc123 sku_code, must existed in multiple_sku_update_list └ price String 可选 15 Value of price configuration. If the price of a specific country is set, it must be greater than or equal to 70% of the original sku price in multiple_sku_update_list └ discount_price String 可选 13.99 Value of discount_price for each country

名称	类型	描述
update_error_code	String	When success equals false, indicating the error code
update_error_message	String	When success equals false, indicating the error message
update_success	Boolean	Indicates the update result is successful or not. Only all the products in mutiple_product_update_list have been updated successfully will make the success to be true, otherwise false.
update_failed_list	SynchronizeProductResponseDto []	update failed list
└ error_code String error code └ error_message String error message └ product_id Number product oid
update_successful_list	SynchronizeProductResponseDto []	update successful list
└ product_id Number product id

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressSolutionBatchProductPriceUpdateRequest req = new AliexpressSolutionBatchProductPriceUpdateRequest();
List<AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeProductRequestDto> list2 = new ArrayList<AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeProductRequestDto>();
AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeProductRequestDto obj3 = new AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeProductRequestDto();
list2.add(obj3);
obj3.setProductId(1000005237852L);
List<AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeSkuRequestDto> list6 = new ArrayList<AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeSkuRequestDto>();
AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeSkuRequestDto obj7 = new AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeSkuRequestDto();
list6.add(obj7);
obj7.setPrice("19.99");
obj7.setDiscountPrice("14.99");
obj7.setSkuCode("123abc");
list4.setMultipleSkuUpdateList(list6);
AliexpressSolutionBatchProductPriceUpdateRequest.MultiCountryPriceConfigurationDto obj9 = new AliexpressSolutionBatchProductPriceUpdateRequest.MultiCountryPriceConfigurationDto();
obj9.setPriceType("absolute");
List<AliexpressSolutionBatchProductPriceUpdateRequest.SingleCountryPriceDto> list11 = new ArrayList<AliexpressSolutionBatchProductPriceUpdateRequest.SingleCountryPriceDto>();
AliexpressSolutionBatchProductPriceUpdateRequest.SingleCountryPriceDto obj12 = new AliexpressSolutionBatchProductPriceUpdateRequest.SingleCountryPriceDto();
list11.add(obj12);
obj12.setShipToCountry("FR");
List<AliexpressSolutionBatchProductPriceUpdateRequest.SingleSkuPriceByCountryDto> list15 = new ArrayList<AliexpressSolutionBatchProductPriceUpdateRequest.SingleSkuPriceByCountryDto>();
AliexpressSolutionBatchProductPriceUpdateRequest.SingleSkuPriceByCountryDto obj16 = new AliexpressSolutionBatchProductPriceUpdateRequest.SingleSkuPriceByCountryDto();
list15.add(obj16);
obj16.setSkuCode("abc123");
obj16.setPrice("15");
obj16.setDiscountPrice("13.99");
list13.setSkuPriceByCountryList(list15);
obj9.setCountryPriceList(list11);
list8.setMultiCountryPriceConfiguration(obj9);
req.setMutipleProductUpdateList(list2);
AliexpressSolutionBatchProductPriceUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AliexpressSolutionBatchProductPriceUpdateRequest req = new AliexpressSolutionBatchProductPriceUpdateRequest();
List<AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeProductRequestDtoDomain> list2 = new List<AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeProductRequestDtoDomain>();
AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeProductRequestDtoDomain obj3 = new AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeProductRequestDtoDomain();
list2.Add(obj3);
obj3.ProductId = 1000005237852L;
List<AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeSkuRequestDtoDomain> list5 = new List<AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeSkuRequestDtoDomain>();
AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeSkuRequestDtoDomain obj6 = new AliexpressSolutionBatchProductPriceUpdateRequest.SynchronizeSkuRequestDtoDomain();
list5.Add(obj6);
obj6.Price = "19.99";
obj6.DiscountPrice = "14.99";
obj6.SkuCode = "123abc";
obj3.MultipleSkuUpdateList= list5;
AliexpressSolutionBatchProductPriceUpdateRequest.MultiCountryPriceConfigurationDtoDomain obj7 = new AliexpressSolutionBatchProductPriceUpdateRequest.MultiCountryPriceConfigurationDtoDomain();
obj7.PriceType = "absolute";
List<AliexpressSolutionBatchProductPriceUpdateRequest.SingleCountryPriceDtoDomain> list9 = new List<AliexpressSolutionBatchProductPriceUpdateRequest.SingleCountryPriceDtoDomain>();
AliexpressSolutionBatchProductPriceUpdateRequest.SingleCountryPriceDtoDomain obj10 = new AliexpressSolutionBatchProductPriceUpdateRequest.SingleCountryPriceDtoDomain();
list9.Add(obj10);
obj10.ShipToCountry = "FR";
List<AliexpressSolutionBatchProductPriceUpdateRequest.SingleSkuPriceByCountryDtoDomain> list12 = new List<AliexpressSolutionBatchProductPriceUpdateRequest.SingleSkuPriceByCountryDtoDomain>();
AliexpressSolutionBatchProductPriceUpdateRequest.SingleSkuPriceByCountryDtoDomain obj13 = new AliexpressSolutionBatchProductPriceUpdateRequest.SingleSkuPriceByCountryDtoDomain();
list12.Add(obj13);
obj13.SkuCode = "abc123";
obj13.Price = "15";
obj13.DiscountPrice = "13.99";
obj10.SkuPriceByCountryList= list12;
obj7.CountryPriceList= list9;
obj3.MultiCountryPriceConfiguration= obj7;
req.MutipleProductUpdateList_ = list2;
AliexpressSolutionBatchProductPriceUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AliexpressSolutionBatchProductPriceUpdateRequest;
$mutiple_product_update_list = new SynchronizeProductRequestDto;
$mutiple_product_update_list->product_id="1000005237852";
$multiple_sku_update_list = new SynchronizeSkuRequestDto;
$multiple_sku_update_list->price="19.99";
$multiple_sku_update_list->discount_price="14.99";
$multiple_sku_update_list->sku_code="123abc";
$mutiple_product_update_list->multiple_sku_update_list = $multiple_sku_update_list;
$multi_country_price_configuration = new MultiCountryPriceConfigurationDto;
$multi_country_price_configuration->price_type="absolute";
$country_price_list = new SingleCountryPriceDto;
$country_price_list->ship_to_country="FR";
$sku_price_by_country_list = new SingleSkuPriceByCountryDto;
$sku_price_by_country_list->sku_code="abc123";
$sku_price_by_country_list->price="15";
$sku_price_by_country_list->discount_price="13.99";
$country_price_list->sku_price_by_country_list = $sku_price_by_country_list;
$multi_country_price_configuration->country_price_list = $country_price_list;
$mutiple_product_update_list->multi_country_price_configuration = $multi_country_price_configuration;
$req->setMutipleProductUpdateList(json_encode($mutiple_product_update_list));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=aliexpress.solution.batch.product.price.update' \
-d 'partner_id=apidoc' \
-d 'session=2f0fc8aa-75bf-4fb2-a8b1-0287013291f6' \
-d 'sign=042F4C04D79F04595DFA1F8E7D111908' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+16%3A57%3A53' \
-d 'v=2.0' \
-d 'mutiple_product_update_list=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AliexpressSolutionBatchProductPriceUpdateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.mutiple_product_update_list=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"aliexpress.solution.batch.product.price.update");
add_param(pRequest,"mutiple_product_update_list","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('aliexpress.solution.batch.product.price.update', {
	'mutiple_product_update_list':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<aliexpress_solution_batch_product_price_update_response>
    <update_error_code></update_error_code>
    <update_error_message></update_error_message>
    <update_success></update_success>
    <update_failed_list>
        <synchronize_product_response_dto>
            <error_code></error_code>
            <error_message></error_message>
            <product_id></product_id>
        </synchronize_product_response_dto>
    </update_failed_list>
    <update_successful_list>
        <synchronize_product_response_dto>
            <product_id></product_id>
        </synchronize_product_response_dto>
    </update_successful_list>
</aliexpress_solution_batch_product_price_update_response>

{
    "aliexpress_solution_batch_product_price_update_response":{
        "update_error_code":"",
        "update_error_message":"",
        "update_success":,
        "update_failed_list":{
            "synchronize_product_response_dto":[
                {
                    "error_code":"",
                    "error_message":"",
                    "product_id":
                }
            ]
        },
        "update_successful_list":{
            "synchronize_product_response_dto":[
                {
                    "product_id":
                }
            ]
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

Developing documentation（已废弃）

aliexpress.solution.batch.product.price.update (aliexpress.solution.batch.product.price.update)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ