提供按照全量或增量形式修改宝贝/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为全量更新，2为增量更新。如果不填，默认为全量更新 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| item | Item | iid、numIid、num和modified，skus中每个sku的skuId、quantity和modified | |
|
|||
1 2 3 4 5 6 7 8 9 | 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()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <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> |
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: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 数量。大于预扣库存数量 |