文档中心 > API类目 > 商品编辑

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

天猫商品/SKU价格更新接口,支持商品、SKU价格同时更新,支持同一商品下的SKU批量更新。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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工具

    如何获得此API

    FAQ

    返回
    顶部