taobao.fenxiao.product.quantity.update (产品库存修改)

修改产品库存信息,支持全量修改以及增量修改两种方式

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_id Number 必须 27960060200 产品ID
type Number 可选 1 库存更新方式,可选。1为全量更新,2为增量更新。如果不填,默认为全量更新。当选择全量更新时,如果库存更新值传入的是负数,会出错并返回错误码;当选择增量更新时,如果库存更新值为负数且绝对值大于当前库存,则sku库存会设置为0
quantity String 必须 10 库存修改值。产品有sku时,与sku属性顺序对应,用,分隔。产品无sku时,只写库存值。 当全量更新库存时,quantity必须为大于等于0的正整数;当增量更新库存时,quantity为整数,可小于等于0。若增量更新时传入的库存为负数,则负数与实际库存之和不能小于0。比如当前实际库存为1,传入增量更新quantity=-1,库存改为0
properties String 可选 10000:10000 sku属性值,产品有sku时填写,多个sku用,分隔。为空时默认该产品无sku,则只修改产品的库存。请参照taobao.fenxiao.products.get接口返回的properties设置入参

响应参数

名称 类型 示例值 描述
result Boolean true 操作结果
created Date 2014-01-01 00:00:00 操作时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoProductQuantityUpdateRequest req = new FenxiaoProductQuantityUpdateRequest();
req.setProductId(27960060200L);
req.setType(1L);
req.setQuantity("10");
req.setProperties("10000:10000");
FenxiaoProductQuantityUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<fenxiao_product_quantity_update_response>
    <result>true</result>
    <created>2014-01-01 00:00:00</created>
</fenxiao_product_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:authz 代销产品必须授权 不更新产品,返回错误

API工具

如何获得此API

FAQ

返回
顶部