入库单-创建 - Powered by MinDoc

简要描述：

入库单创建接口

接口说明：

1.1接口描述：创建入库单到WMS
1.2接口说明：ERP调用奇门接口,奇门调用该接口,FMS调用奇门接口往WMS创建入库单
1.3接口方法：taobao.qimen.entryorder.create

接口版本：

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

请求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.entryorder.create
协议版本号	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 格式

请求参数:

参数名	字段	是否必须	类型	说明
入库单信息	entryOrder	是	data	入库单信息,节点下数据字段详见下述“entryOrder”
入库单详情	orderLines	是	data[]	入库单详情,节点下数据字段详见下述“orderLines”
扩展属性	extendProps	否	Map	扩展属性

entryOrder

参数名	字段	是否必须	类型	说明
入库单信息	entryOrderCode	是	String	入库单号
货主编码	ownerCode	是	String	入库单号
采购单号	purchaseOrderCode	否	String	采购单号(当orderType=CGRK时使用)
入库仓库编码	warehouseCode	是	String	入库仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER)
订单创建时间	orderCreateTime	否	String	订单创建时间(YYYY-MM-DD HH:MM:SS)
业务类型	orderType	否	String	业务类型(SCRK=生产入库;LYRK=领用入库;CCRK=残次品入库;CGRK=采购入库;DBRK=调拨入库;QTRK=其他入库;B2BRK=B2B入库;XNRK=虚拟入库;只传英文编码)
预期到货时间	expectStartTime	否	String	预期到货时间(YYYY-MM-DD HH:MM:SS)
最迟预期到货时间	expectEndTime	否	String	最迟预期到货时间(YYYY-MM-DD HH:MM:SS)
物流公司编码	logisticsCode	否	String	物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通(ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHER=其他(只传英文编码))
物流公司名称	logisticsName	否	String	物流公司名称
运单号	expressCode	否	String	运单号
供应商编码	supplierCode	否	String	供应商编码
供应商名称	supplierName	否	String	供应商名称
操作员编码	operatorCode	否	String	操作员编码
操作员名称	operatorName	否	String	操作员名称
操作时间	operateTime	否	String	操作时间(YYYY-MM-DD HH:MM:SS)
备注	remark	否	String	备注
totalOrderLines	totalOrderLines	否	String	totalOrderLines
入库仓库名称	warehouseName	否	String	入库仓库名称
出库仓库编码	sourceWarehouseCode	否	String	出库仓库编码
出库仓库名称	sourceWarehouseName	否	String	出库仓库名称
关联订单信息	relatedOrders	否	data[]	关联订单信息,节点下数据字段详见下述“relatedOrders”
发件人信息	senderInfo	否	data	发件人信息,节点下数据字段详见下述“senderInfo”
收件人信息	receiverInfo	否	data	收件人信息,节点下数据字段详见下述“receiverInfo”

relatedOrders

参数名	字段	是否必须	类型	说明
关联的订单类型	orderType	否	String	关联的订单类型(CG=采购单;DB=调拨单;CK=出库单;RK=入库单;只传英文编码)
关联的订单编号	orderCode	否	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	商品编码
仓储系统商品ID	itemId	否	String	仓储系统商品ID
商品名称	itemName	否	String	商品名称
应收商品数量	planQty	是	String	应收商品数量
商品属性	skuProperty	否	String	商品属性
采购价	purchasePrice	否	String	采购价
零售价	retailPrice	否	String	零售价
库存类型	inventoryType	否	String	库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP)
商品生产日期	productDate	否	String	商品生产日期(YYYY-MM-DD)
商品过期日期	expireDate	否	String	商品过期日期(YYYY-MM-DD)
生产批号	produceCode	否	String	生产批号
批次编码	batchCode	否	String	批次编码
单位	unit	否	String	单位
sn编码列表	snList	否	data	sn编码列表,节点下数据字段详见下述“snList”

snList

参数名	字段	是否必须	类型	说明
sn编码	sn	否	String[]	sn编码

请求参数示例

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <entryOrder>
        <entryOrderCode>E1234</entryOrderCode>
        <ownerCode>O1234</ownerCode>
        <warehouseCode>W1234</warehouseCode>
        <relatedOrders>
            <relatedOrder>
                <orderType>CG</orderType>
                <orderCode>G1234</orderCode>
            </relatedOrder>
            <relatedOrder>
                <orderType>GC</orderType>
                <orderCode>CG234</orderCode>
            </relatedOrder>
        </relatedOrders>
        <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>
    </entryOrder>
    <orderLines>
        <orderLine>
            <ownerCode>O123</ownerCode>
            <itemCode>I123</itemCode>
            <planQty>12</planQty>
            <snList>
                <sn>X1</sn>
                <sn>S2</sn>
                <sn>C3</sn>
            </snList>
        </orderLine>
        <orderLine>
            <ownerCode>O321</ownerCode>
            <itemCode>I321</itemCode>
            <planQty>21</planQty>
            <snList>
                <sn>S1</sn>
                <sn>C2</sn>
                <sn>X3</sn>
            </snList>
        </orderLine>
    </orderLines>
    <extendProps>
        <xzz>111</xzz>
        <hhz>222</hhz>
    </extendProps>
</request>

返回示例:

正确时返回:

<?xml version="1.0" encoding="utf-8"?>
<response>
 <flag>success|failure</flag>
 <code>响应码</code>
 <message>响应信息</message>
 <entryOrderId>仓储系统入库单编码</entryOrderId>
</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 作者：黄会准