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

taobao.qimen.stockchange.report (库存异动通知接口)

taobao.qimen.stockchange.report

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request StockChangeReportRequest 可选
  • items
  • Item []
  • 可选
  • item
  • └ ownerCode
  • String
  • 必须
  • H1234
  • 货主编码
  • └ warehouseCode
  • String
  • 必须
  • CH1234
  • 仓库编码
  • └ orderCode
  • String
  • 必须
  • OR1234
  • 引起异动的单据编码
  • └ orderType
  • String
  • 可选
  • JYCK
  • 单据类型(JYCK=一般交易出库单;HHCK=换货出库;BFCK=补发出库;PTCK=普通出库单;DBCK=调拨出库;B2BRK=B2B入 库;B2BCK=B2B出库;QTCK=其他出库;SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK= 调拨入库;QTRK= 其他入 库;XTRK= 销退入库;HHRK= 换货入库;CNJG= 仓内加工单)
  • └ outBizCode
  • String
  • 必须
  • OZ1234
  • 外部业务编码(消息ID;用于去重;用来保证因为网络等原因导致重复传输;请求不会被重复处理)
  • └ itemCode
  • String
  • 必须
  • I1234
  • 商品编码
  • └ itemId
  • String
  • 可选
  • CH1234
  • 仓储系统商品ID
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;ZT=在途库存)
  • └ quantity
  • Number
  • 必须
  • 12
  • 商品变化量(可为正为负)
  • └ batchCode
  • String
  • 可选
  • PC1234
  • 批次编码
  • └ productDate
  • String
  • 可选
  • 2017-09-09
  • 商品生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2017-09-09
  • 商品过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • 可选
  • P1234
  • 生产批号
  • └ changeTime
  • String
  • 可选
  • 2017-09-09 12:00:00
  • 异动时间(YYYY-MM-DD HH:MM:SS)
  • batchs
  • Batch []
  • 可选
  • batchs
  • └ batchCode
  • String
  • 可选
  • PC1234
  • 批次编号
  • └ productDate
  • String
  • 可选
  • 2017-09-09
  • 生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2017-09-09
  • 过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • 可选
  • PD1234
  • 生产批号
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损 XS= 箱损;ZT=在途库存)
  • └ quantity
  • Number
  • 可选
  • 12
  • 异动数量(要求batchs节点下所有的异动数量之和等于orderline中的异动数量)
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ isLocked
  • String
  • 可选
  • Y
  • isLocked
  • snList
  • SnList []
  • 可选
  • 扩展属性
  • └ sn
  • String
  • 可选
  • A123
  • sn编码支持多sn
  • └ extendProps
  • Map
  • 可选
  • 扩展属性

响应参数

名称 类型 示例值 描述
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);
StockchangeReportRequest req = new StockchangeReportRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
req.setTotalPage("奇门仓储字段,说明,string(50),,");
req.setCurrentPage("奇门仓储字段,说明,string(50),,");
req.setPageSize("奇门仓储字段,说明,string(50),,");
req.setOwnerCode("奇门仓储字段,说明,string(50),,");
req.setWarehouseCode("奇门仓储字段,说明,string(50),,");
req.setOrderCode("奇门仓储字段,说明,string(50),,");
req.setOrderType("奇门仓储字段,说明,string(50),,");
req.setRemark("奇门仓储字段,说明,string(50),,");
Item obj1 = new Item();
obj1.setTitle("奇门仓储字段,说明,string(50),,");
obj1.setItemName("奇门仓储字段,说明,string(50),,");
obj1.setEnglishName("奇门仓储字段,说明,string(50),,");
obj1.setShortName("奇门仓储字段,说明,string(50),,");
obj1.setCategoryId("奇门仓储字段,说明,string(50),,");
obj1.setCategoryName("奇门仓储字段,说明,string(50),,");
obj1.setSkuProperty("奇门仓储字段,说明,string(50),,");
obj1.setItemType("奇门仓储字段,说明,string(50),,");
obj1.setTagPrice("奇门仓储字段,说明,string(50),,");
obj1.setRetailPrice("奇门仓储字段,说明,string(50),,");
obj1.setCostPrice("奇门仓储字段,说明,string(50),,");
obj1.setPurchasePrice("奇门仓储字段,说明,string(50),,");
obj1.setSupplierCode("奇门仓储字段,说明,string(50),,");
obj1.setSupplierName("奇门仓储字段,说明,string(50),,");
obj1.setSeasonCode("奇门仓储字段,说明,string(50),,");
obj1.setSeasonName("奇门仓储字段,说明,string(50),,");
obj1.setBrandCode("奇门仓储字段,说明,string(50),,");
obj1.setBrandName("奇门仓储字段,说明,string(50),,");
obj1.setSn("奇门仓储字段,说明,string(50),,");
obj1.setIsSNMgmt("奇门仓储字段,说明,string(50),,");
obj1.setBarCode("奇门仓储字段,说明,string(50),,");
obj1.setColor("奇门仓储字段,说明,string(50),,");
obj1.setSize("奇门仓储字段,说明,string(50),,");
obj1.setLength("奇门仓储字段,说明,string(50),,");
obj1.setWidth("奇门仓储字段,说明,string(50),,");
obj1.setHeight("奇门仓储字段,说明,string(50),,");
obj1.setVolume("奇门仓储字段,说明,string(50),,");
obj1.setGrossWeight("奇门仓储字段,说明,string(50),,");
obj1.setNetWeight("奇门仓储字段,说明,string(50),,");
obj1.setTareWeight("奇门仓储字段,说明,string(50),,");
obj1.setSafetyStock("奇门仓储字段,说明,string(50),,");
obj1.setStockUnit("奇门仓储字段,说明,string(50),,");
obj1.setStockStatus("奇门仓储字段,说明,string(50),,");
obj1.setIsShelfLifeMgmt("奇门仓储字段,说明,string(50),,");
obj1.setShelfLife("奇门仓储字段,说明,string(50),,");
obj1.setRejectLifecycle("奇门仓储字段,说明,string(50),,");
obj1.setLockupLifecycle("奇门仓储字段,说明,string(50),,");
obj1.setAdventLifecycle("奇门仓储字段,说明,string(50),,");
obj1.setBatchRemark("奇门仓储字段,说明,string(50),,");
obj1.setIsBatchMgmt("奇门仓储字段,说明,string(50),,");
obj1.setPackCode("奇门仓储字段,说明,string(50),,");
obj1.setPcs("奇门仓储字段,说明,string(50),,");
obj1.setOriginAddress("奇门仓储字段,说明,string(50),,");
obj1.setApprovalNumber("奇门仓储字段,说明,string(50),,");
obj1.setIsFragile("奇门仓储字段,说明,string(50),,");
obj1.setIsHazardous("奇门仓储字段,说明,string(50),,");
obj1.setPricingCategory("奇门仓储字段,说明,string(50),,");
obj1.setIsSku("奇门仓储字段,说明,string(50),,");
obj1.setPackageMaterial("奇门仓储字段,说明,string(50),,");
obj1.setPrice("奇门仓储字段,说明,string(50),,");
obj1.setIsAreaSale("奇门仓储字段,说明,string(50),,");
obj1.setNormalQty("奇门仓储字段,说明,string(50),,");
obj1.setDefectiveQty("奇门仓储字段,说明,string(50),,");
obj1.setReceiveQty("奇门仓储字段,说明,string(50),,");
obj1.setExCode("奇门仓储字段,说明,string(50),,");
obj1.setDiscountPrice("奇门仓储字段,说明,string(50),,");
obj1.setPlanQty("奇门仓储字段,说明,string(50),,");
obj1.setSourceOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setSubSourceOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setOrderLineNo("奇门仓储字段,说明,string(50),,");
obj1.setActualQty("奇门仓储字段,说明,string(50),,");
obj1.setAmount("奇门仓储字段,说明,string(50),,");
obj1.setUnit("奇门仓储字段,说明,string(50),,");
obj1.setLockQuantity("奇门仓储字段,说明,string(50),,");
obj1.setProductCode("奇门仓储字段,说明,string(50),,");
obj1.setPaperQty("奇门仓储字段,说明,string(50),,");
obj1.setDiffQuantity("奇门仓储字段,说明,string(50),,");
obj1.setExtCode("奇门仓储字段,说明,string(50),,");
obj1.setLackQty("奇门仓储字段,说明,string(50),,");
obj1.setReason("奇门仓储字段,说明,string(50),,");
obj1.setSnCode("奇门仓储字段,说明,string(50),,");
obj1.setGoodsCode("奇门仓储字段,说明,string(50),,");
obj1.setStandardPrice("奇门仓储字段,说明,string(50),,");
obj1.setReferencePrice("奇门仓储字段,说明,string(50),,");
obj1.setDiscount("奇门仓储字段,说明,string(50),,");
obj1.setActualAmount("奇门仓储字段,说明,string(50),,");
PriceAdjustment obj2 = new PriceAdjustment();
obj2.setType("奇门仓储字段,说明,string(50),,");
obj2.setStandardPrice("奇门仓储字段,说明,string(50),,");
obj2.setDiscount("奇门仓储字段,说明,string(50),,");
obj2.setStartDate("奇门仓储字段,说明,string(50),,");
obj2.setEndDate("奇门仓储字段,说明,string(50),,");
obj1.setPriceAdjustment(obj2);
obj1.setLatestUpdateTime("奇门仓储字段,说明,string(50),,");
obj1.setTempRequirement("奇门仓储字段,说明,string(50),,");
obj1.setChannelCode("奇门仓储字段,说明,string(50),,");
obj1.setOriginCode("奇门仓储字段,说明,string(50),,");
obj1.setOwnerCode("H1234");
obj1.setWarehouseCode("CH1234");
obj1.setOrderCode("OR1234");
obj1.setOrderType("JYCK");
obj1.setOutBizCode("OZ1234");
obj1.setItemCode("I1234");
obj1.setItemId("CH1234");
obj1.setInventoryType("ZP");
obj1.setQuantity(12L);
obj1.setBatchCode("PC1234");
obj1.setProductDate("2017-09-09");
obj1.setExpireDate("2017-09-09");
obj1.setProduceCode("P1234");
obj1.setChangeTime("2017-09-09 12:00:00");
Batch obj3 = new Batch();
obj3.setBatchCode("PC1234");
obj3.setProductDate("2017-09-09");
obj3.setExpireDate("2017-09-09");
obj3.setProduceCode("PD1234");
obj3.setInventoryType("ZP");
obj3.setQuantity(12L);
obj1.setBatchs(obj3);
obj1.setRemark("备注信息");
obj1.setIsLocked("Y");
req.setItems(obj1);
SnList obj4 = new SnList();
obj4.setSn("A123");
req.setSnList(obj4);
StockchangeReportResponse 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>

错误码解释

错误码 错误描述 解决方案
isp.http-connection-timeout
isp.http-closed
isp.http-read-timeout
isp.http-connection-refuse

API工具

如何获得此API

FAQ

返回
顶部