淘宝开放平台 - 文档中心

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	更多限制	描述
orderLines	OrderLines []	可选	最大列表长度：999999	单据信息
└ itemCode String 必须 10000902453384 商品编码(银泰SKU） └ inventoryType String 必须 ZP 库存类型(ZP=正品;CC=残次;JS=机损;XS= 箱损;ZT=在途库存;默认为查所有类型的库存) └ itemId String 必须 10000902453384 仓储系统商品编码（outId) └ sourceOrderCode String 必须 WZ0179198740004 交易平台-订单查询-渠道订单号 └ planQty String 必须 2 应发商品数量 └ ownerCode String 必须 2627399 货主编码(门店-专柜) └ orderLineNo String 必须 202109060395739682_2 单据行号 └ subSourceOrderCode String 必须 202109060395739682 交易平台子订单编码（不推荐使用） └ itemName String 可选 XXXX 商品名称 └ outBizCode String 可选 XXX 业务标记 └ subDeliveryOrderId String 必须 12312 子发货单信息（不推荐使用） └ amount String 可选 50 商品金额（核销金额） └ skuProperty String 可选 {} SKU属性（不推荐使用）
deliveryOrder	DeliveryOrder	可选		发货信息
└ orderType String 必须 JYCK 出库单类型(JYCK=一般交易出库;HHCK=换货出库;BFCK=补发出库;QTCK=其他出库单) └ operateTime String 可选 2021-09-06 17:54:26 当前状态操作时间(YYYY-MM-DD HH:MM:SS) └ shopNick String 可选银泰百货店铺名称 └ orderSourceCode String 可选 20210906039573XXXX 店铺名称 └ totalOrderLines String 可选 2 总行数 └ ownerCode String 必须 2627399 货主信息 └ deliveryOrderCode String 必须 2021090605122XXXX 发货单号（一笔订单可能存在多笔发货单，以发货单推送的商品进行发货） └ operatorCode String 可选 OFC 操作人编码 └ operatorName String 可选 OFC 操作人名称 └ sourcePlatformName String 必须温州世贸店(WZ世贸) 订单来源平台名称 └ actualAmount String 可选 697 实际金额(元) └ createTime String 必须 2021-09-06 17:54:26 创建时间 └ payTime String 必须 2021-09-06 17:54:08 支付时间 └ sourcePlatformCode String 必须 139905 订单来源平台编码 └ sourceOrderCode String 必须 WZ0179198740004 交易平台-订单查询-渠道订单号 └ transportMode String 必须 OFFLINESALE 发货类型，一般为EXPRESS receiverInfo ReceiverInfo 可选收件人信息 └ area String 可选朝阳区区域 └ city String 必须北京市城市 └ mobile String 可选 18XXXXXX 手机号 └ detailAddress String 必须某小区某楼某门牌地址 └ name String 必须张XXX 姓名 └ province String 必须北京市省 └ town String 可选 “” 镇 └ zipCode String 可选 10000 邮编（不一定存在） └ secretDetailAddress String 可选 ** 加密详细地址 └ secretName String 可选 * 加密收件人姓名 └ secretMobile String 可选 * 加密收件人电话 └ ewaybillOrderCode String 可选 ** 视频号代发的订单密文（只有微信视频号订单存在） └ ewaybillOrderAppid String 可选 wx888888888 视频号代发的订单所属店铺appid（只有微信视频号订单存在） └ oaid String 可选 YWRlM2IxABT...63jsQ== 京东代发的订单密文，长度在150-200位左右 └ jdShopId String 可选 20084366 京东代发的订单所属店铺商家id └ jdOrderId String 可选 313888888888 京东代发的订单京东渠道订单号 └ warehouseCode String 必须 358322 仓库编码 └ placeOrderTime String 必须 2021-09-06 17:54:15 下单时间 └ payNo String 必须 WZ0179198740004 支付平台交易号 └ quantity String 必须 3 数量 └ warehouseAddressCode String 可选 358322 仓库标识（不推荐使用） └ senderInfo String 可选 {} 发送人信息（不推荐使用） └ scheduleDate String 可选 2021-09-06 17:54:26quantity 承诺打包时间（一般不要比这个时间发货晚） └ orderFlag String 可选 “” 订单标记, 目前只有 PRESELL（预售） └ logisticsCode String 可选 "" 期望的物流公司 └ buyerMessage String 可选 “” 购买备注信息（一般为空） deliveryRequirements DeliveryRequirements 可选 {} 配送要求（不推荐使用） └ deliveryType String 可选 “” 配送类型 └ scheduleDay String 可选 2021-09-06 17:54:26 配送日期 └ scheduleEndTime String 可选 2021-09-06 17:54:26 结束时间 └ scheduleStartTime String 可选 2021-09-06 17:54:26 开始时间 └ scheduleType String 可选 1 配送方式 └ supplierCode String 可选 123456 供应商ID

名称	类型	示例值	描述
deliveryOrderId	String	64652868	出仓编号（供应商内部唯一编号）
errorMsg	String	错误信息	错误信息
errorCode	String	错误编码	错误编码
success	Boolean	false	是否请求成功

{"orderLines":[{"inventoryType":"ZP","planQty":"2","orderLineNo":"202109060395739682_2","amount":"50","ownerCode":"2627399","itemCode":"10000902453384","subDeliveryOrderId":"12312","subSourceOrderCode":"202109060395739682","skuProperty":"{}","itemId":"10000902453384","itemName":"XXXX","outBizCode":"XXX","sourceOrderCode":"WZ0179198740004"}],"deliveryOrder":{"deliveryRequirements":{"scheduleType":"1","deliveryType":"“”","scheduleDay":"2021-09-06 17:54:26","scheduleEndTime":"2021-09-06 17:54:26","scheduleStartTime":"2021-09-06 17:54:26"},"orderType":"JYCK","ownerCode":"2627399","payTime":"2021-09-06 17:54:08","operateTime":"2021-09-06 17:54:26","receiverInfo":{"area":"朝阳区","zipCode":"10000","secretName":"***","town":"“”","city":"北京市","mobile":"18XXXXXX","ewaybillOrderAppid":"wx888888888","ewaybillOrderCode":"****","jdShopId":"20084366","secretMobile":"***","province":"北京市","secretDetailAddress":"****","name":"张XXX","detailAddress":"某小区某楼某门牌","oaid":"YWRlM2IxABT...63jsQ==","jdOrderId":"313888888888"},"deliveryOrderCode":"2021090605122XXXX","supplierCode":"123456","operatorCode":"OFC","operatorName":"OFC","sourcePlatformName":"温州世贸店(WZ世贸)","warehouseCode":"358322","placeOrderTime":"2021-09-06 17:54:15","shopNick":"银泰百货","payNo":"WZ0179198740004","orderSourceCode":"20210906039573XXXX","scheduleDate":"2021-09-06 17:54:26quantity","totalOrderLines":"2","quantity":"3","actualAmount":"697","logisticsCode":"\"\"","buyerMessage":"“”","senderInfo":"{}","sourcePlatformCode":"139905","createTime":"2021-09-06 17:54:26","sourceOrderCode":"WZ0179198740004","orderFlag":"“”","transportMode":"OFFLINESALE","warehouseAddressCode":"358322"}}

{
    "deliveryOrderId":"64652868",
    "errorMsg":"错误信息",
    "errorCode":"错误编码",
    "success":false
}

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

错误码	错误描述	解决方案
isp.http-read-timeout
response-body-parse-error

错误码查询工具 SDK下载

开放平台

银泰开放平台

qimen.alibaba.mos.order.delivery.create (银泰-履约-发货通知下发)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ