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

taobao.qimen.inventory.report (库存盘点通知接口)

WMS调用奇门的接口,将库存盘点情况回传ERP

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request InventoryReportRequest 可选
  • └ totalPage
  • Number
  • 必须
  • 12
  • 总页数
  • └ currentPage
  • Number
  • 必须
  • 1
  • 当前页(从1开始)
  • └ pageSize
  • Number
  • 必须
  • 12
  • 每页记录的条数
  • └ warehouseCode
  • String
  • 必须
  • W1234
  • 仓库编码
  • └ checkOrderCode
  • String
  • 必须
  • P1234
  • 盘点单编码
  • └ checkOrderId
  • String
  • 可选
  • PS1234
  • 仓储系统的盘点单编码
  • └ ownerCode
  • String
  • 必须
  • H1234
  • 货主编码
  • └ checkTime
  • String
  • 可选
  • 2016-09-09 12:00:00
  • 盘点时间(YYYY-MM-DD HH:MM:SS)
  • └ outBizCode
  • String
  • 必须
  • OZ1234
  • 外部业务编码(消息ID;用于去重;ISV对于同一请求;分配一个唯一性的编码。用来保证因为网络等原因导致重复传输;请求不 会被重复处理)
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • items
  • Item []
  • 可选
  • 商品库存信息列表
  • └ itemCode
  • String
  • 必须
  • I1234
  • 商品编码
  • └ itemId
  • String
  • 可选
  • ID1234
  • 仓储系统商品ID
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS= 箱损;ZT=在途库存;默认为ZP)
  • └ quantity
  • Number
  • 必须
  • 12
  • 盘盈盘亏商品变化量(盘盈为正数;盘亏为负数)
  • └ batchCode
  • String
  • 可选
  • P1234
  • 批次编码
  • └ productDate
  • String
  • 可选
  • 2016-09-09
  • 商品生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2016-09-09
  • 商品过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • 可选
  • P1234
  • 生产批号
  • └ snCode
  • String
  • 可选
  • X1234
  • 商品序列号
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ totalQty
  • Number
  • 可选
  • 100
  • 库存商品总量
  • └ extendProps
  • Map
  • 可选
  • 商品库存信息扩展属性
  • └ extendProps
  • Map
  • 可选
  • 扩展属性
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ adjustType
  • String
  • 必须
  • CHECK
  • 变动类型:CHECK=盘点 ADJUST=调整

响应参数

名称 类型 示例值 描述
response Response
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
InventoryReportRequest req = new InventoryReportRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
req.setTotalPage(12L);
req.setCurrentPage(1L);
req.setPageSize(12L);
req.setWarehouseCode("W1234");
req.setCheckOrderCode("P1234");
req.setCheckOrderId("PS1234");
req.setOwnerCode("H1234");
req.setCheckTime("2016-09-09 12:00:00");
req.setOutBizCode("OZ1234");
req.setRemark("备注信息");
Item obj1 = new Item();
obj1.setItemCode("I1234");
obj1.setItemId("ID1234");
obj1.setInventoryType("ZP");
obj1.setQuantity(12L);
obj1.setBatchCode("P1234");
obj1.setProductDate("2016-09-09");
obj1.setExpireDate("2016-09-09");
obj1.setProduceCode("P1234");
obj1.setSnCode("X1234");
obj1.setRemark("备注信息");
obj1.setWarehouseCode("warehouseCode");
obj1.setOwnerCode("ownerCode");
obj1.setTotalQty(100L);
req.setItems(obj1);
req.setOrderType("orderType");
req.setRemark("备注");
req.setAdjustType("CHECK");
InventoryReportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
</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

返回
顶部