简要描述:

  • 出库单创建接口

接口说明:

  • 1.1接口描述:创建出库单到WMS
  • 1.2接口说明:ERP调用奇门接口,奇门调用该接口,FMS调用奇门接口往WMS创建出库单。和发货单的区别是,发货单创建是和订单相关的发货操作,而该接口是普通的货品出库,和订单无关。
  • 1.3接口方法:taobao.qimen.stockout.create

接口版本:

版本号 制定人 制定日期 修订日期
1.0.0 黄会准 2020-07-31 2020-07-31

请求URL:

环境 HTTP地址
测试环境 http://apitest.yptcgroup.com/thirdpart/dispatcher
预发布环境 http://apiuat.yptcgroup.com/thirdpart/dispatcher
正式环境 http://api.yptcgroup.com/thirdpart/dispatcher

请求方式:

  • POST

请求头:

参数名 是否必须 类型 说明
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>

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2026-06-17 09:44   作者:黄会准