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

tmall.item.quantity.update (天猫商品/SKU库存更新接口)

天猫商品/SKU库存更新接口;支持商品库存更新;支持同一商品下的SKU批量更新。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 123456789 商品id
item_quantity Number 可选 12 商品库存数;增量编辑方式支持正数、负数。(无SKU商品使用这个字段)
sku_quantities UpdateSkuQuantity [] 可选
  • 最大列表长度:20
  • 更新SKU库存时候的SKU库存对象;如果没有SKU或者不更新SKU库存,可以不填;查找SKU目前支持ID,属性串和商家编码三种模式,建议选用一种最合适的,切勿滥用,一次调用中如果混合使用,更新结果不可预期!
    • └ outer_id
    • String
    • 可选
    • 2015_01_05_D_123
    • Sku的商家外部id,用于指定被修改库存的SKU
    • └ properties
    • String
    • 可选
    • 1627207:28326;1630696:3266779
    • Sku属性串。格式:pid:vid;pid:vid,如: 1627207:3232483;1630696:3284570,表示机身颜色:军绿色;手机套餐:一电一充,用于指定被修改库存的SKU
    • └ quantity
    • Number
    • 可选
    • 12
    • SKU属于这个sku的商品的库存;增量编辑方式支持正数、负数
    • └ sku_id
    • Number
    • 可选
    • 12123123
    • SkuID,用于指定被修改库存的
    options UpdateItemQuantityOption 可选 商品库存更新时候的可选参数
    • └ outer_biz_key
    • String
    • 可选
    • 2df528b43c68a0fe7a5e82
    • 增量更新时幂等外部编码,只能包含十六进制字符(0-9,a-f,A-F)
    • └ type
    • Number
    • 可选
    • 1
    • 库存更新方式: 1是全量更新 2是增量更新;默认是1。

    响应参数

    名称 类型 示例值 描述
    quantity_update_result String 12313123123 库存更新结果,商品id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallItemQuantityUpdateRequest req = new TmallItemQuantityUpdateRequest();
    req.setItemId(123456789L);
    req.setItemQuantity(12L);
    List<TmallItemQuantityUpdateRequest.UpdateSkuQuantity> list2 = new ArrayList<TmallItemQuantityUpdateRequest.UpdateSkuQuantity>();
    TmallItemQuantityUpdateRequest.UpdateSkuQuantity obj3 = new TmallItemQuantityUpdateRequest.UpdateSkuQuantity();
    list2.add(obj3);
    obj3.setOuterId("2015_01_05_D_123");
    obj3.setProperties("1627207:28326;1630696:3266779");
    obj3.setQuantity(12L);
    obj3.setSkuId(12123123L);
    req.setSkuQuantities(list2);
    TmallItemQuantityUpdateRequest.UpdateItemQuantityOption obj4 = new TmallItemQuantityUpdateRequest.UpdateItemQuantityOption();
    obj4.setOuterBizKey("2df528b43c68a0fe7a5e82");
    obj4.setType(1L);
    req.setOptions(obj4);
    TmallItemQuantityUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_item_quantity_update_response>
        <quantity_update_result>12313123123</quantity_update_result>
    </tmall_item_quantity_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.invalid-parameter:item_id 商品id不存在 请确认商品是否存在或者已删除,传人正确的商品id
    isp.tmallitem-service-error:empty 系统异常 请稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部