淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
num_iid	Number	必须	123456		Sku所属商品数字id，可通过 taobao.item.get 获取
properties	String	必须	1627207:28326;1630696:3266779		Sku属性串。格式:pid:vid;pid:vid,如: 1627207:3232483;1630696:3284570,表示机身颜色:军绿色;手机套餐:一电一充
quantity	Number	可选	3		Sku的库存数量。sku的总数量应该小于等于商品总数量(Item的NUM)，sku数量变化后item的总数量也会随着变化。取值范围:大于等于零的整数
price	Price	可选	207.02		Sku的销售价格。精确到2位小数;单位:元。如:200.07，表示:200元7分。修改后的sku价格要保证商品的价格在所有sku价格所形成的价格区间内（例如：商品价格为6元，sku价格有5元、10元两种，如果要修改5元sku的价格，那么修改的范围只能是0-6元之间；如果要修改10元的sku，那么修改的范围只能是6到无穷大的区间中）
outer_id	String	可选	123456		Sku的商家外部id
lang	String	可选	zh_CN	默认值：zh_CN	Sku文字的版本。可选值:zh_HK(繁体),zh_CN(简体);默认值:zh_CN
item_price	Price	可选	204		sku所属商品的价格。当用户更新sku，使商品价格不属于sku价格之间的时候，用于修改商品的价格，使sku能够更新成功
ignorewarning	String	可选	,ifd_warning,FakeCredit_Warning,		忽略警告提示.

名称	类型	示例值	描述
sku	Sku		商品SKU信息（只包含num_iid和modified）
└ iid String asdf12323adfaa sku所属商品id(注意：iid近期即将废弃，请用num_iid参数) └ num_iid Number 12345 sku所属商品数字id └ modified String 2009-11-04 15:24:43 sku最后修改日期时间格式：yyyy-MM-dd HH:mm:ss └ sku_id Number 123 sku的id

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemSkuPriceUpdateRequest req = new ItemSkuPriceUpdateRequest();
req.setNumIid(123456L);
req.setProperties("1627207:28326;1630696:3266779");
req.setQuantity(3L);
req.setPrice("207.02");
req.setOuterId("123456");
req.setLang("zh_CN");
req.setItemPrice("204");
req.setIgnorewarning(",ifd_warning,FakeCredit_Warning,");
ItemSkuPriceUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
ItemSkuPriceUpdateRequest req = new ItemSkuPriceUpdateRequest();
req.NumIid = 123456L;
req.Properties = "1627207:28326;1630696:3266779";
req.Quantity = 3L;
req.Price = "207.02";
req.OuterId = "123456";
req.Lang = "zh_CN";
req.ItemPrice = "204";
req.Ignorewarning = ",ifd_warning,FakeCredit_Warning,";
ItemSkuPriceUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new ItemSkuPriceUpdateRequest;
$req->setNumIid("123456");
$req->setProperties("1627207:28326;1630696:3266779");
$req->setQuantity("3");
$req->setPrice("207.02");
$req->setOuterId("123456");
$req->setLang("zh_CN");
$req->setItemPrice("204");
$req->setIgnorewarning(",ifd_warning,FakeCredit_Warning,");
$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=taobao.item.sku.price.update' \
-d 'partner_id=apidoc' \
-d 'session=d93171d9-52a6-4c10-bb2a-0f5d2c66621f' \
-d 'sign=7816DF0560857F9CEF8F12D562CBA6A8' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-24+18%3A24%3A24' \
-d 'v=2.0' \
-d 'ignorewarning=%2Cifd_warning%2CFakeCredit_Warning%2C' \
-d 'item_price=204' \
-d 'lang=zh_CN' \
-d 'num_iid=123456' \
-d 'outer_id=123456' \
-d 'price=207.02' \
-d 'properties=1627207%3A28326%3B1630696%3A3266779' \
-d 'quantity=3'

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

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

req.num_iid=123456
req.properties="1627207:28326;1630696:3266779"
req.quantity=3
req.price="207.02"
req.outer_id="123456"
req.lang="zh_CN"
req.item_price="204"
req.ignorewarning=",ifd_warning,FakeCredit_Warning,"
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,"taobao.item.sku.price.update");
add_param(pRequest,"num_iid","123456");
add_param(pRequest,"properties","1627207:28326;1630696:3266779");
add_param(pRequest,"quantity","3");
add_param(pRequest,"price","207.02");
add_param(pRequest,"outer_id","123456");
add_param(pRequest,"lang","zh_CN");
add_param(pRequest,"item_price","204");
add_param(pRequest,"ignorewarning",",ifd_warning,FakeCredit_Warning,");
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('taobao.item.sku.price.update', {
	'num_iid':'123456',
	'properties':'1627207:28326;1630696:3266779',
	'quantity':'3',
	'price':'207.02',
	'outer_id':'123456',
	'lang':'zh_CN',
	'item_price':'204',
	'ignorewarning':',ifd_warning,FakeCredit_Warning,'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<item_sku_price_update_response>
    <sku>
        <iid>asdf12323adfaa</iid>
        <num_iid>12345</num_iid>
        <modified>2009-11-04 15:24:43</modified>
        <sku_id>123</sku_id>
    </sku>
</item_sku_price_update_response>

{
    "item_sku_price_update_response":{
        "sku":{
            "iid":"asdf12323adfaa",
            "num_iid":12345,
            "modified":"2009-11-04 15:24:43",
            "sku_id":123
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案
isv.item-update-service-error:IC_SKU_MUST_IN_SPU_RANGE	商品所选择销售属性超出产品许可范围，请联系小二确认
isv.item-update-service-error:IC_BRAND_NOT_GRANT_FOR_B	未授权发布此品牌的商品	当发生此错误时不能重试，需要重新编辑整个商品的品牌相关信息。
isv.item-update-service-error:ITEM_NOT_FOUND	没有找到宝贝
isv.item-update-service-error:IC_CHECKSTEP_PRICE_ERROR	不符合类目价格限制，此类目下最高价格为${CATEGORY_PRICE_LIMITED_HIGHT}，最低价格为${CATEGORY_PRICE_LIMITED_LOW}
isv.item-update-service-error:ITEM_INPUT_PROPERTIES_ERROR	输入属性错误
isv.item-update-service-error:IC_INVALID_SPU_FOR_VERTICAL	产品不在产品库内，请联系我们的小二！
isv.item-get-service-error:ITEM_NOT_FOUND	没有找到宝贝	1. 确认num_iid是否正确，请通过taobao.items.get/taobao.items.search等查询接口获取正确的宝贝 num_iid，再通过taobao.item.sku.update接口更新sku信息； 2. 如果num_iid无误，则对应的宝贝可能已违规或进入历史库，在本地增加逻辑：发现报商品不存在的错误（ITEM_NOT_FOUND）就将本地的商品记录删除掉，防止卖家或者系统自动重试再次发生这个问题。3. 这个是业务不可避免的错误。当商品被删除一定时间、或者商品长达3个月都没有被编辑过以后，商品会被移到历史库中再也找不到。解决该问题，可以使用增量 api监控商品被删除的消息，及时把发生这个错误的商品从本地数据库中删除掉，随时保持数据的同步性。发生这个错误时不要重试。
isv.item-update-service-error:IC_CATEGORY_NOT_GRANT_FOR_B	未授权发布此类目的商品
isv.item-is-delete:invalid-numIid-or-iid	该商品已被删除	1. 出现此错误不要重试，通过增量接口taobao.increment.items.get获取被删除的商品，在本地数据库更新； 2. 为减少此错误的发生量，平时应增加逻辑：用增量接口taobao.increment.items.get监控商品状态，定时更新数据库
isv.item-update-service-error:QUANTITY_ITEM_CAT_TOO_LARGE	您出售中的“${mainCategoryName}”类目下宝贝总数已超过此类目宝贝数量限额（卖家评分:${onlineLimitBeginRate}-${onlineLimitEndRate}，允许宝贝个数:${onlineLimitMax}），请您及时调整您的宝贝数量，再上传宝贝	1.发生该错误时不能重试。2.将这个用户和这个类目做上关联标记，用户不能再到这个类目下发布在售商品或编辑、上架商品，需要等卖家下架其他商品后再手动解除其限制。
isv.item-update-service-error:IC_CHECKSTEP_ALREADY_EXISTS_SAME_SPU	您已发布过同类宝贝，不允许重复发布	当前商品所属的产品下已经有一个一样的商品了，出现此错误不可重试，重新编辑商品为下架状态，或者下架另外一个商品后再编辑此商品。
isv.item-update-service-error:IC_PRICE_LIMIT_FOR_DPC	宝贝价格须在指定零售价范围内（${lowPriceForDpc}-${highPriceForDpc}元），如有异常，请您登陆分销平台同步商品信息
isv.missing-parameter:sku-quantity-or-price	quantity和price有一个或都没有传入	每次编辑sku的时候，如果是用户新加的sku，增加校验quantity和price的步骤，这两个参数都必须要传进来。或者每次编辑都将这两个参数传回来，不传就前端报错，不允许调用接口。
isv.item-update-service-error:IC_CHECKSTEP_SKU_DUPLICATE	宝贝销售属性出错（重复），请重新编辑
isv.item-update-service-error:ITEM_PROPERTIES_ERROR	${lostPropText}属性出错	1.发生错误需要让卖家重新编辑商品，不能直接重试 2.发布商品前，需要对卖家发布商品的属性做好前端校验，看必填属性有没有缺失，可选属性有没有填错。属性最好直接让卖家选择，不要让卖家手工输入。 3.如果卖家的商品关联了product，最好将product取出来的关键属性直接填充到商品的属性中，避面因用户错选导致错误。4.每天定期更新本地的类目属性数据（每天凌晨5点后更新，每天更新一次），保证本地数据的正确性。
isv.missing-parameter:iid-or-numIid	参数：iid或numIid没有传入
isv.item-update-service-error:IC_CHECKSTEP_SKU_PROP_NOT_FOUND_IN_ITEM	宝贝销售属性出错（销售属性和商品属性不一致），请重新编辑
isv.item-update-service-error:ERROR_SHOP_CATEGORY_HAS_SUB_CATEGORIES	自定义店铺分类不存在或者店铺分类错误	更新自定义店铺类目的时候要先搜一下店铺该类目下是否有商品，如果有商品，要同时更新商品的seller_cids，但如果是用户在淘宝后台更改自定义类目，则出现错误后不要重试，然后用户到淘宝后台修改
isv.item-update-service-error:IC_ITEM_DESC_COULD_NOT_BE_EMPTY	商品描述为空	出现问题后不要重试
isv.item-update-service-error:IC_CHECKSTEP_NO_PERMISSION	您未通过认证或已被处罚，请核实	发生该错误时不要重试，将这个用户做上标记后让用户检查自己的权限问题，等用户处理好了再让用户来手动取消禁止标记。否则就不允许用户发布或者编辑商品
isv.item-update-service-error:IC_ITEM_3C_RULE_INVOICE	淘宝电器城商品必须有发票/有保修/卖家包邮
isv.item-update-service-error:IC_SELLER_NEED_PAY_POSTFEE	必须由卖家承担运费
isv.item-update-service-error:FORBIDDEN_QUANTITY_ZERO_ERROR	上架商品数量必须大于0	此接口需要在前端做好改进控制：1.编辑sku前需要对当前商品所有的sku进行判断，如果此sku是最后一个有数量的sku，不能将他更新为0，或者直接将sku下架即可。2.在批量对sku进行编辑的时候要注意编辑顺序，先增加sku或者先编辑数量不为0的sku，再编辑数量为0 的sku或者删除sku。3.出现此错误不能重试，要提示卖家重新编辑商品。
isv.item-update-service-error:IC_CHECKSTEP_SKU_PROP_NOT_SALE	宝贝销售属性出错（非销售属性），请重新编辑	1.前端要定期更新淘宝的类目属性数据，每天早上5点以后更新一次。2.发生次错误不能重试，需要提示用户重新编辑商品和sku的属性再上传（如果是新增sku报错误则重新编辑，如果是旧的sku报此错误需要删除旧的sku重新上传新的sku）
isv.item-update-service-error:IC_CHECKSTEP_SPU_NOT_EXIST	您发布的商品无对应产品	请登录“淘宝网”先行发布产品
isv.item-update-service-error:GENERIC_FAILURE	系统错误，请稍后再试
isv.item-update-service-error:IC_CHECKSTEP_ITME_SKU_PRICE_UNMATCH	商品的价格要位于sku的价格区间之中（例如，sku价格有5元、10元两种，那么商品的价格就需要大于等于5元，小于等于10元）	需要对item价格或sku价格做更改时，在前端做好校验。发生错误后重新编辑商品价格再提交，不要直接重试。
错误码：40，子错误码：null	缺少必要的传入参数
错误码：41，子错误码：null	传入参数的格式错误
isv.item-update-service-error:IC_CHECKSTEP_SKU_ERROR	宝贝销售属性出错
isv.item-update-service-error:IC_CHECKSTEP_SKU_PRICE_ERROR	宝贝销售价格错误
isv.invalid-parameter:sku-price	参数：sku-price无效，格式不对、非法值、越界等	1. 出现此错误后不要重试，请验证sku的价格是否大于等于0； 2. 应用在前端应对sku价格进行校验，超出范围便提示用户重新输入
isv.invalid-permission:update-item	该商品不属于当前用户	请在用户和商品之间做好匹配
isv.error-trigger-fake-credit	触发了防炒信规则警告	在 ignorewarning 字段中包含 “,FakeCredit_Warning,” 字样(引号内)，如果这样做，系统将认为用户确认了警告的内容并要求进行更新。
isp.system-busy	服务异常，请稍后重试	服务异常，请稍后重试
isv.item-service-error:IC_OPTIMISTIC_LOCKING_CONFLICT	商品更新频率太快，请降低商家维度更新频率	商品更新频率太快，请降低商家维度更新频率
isv.item-not-exist:invalid-numIid-or-iid	商品不存在	商品不存在，请检查numIid是否填写正确
isv.item-service-error:IC_CHECKSTEP_ITME_NOT_IN_SKU_PRICE	商品价格和sku价格不匹配	请检查商品价格是否包含在sku价格中
isv.item-service-error:AUCTION_SCHEMA_SKU_FEATURE_NO_PERMISSION	此商品暂不支持TOP编辑，请到商家后台完成编辑	此商品暂不支持TOP编辑，请到商家后台完成编辑
isv.item-service-error:IC_STUFF_STATUS_NEW_LIMITED_WITH_NOSHOP	发布、编辑上架和上架全新宝贝必须是店铺卖家	发布、编辑上架和上架全新宝贝必须是店铺卖家
isv.item-service-error:IC_CHECKSTEP_ITME_SKU_PRICE_UNMATCH	商品价格和sku价格不匹配	请检查商品价格是否在sku价格中
isv.item-service-error:ITEM_PROPERTIES_ERROR	缺少类目必填属性, 类目ID:[50012043],类目名称:[板鞋/休闲鞋], 属性ID:[122276315],属性名称:[款式]	请完善后再提交

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

淘宝商品API

taobao.item.sku.price.update (更新商品SKU的价格)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ