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

taobao.qimen.inventoryreserve.create (库存预占接口)

ERP调用奇门的接口,查询发货库存预占用信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request InventoryReserveCreateRequest 可选
  • └ ownerCode
  • String
  • 必须
  • H1234
  • 货主编码
  • └ orderCode
  • String
  • 必须
  • E1234
  • ERP订单编码
  • └ orderSource
  • Number
  • 必须
  • 213
  • 订单来源(213 天猫、201 淘宝、214 京东、202 1688 阿里中文站、203 苏宁在线、204 亚马逊中国、205 当当、208 1号店、207 唯品会、209 国美在线、210 拍拍、206 易贝ebay、211 聚美优品、212 乐蜂 网、215 邮乐、216 凡客、217 优购、218 银泰、219 易讯、221 聚尚网、222 蘑菇街、223 POS门店、301 其他)
  • └ warehouseCode
  • String
  • 可选
  • W1234
  • 仓库编码
  • └ maxWarehouseNum
  • Number
  • 可选
  • 12
  • 最大仓库数(当一个仓库不满足库存时.是否允许占用多个仓库库存.如果允许.需要指定最大分仓数量.但不能拆分订单明细. 0:不限个数.只要满足发货.不限分占几个仓库 1:默认值.只能单仓发 >1:最大 占用数量)
  • receiverInfo
  • ReceiverInfo
  • 可选
  • 收件者信息
  • └ zipCode
  • String
  • 可选
  • 332132
  • 邮编
  • └ province
  • String
  • 必须
  • 浙江
  • 省份
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ area
  • String
  • 可选
  • 余杭
  • 区域
  • └ town
  • String
  • 可选
  • 横桥
  • 村镇
  • itemInventories
  • ItemInventory []
  • 可选
  • 交易订单信息
  • └ orderSourceCode
  • String
  • 必须
  • 12345
  • 订单交易编码
  • └ subSourceCode
  • String
  • 必须
  • sub1234
  • 子交易编码
  • └ itemId
  • String
  • 必须
  • item1234
  • 菜鸟商品ID
  • └ itemCode
  • String
  • 可选
  • CN1234
  • 菜鸟商品编码
  • └ quantity
  • Number
  • 必须
  • 12
  • 商品数量
  • └ extendProps
  • Map
  • 可选
  • 扩展属性

响应参数

名称 类型 示例值 描述
response InventoryReserveCreateResponse
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息
  • └ orderCode
  • String
  • ERP1234
  • ERP订单编码
  • └ isRetry
  • String
  • N
  • 是否需要重试(Y/N (默认为N)返回Y时建议系统自动重试)
  • itemInventories
  • ItemInventory []
  • └ orderSourceCode
  • String
  • D1234
  • 订单交易编码
  • └ subSourceCode
  • String
  • sub1234
  • 子交易编码
  • └ combItemId
  • String
  • com1234
  • 菜鸟组合货品ID
  • └ itemId
  • String
  • CN1234
  • 菜鸟商品ID
  • └ itemCode
  • String
  • cnb1234
  • 菜鸟商品编码
  • └ quantity
  • Number
  • 12
  • 商品数量
  • └ warehouseCode
  • String
  • W1234
  • 仓库编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
InventoryreserveCreateRequest req = new InventoryreserveCreateRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
req.setOwnerCode("H1234");
req.setOrderCode("E1234");
req.setOrderSource(213L);
req.setWarehouseCode("W1234");
req.setMaxWarehouseNum(12L);
ReceiverInfo obj1 = new ReceiverInfo();
obj1.setZipCode("332132");
obj1.setProvince("浙江");
obj1.setCity("杭州");
obj1.setArea("余杭");
obj1.setTown("横桥");
req.setReceiverInfo(obj1);
ItemInventory obj2 = new ItemInventory();
obj2.setOrderSourceCode("12345");
obj2.setSubSourceCode("sub1234");
obj2.setItemId("item1234");
obj2.setItemCode("CN1234");
obj2.setQuantity(12L);
req.setItemInventories(obj2);
InventoryreserveCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
    <orderCode>ERP1234</orderCode>
    <isRetry>N</isRetry>
    <itemInventories>
        <item_inventory>
            <orderSourceCode>D1234</orderSourceCode>
            <subSourceCode>sub1234</subSourceCode>
            <combItemId>com1234</combItemId>
            <itemId>CN1234</itemId>
            <itemCode>cnb1234</itemCode>
            <quantity>12</quantity>
            <warehouseCode>W1234</warehouseCode>
        </item_inventory>
    </itemInventories>
</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

返回
顶部