taobao.item.quantity.update.tmall (taobao.item.quantity.update.tmall)

提供按照全量或增量形式修改宝贝/SKU库存的功能

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
num_iid Number 必须 3838293428 商品数字ID,必填参数
sku_id Number 可选 1230005 要操作的SKU的数字ID,可选。如果不填默认修改宝贝的库存,如果填上则修改该SKU的库存
outer_id String 可选 1234 SKU的商家编码,可选参数。如果不填则默认修改宝贝的库存,如果填了则按照商家编码搜索出对应的SKU并修改库存。当sku_id和本字段都填写时以sku_id为准搜索对应SKU
quantity Number 必须 0 库存修改值,必选。当全量更新库存时,quantity必须为大于等于0的正整数;当增量更新库存时,quantity为整数,可小于等于0。若增量更新时传入的库存为负数,则负数与实际库存之和不能小于0。比如当前实际库存为1,传入增量更新quantity=-1,库存改为0
type Number 可选 1
  • 默认值:1
  • 库存更新方式,可选。1为全量更新,2为增量更新。如果不填,默认为全量更新

    响应参数

    名称 类型 示例值 描述
    item Item iid、numIid、num和modified,skus中每个sku的skuId、quantity和modified
    • └ iid
    • String
    • 569a64fce2e98bce187bcbbb4a4d262a
    • 商品id(注意:iid近期即将废弃,请用num_iid参数)
    • └ num_iid
    • Number
    • 1489161932
    • 商品数字id
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 商品修改时间(格式:yyyy-MM-dd HH:mm:ss)
    • └ num
    • Number
    • 8888
    • 商品数量
    • skus
    • Sku []
    • Sku列表。fields中只设置sku可以返回Sku结构体中所有字段,如果设置为sku.sku_id、sku.properties、sku.quantity等形式就只会返回相应的字段
    • └ sku_id
    • Number
    • 123
    • sku的id
    • └ modified
    • String
    • 2009-11-04 15:24:43
    • sku最后修改日期 时间格式:yyyy-MM-dd HH:mm:ss
    • └ quantity
    • Number
    • 3
    • 属于这个sku的商品的数量,

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ItemQuantityUpdateTmallRequest req = new ItemQuantityUpdateTmallRequest();
    req.setNumIid(3838293428L);
    req.setSkuId(1230005L);
    req.setOuterId("1234");
    req.setQuantity(0L);
    req.setType(1L);
    ItemQuantityUpdateTmallResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <item_quantity_update_tmall_response>
        <item>
            <iid>569a64fce2e98bce187bcbbb4a4d262a</iid>
            <num_iid>1489161932</num_iid>
            <modified>2000-01-01 00:00:00</modified>
            <num>8888</num>
            <skus>
                <sku>
                    <sku_id>123</sku_id>
                    <modified>2009-11-04 15:24:43</modified>
                    <quantity>3</quantity>
                </sku>
            </skus>
        </item>
    </item_quantity_update_tmall_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:type 更新方式有误 不传入参数,或传入数字类型的1或者2
    isv.invalid-parameter:quantity 库存数量不能为负数 改为大于等于0的整数
    isp.item-quantity-item-update-service-unavailable 更新商品库存服务不可用 通知开发人员
    isp.item-quantity-sku-update-service-unavailable 更新sku库存服务不可用 通知开发人员
    isp.item-get-service-unavailable 获取单个商品服务不可用 联系开发人员
    isv.missing-parameter:numIid 商品num_iid必须传入 传入参数
    isv.item-is-delete:invalid-numIid-or-iid 商品id对应的商品已经被删除 检查商品Id是否正确,或联系开发人员
    isv.item-not-exist:invalid-numIid-or-iid 商品id对应的商品不存在 检查商品Id是否正确,或联系开发人员
    isv.invalid-parameter:sku-properties 传入的sku的属性找不到对应的sku记录 检查skuId或者outerId是否正确,或联系开发人员
    isv.item-quantity-item-update-service-error 商品库存更新失败 不符合业务处理逻辑,请参考出错原因
    错误码:40,子错误码:null 缺少必要的传入参数 请根据返回的错误信息,将必传参数都填写好
    isv.error-inventory-invalid-item-quantity 宝贝数量 必须大于预扣库存,否则会导致拍卖下未付款的卖家,付款失败 重新编辑宝贝数量,大于预扣库存数量
    isv.error-inventory-invalid-sku-quantity 销售数量 必须大于预扣库存,否则会导致拍卖下未付款的卖家,付款失败 重新编辑sku 数量。大于预扣库存数量

    API工具

    如何获得此API

    FAQ

    返回
    顶部