文档中心 > API类目 > SCM WMS API

qimen.tmall.luxury.wms.order.send (订单下发给wms)

订单下发给wms

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
ownerUserId	String	必须	3793607024		货主ID
ownerUserName	String	可选	天猫奢品官方直营店		货主名称
storeCode	String	必须	4563		仓储编码
orderCode	String	可选	1255		仓储中心订单编码
orderSourceCode	String	必须	1255		外部单据号
orderType	Number	必须	302		单据类型： 201 交易出库单502 换货出库单
userId	String	可选	450100374		店铺id
userName	String	可选	天猫奢品官方直营店		店铺名称
prevOrderCode	String	可选	1254		关联的前一个订单
bizLine	Number	可选	1		订单业务线，如果不传则默认4PL F_PL(1, "4PL") T_PL(2, "3PL") MLH(3, "魅力惠") UNKNOWN(-1, "错误入参")
serviceItemId	String	可选	5000000000012		服务商品id
orderFlag	String	可选	presell		仓库订单需要履行服务标识： 1: cod –货到付款 2: limit-限时配送 3: presell-预售 4:invoiceinfo-需要发票 8:退换货 9:上门服务 10: 不可改配送方式 12: 买家家承担运费 20: 使用干配服务 22：配送方式 32：标识期货预售的预发货单 34：生鲜－常温服务标 35：生鲜－冷链服务标 36：退货时同时换货 37：负卖 38：高值订单 39：环保配送 40：预约配送
orderSource	Number	可选	214		订单来源（213 天猫，201 淘宝，214 京东，202 1688 阿里中文站，203 苏宁在线，204 亚马逊中国，205 当当，208 1号店，207 唯品会，209 国美在线，210 拍拍，206 易贝ebay，211 聚美优品，212 乐蜂网，215 邮乐，216 凡客，217 优购，218 银泰，219 易讯，221 聚尚网，222 蘑菇街，223 POS门店，301 其他不在范围之内请忽略）
tradeType	Number	可选	201		201, "淘宝交易" 202, "其他交易" 503, "补发出库" 1, "非交易"
orderCreateTime	String	必须	2019-03-28 06:16:30		订单创建时间(格式为 YYYY-MM-DD HH:mm:ss)
orderPayTime	String	可选	2019-03-28 06:16:30		订单支付时间(格式为 YYYY-MM-DD HH:mm:ss)
orderExaminationTime	String	可选	2019-03-28 06:16:30		订单审核时间(格式为 YYYY-MM-DD HH:mm:ss)
orderShopCreateTime	String	可选	2019-03-28 06:16:30		前台交易创建时间(格式为 YYYY-MM-DD HH:mm:ss)
orderAmount	Number	可选	32112		订单金额（=总商品金额-订单优惠金额+快递费用），单位分币种为美元时是美分
discountAmount	Number	可选	1231		订单优惠金额，单位分币种为美元时是美分
arAmount	Number	可选	1234		订单应收金额，消费者还需要付多少钱，单位分币种为美元时是美分
gotAmount	Number	可选	1234		订单已收金额，消费者已经支付多少钱，单位分币种为美元时是美分
postfee	Number	可选	1234		快递费用，单位分币种为美元时是美分
serviceFee	Number	可选	1234		服务费，单位分，例如COD币种为美元时是美分
tmsServiceCode	String	可选	456321		配送编码
tmsServiceName	String	可选	顺丰快递		配送公司名称
tmsOrderCode	String	可选	asd-123456		运单号，指定运单号发货业务
tmsOrderUrl	String	可选	https://www.baidu.com/		面单rul
transportType	String	可选	禁小刀		快递限制
expressNoMark	String	可选	456123		顺丰地区编码
deliverRequirements	DeliverRequirements	可选			配送要求
└ expectEndTime String 可选 123456789 预期送达结束日期（格式为 YYYYMMDD) └ expectStartTime String 可选 123456789 预期送达开始日期（格式为 YYYYMMDD) └ scheduleEnd String 可选 123456789 送达结束时间（格式为 hh:mm:ss） └ scheduleStart String 可选 123456789 送达开始时间（格式为 hh:mm:ss） └ scheduleDay String 可选 123456789 送达日期（格式为 YYYYMMDD) └ scheduleType Number 可选 123456789 投递时延要求( 11-工作日 2 -节假日 101当日达 102次晨达 103次日达 111 活动标 104 预约达 10101 当日下午达 10102 当日夜间达 10301 次日上午达 )
receiverInfo	ReceiverInfo	必须			收货方信息一般是本地语言
└ receiverWangwang String 可选 123456789 收件人旺旺 └ receiverMobile String 可选 123456789 收件人手机，手机和电话不会同时为空 └ receiverPhone String 可选 123456789 收件人电话，手机和电话不会同时为空 └ buyerId String 可选 123456789 买家id └ receiverNick String 可选 123456789 收件人昵称 └ receiverName String 必须 123456789 收件人名称 └ receiverAddress String 必须 123456789 收件方详情地址，不包含省、市、区、街道信息 └ receiverDivisionId String 可选 123456789 收件方最小区划ID，四级地址ID └ receiveTown String 可选 123456789 收件方镇 └ receiverArea String 可选 123456789 收件方区县，市与区不会同时为空 └ receiverCity String 可选 123456789 收件方城市，市与区不会同时为空 └ receiverProvince String 可选 123456789 收件方省份国际地址可能没有 └ receiverCountry String 可选 123456789 收件方国家 └ receiverZipCode String 可选 123456789 收件方邮编
uniReceiverInfo	ReceiverInfo	可选			通用收货方信息一般是英语
└ receiverPhone String 可选 123456789 收件人电话，手机和电话不会同时为空 └ receiverMobile String 可选 123456789 收件人手机，手机和电话不会同时为空 └ receiverWangwang String 可选 123456789 收件人旺旺 └ buyerId String 可选 123456789 买家id └ receiverNick String 可选 123456789 收件人昵称 └ receiverName String 可选 123456789 收件人名称 └ receiverAddress String 可选 123456789 收件方详情地址，不包含省、市、区、街道信息 └ receiverDivisionId String 可选 123456789 收件方最小区划ID，四级地址ID └ receiveTown String 可选 123456789 收件方镇 └ receiverArea String 可选 123456789 收件方区县，市与区不会同时为空 └ receiverCity String 可选 123456789 收件方城市，市与区不会同时为空 └ receiverProvince String 可选 123456789 收件方省份国际地址可能没有 └ receiverCountry String 可选 123456789 收件方国家 └ receiverZipCode String 可选 123456789 收件方邮编
senderInfo	SenderInfo	可选			发货方信息
└ senderPhone String 可选 123456789 发件人电话，手机和电话不会同时为空 └ senderMobile String 可选 123456789 发件人手机，手机和电话不会同时为空 └ senderEmail String 可选 123456789 发送方电子邮件 └ senderName String 必须 123456789 发件方名称 └ senderDivisionId String 可选 123456789 发件方最小区划ID └ senderAddress String 必须 123456789 发件方详情地址，不包含省、市、区、街道信息 └ senderTown String 可选 123456789 发件方镇村 └ senderArea String 可选 123456789 发件方区县，市与区不会同时为空 └ senderCity String 可选 123456789 发件方城市，市与区不会同时为空 └ senderProvince String 可选 123456789 发件方省份国际地址可能没有 └ senderCountry String 可选 123456789 发件方国家 └ senderZipCode String 可选 123456789 发件方邮编
timeZone	String	可选	+0800		时区格式如 +0800
currency	String	可选	123456789		币种如CNY USD
invoiceInfoList	InvoiceItem []	可选		最大列表长度：999	发票信息列表
detailList ItemDetail [] 可选发票明细列表,发票内容和明细二选一 └ taxAmount String 可选 123456789 税额 └ taxCode String 可选 123456789 税收编码 └ taxRate String 可选 123456789 税率(增值发票必填) └ amount String 可选 123456789 发票明细总金额,单位分 └ quantity Number 可选 123456789 数量 └ price String 可选 123456789 单价,单位分(增值税发票可以为空) └ unit String 可选 123456789 数量单位 └ specificModel String 可选 123456789 规格型号 └ itemName String 可选 123456789 商品名称 └ billContent String 可选 123456789 发票内容,发票内容和明细二选一 └ buyerBankAccount String 可选 123456789 购方开户行及帐号 └ buyerAddrPhone String 可选 123456789 购方地址、电话 └ taxNumber String 可选 123456789 税号 └ buyerNo String 可选 123456789 购方纳税人识别号 └ billNumber String 可选 123456789 发票号码 └ billCode String 可选 123456789 发票代码 └ billAccount String 可选 123456789 发票金额，单位：分 └ billTitle String 可选 123456789 发票抬头 └ billId Number 可选 123456789 发票ID，发票去重使用，一个订单可以有多张发票，LBX+ billId是唯一的 └ billType String 可选 123456789 发票类型(1营业税发票（普通）3增值税发票)
orderItemList	WmsConsignOrderItem []	必须		最大列表长度：999	订单商品列表
└ extendFields String 可选 123456789 拓展属性数据 └ extProperties String 可选 123456789 超大报文扩展属性 └ attribute String 可选 123456789 扩展字段下发wms └ features String 可选 123456789 商品销售属性 └ batchRemark String 可选 123456789 批次备注 └ itemVersion Number 可选 123456789 商品版本 └ discountAmount Number 可选 123456789 商品优惠金额 └ taxRate String 可选 123456789 税率，单位%，保留2位小数 └ itemPrice Number 可选 123456789 商品销售价格 └ actualPrice Number 可选 123456789 商品实际价格 └ itemQuantity Number 必须 123456789 商品数量 └ inventoryType Number 必须 123456789 库存类型(1 正品 ) └ purchaseOrderCode String 可选 123456789 采购单号，是批次属性，指定PO发货 └ batchProductQuantity Number 可选 123456789 批次商品数量 └ guaranteeUnit Number 可选 123456789 保质期单位 └ guaranteePeriod Number 可选 123456789 保质期 └ produceCode String 可选 123456789 产品批号 └ produceArea String 可选 123456789 生产地区 └ dueDate String 可选 123456789 到效日期,保质期商品信息，如果商品启用了保质期管理，需要仓库按指定保质期生产指定批次发货，目前是俪人购，喵生鲜业务，一般不会指定 └ produceDate String 可选 123456789 生产日期,保质期商品信息，如果商品启用了保质期管理，需要仓库按指定保质期生产指定批次发货，目前是俪人购，喵生鲜业务，一般不会指定 └ itemFlag Number 可选 123456789 商品标识 └ pictureUrl String 可选 123456789 商品图片url └ batchCode String 可选 123456789 批次号指定批次发货，目前是俪人购，喵生鲜业务，一般不会指定 └ poNo String 可选 123456789 采购单号 └ barCode String 可选 123456789 条形码 └ provideUserNick String 可选 123456789 供应商昵称 └ provideUserID Number 可选 123456789 供应商id └ distributorUserNick String 可选 123456789 分销商昵称 └ distributorUserId Number 可选 123456789 分销商id └ itemCode String 可选 123456789 商家对商品的编码 └ storeCode String 必须 123456789 仓储编码 └ itemName String 可选 123456789 商品名称 └ subSourceCode String 必须 123456789 子交易编码 └ itemId String 必须 123456789 商品ID └ orderSourceCode String 必须 123456789 外部单据号 └ orderCode String 可选 123456789 仓储中心订单编码 └ orderItemId String 可选 123456789 订单明细编码
packageRequirements	WmsConsignOrderPackageRequirement []	可选		最大列表长度：999	包装要求
└ priority String 可选 123456789 优先级 1最高，10最低。 └ materialGroup String 可选 123456789 包材分组 └ materialClass String 可选 123456789 包材分类 └ materialTypes String 可选 123456789 所有可用的包材编码列出，以逗号分隔
properties	String	可选	{"key":"value"}		公有扩展属性，会直接透传WMS
privateProperties	String	可选	{"key":"value"}		附带透传属性列表,支持下发仓，做扩展支持
extendFields	String	可选	{"key":"value"}		拓展属性数据
tmsExtendFields	String	可选	{"key":"value"}		拓展属性数据
remark	String	可选	备注		备注

响应参数

名称	类型	示例值	描述
result	ResultDO		结果
└ data String xxxxx 返回数据 └ errorMessage String 报文解析异常*** 错误信息 └ errorCode String 405 错误码 └ success Boolean false 是否成功

请求示例

{"orderType":302,"deliverRequirements":{"scheduleStart":"123456789","scheduleType":123456789,"expectEndTime":"123456789","expectStartTime":"123456789","scheduleDay":"123456789","scheduleEnd":"123456789"},"tmsExtendFields":"{\"key\":\"value\"}","orderItemList":[{"distributorUserId":123456789,"extProperties":"123456789","actualPrice":123456789,"dueDate":"123456789","itemCode":"123456789","discountAmount":123456789,"batchProductQuantity":123456789,"features":"123456789","produceCode":"123456789","produceDate":"123456789","itemName":"123456789","purchaseOrderCode":"123456789","poNo":"123456789","extendFields":"123456789","orderSourceCode":"123456789","attribute":"123456789","inventoryType":123456789,"itemQuantity":123456789,"orderItemId":"123456789","itemVersion":123456789,"pictureUrl":"123456789","batchCode":"123456789","provideUserNick":"123456789","subSourceCode":"123456789","distributorUserNick":"123456789","barCode":"123456789","taxRate":"123456789","itemId":"123456789","batchRemark":"123456789","produceArea":"123456789","itemFlag":123456789,"provideUserID":123456789,"itemPrice":123456789,"guaranteePeriod":123456789,"orderCode":"123456789","guaranteeUnit":123456789,"storeCode":"123456789"}],"receiverInfo":{"receiverWangwang":"123456789","receiverName":"123456789","receiverMobile":"123456789","receiverArea":"123456789","receiverProvince":"123456789","buyerId":"123456789","receiverCity":"123456789","receiverNick":"123456789","receiverAddress":"123456789","receiverDivisionId":"123456789","receiverPhone":"123456789","receiverCountry":"123456789","receiverZipCode":"123456789","receiveTown":"123456789"},"postfee":1234,"discountAmount":1231,"remark":"备注","bizLine":1,"tmsServiceCode":"456321","tmsOrderCode":"asd-123456","orderAmount":32112,"orderSourceCode":"1255","extendFields":"{\"key\":\"value\"}","ownerUserName":"天猫奢品官方直营店","gotAmount":1234,"expressNoMark":"456123","transportType":"禁小刀","uniReceiverInfo":{"receiverWangwang":"123456789","receiverName":"123456789","receiverMobile":"123456789","receiverArea":"123456789","receiverProvince":"123456789","buyerId":"123456789","receiverCity":"123456789","receiverNick":"123456789","receiverAddress":"123456789","receiverDivisionId":"123456789","receiverPhone":"123456789","receiverCountry":"123456789","receiverZipCode":"123456789","receiveTown":"123456789"},"currency":"123456789","tradeType":201,"arAmount":1234,"serviceItemId":"5000000000012","serviceFee":1234,"orderSource":214,"invoiceInfoList":[{"billAccount":"123456789","buyerBankAccount":"123456789","buyerNo":"123456789","billId":123456789,"billType":"123456789","detailList":[{"taxRate":"123456789","amount":"123456789","unit":"123456789","itemName":"123456789","quantity":123456789,"price":"123456789","specificModel":"123456789","taxAmount":"123456789","taxCode":"123456789"}],"taxNumber":"123456789","billCode":"123456789","billTitle":"123456789","billContent":"123456789","billNumber":"123456789","buyerAddrPhone":"123456789"}],"orderCreateTime":"2019-03-28 06:16:30","timeZone":"+0800","tmsServiceName":"顺丰快递","tmsOrderUrl":"https://www.baidu.com/","privateProperties":"{\"key\":\"value\"}","userName":"天猫奢品官方直营店","userId":"450100374","senderInfo":{"senderPhone":"123456789","senderName":"123456789","senderAddress":"123456789","senderTown":"123456789","senderEmail":"123456789","senderMobile":"123456789","senderProvince":"123456789","senderDivisionId":"123456789","senderZipCode":"123456789","senderCountry":"123456789","senderCity":"123456789","senderArea":"123456789"},"orderExaminationTime":"2019-03-28 06:16:30","orderShopCreateTime":"2019-03-28 06:16:30","ownerUserId":"3793607024","orderFlag":"presell","orderCode":"1255","orderPayTime":"2019-03-28 06:16:30","prevOrderCode":"1254","packageRequirements":[{"materialClass":"123456789","materialGroup":"123456789","materialTypes":"123456789","priority":"123456789"}],"properties":"{\"key\":\"value\"}","storeCode":"4563"}

响应示例

{
    "result":{
        "data":"xxxxx",
        "errorMessage":"报文解析异常***",
        "errorCode":"405",
        "success":false
    }
}

验签示例

{"result":{"success":"false","errorMessage":"Illegal request","errorCode":"sign-check-failure"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

SCM WMS API

qimen.tmall.luxury.wms.order.send (订单下发给wms)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ