文档中心 > API类目 > 奇门仓储API

taobao.qimen.storeinventory.itemupdate (库存增量更新接口)

ERP调用该接口,增量更新门店或电商仓库存,该接口一次可以同时增量更新多个门店的多个商品的非确定性库存。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
operation_time String 必须 2016-03-01 10:10:10 操作时间
stores Store [] 可选
  • 最大列表长度:20
  • 门店列表
    • store_inventories
    • StoreInventory []
    • 可选
    • 门店库存列表
    • └ bill_num
    • String
    • 必须
    • 1461150596019
    • 单据流水号,用于幂等操作
    • └ bill_type
    • String
    • 必须
    • BALANCE
    • 单据类型
    • └ item_id
    • Number
    • 必须
    • 2100764276403
    • 淘宝前端商品id
    • └ outer_id
    • String
    • 必须
    • 8235210076427640306
    • ISV系统中商品编码
    • └ sku_id
    • Number
    • 可选
    • 31154330882
    • 商品的SKU编码
    • └ inventory_type
    • String
    • 必须
    • CERTAINTY
    • 库存类型
    • └ quantity
    • Number
    • 必须
    • 12
    • 对应类型的库存数量(正数
    • └ final_quantity
    • Number
    • 可选
    • 10
    • 调整后库存数量
    • └ warehouse_type
    • String
    • 必须
    • WAREHOUSE
    • 库存来源的类型
    • └ warehouse_id
    • String
    • 必须
    • toptest_015_warehouse01
    • 门店ID(商户中心)或 电商仓ID

    响应参数

    名称 类型 示例值 描述
    flag String failure 响应标示
    qimen_code String 200 响应标签
    message String 响应信息 响应信息
    error_descriptions Error [] 错误信息列表 错误信息列表
    • └ descrpition
    • String
    • IDEMPOTENT
    • 错误描述
    • └ failed_bill_num
    • String
    • 1461150596019
    • 处理失败的流水号

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    QimenStoreinventoryItemupdateRequest req = new QimenStoreinventoryItemupdateRequest();
    req.setOperationTime("2016-03-01 10:10:10");
    List<QimenStoreinventoryItemupdateRequest.Store> list2 = new ArrayList<QimenStoreinventoryItemupdateRequest.Store>();
    QimenStoreinventoryItemupdateRequest.Store obj3 = new QimenStoreinventoryItemupdateRequest.Store();
    list2.add(obj3);
    List<QimenStoreinventoryItemupdateRequest.StoreInventory> list6 = new ArrayList<QimenStoreinventoryItemupdateRequest.StoreInventory>();
    QimenStoreinventoryItemupdateRequest.StoreInventory obj7 = new QimenStoreinventoryItemupdateRequest.StoreInventory();
    list6.add(obj7);
    obj7.setBillNum("1461150596019");
    obj7.setBillType("BALANCE");
    obj7.setItemId(2100764276403L);
    obj7.setOuterId("8235210076427640306");
    obj7.setSkuId(31154330882L);
    obj7.setInventoryType("CERTAINTY");
    obj7.setQuantity(12L);
    obj7.setFinalQuantity(10L);
    list4.setStoreInventories(list6);
    obj3.setWarehouseType("WAREHOUSE");
    obj3.setWarehouseId("toptest_015_warehouse01");
    req.setStores(list2);
    QimenStoreinventoryItemupdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <qimen_storeinventory_itemupdate_response>
        <flag>failure</flag>
        <qimen_code>200</qimen_code>
        <message>响应信息</message>
        <error_descriptions>
            <error>
                <descrpition>IDEMPOTENT</descrpition>
                <failed_bill_num>1461150596019</failed_bill_num>
            </error>
        </error_descriptions>
    </qimen_storeinventory_itemupdate_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

    返回
    顶部