淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
item_id	Number	必须	123456789		商品ID
item_price	Price	可选	99.99		被更新商品价格
sku_prices	UpdateSkuPrice []	可选		最大列表长度：999999	更新SKU价格时候的SKU价格对象；如果没有SKU或者不更新SKU价格，可以不填;查找SKU目前支持ID，属性串和商家编码三种模式，建议选用一种最合适的，切勿滥用，一次调用中如果混合使用，更新结果不可预期！
└ sku_id Number 可选 123456 SkuID，用于指定被修改价格的SKU └ properties String 可选 1627207:28326;1630696:3266779 Sku属性串。格式:pid:vid;pid:vid,如: 1627207:3232483;1630696:3284570,表示机身颜色:军绿色;手机套餐:一电一充，用于指定被修改价格的SKU └ outer_id String 可选 2015_01_05_D_123 Sku的商家外部id，用于指定被修改价格的SKU └ price String 可选 200.07 属于这个sku的商品的价格取值范围:0-100000000;精确到2位小数;单位:元。如:200.07，表示:200元7分。
options	UpdateItemPriceOption	可选			商品价格更新时候的可选参数
└ ignore_fake_credit Boolean 可选 true 是否忽略涉嫌炒信警告信息 └ currency_type String 可选 CNY 目标币种，非必填，仅支持天猫国际官网同购商家将外币价格修改成人民币价格时使用

名称	类型	示例值	描述
price_update_result	String	1234556	价格更新结果

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallItemPriceUpdateRequest req = new TmallItemPriceUpdateRequest();
req.setItemId(123456789L);
req.setItemPrice("99.99");
List<TmallItemPriceUpdateRequest.UpdateSkuPrice> list2 = new ArrayList<TmallItemPriceUpdateRequest.UpdateSkuPrice>();
TmallItemPriceUpdateRequest.UpdateSkuPrice obj3 = new TmallItemPriceUpdateRequest.UpdateSkuPrice();
list2.add(obj3);
obj3.setSkuId(123456L);
obj3.setProperties("1627207:28326;1630696:3266779");
obj3.setOuterId("2015_01_05_D_123");
obj3.setPrice("200.07");
req.setSkuPrices(list2);
TmallItemPriceUpdateRequest.UpdateItemPriceOption obj4 = new TmallItemPriceUpdateRequest.UpdateItemPriceOption();
obj4.setIgnoreFakeCredit(true);
obj4.setCurrencyType("CNY");
req.setOptions(obj4);
TmallItemPriceUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<tmall_item_price_update_response>
    <price_update_result>1234556</price_update_result>
</tmall_item_price_update_response>

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>

错误码	错误描述	解决方案
isv.item-service-error:FORBIDDEN_QUANTITY_ZERO_ERROR	上架的数量必须大于0	上架的数量必须大于0
isv.item-service-error:CATEGORY_LIMIT_SPU_BOOK_NORMAL	请在ISBN输入框内输入13位或10位ISBN数字，不包括“-”符号，如确认正确，则可能是该ISBN还未授权发布	按要求正确输入，并确认ISBN已经获得授权发布（是否以及获得授权，可咨询客服）
isv.item-service-error:IC_LIMIT_FOR_DPC	供应商限制该分销商品修改，如有疑问，请到分销平台，“我的分销商品”页面同步产品信息。	到分销平台，“我的分销商品”页面同步产品信息。
isv.item-service-error:IC_CHECKSTEP_ITME_SKU_PRICE_UNMATCH	宝贝价格必须介于销售属性组合价格区间之内	修改时，保证商品价格在sku价格区间内。假设商品有2个sku，sku价格分别是13 和 15 ，那要求商品价格必须在13-15之间
isv.item-service-error:IC_CHECKSTEP_INPUT_PROPERTY_ERROR	输入属性错误	检查调用api时入参
isv.invalid-parameter:item_id	没有找到商品，请确认商品是否存在或者已删除	确认商品是否存在或者已删除
isv.item-service-error:IC_CHECKSTEP_ALREADY_EXISTS_SAME_SPU	您已发布过同类宝贝，不允许重复发布	商品已发布，不允许重复发布
isp.tmall_item_service_error	服务不可用	稍后重试
isv.item-service-error:IC_QS_NOT_VALID	产品许可证无效或已过期	卖家中心编辑商品，更换或填写正确有效的许可证号
isv.item-service-error:IC_CHECKSTEP_ITME_NOT_IN_SKU_PRICE	商品更新价格不在SKU价格范围内	请检查价格参数，商品价格需要是SKU中的价格
isv.item-service-error:IC_PERMISSION_TOP_EDIT_LIMIT	此商品暂不支持top编辑，请使用天猫商品管理后台进行编辑	此商品暂不支持top编辑，请使用天猫商品管理后台进行编辑
isp.remote-service-error:productService	服务异常，请稍后重试	服务异常，请稍后重试
isp.remote-service-error:productService:QUERY_USER_INFO_ERROR	服务异常，请稍后重试	服务异常，请稍后重试
isv.item-service-error:ERR_RULE_TITLE_SECURITY_CHAR_LIMITATION	标题/卖点/短标题禁止使用半角符号“ <> ” 符号，但可以使用全角符号“ ＜＞”	标题/卖点/短标题禁止使用半角符号“ <> ” 符号，但可以使用全角符号“ ＜＞”
isv.item-service-error:ITEM_NOT_FOUND	商品信息不存在	商品信息不存在，不要重复提交
isv.item-service-error:IC_OPTIMISTIC_LOCKING_CONFLICT	商品更新频率太快，请降低更新频率	商品更新频率太快，请降低更新频率
isp.system-service-error	服务异常，请稍后重试	服务异常，请稍后重试
isv.item-service-error:ERR_RULE_ITEM_PUB_QUANTITY_LIMIT_TMALL_CAR	店铺在该一级类目下出售中商品总数已超过此类目商品数量限额	您的店铺在该一级类目下出售中商品总数已超过此类目商品数量限额，请您及时调整您的商品数量，再上传商品，详见：https://service.tmall.com/support/tmall/knowledge-13115881.htm
isv.item-service-error:IC_TAOQIANGGOU_PRICE_MOIDIFY_LIMIT	该商品参加淘抢购活动，不允许修改原价	该商品参加淘抢购活动，不允许修改原价
isv.item-service-error:RULE_TMALL_HUAZHUANGPIN118338_TOP_NOT_PERMIT_TO_EDIT	此商品暂不支持top编辑，请使用天猫商品管理后台进行编辑	此商品已通过化妆品校验，暂不支持top编辑，请使用天猫商品管理后台进行编辑
isv.item-service-error:IC_CHECKSTEP_NO_PERMISSION	您未通过认证或已被处罚，请核实	您未通过认证或已被处罚，请核实
isp.remote-service-error	服务异常，请稍后重试	服务异常，请稍后重试
isp.service-unavailable	服务异常，请稍后重试	服务异常，请稍后重试
isp.item-get-service-unavailable	服务异常，请稍后重试	服务异常，请稍后重试

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

淘宝商品API

tmall.item.price.update (天猫商品/SKU价格更新接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ