淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
returnWarehouseBill	ReturnWarehouseBill	可选			退仓单
└ returnWarehouseBillId String 可选 2343243241 退仓单号 └ warehouseCode String 可选 DRF1102 仓编码 └ sourceMerchantCode String 可选 DARUNFA 来源商家编码 └ sourceNodeCode String 可选 UDDRF1001 来源配送站编码\仓编码(若存在配送站，给配送站编码；若不存在配送站，给仓编码) └ contactInfo String 可选手机号：3334443434 联系方式 └ remark String 可选退仓备注 └ isTest Boolean 可选 true 是否测试单 └ containerList String [] 可选容器列表 └ isVirtual Boolean 可选 false 是否是虚拟退仓单 skuInfoList ReverseSkuInfo [] 可选子单列表 └ reverseFulfillOrderId String 可选 4352345 逆向履约主单号 └ reverseFulfillSubOrderId String 可选 2341241324 逆向履约子单号 └ relatedFulfillOrderId String 可选 13423324 关联的正向履约单号 └ relatedFulfillSubOrderId String 可选 2435345345 关联的正向履约子单号 └ relatedSourceOrderId String 可选 4563345654 关联的正向淘系交易主单号 └ relatedSubSourceOrderId String 可选 34546436 关联的正向淘系交易子单号 └ relatedBizOrderId String 可选 3454354 关联的正向盒马交易主单号 └ relatedSubBizOrderId String 可选 324535345 关联的正向盒马交易子单号 └ reverseSaleOrderCode String 可选 5464536345 盒马逆向退货单号 └ refundId String 可选 43534 退款单号 └ orderChannel String 可选 APP 销售渠道："POS"，"APP" └ reverseOrderSource String 可选 AFTER_SALE 逆向单来源： 1,AFTER_SALE （售后退货）; 2,IN_SALE（售中取消）; └ skuCode String 可选 100344 商品编码 └ skuName String 可选可口可乐商品名称 └ stockUnit String 可选瓶库存单位 └ isStandardSku Boolean 可选 true 是否是标品：true（“标品”），false（“非标品”） └ refundStockQuantity String 可选 10 退款数量（库存单位） └ shouldFetchStockQuantity String 可选 10 应取数量（库存单位） └ enterDockStockQuantity String 可选 8 入站数量（库存单位） └ returnBoundStockQuantity String 可选 6 退仓数量（库存单位） └ customerLossStockQuantity String 可选 0 客损数量（库存单位）：退款数量-应取数量 └ riderLossStockQuantity String 可选 2 骑手损数量（库存单位）：应取数量-入站数量 └ deliveryLossStockQuantity String 可选 2 站损数量（库存单位）：入站数量-退仓数量 └ sourceSellerId String 可选 725677994 卖家id └ attribute String 可选 {"name":"zhangsan"} 扩展属性，json串 └ attribute String 可选 {"name":"zhangsan"} 扩展属性，json串

名称	类型	示例值	描述
success	Boolean	true	调用是否成功
errorCode	String	SYSTEM_ERROR	错误码
errorDesc	String	系统异常	返回码含义描述

{"returnWarehouseBill":{"returnWarehouseBillId":"2343243241","contactInfo":"手机号：3334443434","isTest":true,"containerList":[""],"sourceMerchantCode":"DARUNFA","sourceNodeCode":"UDDRF1001","remark":"退仓","isVirtual":false,"attribute":"{\"name\":\"zhangsan\"}","warehouseCode":"DRF1102","skuInfoList":[{"relatedFulfillOrderId":"13423324","relatedSubSourceOrderId":"34546436","enterDockStockQuantity":"8","isStandardSku":true,"orderChannel":"APP","reverseFulfillOrderId":"4352345","relatedSourceOrderId":"4563345654","skuName":"可口可乐","reverseOrderSource":"AFTER_SALE","shouldFetchStockQuantity":"10","customerLossStockQuantity":"0","sourceSellerId":"725677994","attribute":"{\"name\":\"zhangsan\"}","relatedSubBizOrderId":"324535345","reverseFulfillSubOrderId":"2341241324","relatedFulfillSubOrderId":"2435345345","relatedBizOrderId":"3454354","stockUnit":"瓶","refundStockQuantity":"10","riderLossStockQuantity":"2","reverseSaleOrderCode":"5464536345","returnBoundStockQuantity":"6","deliveryLossStockQuantity":"2","refundId":"43534","skuCode":"100344"}]}}

{
    "success":true,
    "errorCode":"SYSTEM_ERROR",
    "errorDesc":"系统异常"
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

菜鸟仓配API

qimen.alibaba.cainiao.whc.fulfill.do.return.warehouse.task (退仓单下发仓储系统)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ