接口说明
- ERP调用的虎符API名称:jingdong.hufu.entryorder.create
- 虎符调用WMS的API名称:entryorder.create
- 注:
- 调拨接口其实可以拆分为出库单创建+入库单创建,同时可以考虑使用该接口中的relatedOrders字段。
- 该接口以及后面的出库单创建、发货单创建都是同步接口,ERP调用创建接口后,WMS的响应报文success说明WMS已经将该入库单创建成功,而不仅仅是消息接收成功。而后面的confirm接口是回告ERP入库已经完成。
入参规范
<?xml version="1.0" encoding="utf-8"?>
<request>
<entryOrder>
<totalOrderLines>单据总行数,int,当单据需要分多个请求发送时,发送方需要将totalOrderLines填入,接收方收到后,根据实际接收到的条数和totalOrderLines进行比对,如果小于,则继续等待接收请求。如果等于,则表示该单据的所有请求发送完成。
</totalOrderLines>
<entryOrderCode>入库单号, string (50) , 必填</entryOrderCode>
<ownerCode>货主编码, string (50) , 必填</ownerCode>
<purchaseOrderCode>采购单号,string(50),当orderType=CGRK时,使用</purchaseOrderCode>
<warehouseCode>仓库编码, string (50),必填 ,统仓统配等无需ERP指定仓储编码的情况填OTHER</warehouseCode>
<orderCreateTime>订单创建时间, string (19) , YYYY-MM-DD HH:MM:SS</orderCreateTime>
<orderType>业务类型 (SCRK=生产入库,LYRK=领用入库,CCRK=残次品入库,CGRK=采购入库,DBRK=调拨入库, QTRK=其他入库,B2BRK=B2B入库,XNRK=虚拟入库 string (50) , (只传英文编码) </orderType>
<relatedOrders><!--关联的订单单据类型和单据号,如采购单、调拨单等-->
<relatedOrder>
<orderType>关联的订单类型,CG=采购单,DB=调拨单, CK=出库单,RK=入库单,string (50) , (只传英文编码)</orderType>
<orderCode>关联的订单编号,string(50)</orderCode>
</relatedOrder>
</relatedOrders>
<expectStartTime>预期到货时间, string (19) , YYYY-MM-DD HH:MM:SS</expectStartTime>
<expectEndTime>最迟预期到货时间, string (19) , YYYY-MM-DD HH:MM:SS</expectEndTime>
<logisticsCode>物流公司编码, string (50) , SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通 、ZTO=中通 (ZTO) 、HTKY=百世汇通、UC=优速、STO=申通、TTKDEX=天天快递 、QFKD=全峰、FAST=快捷、POSTB=邮政小包 、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、OTHER=其他(只传英文编码) </logisticsCode>
<logisticsName>物流公司名称, string (200) </logisticsName>
<expressCode>运单号, string (50) </expressCode>
<supplierCode>供应商编码 string (50) </supplierCode>
<supplierName>供应商名称 string (200) </supplierName>
<operatorCode>操作员编码, string (50) </operatorCode>
<operatorName>操作员名称, string (50) </operatorName>
<operateTime>操作时间, string (19) , YYYY-MM-DD HH:MM:SS</operateTime>
<senderInfo> <!--发件人信息-->
<company>公司名称, string (200) </company>
<name>姓名, string (50) </name>
<zipCode>邮编, string (50) </zipCode>
<tel>固定电话, string (50) </tel>
<mobile>移动电话, string (50) </mobile>
<email>电子邮箱, string (50) </email>
<countryCode>国家二字码,string(50)</countryCode>
<province>省份, string (50) </province>
<city>城市, string (50) </city>
<area>区域, string (50) </area>
<town>村镇, string (50) </town>
<detailAddress>详细地址, string (200) </detailAddress>
</senderInfo>
<receiverInfo> <!--收件人信息-->
<company>公司名称, string (200) </company>
<name>姓名, string (50) </name>
<zipCode>邮编, string (50) </zipCode>
<tel>固定电话, string (50) </tel>
<mobile>移动电话, string (50) </mobile>
<email>电子邮箱, string (50) </email>
<countryCode>国家二字码,string(50)</countryCode>
<province>省份, string (50) </province>
<city>城市, string (50) </city>
<area>区域, string (50) </area>
<town>村镇, string (50) </town>
<detailAddress>详细地址, string (200) </detailAddress>
</receiverInfo>
<remark>备注, string (500) </remark>
<extendProps>扩展属性
<key1>value1</key1>
<key2>value2</key2>
</extendProps>
</entryOrder>
<orderLines>
<orderLine>
<outBizCode>外部业务编码, 消息ID, 用于去重,当单据需要分批次发送时使用 </outBizCode>
<orderLineNo>入库单的行号,string(50)</orderLineNo>
<ownerCode>货主编码, string (50) , 必填</ownerCode>
<itemCode>商品编码, string (50) , 必填</itemCode>
<itemId>仓储系统商品ID,string(50),条件必填</itemId>
<itemName>商品名称, string (200) </itemName>
<planQty>应收商品数量, int, 必填</planQty>
<skuProperty>商品属性, string (200) </skuProperty>
<purchasePrice>采购价, double (18, 2) </purchasePrice>
<retailPrice>零售价, double (18, 2) </retailPrice>
<inventoryType>库存类型,string (50) , ZP=正品, CC=残次,JS=机损, XS= 箱损,默认为ZP</inventoryType>
<productDate>商品生产日期 YYYY-MM-DD</productDate>
<expireDate>商品过期日期YYYY-MM-DD</expireDate>
<produceCode>生产批号, string (50) </produceCode>
<batchCode>批次编码, string (50) </batchCode>
<extendProps>扩展属性
<key1>value1</key1>
<key2>value2</key2>
</extendProps>
</orderLine>
</orderLines>
</request>
出参规范
<?xml version="1.0" encoding="utf-8"?>
<response>
<flag>success|failure</flag>
<code>响应码</code>
<message>响应信息</message>
<entryOrderId>仓储系统入库单编码, string (50) </entryOrderId>
</response>