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

taobao.qimen.entryorder.confirm (入库单确认接口)

WMS调用接口,回传入库单信息;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request EntryOrderConfirmRequest 可选
  • entryOrder
  • EntryOrder
  • 可选
  • 入库单信息
  • └ orderCode
  • String
  • 可选
  • 订单编码
  • 订单编码
  • └ orderId
  • String
  • 可选
  • 后端订单id
  • 后端订单id
  • └ orderType
  • String
  • 可选
  • 订单类型
  • 订单类型
  • └ warehouseName
  • String
  • 可选
  • 仓库名称
  • 仓库名称
  • └ totalOrderLines
  • Number
  • 可选
  • 12
  • 单据总行数(当单据需要分多个请求发送时;发送方需要将totalOrderLines填入;接收方收到后;根据实际接收到的 条数和 totalOrderLines进行比对;如果小于;则继续等待接收请求。如果等于;则表示该单据的所有请求发送完 成)
  • └ entryOrderCode
  • String
  • 必须
  • E1234
  • 入库单号
  • └ ownerCode
  • String
  • 必须
  • O1234
  • 货主编码
  • └ purchaseOrderCode
  • String
  • 可选
  • C123455
  • 采购单号(当orderType=CGRK时使用)
  • └ warehouseCode
  • String
  • 必须
  • W1234
  • 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER)
  • └ entryOrderId
  • String
  • 可选
  • E1234
  • 仓储系统入库单ID
  • └ entryOrderType
  • String
  • 可选
  • SCRK
  • 入库单类型(SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入 库;B2BRK=B2B入库)
  • └ outBizCode
  • String
  • 必须
  • O1234
  • 外部业务编码(消息ID;用于去重;ISV对于同一请求;分配一个唯一性的编码。用来保证因为网络等原因导致重复传输;请求 不会被重复处理)
  • └ confirmType
  • Number
  • 可选
  • 0
  • 支持出入库单多次收货(多次收货后确认时:0:表示入库单最终状态确认;1:表示入库单中间状态确认;每次入库传入的数量为增 量;特殊情况;同一入库单;如果先收到0;后又收到1;允许修改收货的数量)
  • └ status
  • String
  • 必须
  • NEW
  • 入库单状态(NEW-未开始处理;ACCEPT-仓库接单;PARTFULFILLED-部分收货完成;FULFILLED-收货完成;EXCEPTION-异 常;CANCELED-取消;CLOSED-关闭;REJECT-拒单;CANCELEDFAIL-取消失败;只传英文编码)
  • └ operateTime
  • String
  • 可选
  • 2017-09-09 12:00:00
  • 操作时间(YYYY-MM-DD HH:MM:SS;当status=FULFILLED;operateTime为入库时间)
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ freight
  • String
  • 可选
  • 奇门仓储字段,说明,string(50),,
  • 邮费
  • └ subOrderType
  • String
  • 可选
  • hss
  • 入库单确认的其他入库子类型,用于entryOrderType设置为其他入库时设置
  • └ responsibleDepartment
  • String
  • 可选
  • 财务部
  • 该笔入库单的费用承担部门或责任部门
  • └ shopNick
  • String
  • 必须
  • 旗舰店
  • 店铺名称
  • └ shopCode
  • String
  • 必须
  • ssss
  • 店铺编码
  • └ extendProps
  • Map
  • 可选
  • 入库单信息
  • orderLines
  • OrderLine []
  • 可选
  • 订单信息
  • └ outBizCode
  • String
  • 可选
  • O123
  • 外部业务编码(消息ID;用于去重;当单据需要分批次发送时使用)
  • └ orderLineNo
  • String
  • 可选
  • EL123
  • 入库单的行号
  • └ ownerCode
  • String
  • 必须
  • O123
  • 货主编码
  • └ itemCode
  • String
  • 必须
  • I123
  • 商品编码
  • └ itemId
  • String
  • 可选
  • CI123
  • 仓储系统商品ID
  • └ itemName
  • String
  • 可选
  • IN123
  • 商品名称
  • └ planQty
  • Number
  • 必须
  • 12
  • 应收商品数量
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP)
  • └ actualQty
  • Number
  • 必须
  • 12
  • 实收数量
  • └ productDate
  • String
  • 可选
  • 2017-09-09
  • 商品生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2017-09-09
  • 商品过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • 可选
  • P1234
  • 生产批号
  • └ batchCode
  • String
  • 可选
  • PCODE123
  • 批次编码
  • batchs
  • Batch []
  • 可选
  • 批次信息
  • └ batchCode
  • String
  • 可选
  • P1234
  • 批次编号
  • └ productDate
  • String
  • 可选
  • 2016-09-09
  • 生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2016-09-09
  • 过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • 可选
  • P1234
  • 生产批号
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS= 箱损;默认为ZP;)
  • └ actualQty
  • Number
  • 可选
  • 12
  • 实收数量(要求batchs节点下所有的实收数量之和等于orderline中的实收数量)
  • └ extendProps
  • Map
  • 可选
  • 批次信息扩展字段
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ unit
  • String
  • 可选
  • 盒/箱/个等
  • 单位
  • snList
  • SnList
  • 可选
  • sn列表
  • └ sn
  • String []
  • 可选
  • sn编码
  • └ extendProps
  • Map
  • 可选
  • 订单信息扩展属性
  • └ extendProps
  • Map
  • 可选
  • 扩展属性
  • totalOrders
  • TotalOrder []
  • 可选
  • 分批次入库的最后一次回传
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ actualQty
  • String
  • 可选
  • 10
  • 实收数量
  • └ itemName
  • String
  • 可选
  • IN123
  • 商品名称
  • └ itemId
  • String
  • 可选
  • I123
  • 仓储系统商品ID
  • └ itemCode
  • String
  • 可选
  • I123
  • 商品编码
  • └ ownerCode
  • String
  • 可选
  • O123
  • 货主编码
  • └ orderLineNo
  • String
  • 可选
  • EL123
  • 单据行号

响应参数

名称 类型 示例值 描述
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);
EntryorderConfirmRequest req = new EntryorderConfirmRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
EntryOrder obj1 = new EntryOrder();
obj1.setContractCode("奇门仓储字段,说明,string(50),,");
obj1.setPlanArrivalTime("奇门仓储字段,说明,string(50),,");
obj1.setExpectStartTime("奇门仓储字段,说明,string(50),,");
obj1.setExpectEndTime("奇门仓储字段,说明,string(50),,");
obj1.setExpressCode("奇门仓储字段,说明,string(50),,");
obj1.setOperatorCode("奇门仓储字段,说明,string(50),,");
obj1.setOperatorName("奇门仓储字段,说明,string(50),,");
obj1.setSizeDetail("奇门仓储字段,说明,string(50),,");
obj1.setIsCheck("奇门仓储字段,说明,string(50),,");
obj1.setIsNudePackage("奇门仓储字段,说明,string(50),,");
obj1.setOrderSource("奇门仓储字段,说明,string(50),,");
obj1.setExtOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setConsignId("奇门仓储字段,说明,string(50),,");
obj1.setBusinessId("奇门仓储字段,说明,string(50),,");
obj1.setLogisticsCode("奇门仓储字段,说明,string(50),,");
obj1.setLogisticsName("奇门仓储字段,说明,string(50),,");
obj1.setLogisticsContactName("奇门仓储字段,说明,string(50),,");
obj1.setLogisticsContactNo("奇门仓储字段,说明,string(50),,");
obj1.setLogisticsContactPhone("奇门仓储字段,说明,string(50),,");
obj1.setSupplierCode("奇门仓储字段,说明,string(50),,");
obj1.setSupplierName("奇门仓储字段,说明,string(50),,");
obj1.setSupplierZipCode("奇门仓储字段,说明,string(50),,");
obj1.setSupplierTel("奇门仓储字段,说明,string(50),,");
obj1.setSupplierPhone("奇门仓储字段,说明,string(50),,");
obj1.setSupplierProvince("奇门仓储字段,说明,string(50),,");
obj1.setSupplierCity("奇门仓储字段,说明,string(50),,");
obj1.setSupplierArea("奇门仓储字段,说明,string(50),,");
obj1.setSupplierTown("奇门仓储字段,说明,string(50),,");
obj1.setSupplierAddress("奇门仓储字段,说明,string(50),,");
obj1.setSupplierEmail("奇门仓储字段,说明,string(50),,");
obj1.setOrderCreateTime("奇门仓储字段,说明,string(50),,");
SenderInfo obj2 = new SenderInfo();
obj2.setCompany("奇门仓储字段,说明,string(50),,");
obj2.setName("奇门仓储字段,说明,string(50),,");
obj2.setZipCode("奇门仓储字段,说明,string(50),,");
obj2.setTel("奇门仓储字段,说明,string(50),,");
obj2.setMobile("奇门仓储字段,说明,string(50),,");
obj2.setProvince("奇门仓储字段,说明,string(50),,");
obj2.setCity("奇门仓储字段,说明,string(50),,");
obj2.setArea("奇门仓储字段,说明,string(50),,");
obj2.setTown("奇门仓储字段,说明,string(50),,");
obj2.setDetailAddress("奇门仓储字段,说明,string(50),,");
obj2.setEmail("奇门仓储字段,说明,string(50),,");
obj2.setCountryCode("奇门仓储字段,说明,string(50),,");
obj2.setId("奇门仓储字段,说明,string(50),,");
obj2.setCarNo("奇门仓储字段,说明,string(50),,");
obj2.setFax("奇门仓储字段,说明,string(50),,");
obj2.setBirthDate("奇门仓储字段,说明,string(50),,");
obj2.setCareer("奇门仓储字段,说明,string(50),,");
obj2.setNick("奇门仓储字段,说明,string(50),,");
obj2.setIdType("奇门仓储字段,说明,string(50),,");
obj2.setIdNumber("奇门仓储字段,说明,string(50),,");
obj2.setCountryCodeCiq("奇门仓储字段,说明,string(50),,");
obj2.setCountryCodeCus("奇门仓储字段,说明,string(50),,");
obj2.setGender("奇门仓储字段,说明,string(50),,");
obj2.setRemark("备注");
obj1.setSenderInfo(obj2);
ReceiverInfo obj3 = new ReceiverInfo();
obj3.setCompany("奇门仓储字段,说明,string(50),,");
obj3.setName("奇门仓储字段,说明,string(50),,");
obj3.setZipCode("奇门仓储字段,说明,string(50),,");
obj3.setTel("奇门仓储字段,说明,string(50),,");
obj3.setMobile("奇门仓储字段,说明,string(50),,");
obj3.setProvince("奇门仓储字段,说明,string(50),,");
obj3.setCity("奇门仓储字段,说明,string(50),,");
obj3.setArea("奇门仓储字段,说明,string(50),,");
obj3.setTown("奇门仓储字段,说明,string(50),,");
obj3.setDetailAddress("奇门仓储字段,说明,string(50),,");
obj3.setEmail("奇门仓储字段,说明,string(50),,");
obj3.setCountryCode("奇门仓储字段,说明,string(50),,");
obj3.setId("奇门仓储字段,说明,string(50),,");
obj3.setCarNo("奇门仓储字段,说明,string(50),,");
obj3.setFax("奇门仓储字段,说明,string(50),,");
obj3.setBirthDate("奇门仓储字段,说明,string(50),,");
obj3.setCareer("奇门仓储字段,说明,string(50),,");
obj3.setNick("奇门仓储字段,说明,string(50),,");
obj3.setIdType("奇门仓储字段,说明,string(50),,");
obj3.setIdNumber("奇门仓储字段,说明,string(50),,");
obj3.setCountryCodeCiq("奇门仓储字段,说明,string(50),,");
obj3.setCountryCodeCus("奇门仓储字段,说明,string(50),,");
obj3.setGender("奇门仓储字段,说明,string(50),,");
obj3.setRemark("备注");
obj1.setReceiverInfo(obj3);
RelatedOrder obj4 = new RelatedOrder();
obj4.setOrderCode("奇门仓储字段,说明,string(50),,");
obj4.setOrderType("奇门仓储字段,说明,string(50),,");
obj4.setRemark("备注");
obj1.setRelatedOrders(obj4);
obj1.setOrderCode("订单编码");
obj1.setOrderId("后端订单id");
obj1.setOrderType("订单类型");
obj1.setWarehouseName("仓库名称");
obj1.setTotalOrderLines(12L);
obj1.setEntryOrderCode("E1234");
obj1.setOwnerCode("O1234");
obj1.setPurchaseOrderCode("C123455");
obj1.setWarehouseCode("W1234");
obj1.setEntryOrderId("E1234");
obj1.setEntryOrderType("SCRK");
obj1.setOutBizCode("O1234");
obj1.setConfirmType(0L);
obj1.setStatus("NEW");
obj1.setOperateTime("2017-09-09 12:00:00");
obj1.setRemark("备注信息");
obj1.setFreight("奇门仓储字段,说明,string(50),,");
obj1.setSubOrderType("hss");
obj1.setResponsibleDepartment("财务部");
obj1.setShopNick("旗舰店");
obj1.setShopCode("ssss");
req.setEntryOrder(obj1);
OrderLine obj5 = new OrderLine();
obj5.setSkuProperty("奇门仓储字段,说明,string(50),,");
obj5.setPurchasePrice("奇门仓储字段,说明,string(50),,");
obj5.setRetailPrice("奇门仓储字段,说明,string(50),,");
obj5.setProductCode("奇门仓储字段,说明,string(50),,");
obj5.setStockInQty("奇门仓储字段,说明,string(50),,");
obj5.setStockOutQty("奇门仓储字段,说明,string(50),,");
obj5.setTaobaoItemCode("奇门仓储字段,说明,string(50),,");
obj5.setDiscountPrice("奇门仓储字段,说明,string(50),,");
obj5.setColor("奇门仓储字段,说明,string(50),,");
obj5.setSize("奇门仓储字段,说明,string(50),,");
obj5.setStandardPrice("奇门仓储字段,说明,string(50),,");
obj5.setReferencePrice("奇门仓储字段,说明,string(50),,");
obj5.setDiscount("奇门仓储字段,说明,string(50),,");
obj5.setStandardAmount("奇门仓储字段,说明,string(50),,");
obj5.setSettlementAmount("奇门仓储字段,说明,string(50),,");
obj5.setLocationCode("奇门仓储字段,说明,string(50),,");
obj5.setAmount("奇门仓储字段,说明,string(50),,");
obj5.setMoveOutLocation("奇门仓储字段,说明,string(50),,");
obj5.setMoveInLocation("奇门仓储字段,说明,string(50),,");
obj5.setExceptionQty("奇门仓储字段,说明,string(50),,");
obj5.setOutBizCode("O123");
obj5.setOrderLineNo("EL123");
obj5.setOwnerCode("O123");
obj5.setItemCode("I123");
obj5.setItemId("CI123");
obj5.setItemName("IN123");
obj5.setPlanQty(12L);
obj5.setInventoryType("ZP");
obj5.setActualQty(12L);
obj5.setProductDate("2017-09-09");
obj5.setExpireDate("2017-09-09");
obj5.setProduceCode("P1234");
obj5.setBatchCode("PCODE123");
Batch obj6 = new Batch();
obj6.setRemark("备注");
obj6.setBatchCode("P1234");
obj6.setProductDate("2016-09-09");
obj6.setExpireDate("2016-09-09");
obj6.setProduceCode("P1234");
obj6.setInventoryType("ZP");
obj6.setActualQty(12L);
obj6.setQuantity("temp");
obj5.setBatchs(obj6);
obj5.setRemark("备注信息");
obj5.setOrderSourceCode("temp");
obj5.setSubSourceCode("temp");
obj5.setSourceOrderCode("temp");
obj5.setSubSourceOrderCode("temp");
obj5.setExtCode("temp");
obj5.setActualPrice("temp");
obj5.setDiscountAmount("temp");
obj5.setQuantity("temp");
obj5.setWarehouseCode("temp");
obj5.setDeliveryOrderId("temp");
obj5.setStatus("temp");
obj5.setQrCode("temp");
obj5.setPayNo("temp");
obj5.setSubDeliveryOrderId("temp");
obj5.setUnit("盒/箱/个等");
SnList obj7 = new SnList();
obj7.setSn("");
obj5.setSnList(obj7);
req.setOrderLines(obj5);
Item obj8 = new Item();
obj8.setQuantity("奇门仓储字段,说明,string(50),,");
obj8.setNormalQty("奇门仓储字段,说明,string(50),,");
obj8.setDefectiveQty("奇门仓储字段,说明,string(50),,");
obj8.setReceiveQty("奇门仓储字段,说明,string(50),,");
obj8.setExCode("奇门仓储字段,说明,string(50),,");
obj8.setDiscountPrice("奇门仓储字段,说明,string(50),,");
obj8.setInventoryType("奇门仓储字段,说明,string(50),,");
obj8.setPlanQty("奇门仓储字段,说明,string(50),,");
obj8.setSourceOrderCode("奇门仓储字段,说明,string(50),,");
obj8.setSubSourceOrderCode("奇门仓储字段,说明,string(50),,");
obj8.setProduceCode("奇门仓储字段,说明,string(50),,");
obj8.setOrderLineNo("奇门仓储字段,说明,string(50),,");
obj8.setActualQty("奇门仓储字段,说明,string(50),,");
obj8.setAmount("奇门仓储字段,说明,string(50),,");
obj8.setUnit("奇门仓储字段,说明,string(50),,");
obj8.setWarehouseCode("奇门仓储字段,说明,string(50),,");
obj8.setLockQuantity("奇门仓储字段,说明,string(50),,");
obj8.setOrderCode("奇门仓储字段,说明,string(50),,");
obj8.setOrderType("奇门仓储字段,说明,string(50),,");
obj8.setOutBizCode("奇门仓储字段,说明,string(50),,");
obj8.setProductCode("奇门仓储字段,说明,string(50),,");
obj8.setPaperQty("奇门仓储字段,说明,string(50),,");
obj8.setDiffQuantity("奇门仓储字段,说明,string(50),,");
obj8.setExtCode("奇门仓储字段,说明,string(50),,");
obj8.setLackQty("奇门仓储字段,说明,string(50),,");
obj8.setReason("奇门仓储字段,说明,string(50),,");
obj8.setSnCode("奇门仓储字段,说明,string(50),,");
Batch obj9 = new Batch();
obj9.setBatchCode("奇门仓储字段,说明,string(50),,");
obj9.setProductDate("奇门仓储字段,说明,string(50),,");
obj9.setExpireDate("奇门仓储字段,说明,string(50),,");
obj9.setProduceCode("奇门仓储字段,说明,string(50),,");
obj9.setInventoryType("奇门仓储字段,说明,string(50),,");
obj9.setActualQty("奇门仓储字段,说明,string(50),,");
obj9.setQuantity("奇门仓储字段,说明,string(50),,");
obj9.setRemark("备注");
obj8.setBatchs(obj9);
obj8.setGoodsCode("奇门仓储字段,说明,string(50),,");
obj8.setStandardPrice("奇门仓储字段,说明,string(50),,");
obj8.setReferencePrice("奇门仓储字段,说明,string(50),,");
obj8.setDiscount("奇门仓储字段,说明,string(50),,");
obj8.setActualAmount("奇门仓储字段,说明,string(50),,");
PriceAdjustment obj10 = new PriceAdjustment();
obj10.setType("奇门仓储字段,说明,string(50),,");
obj10.setStandardPrice("奇门仓储字段,说明,string(50),,");
obj10.setDiscount("奇门仓储字段,说明,string(50),,");
obj10.setStartDate("奇门仓储字段,说明,string(50),,");
obj10.setEndDate("奇门仓储字段,说明,string(50),,");
obj10.setRemark("备注");
obj8.setPriceAdjustment(obj10);
obj8.setLatestUpdateTime("奇门仓储字段,说明,string(50),,");
obj8.setChangeTime("奇门仓储字段,说明,string(50),,");
obj8.setTempRequirement("奇门仓储字段,说明,string(50),,");
obj8.setChannelCode("奇门仓储字段,说明,string(50),,");
obj8.setOriginCode("奇门仓储字段,说明,string(50),,");
obj8.setRemark("备注");
obj8.setSeasonName("temp");
obj8.setSeasonCode("temp");
obj8.setSupplierName("temp");
obj8.setSupplierCode("temp");
obj8.setPurchasePrice("temp");
obj8.setCostPrice("temp");
obj8.setRetailPrice("temp");
obj8.setTagPrice("temp");
obj8.setItemType("v");
obj8.setSkuProperty("temp");
obj8.setCategoryName("temp");
obj8.setCategoryId("temp");
obj8.setShortName("temp");
obj8.setEnglishName("temp");
obj8.setItemName("temp");
obj8.setItemId("temp");
obj8.setItemCode("temp");
obj8.setTitle("temp");
obj8.setOwnerCode("temp");
obj8.setHeight("temp");
obj8.setWidth("temp");
obj8.setLength("temp");
obj8.setSize("temp");
obj8.setColor("temp");
obj8.setBarCode("temp");
obj8.setIsSNMgmt("temp");
obj8.setSn("temp");
obj8.setBrandName("temp");
obj8.setBrandCode("temp");
obj8.setProductDate("temp");
obj8.setStockStatus("temp");
obj8.setStockUnit("temp");
obj8.setSafetyStock("temp");
obj8.setTareWeight("temp");
obj8.setNetWeight("temp");
obj8.setGrossWeight("temp");
obj8.setVolume("temp");
obj8.setOriginAddress("temp");
obj8.setPcs("temp");
obj8.setPackCode("temp");
obj8.setIsBatchMgmt("temp");
obj8.setBatchRemark("temp");
obj8.setBatchCode("temp");
obj8.setAdventLifecycle("temp");
obj8.setLockupLifecycle("temp");
obj8.setRejectLifecycle("temp");
obj8.setShelfLife("temp");
obj8.setIsShelfLifeMgmt("temp");
obj8.setExpireDate("temp");
obj8.setPricingCategory("temp");
obj8.setIsHazardous("temp");
obj8.setIsFragile("temp");
obj8.setApprovalNumber("temp");
obj8.setIsAreaSale("temp");
obj8.setPrice("temp");
obj8.setPackageMaterial("temp");
obj8.setIsSku("temp");
req.setItems(obj8);
TotalOrder obj11 = new TotalOrder();
obj11.setRemark("备注信息");
obj11.setActualQty("10");
obj11.setItemName("IN123");
obj11.setItemId("I123");
obj11.setItemCode("I123");
obj11.setOwnerCode("O123");
obj11.setOrderLineNo("EL123");
req.setTotalOrders(obj11);
EntryorderConfirmResponse 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-read-timeout
isp.http-connection-refuse
isp.http-closed

API工具

如何获得此API

FAQ

返回
顶部