taobao.inventory.adjust.external (非交易库存调整单)

商家非交易调整库存,调拨出库、盘点等时调用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_unique_code String 必须 1 商家外部定单号
occupy_operate_code String 可选 1 库存占用返回的操作码.operate_type 为OUTBOUND时,如果是确认事先进行过的库存占用,需要传入当时返回的操作码,并且明细必须与申请时保持一致
operate_type String 可选 test test
biz_type String 可选 BALANCE 外部订单类型, BALANCE:盘点、NON_TAOBAO_TRADE:非淘宝交易、ALLOCATE:调拨、OTHERS:其他
operate_time String 可选 2000-01-01 00:00:00 业务操作时间
store_code String 必须 ABC0001 商家仓库编码
items String 必须 [{"scItemId":"12345","scItemCode":"GLY0001","inventoryType":"1",”direction”:1"quantity":"111"}] 商品初始库存信息: [{"scItemId":"商品后端ID,如果有传scItemCode,参数可以为0","scItemCode":"商品商家编码","inventoryType":"库存类型 1:正常,”direction”: 1: 盘盈 -1: 盘亏,参数可选,"quantity":"数量(正数)"}]
reduce_type String 可选 test test

响应参数

名称 类型 示例值 描述
operate_code String INBOUND 操作返回码
tip_infos TipInfo [] 提示信息 提示信息
  • └ sc_item_id
  • String
  • demo
  • 商品id
  • └ info
  • String
  • demo
  • 返回信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
InventoryAdjustExternalRequest req = new InventoryAdjustExternalRequest();
req.setBizUniqueCode("1");
req.setOccupyOperateCode("1");
req.setOperateType("test");
req.setBizType("BALANCE");
req.setOperateTime("2000-01-01 00:00:00");
req.setStoreCode("ABC0001");
req.setItems("[{\"scItemId\":\"12345\",\"scItemCode\":\"GLY0001\",\"inventoryType\":\"1\",”direction”:1\"quantity\":\"111\"}]");
req.setReduceType("test");
InventoryAdjustExternalResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<inventory_adjust_external_response>
    <operate_code>INBOUND</operate_code>
    <tip_infos>
        <tip_info>
            <sc_item_id>demo</sc_item_id>
            <info>demo</info>
        </tip_info>
    </tip_infos>
</inventory_adjust_external_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.inventory-error:40001 不能使用该服务 请先建立该服务。
isv.inventory-error:30006 明细为空 请传入明细信息。
isv.inventory-error:00001 JSON解析异常 请检查商品初始库存信息的JSON格式是否正确。
isv.inventory-error:20002 后端商品不存在 请传入有效的后端商品。
isv.inventory-error:30007 传入的库存操作类别不能识别,不支持此操作方式 请传入有效的库存操作类别。
isv.inventory-error:30013 该商品不允许操作 请检查商用品状态。
isv.inventory-error:00006 数据库访问错误 请稍候再试。
isv.inventory-error:30014 无可用库存记录 请初始化库存
isv.inventory-error:30002 商品库存不足 请增加商品库存
isv.inventory-error:00005 必填参数为空 请输入必选参数
isv.inventory-error:10001 错误的外部订单类型 请选择正确的订单类型
isv.inventory-error:10002 错误的占用类型 请选择正确的占用类型
isv.inventory-error:00004 参数异常 请检查参数
isv.inventory-error:30001 错误的商品库存类型 请检查商品库存类型
isv.inventory-error:00008 获取库存账户规则错误 请检查是否支持操作类型和reduceType的组合
isv.inventory-error:00000 未知异常 请稍后重试
isv.inventory-error:30011 无足够商品 请增加商品
isv.inventory-error:30015 盘点操作未指明是盘亏还是盘盈 指明盘亏或者盘盈

API工具

如何获得此API

FAQ

返回
顶部