taobao.inventory.merchant.adjust (货品库存商家端调整)

货品库存商家端调整 ,入库,出库,盘点

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
inventory_check InventoryCheckDto 必须 调整库存对象
  • └ check_mode
  • Number
  • 必须
  • 2
  • 1:全量更新 2: 出入库盘盈盘亏
  • └ inv_store_type
  • Number
  • 必须
  • 2
  • 2: 仓库类型 6:门店类型
  • detail_list
  • InventoryCheckDetailDto []
  • 必须
  • 调整明细
  • └ inv_biz_code
  • String
  • 可选
  • ONLINE_INVENTORY
  • 如果是门店类型,则为必填。 ONLINE_INVENTORY 线上可售库存, SHARE_INVENTORY 线下可售库存
  • └ quantity
  • Number
  • 必须
  • 1
  • 调整数量,正数盘盈,负数盘亏
  • └ sc_item_id
  • Number
  • 必须
  • 123
  • 若为货品仓库存,则此处是货品ID 若为商品直接设置仓库存,则此处是商品ID, 若商品带SKU,还需要补充skuId
  • └ sub_order_id
  • String
  • 必须
  • checkin_sub_20170101_123
  • 每个货品的调整子单据号,作为业务调整依据,处理时会根据此单据号作幂
  • └ sku_id
  • Number
  • 可选
  • 123
  • 调整商品对应的SKUID,如果商品为货品,则为0
  • └ store_code
  • String
  • 必须
  • chana_store
  • 仓库code或者门店id
  • └ order_id
  • String
  • 必须
  • checkin_main_20170101_123
  • 调整单据号

响应参数

名称 类型 示例值 描述
result SingleResult result result
  • └ error_message
  • String
  • errorMessage
  • 错误信息
  • adjust_results
  • InventoryCheckResultDto []
  • data
  • data
  • └ error_msg
  • String
  • errorMsg
  • 错误信息
  • └ error_code
  • String
  • errorCode
  • 错误码
  • └ success
  • Boolean
  • false
  • 每个子调整单据是否成功
  • └ sub_order_id
  • String
  • checkin_sub_20170101_123
  • 每个货品的调整子单据号,作为业务调整依据,处理时会幂等
  • └ error_code
  • String
  • illeagal param
  • 错误码
  • └ success
  • Boolean
  • false
  • 如果是失败,可能是部分失败。如果是成功,则全部成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
InventoryMerchantAdjustRequest req = new InventoryMerchantAdjustRequest();
InventoryMerchantAdjustRequest.InventoryCheckDto obj1 = new InventoryMerchantAdjustRequest.InventoryCheckDto();
obj1.setCheckMode(2L);
obj1.setInvStoreType(2L);
List<InventoryMerchantAdjustRequest.InventoryCheckDetailDto> list3 = new ArrayList<InventoryMerchantAdjustRequest.InventoryCheckDetailDto>();
InventoryMerchantAdjustRequest.InventoryCheckDetailDto obj4 = new InventoryMerchantAdjustRequest.InventoryCheckDetailDto();
list3.add(obj4);
obj4.setInvBizCode("ONLINE_INVENTORY");
obj4.setQuantity(1L);
obj4.setScItemId(123L);
obj4.setSubOrderId("checkin_sub_20170101_123");
obj4.setSkuId(123L);
obj1.setDetailList(list3);
obj1.setStoreCode("chana_store");
obj1.setOrderId("checkin_main_20170101_123");
req.setInventoryCheck(obj1);
InventoryMerchantAdjustResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<inventory_merchant_adjust_response>
    <result>
        <error_message>errorMessage</error_message>
        <adjust_results>
            <inventory_check_result_dto>
                <error_msg>errorMsg</error_msg>
                <error_code>errorCode</error_code>
                <success>false</success>
                <sub_order_id>checkin_sub_20170101_123</sub_order_id>
            </inventory_check_result_dto>
        </adjust_results>
        <error_code>illeagal param</error_code>
        <success>false</success>
    </result>
</inventory_merchant_adjust_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部