淘宝开放平台

登录
文档中心 > API类目 > 淘宝商品API

淘宝商品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
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    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示例
    1
    2
    3
    <tmall_item_quantity_update_response>
        <quantity_update_result>12313123123</quantity_update_result>
    </tmall_item_quantity_update_response>

    异常示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    <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测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部