简要描述:
接口说明:
- 1.1接口描述:创建出库单到WMS
- 1.2接口说明:ERP调用奇门接口,奇门调用该接口,FMS调用奇门接口往WMS创建出库单。和发货单的区别是,发货单创建是和订单相关的发货操作,而该接口是普通的货品出库,和订单无关。
- 1.3接口方法:taobao.qimen.stockout.create
接口版本:
| 版本号 |
制定人 |
制定日期 |
修订日期 |
| 1.0.0 |
黄会准 |
2020-07-31 |
2020-07-31 |
请求URL:
请求方式:
请求头:
| 参数名 |
是否必须 |
类型 |
说明 |
| Content-Type |
是 |
string |
请求类型,统一是 application/xml |
系统级请求参数
| 参数名 |
字段 |
是否必须 |
类型 |
长度 |
说明 |
| WMS 的appkey |
app_key |
是 |
String |
|
应用接入时申请的 appkey |
| 接口方法 |
method |
是 |
String |
|
WMS 相关的业务接口名称,如商品信息同步的请求,method= taobao.qimen.item.synchronize |
| 协议版本号 |
v |
是 |
String |
|
版本号 默认请传3.0 |
| content 格式 |
format |
是 |
String |
|
目前支持 XML |
| 加密令牌 |
sign |
是 |
String |
|
根据 url 和密钥计算的结果 |
| 加密方法 |
sign_method |
是 |
String |
|
md5 |
| 用户id |
customerid |
是 |
String |
|
WMS 颁发给用户的 ID |
| 请求时间 |
timestamp |
是 |
String |
|
yyyy-MM-dd HH:mm:ss 格式 |
请求参数:
| 参数名 |
字段 |
是否必须 |
类型 |
说明 |
| 入库单信息 |
deliveryOrder |
是 |
data |
出库单信息,节点下数据字段详见下述“entryOrder” |
| 入库单详情 |
orderLines |
是 |
data[] |
单据信息,节点下数据字段详见下述“orderLines” |
| 扩展属性 |
extendProps |
否 |
Map |
扩展属性 |
deliveryOrder
| 参数名 |
字段 |
是否必须 |
类型 |
说明 |
| 单据总行数 |
totalOrderLines |
否 |
int |
单据总行数(当单据需要分多个请求发送时;发送方需要将totalOrderLines填入;接收方收到后;根据实际接收到的条数和totalOrderLines进行比对;如果小于;则继续等待接收请求。如果等于;则表示该单据的所有请求发送完成.) |
| 出库单号 |
deliveryOrderCode |
是 |
String |
出库单号 |
| 出库单类型 |
orderType |
是 |
String |
出库单类型(PTCK=普通出库单;DBCK=调拨出库;B2BCK=B2B出库;QTCK=其他出库;CGTH=采购退货出库单;XNCK=虚拟出库单, JITCK=唯品出库) |
| 关联单据信息 |
relatedOrders |
否 |
data[] |
关联单据信息 |
| 仓库编码 |
warehouseCode |
是 |
String |
仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER) |
| 出库单创建时间 |
createTime |
是 |
String |
出库单创建时间(YYYY-MM-DD HH:MM:SS) |
| 要求出库时间 |
scheduleDate |
否 |
String |
要求出库时间(YYYY-MM-DD) |
| 物流公司编码 |
logisticsCode |
否 |
String |
物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通 、ZTO=中通(ZTO)、HTKY=百世汇通、UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、OTHER=其他;只传英文编码) |
| 物流公司名称 |
logisticsName |
否 |
String |
物流公司名称(包括干线物流公司等) |
| 供应商编码 |
supplierCode |
否 |
String |
供应商编码 |
| 供应商名称 |
supplierName |
否 |
String |
供应商名称 |
| 提货方式 |
transportMode |
否 |
String |
提货方式(到仓自提、快递、干线物流) |
| 提货人信息 |
pickerInfo |
否 |
data |
提货人信息 |
| 发件人信息 |
pickerInfo |
否 |
data |
发件人信息 |
| 收件人信息 |
pickerInfo |
否 |
data |
收件人信息 |
| 备注 |
remark |
否 |
String |
备注 |
| 出库单渠道类型 |
orderSourceType |
否 |
String |
出库单渠道类型,VIP=唯品会,FX=分销 ,SHOP=门店 |
| 到货时间 |
receivingTime |
否 |
String |
到货时间(YYYY-MM-DD HH:MM:SS) |
| 送货时间 |
shippingTime |
否 |
String |
送货时间(YYYY-MM-DD HH:MM:SS) |
| 入库仓库名称 |
targetWarehouseName |
否 |
String |
入库仓库名称 |
| 入库仓库编码 |
targetWarehouseCode |
否 |
String |
入库仓库编码,统仓统配等无需ERP指定仓储编码的情况填OTHER |
| 关联的入库单号 |
targetEntryOrderCode |
否 |
String |
关联的入库单号(ERP分配) |
| 仓库名称 |
warehouseName |
否 |
String |
仓库名称 |
pickerInfo
| 参数名 |
字段 |
是否必须 |
类型 |
说明 |
| 公司名称 |
company |
否 |
String |
公司名称 |
| 姓名 |
name |
否 |
String |
姓名 |
| 固定电话 |
tel |
否 |
String |
固定电话 |
| 移动电话 |
mobile |
否 |
String |
移动电话 |
| 证件号 |
id |
否 |
String |
证件号 |
| 车牌号 |
carNo |
否 |
String |
车牌号 |
senderInfo
| 参数名 |
字段 |
是否必须 |
类型 |
说明 |
| 公司名称 |
company |
否 |
String |
公司名称 |
| 姓名 |
name |
是 |
String |
姓名 |
| 邮编 |
zipCode |
否 |
String |
邮编 |
| 固定电话 |
tel |
否 |
String |
固定电话 |
| 移动电话 |
mobile |
是 |
String |
移动电话 |
| 电子邮箱 |
email |
否 |
String |
电子邮箱 |
| 国家二字码 |
countryCode |
否 |
String |
国家二字码 |
| 省份 |
province |
是 |
String |
省份 |
| 城市 |
city |
是 |
String |
城市 |
| 区域 |
area |
否 |
String |
区域 |
| 村镇 |
town |
否 |
String |
村镇 |
| 详细地址 |
tel |
是 |
String |
详细地址 |
receiverInfo
| 参数名 |
字段 |
是否必须 |
类型 |
说明 |
| 公司名称 |
company |
否 |
String |
公司名称 |
| 姓名 |
name |
是 |
String |
姓名 |
| 邮编 |
zipCode |
否 |
String |
邮编 |
| 固定电话 |
tel |
否 |
String |
固定电话 |
| 移动电话 |
mobile |
是 |
String |
移动电话 |
| 电子邮箱 |
email |
否 |
String |
电子邮箱 |
| 国家二字码 |
countryCode |
否 |
String |
国家二字码 |
| 省份 |
province |
是 |
String |
省份 |
| 城市 |
city |
是 |
String |
城市 |
| 区域 |
area |
否 |
String |
区域 |
| 村镇 |
town |
否 |
String |
村镇 |
| 详细地址 |
tel |
是 |
String |
详细地址 |
orderLines
| 参数名 |
字段 |
是否必须 |
类型 |
说明 |
| 外部业务编码 |
outBizCode |
否 |
String |
外部业务编码(消息ID;用于去重;当单据需要分批次发送时使用) |
| 单据行号 |
orderLineNo |
否 |
String |
单据行号 |
| 货主编码 |
ownerCode |
是 |
String |
货主编码 |
| 商品编码 |
itemCode |
是 |
String |
商品编码 |
| 仓储系统商品编码 |
itemId |
否 |
String |
仓储系统商品编码 |
| 库存类型 |
inventoryType |
否 |
String |
库存类型(ZP=正品;CC=残次;JS=机损;XS= 箱损;ZT=在途库存;默认为查所有类型的库存) |
| 商品名称 |
itemName |
否 |
String |
商品名称 |
| 应发商品数量 |
planQty |
否 |
String |
应发商品数量 |
| 批次编码 |
batchCode |
否 |
String |
批次编码 |
| 生产日期 |
productDate |
否 |
String |
生产日期(YYYY-MM-DD) |
| 过期日期 |
expireDate |
否 |
String |
过期日期(YYYY-MM-DD) |
| 生产批号 |
platformCode |
否 |
String |
生产批号 |
| 交易平台商品编码 |
batchCode |
否 |
String |
交易平台商品编码 |
| 单位 |
unit |
否 |
String |
单位 |
请求参数示例
<?xml version="1.0" encoding="UTF-8" ?>
<request>
<deliveryOrder>
<totalOrderLines>12</totalOrderLines>
<deliveryOrderCode>TB1234</deliveryOrderCode>
<orderType>PTCK</orderType>
<relatedOrders>
<relatedOrder>
<orderType>CG</orderType>
<orderCode>GL1234</orderCode>
</relatedOrder>
<relatedOrder>
<orderType>GC</orderType>
<orderCode>1234GL</orderCode>
</relatedOrder>
</relatedOrders>
<warehouseCode>CK1234</warehouseCode>
<createTime>2016-09-09 12:00:00</createTime>
<scheduleDate>2017-09-09</scheduleDate>
<logisticsCode>SF</logisticsCode>
<logisticsName>顺丰</logisticsName>
<supplierCode>TB</supplierCode>
<supplierName>淘宝</supplierName>
<transportMode>自提</transportMode>
<remark>备注</remark>
<orderSourceType>VIP</orderSourceType>
<receivingTime>2016-09-09 12:00:00</receivingTime>
<shippingTime>2016-09-09 12:00:00</shippingTime>
<targetWarehouseName>入库仓库名称</targetWarehouseName>
<targetWarehouseCode>OTHER</targetWarehouseCode>
<targetEntryOrderCode>123</targetEntryOrderCode>
<warehouseName>仓库名称</warehouseName>
<senderInfo>
<name>老王</name>
<province>浙江省</province>
<mobile>13214567869</mobile>
<city>杭州</city>
<detailAddress>杭州市余杭区989号</detailAddress>
</senderInfo>
<receiverInfo>
<name>李四</name>
<province>浙江省</province>
<mobile>12214567869</mobile>
<city>杭州</city>
<detailAddress>杭州市余杭区787号</detailAddress>
</receiverInfo>
<pickerInfo>
<company>天猫</company>
<name>老王</name>
<tel>897765</tel>
<mobile>123421234</mobile>
<id>123213123131</id>
<carNo>xx</carNo>
</pickerInfo>
</deliveryOrder>
<orderLines>
<orderLine>
<outBizCode>OB1234</outBizCode>
<orderLineNo>11</orderLineNo>
<ownerCode>H1234</ownerCode>
<itemCode>I1234</itemCode>
<itemId>W1234</itemId>
<inventoryType>ZP</inventoryType>
<itemName>淘公仔</itemName>
<planQty>11</planQty>
<batchCode>123</batchCode>
<productDate>2016-07-06</productDate>
<expireDate>2016-07-07</expireDate>
<produceCode>P11233</produceCode>
<platformCode>123456789</platformCode>
<unit>个</unit>
</orderLine>
<orderLine>
<outBizCode>OB1234</outBizCode>
<orderLineNo>11</orderLineNo>
<ownerCode>H1234</ownerCode>
<itemCode>I1234</itemCode>
<itemId>W1234</itemId>
<inventoryType>ZP</inventoryType>
<itemName>淘公仔</itemName>
<planQty>11</planQty>
<batchCode>123</batchCode>
<productDate>2016-07-06</productDate>
<expireDate>2016-07-07</expireDate>
<produceCode>P11233</produceCode>
<platformCode>123456789</platformCode>
<unit>个</unit>
</orderLine>
</orderLines>
<extendProps>
<xzz>111</xzz>
<hhz>222</hhz>
</extendProps>
</request>
返回示例:
正确时返回:
<?xml version="1.0" encoding="utf-8"?>
<response>
<flag>success</flag>
<code>响应码</code>
<message>响应信息</message>
<deliveryOrderId>出库单仓储系统编码</deliveryOrderId>
<createTime>订单创建时间</createTime>
</response>
错误时返回:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response>
<flag>failure</flag>
<code>failure</code>
<message>请求奇门接口失败</message>
<subCode>100002</subCode>
<subMessage>请求WMS奇门接口失败,错误原因:{"code":"TOP29","flag":"failure","message":"Invalid app Key","success":false}</subMessage>
<requestId>ace95ef4cb9a4b42b2e6812a50745b64</requestId>
</response>
备注:
文档更新时间: 2020-08-07 14:07 作者:黄会准