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

taobao.qimen.inventory.synchronize (库存状态同步接口)

ERP通过该接口同步指定商品的库存信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request Request 可选
  • └ ownerCode
  • String
  • 可选
  • 货主编码,货主编码,string(50),,
  • 货主编码,货主编码,string(50),,
  • └ warehouseCode
  • String
  • 可选
  • 仓库编码,仓库编码,string(50),,
  • 仓库编码,仓库编码,string(50),,
  • └ adjustOrderCode
  • String
  • 可选
  • 调整单编码,调整单编码,string(50),,
  • 调整单编码,调整单编码,string(50),,
  • └ adjustTime
  • String
  • 可选
  • 订单创建时间,订单创建时间,string(50),,
  • 订单创建时间,订单创建时间,string(50),,
  • └ adjustType
  • String
  • 可选
  • 库存调整类型,库存调整类型,string(50),,
  • 库存调整类型,库存调整类型,string(50),,
  • relatedOrders
  • RelatedOrders
  • 可选
  • 关联订单
  • └ orderType
  • String
  • 可选
  • 关联的订单类型,关联的订单类型,string(50),,
  • 关联的订单类型,关联的订单类型,string(50),,
  • └ orderCode
  • String
  • 可选
  • 关联的订单编号,关联的订单编号,string(50),,
  • 关联的订单编号,关联的订单编号,string(50),,
  • └ remark
  • String
  • 可选
  • 备注,备注,string(50),,
  • 备注,备注,string(50),,
  • items
  • Items
  • 可选
  • 商品列表
  • item
  • Item
  • 可选
  • 商品
  • └ itemCode
  • String
  • 可选
  • 商品编码,,string(50),,
  • 商品编码,,string(50),,
  • └ itemId
  • String
  • 可选
  • 仓储系统商品ID,,string(50),,
  • 仓储系统商品ID,,string(50),,
  • └ inventoryType
  • String
  • 可选
  • 库存类型,,string(50),,
  • 库存类型,,string(50),,
  • └ planQty
  • String
  • 可选
  • 调整数量,,string(50),,
  • 调整数量,,string(50),,
  • └ batchCode
  • String
  • 可选
  • 批次编码,,string(50),,
  • 批次编码,,string(50),,
  • └ productDate
  • String
  • 可选
  • 商品生产日期,,string(50),,
  • 商品生产日期,,string(50),,
  • └ expireDate
  • String
  • 可选
  • 商品过期日期,,string(50),,
  • 商品过期日期,,string(50),,
  • └ produceCode
  • String
  • 可选
  • 生产批号,,string(50),,
  • 生产批号,,string(50),,
  • └ snCode
  • String
  • 可选
  • 商品序列号,,string(50),,
  • 商品序列号,,string(50),,
  • └ remark
  • String
  • 可选
  • 备注,,string(50),,
  • 备注,,string(50),,

响应参数

名称 类型 示例值 描述
response Response
  • └ flag
  • String
  • 响应结果,success|failure,string (10),必填
  • 响应结果,success|failure,string (10),必填
  • └ code
  • String
  • 响应码,,string (50),
  • 响应码,,string (50),
  • └ message
  • String
  • 响应信息,,string (100),
  • 响应信息,,string (100),

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
InventorySynchronizeRequest req = new InventorySynchronizeRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
req.setOwnerCode("货主编码,货主编码,string(50),,");
req.setWarehouseCode("仓库编码,仓库编码,string(50),,");
req.setAdjustOrderCode("调整单编码,调整单编码,string(50),,");
req.setAdjustTime("订单创建时间,订单创建时间,string(50),,");
req.setAdjustType("库存调整类型,库存调整类型,string(50),,");
RelatedOrders obj1 = new RelatedOrders();
obj1.setOrderType("关联的订单类型,关联的订单类型,string(50),,");
obj1.setOrderCode("关联的订单编号,关联的订单编号,string(50),,");
req.setRelatedOrders(obj1);
req.setRemark("备注,备注,string(50),,");
Items obj2 = new Items();
Item obj3 = new Item();
obj3.setItemCode("商品编码,,string(50),,");
obj3.setItemId("仓储系统商品ID,,string(50),,");
obj3.setInventoryType("库存类型,,string(50),,");
obj3.setPlanQty("调整数量,,string(50),,");
obj3.setBatchCode("批次编码,,string(50),,");
obj3.setProductDate("商品生产日期,,string(50),,");
obj3.setExpireDate("商品过期日期,,string(50),,");
obj3.setProduceCode("生产批号,,string(50),,");
obj3.setSnCode("商品序列号,,string(50),,");
obj3.setRemark("备注,,string(50),,");
obj2.setItem(obj3);
req.setItems(obj2);
InventorySynchronizeResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<response>
    <flag>响应结果,success|failure,string (10),必填</flag>
    <code>响应码,,string (50),</code>
    <message>响应信息,,string (100),</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

返回
顶部