简要描述:

  • 出库单创建接口

接口说明:

  • 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>

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2020-08-07 14:07   作者:黄会准