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

taobao.qimen.entryorder.create (入库单创建接口)

taobao.qimen.entryorder.create

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request EntryOrderCreateRequest 可选
  • entryOrder
  • EntryOrder
  • 可选
  • 入库单信息
  • └ entryOrderCode
  • String
  • 必须
  • E1234
  • 入库单号
  • └ ownerCode
  • String
  • 必须
  • O1234
  • 货主编码
  • └ purchaseOrderCode
  • String
  • 可选
  • C123455
  • 采购单号(当orderType=CGRK时使用)
  • └ warehouseCode
  • String
  • 必须
  • W1234
  • 入库仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER)
  • └ orderCreateTime
  • String
  • 可选
  • 2016-09-09 12:00:00
  • 订单创建时间(YYYY-MM-DD HH:MM:SS)
  • └ orderType
  • String
  • 可选
  • SCRK
  • 业务类型(SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入 库;XNRK=虚拟入库;只传英文编码)
  • relatedOrders
  • RelatedOrder []
  • 可选
  • 关联订单信息
  • └ orderType
  • String
  • 可选
  • CG
  • 关联的订单类型(CG=采购单;DB=调拨单;CK=出库单;RK=入库单;只传英文编码)
  • └ orderCode
  • String
  • 可选
  • G1234
  • 关联的订单编号
  • └ expectStartTime
  • String
  • 可选
  • 2015-09-09 12:00:00
  • 预期到货时间(YYYY-MM-DD HH:MM:SS)
  • └ expectEndTime
  • String
  • 可选
  • 2015-09-09 12:00:00
  • 最迟预期到货时间(YYYY-MM-DD HH:MM:SS)
  • └ logisticsCode
  • String
  • 可选
  • SF
  • 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通 、ZTO=中通(ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHER=其他(只传英文编码))
  • └ logisticsName
  • String
  • 可选
  • 顺丰
  • 物流公司名称
  • └ expressCode
  • String
  • 可选
  • Y1234
  • 运单号
  • └ supplierCode
  • String
  • 可选
  • G1234
  • 供应商编码
  • └ supplierName
  • String
  • 可选
  • GN1234
  • 供应商名称
  • └ operatorCode
  • String
  • 可选
  • ON1234
  • 操作员编码
  • └ operatorName
  • String
  • 可选
  • 老王
  • 操作员名称
  • └ operateTime
  • String
  • 可选
  • 2017-09-09 12:00:00
  • 操作时间(YYYY-MM-DD HH:MM:SS)
  • senderInfo
  • SenderInfo
  • 可选
  • 发件人信息
  • └ company
  • String
  • 可选
  • 淘宝
  • 公司名称
  • └ name
  • String
  • 必须
  • 老王
  • 姓名
  • └ zipCode
  • String
  • 可选
  • 043300
  • 邮编
  • └ tel
  • String
  • 可选
  • 81020340
  • 固定电话
  • └ mobile
  • String
  • 必须
  • 13214567869
  • 移动电话
  • └ email
  • String
  • 可选
  • 345@gmail.com
  • 电子邮箱
  • └ countryCode
  • String
  • 可选
  • 051532
  • 国家二字码
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ area
  • String
  • 可选
  • 余杭
  • 区域
  • └ town
  • String
  • 可选
  • 横加桥
  • 村镇
  • └ detailAddress
  • String
  • 必须
  • 杭州市余杭区989号
  • 详细地址
  • receiverInfo
  • ReceiverInfo
  • 可选
  • 收件人信息
  • └ company
  • String
  • 可选
  • 淘宝
  • 公司名称
  • └ name
  • String
  • 必须
  • 老王
  • 姓名
  • └ zipCode
  • String
  • 可选
  • 043300
  • 邮编
  • └ tel
  • String
  • 可选
  • 808786543
  • 固定电话
  • └ mobile
  • String
  • 必须
  • 13423456785
  • 移动电话
  • └ idType
  • String
  • 可选
  • 1
  • 收件人证件类型(1-身份证;2-军官证;3-护照;4-其他)
  • └ idNumber
  • String
  • 可选
  • 12345
  • 收件人证件号码
  • └ email
  • String
  • 可选
  • 878987654@qq.com
  • 电子邮箱
  • └ countryCode
  • String
  • 可选
  • 045565
  • 国家二字码
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ area
  • String
  • 可选
  • 余杭
  • 区域
  • └ town
  • String
  • 可选
  • 横加桥
  • 村镇
  • └ detailAddress
  • String
  • 必须
  • 杭州市余杭区989号
  • 详细地址
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ totalOrderLines
  • String
  • 可选
  • 12
  • totalOrderLines
  • └ warehouseName
  • String
  • 可选
  • E1234
  • 入库仓库名称
  • └ sourceWarehouseCode
  • String
  • 可选
  • E1234
  • 出库仓库编码
  • └ sourceWarehouseName
  • String
  • 可选
  • E1234
  • 出库仓库名称
  • └ 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
  • 应收商品数量
  • └ skuProperty
  • String
  • 可选
  • 属性
  • 商品属性
  • └ purchasePrice
  • String
  • 可选
  • 12.0
  • 采购价
  • └ retailPrice
  • String
  • 可选
  • 12.0
  • 零售价
  • └ inventoryType
  • String
  • 可选
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP)
  • └ productDate
  • String
  • 可选
  • 2017-09-09
  • 商品生产日期(YYYY-MM-DD)
  • └ expireDate
  • String
  • 可选
  • 2017-09-09
  • 商品过期日期(YYYY-MM-DD)
  • └ produceCode
  • String
  • 可选
  • P1234
  • 生产批号
  • └ batchCode
  • String
  • 可选
  • PCODE123
  • 批次编码
  • └ unit
  • String
  • 可选
  • 个/盒/箱/柜等
  • 单位
  • snList
  • SnList
  • 可选
  • sn编码列表
  • └ sn
  • String []
  • 可选
  • sn编码
  • └ extendProps
  • Map
  • 可选
  • 入库单信息扩展信息
  • └ extendProps
  • Map
  • 可选
  • 扩展属性

响应参数

名称 类型 示例值 描述
response Response
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息
  • └ entryOrderId
  • String
  • EID1234
  • 仓储系统入库单编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenClient client = new DefaultQimenClient(url, appkey, secret);
EntryorderCreateRequest req = new EntryorderCreateRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
EntryOrder obj1 = new EntryOrder();
obj1.setEntryOrderCode("E1234");
obj1.setOwnerCode("O1234");
obj1.setPurchaseOrderCode("C123455");
obj1.setWarehouseCode("W1234");
obj1.setOrderCreateTime("2016-09-09 12:00:00");
obj1.setOrderType("SCRK");
RelatedOrder obj2 = new RelatedOrder();
obj2.setRemark("备注");
obj2.setOrderType("CG");
obj2.setOrderCode("G1234");
obj1.setRelatedOrders(obj2);
obj1.setExpectStartTime("2015-09-09 12:00:00");
obj1.setExpectEndTime("2015-09-09 12:00:00");
obj1.setLogisticsCode("SF");
obj1.setLogisticsName("顺丰");
obj1.setExpressCode("Y1234");
obj1.setSupplierCode("G1234");
obj1.setSupplierName("GN1234");
obj1.setOperatorCode("ON1234");
obj1.setOperatorName("老王");
obj1.setOperateTime("2017-09-09 12:00:00");
SenderInfo obj3 = new SenderInfo();
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("备注");
obj3.setCompany("淘宝");
obj3.setName("老王");
obj3.setZipCode("043300");
obj3.setTel("81020340");
obj3.setMobile("13214567869");
obj3.setEmail("345@gmail.com");
obj3.setCountryCode("051532");
obj3.setProvince("浙江省");
obj3.setCity("杭州");
obj3.setArea("余杭");
obj3.setTown("横加桥");
obj3.setDetailAddress("杭州市余杭区989号");
obj3.setId("temp");
obj3.setCarNo("temp");
obj1.setSenderInfo(obj3);
ReceiverInfo obj4 = new ReceiverInfo();
obj4.setFax("奇门仓储字段,说明,string(50),,");
obj4.setBirthDate("奇门仓储字段,说明,string(50),,");
obj4.setCareer("奇门仓储字段,说明,string(50),,");
obj4.setNick("奇门仓储字段,说明,string(50),,");
obj4.setCountryCodeCiq("奇门仓储字段,说明,string(50),,");
obj4.setCountryCodeCus("奇门仓储字段,说明,string(50),,");
obj4.setGender("奇门仓储字段,说明,string(50),,");
obj4.setRemark("备注");
obj4.setCompany("淘宝");
obj4.setName("老王");
obj4.setZipCode("043300");
obj4.setTel("808786543");
obj4.setMobile("13423456785");
obj4.setIdType("1");
obj4.setIdNumber("12345");
obj4.setEmail("878987654@qq.com");
obj4.setCountryCode("045565");
obj4.setProvince("浙江省");
obj4.setCity("杭州");
obj4.setArea("余杭");
obj4.setTown("横加桥");
obj4.setDetailAddress("杭州市余杭区989号");
obj4.setId("temp");
obj4.setCarNo("temp");
obj1.setReceiverInfo(obj4);
obj1.setRemark("备注信息");
obj1.setContractCode("temp");
obj1.setPlanArrivalTime("temp");
obj1.setStatus("temp");
obj1.setSizeDetail("temp");
obj1.setIsCheck("temp");
obj1.setIsNudePackage("temp");
obj1.setOrderSource("temp");
obj1.setExtOrderCode("temp");
obj1.setConsignId("temp");
obj1.setBusinessId("temp");
obj1.setLogisticsContactName("temp");
obj1.setLogisticsContactNo("temp");
obj1.setLogisticsContactPhone("temp");
obj1.setSupplierZipCode("temp");
obj1.setSupplierTel("temp");
obj1.setSupplierPhone("temp");
obj1.setSupplierProvince("temp");
obj1.setSupplierCity("temp");
obj1.setSupplierArea("temp");
obj1.setSupplierTown("temp");
obj1.setSupplierAddress("temp");
obj1.setSupplierEmail("temp");
obj1.setOutBizCode("temp");
obj1.setConfirmType("temp");
obj1.setTotalOrderLines("12");
obj1.setWarehouseName("E1234");
obj1.setSourceWarehouseCode("E1234");
obj1.setSourceWarehouseName("E1234");
req.setEntryOrder(obj1);
OrderLine obj5 = new OrderLine();
obj5.setProductCode("奇门仓储字段,说明,string(50),,");
obj5.setStockInQty("奇门仓储字段,说明,string(50),,");
obj5.setStockOutQty("奇门仓储字段,说明,string(50),,");
Batch obj6 = new Batch();
obj6.setBatchCode("奇门仓储字段,说明,string(50),,");
obj6.setProductDate("奇门仓储字段,说明,string(50),,");
obj6.setExpireDate("奇门仓储字段,说明,string(50),,");
obj6.setProduceCode("奇门仓储字段,说明,string(50),,");
obj6.setInventoryType("奇门仓储字段,说明,string(50),,");
obj6.setActualQty("奇门仓储字段,说明,string(50),,");
obj6.setQuantity("奇门仓储字段,说明,string(50),,");
obj6.setRemark("备注");
obj5.setBatchs(obj6);
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.setRemark("备注");
obj5.setOutBizCode("O123");
obj5.setOrderLineNo("EL123");
obj5.setOwnerCode("O123");
obj5.setItemCode("I123");
obj5.setItemId("CI123");
obj5.setItemName("IN123");
obj5.setPlanQty(12L);
obj5.setSkuProperty("属性");
obj5.setPurchasePrice("12.0");
obj5.setRetailPrice("12.0");
obj5.setInventoryType("ZP");
obj5.setProductDate("2017-09-09");
obj5.setExpireDate("2017-09-09");
obj5.setProduceCode("P1234");
obj5.setBatchCode("PCODE123");
obj5.setOrderSourceCode("temp");
obj5.setSubSourceCode("temp");
obj5.setActualQty("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.setOwnerCode("temp");
obj8.setTitle("temp");
obj8.setItemCode("temp");
obj8.setItemId("temp");
obj8.setItemName("temp");
obj8.setEnglishName("temp");
obj8.setShortName("temp");
obj8.setCategoryId("temp");
obj8.setCategoryName("temp");
obj8.setSkuProperty("temp");
obj8.setItemType("temp");
obj8.setTagPrice("temp");
obj8.setRetailPrice("temp");
obj8.setCostPrice("temp");
obj8.setPurchasePrice("temp");
obj8.setSupplierCode("temp");
obj8.setSupplierName("temp");
obj8.setSeasonCode("temp");
obj8.setSeasonName("temp");
obj8.setBrandCode("temp");
obj8.setBrandName("temp");
obj8.setSn("temp");
obj8.setIsSNMgmt("temp");
obj8.setBarCode("temp");
obj8.setColor("temp");
obj8.setSize("temp");
obj8.setLength("temp");
obj8.setWidth("temp");
obj8.setHeight("temp");
obj8.setVolume("temp");
obj8.setGrossWeight("temp");
obj8.setNetWeight("temp");
obj8.setTareWeight("temp");
obj8.setSafetyStock("temp");
obj8.setStockUnit("temp");
obj8.setStockStatus("temp");
obj8.setProductDate("temp");
obj8.setExpireDate("temp");
obj8.setIsShelfLifeMgmt("temp");
obj8.setShelfLife("temp");
obj8.setRejectLifecycle("temp");
obj8.setLockupLifecycle("temp");
obj8.setAdventLifecycle("temp");
obj8.setBatchCode("temp");
obj8.setBatchRemark("temp");
obj8.setIsBatchMgmt("temp");
obj8.setPackCode("temp");
obj8.setPcs("temp");
obj8.setOriginAddress("temp");
obj8.setApprovalNumber("temp");
obj8.setIsFragile("temp");
obj8.setIsHazardous("temp");
obj8.setPricingCategory("temp");
obj8.setIsSku("temp");
obj8.setPackageMaterial("temp");
obj8.setPrice("temp");
obj8.setIsAreaSale("temp");
req.setItems(obj8);
EntryorderCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

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

返回
顶部