淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
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。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
request	ReturnOrderConfirmRequest	可选
returnOrder ReturnOrder 可选退货单信息 └ returnOrderCode String 必须 R1234 ERP的退货入库单编码 └ returnOrderId String 可选 R1234 仓库系统订单编码 └ warehouseCode String 必须 W1234 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER) └ outBizCode String 可选 OZ1234 外部业务编码(消息ID;用于去重;ISV对于同一请求;分配一个唯一性的编码。用来保证因为网络等原因导致重复传输;请求不会被重复处理) └ orderType String 可选 THRK 单据类型(THRK=退货入库;HHRK=换货入库;只传英文编码) └ orderConfirmTime String 可选 2016-09-09 12:00:00 确认入库时间(YYYY-MM-DD HH:MM:SS) └ logisticsCode String 必须 SF 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通(ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHER=其他;只传英文编码) └ logisticsName String 可选顺丰物流公司名称 └ expressCode String 可选 YD1234 运单号 └ returnReason String 可选破损退货退货原因 └ remark String 可选备注信息备注 senderInfo SenderInfo 可选发件人信息 └ company String 可选淘宝公司名称 └ name String 必须老王姓名 └ zipCode String 可选 043300 邮编 └ tel String 可选 81020340 固定电话 └ mobile String 必须 13214567869 移动电话 └ email String 可选 345@gmail.com 电子邮箱 └ countryCode String 可选 051532 国家二字码 └ province String 必须浙江省省份 └ city String 必须杭州城市 └ area String 可选余杭区域 └ town String 可选横加桥村镇 └ detailAddress String 必须杭州市余杭区989号详细地址 └ remark String 可选备注备注 └ confirmType Number 可选 0 退货单多次入库 └ extendProps Map 可选退货单信息扩展字段 orderLines OrderLine [] 可选订单信息 └ remark String 可选备注备注 └ orderLineNo String 可选 D1234 单据行号 └ sourceOrderCode String 可选 PD1224 交易平台订单 └ subSourceOrderCode String 可选 PL1234 交易平台子订单编码 └ ownerCode String 必须 HZ1234 货主编码 └ itemCode String 必须 I1234 商品编码 └ itemId String 可选 CK1234 仓储系统商品编码(条件为提供后端（仓储系统）商品编码的仓储系统) └ inventoryType String 可选 ZP 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP) └ planQty Number 必须 12 应收商品数量 └ batchCode String 可选 P123 批次编码 └ productDate String 可选 2016-09-09 生产日期(YYYY-MM-DD) └ expireDate String 可选 2016-09-09 过期日期(YYYY-MM-DD) └ produceCode String 可选 P1234 生产批号 batchs Batch [] 可选批次信息 └ remark String 可选备注备注 └ batchCode String 可选 P1234 批次编号 └ productDate String 可选 2016-09-09 生产日期(YYYY-MM-DD) └ expireDate String 可选 2016-09-09 过期日期(YYYY-MM-DD) └ produceCode String 可选 P1234 生产批号 └ inventoryType String 可选 ZP 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP) └ actualQty Number 可选 12 实收数量(要求batchs节点下所有的实收数量之和等于orderline中的实收数量) └ extendProps Map 可选批次信息扩展属性 └ qrCode String 可选 1;1;1 商品的二维码(类似电子产品的SN码;用来进行商品的溯源;多个二维码之间用分号;隔开) └ actualQty String 必须 12 实收商品数量 snList SnList 可选 sn列表 └ sn String [] 可选 sn编码 └ extendProps Map 可选订单信息扩展字段 └ extendProps Map 可选扩展属性

名称	类型	示例值	描述
response	Response
└ flag String success 响应结果:success\|failure └ code String 0 响应码 └ message String invalid appkey 响应信息

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

QimenClient client = new DefaultQimenClient(url, appkey, secret);
ReturnorderConfirmRequest req = new ReturnorderConfirmRequest();
req.setCustomerId("stub-cust-code");
req.setVersion("2.0");
ReturnOrder obj1 = new ReturnOrder();
obj1.setOwnerCode("奇门仓储字段,说明,string(50),,");
obj1.setReturnOrderStatus("奇门仓储字段,说明,string(50),,");
obj1.setOrderFlag("奇门仓储字段,说明,string(50),,");
obj1.setSourceOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setBuyerNick("奇门仓储字段,说明,string(50),,");
obj1.setRefOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setEarliestArrivalTime("奇门仓储字段,说明,string(50),,");
obj1.setPlanArrivalTime("奇门仓储字段,说明,string(50),,");
obj1.setActionType("奇门仓储字段,说明,string(50),,");
obj1.setPreDeliveryOrderCode("奇门仓储字段,说明,string(50),,");
obj1.setPreDeliveryOrderId("奇门仓储字段,说明,string(50),,");
obj1.setSupplierCode("奇门仓储字段,说明,string(50),,");
obj1.setSupplierName("奇门仓储字段,说明,string(50),,");
obj1.setReturnOrderCode("R1234");
obj1.setReturnOrderId("R1234");
obj1.setWarehouseCode("W1234");
obj1.setOutBizCode("OZ1234");
obj1.setOrderType("THRK");
obj1.setOrderConfirmTime("2016-09-09 12:00:00");
obj1.setLogisticsCode("SF");
obj1.setLogisticsName("顺丰");
obj1.setExpressCode("YD1234");
obj1.setReturnReason("破损退货");
obj1.setRemark("备注信息");
SenderInfo obj2 = new SenderInfo();
obj2.setId("奇门仓储字段,说明,string(50),,");
obj2.setCarNo("奇门仓储字段,说明,string(50),,");
obj2.setFax("奇门仓储字段,说明,string(50),,");
obj2.setBirthDate("奇门仓储字段,说明,string(50),,");
obj2.setCareer("奇门仓储字段,说明,string(50),,");
obj2.setNick("奇门仓储字段,说明,string(50),,");
obj2.setIdType("奇门仓储字段,说明,string(50),,");
obj2.setIdNumber("奇门仓储字段,说明,string(50),,");
obj2.setCountryCodeCiq("奇门仓储字段,说明,string(50),,");
obj2.setCountryCodeCus("奇门仓储字段,说明,string(50),,");
obj2.setGender("奇门仓储字段,说明,string(50),,");
obj2.setCompany("淘宝");
obj2.setName("老王");
obj2.setZipCode("043300");
obj2.setTel("81020340");
obj2.setMobile("13214567869");
obj2.setEmail("345@gmail.com");
obj2.setCountryCode("051532");
obj2.setProvince("浙江省");
obj2.setCity("杭州");
obj2.setArea("余杭");
obj2.setTown("横加桥");
obj2.setDetailAddress("杭州市余杭区989号");
obj2.setRemark("备注");
obj1.setSenderInfo(obj2);
obj1.setConfirmType(0L);
req.setReturnOrder(obj1);
List<OrderLine> list4 = new ArrayList<OrderLine>();
OrderLine obj5 = new OrderLine();
list4.add(obj5);
obj5.setOrderSourceCode("奇门仓储字段,说明,string(50),,");
obj5.setSubSourceCode("奇门仓储字段,说明,string(50),,");
obj5.setItemName("奇门仓储字段,说明,string(50),,");
obj5.setSkuProperty("奇门仓储字段,说明,string(50),,");
obj5.setPurchasePrice("奇门仓储字段,说明,string(50),,");
obj5.setRetailPrice("奇门仓储字段,说明,string(50),,");
obj5.setExtCode("奇门仓储字段,说明,string(50),,");
obj5.setActualPrice("奇门仓储字段,说明,string(50),,");
obj5.setDiscountAmount("奇门仓储字段,说明,string(50),,");
obj5.setQuantity("奇门仓储字段,说明,string(50),,");
obj5.setOutBizCode("奇门仓储字段,说明,string(50),,");
obj5.setProductCode("奇门仓储字段,说明,string(50),,");
obj5.setStockInQty("奇门仓储字段,说明,string(50),,");
obj5.setStockOutQty("奇门仓储字段,说明,string(50),,");
obj5.setWarehouseCode("奇门仓储字段,说明,string(50),,");
obj5.setDeliveryOrderId("奇门仓储字段,说明,string(50),,");
obj5.setStatus("奇门仓储字段,说明,string(50),,");
obj5.setPayNo("奇门仓储字段,说明,string(50),,");
obj5.setTaobaoItemCode("奇门仓储字段,说明,string(50),,");
obj5.setDiscountPrice("奇门仓储字段,说明,string(50),,");
obj5.setColor("奇门仓储字段,说明,string(50),,");
obj5.setSize("奇门仓储字段,说明,string(50),,");
obj5.setStandardPrice("奇门仓储字段,说明,string(50),,");
obj5.setReferencePrice("奇门仓储字段,说明,string(50),,");
obj5.setDiscount("奇门仓储字段,说明,string(50),,");
obj5.setStandardAmount("奇门仓储字段,说明,string(50),,");
obj5.setSettlementAmount("奇门仓储字段,说明,string(50),,");
obj5.setLocationCode("奇门仓储字段,说明,string(50),,");
obj5.setAmount("奇门仓储字段,说明,string(50),,");
obj5.setMoveOutLocation("奇门仓储字段,说明,string(50),,");
obj5.setMoveInLocation("奇门仓储字段,说明,string(50),,");
obj5.setExceptionQty("奇门仓储字段,说明,string(50),,");
obj5.setSubDeliveryOrderId("奇门仓储字段,说明,string(50),,");
obj5.setRemark("备注");
obj5.setOrderLineNo("D1234");
obj5.setSourceOrderCode("PD1224");
obj5.setSubSourceOrderCode("PL1234");
obj5.setOwnerCode("HZ1234");
obj5.setItemCode("I1234");
obj5.setItemId("CK1234");
obj5.setInventoryType("ZP");
obj5.setPlanQty(12L);
obj5.setBatchCode("P123");
obj5.setProductDate("2016-09-09");
obj5.setExpireDate("2016-09-09");
obj5.setProduceCode("P1234");
Batch obj7 = new Batch();
obj7.setQuantity("奇门仓储字段,说明,string(50),,");
obj7.setRemark("备注");
obj7.setBatchCode("P1234");
obj7.setProductDate("2016-09-09");
obj7.setExpireDate("2016-09-09");
obj7.setProduceCode("P1234");
obj7.setInventoryType("ZP");
obj7.setActualQty(12L);
list6.setBatchs(obj7);
obj5.setQrCode("1;1;1");
obj5.setActualQty("12");
SnList obj9 = new SnList();
obj9.setSn("");
list8.setSnList(obj9);
req.setOrderLines(list4);
ReturnorderConfirmResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

IQimenClient client = new DefaultQimenClient(url, appkey, secret);
ReturnorderConfirmRequest req = new ReturnorderConfirmRequest();
req.CustomerId = "stub-cust-code";
req.Version = "2.0";
ReturnorderConfirmRequest.ReturnOrderDomain obj1 = new ReturnorderConfirmRequest.ReturnOrderDomain();
req.ReturnOrder_= obj1;
obj1.OwnerCode = "奇门仓储字段,说明,string(50),,";
obj1.ReturnOrderStatus = "奇门仓储字段,说明,string(50),,";
obj1.OrderFlag = "奇门仓储字段,说明,string(50),,";
obj1.SourceOrderCode = "奇门仓储字段,说明,string(50),,";
obj1.BuyerNick = "奇门仓储字段,说明,string(50),,";
obj1.RefOrderCode = "奇门仓储字段,说明,string(50),,";
obj1.EarliestArrivalTime = "奇门仓储字段,说明,string(50),,";
obj1.PlanArrivalTime = "奇门仓储字段,说明,string(50),,";
obj1.ActionType = "奇门仓储字段,说明,string(50),,";
obj1.PreDeliveryOrderCode = "奇门仓储字段,说明,string(50),,";
obj1.PreDeliveryOrderId = "奇门仓储字段,说明,string(50),,";
obj1.SupplierCode = "奇门仓储字段,说明,string(50),,";
obj1.SupplierName = "奇门仓储字段,说明,string(50),,";
obj1.ReturnOrderCode = "R1234";
obj1.ReturnOrderId = "R1234";
obj1.WarehouseCode = "W1234";
obj1.OutBizCode = "OZ1234";
obj1.OrderType = "THRK";
obj1.OrderConfirmTime = "2016-09-09 12:00:00";
obj1.LogisticsCode = "SF";
obj1.LogisticsName = "顺丰";
obj1.ExpressCode = "YD1234";
obj1.ReturnReason = "破损退货";
obj1.Remark = "备注信息";
List<ReturnorderConfirmRequest.SenderInfoDomain> list3 = new List<ReturnorderConfirmRequest.SenderInfoDomain>();
ReturnorderConfirmRequest.SenderInfoDomain obj4 = new ReturnorderConfirmRequest.SenderInfoDomain();
list3.Add(obj4);
obj1.SenderInfo_ = list3;
obj4.Id = "奇门仓储字段,说明,string(50),,";
obj4.CarNo = "奇门仓储字段,说明,string(50),,";
obj4.Fax = "奇门仓储字段,说明,string(50),,";
obj4.BirthDate = "奇门仓储字段,说明,string(50),,";
obj4.Career = "奇门仓储字段,说明,string(50),,";
obj4.Nick = "奇门仓储字段,说明,string(50),,";
obj4.IdType = "奇门仓储字段,说明,string(50),,";
obj4.IdNumber = "奇门仓储字段,说明,string(50),,";
obj4.CountryCodeCiq = "奇门仓储字段,说明,string(50),,";
obj4.CountryCodeCus = "奇门仓储字段,说明,string(50),,";
obj4.Gender = "奇门仓储字段,说明,string(50),,";
obj4.Company = "淘宝";
obj4.Name = "老王";
obj4.ZipCode = "043300";
obj4.Tel = "81020340";
obj4.Mobile = "13214567869";
obj4.Email = "345@gmail.com";
obj4.CountryCode = "051532";
obj4.Province = "浙江省";
obj4.City = "杭州";
obj4.Area = "余杭";
obj4.Town = "横加桥";
obj4.DetailAddress = "杭州市余杭区989号";
obj4.Remark = "备注";
obj1.SenderInfo= list5;
obj1.ConfirmType = 0L;
req.ReturnOrder_ = obj1;
List<ReturnorderConfirmRequest.OrderLineDomain> list7 = new List<ReturnorderConfirmRequest.OrderLineDomain>();
ReturnorderConfirmRequest.OrderLineDomain obj8 = new ReturnorderConfirmRequest.OrderLineDomain();
list7.Add(obj8);
req.OrderLines_ = list7;
obj8.OrderSourceCode = "奇门仓储字段,说明,string(50),,";
obj8.SubSourceCode = "奇门仓储字段,说明,string(50),,";
obj8.ItemName = "奇门仓储字段,说明,string(50),,";
obj8.SkuProperty = "奇门仓储字段,说明,string(50),,";
obj8.PurchasePrice = "奇门仓储字段,说明,string(50),,";
obj8.RetailPrice = "奇门仓储字段,说明,string(50),,";
obj8.ExtCode = "奇门仓储字段,说明,string(50),,";
obj8.ActualPrice = "奇门仓储字段,说明,string(50),,";
obj8.DiscountAmount = "奇门仓储字段,说明,string(50),,";
obj8.Quantity = "奇门仓储字段,说明,string(50),,";
obj8.OutBizCode = "奇门仓储字段,说明,string(50),,";
obj8.ProductCode = "奇门仓储字段,说明,string(50),,";
obj8.StockInQty = "奇门仓储字段,说明,string(50),,";
obj8.StockOutQty = "奇门仓储字段,说明,string(50),,";
obj8.WarehouseCode = "奇门仓储字段,说明,string(50),,";
obj8.DeliveryOrderId = "奇门仓储字段,说明,string(50),,";
obj8.Status = "奇门仓储字段,说明,string(50),,";
obj8.PayNo = "奇门仓储字段,说明,string(50),,";
obj8.TaobaoItemCode = "奇门仓储字段,说明,string(50),,";
obj8.DiscountPrice = "奇门仓储字段,说明,string(50),,";
obj8.Color = "奇门仓储字段,说明,string(50),,";
obj8.Size = "奇门仓储字段,说明,string(50),,";
obj8.StandardPrice = "奇门仓储字段,说明,string(50),,";
obj8.ReferencePrice = "奇门仓储字段,说明,string(50),,";
obj8.Discount = "奇门仓储字段,说明,string(50),,";
obj8.StandardAmount = "奇门仓储字段,说明,string(50),,";
obj8.SettlementAmount = "奇门仓储字段,说明,string(50),,";
obj8.LocationCode = "奇门仓储字段,说明,string(50),,";
obj8.Amount = "奇门仓储字段,说明,string(50),,";
obj8.MoveOutLocation = "奇门仓储字段,说明,string(50),,";
obj8.MoveInLocation = "奇门仓储字段,说明,string(50),,";
obj8.ExceptionQty = "奇门仓储字段,说明,string(50),,";
obj8.SubDeliveryOrderId = "奇门仓储字段,说明,string(50),,";
obj8.Remark = "备注";
obj8.OrderLineNo = "D1234";
obj8.SourceOrderCode = "PD1224";
obj8.SubSourceOrderCode = "PL1234";
obj8.OwnerCode = "HZ1234";
obj8.ItemCode = "I1234";
obj8.ItemId = "CK1234";
obj8.InventoryType = "ZP";
obj8.PlanQty = 12L;
obj8.BatchCode = "P123";
obj8.ProductDate = "2016-09-09";
obj8.ExpireDate = "2016-09-09";
obj8.ProduceCode = "P1234";
List<ReturnorderConfirmRequest.BatchDomain> list10 = new List<ReturnorderConfirmRequest.BatchDomain>();
ReturnorderConfirmRequest.BatchDomain obj11 = new ReturnorderConfirmRequest.BatchDomain();
list10.Add(obj11);
obj8.Batchs_ = list10;
obj11.Quantity = "奇门仓储字段,说明,string(50),,";
obj11.Remark = "备注";
obj11.BatchCode = "P1234";
obj11.ProductDate = "2016-09-09";
obj11.ExpireDate = "2016-09-09";
obj11.ProduceCode = "P1234";
obj11.InventoryType = "ZP";
obj11.ActualQty = 12L;
obj8.Batchs= list12;
obj8.QrCode = "1;1;1";
obj8.ActualQty = "12";
List<ReturnorderConfirmRequest.SnListDomain> list14 = new List<ReturnorderConfirmRequest.SnListDomain>();
ReturnorderConfirmRequest.SnListDomain obj15 = new ReturnorderConfirmRequest.SnListDomain();
list14.Add(obj15);
obj8.SnList_ = list14;
obj15.Sn = "";
obj8.SnList= list16;
req.OrderLines_ = list17;
ReturnorderConfirmResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new QimenReturnorderConfirmRequest;
$request = new ReturnOrderConfirmRequest;
$returnOrder = new ReturnOrder;
$returnOrder->owner_code="奇门仓储字段,说明,string(50),,";
$returnOrder->return_order_status="奇门仓储字段,说明,string(50),,";
$returnOrder->order_flag="奇门仓储字段,说明,string(50),,";
$returnOrder->source_order_code="奇门仓储字段,说明,string(50),,";
$returnOrder->buyer_nick="奇门仓储字段,说明,string(50),,";
$returnOrder->ref_order_code="奇门仓储字段,说明,string(50),,";
$returnOrder->earliest_arrival_time="奇门仓储字段,说明,string(50),,";
$returnOrder->plan_arrival_time="奇门仓储字段,说明,string(50),,";
$returnOrder->action_type="奇门仓储字段,说明,string(50),,";
$returnOrder->pre_delivery_order_code="奇门仓储字段,说明,string(50),,";
$returnOrder->pre_delivery_order_id="奇门仓储字段,说明,string(50),,";
$returnOrder->supplier_code="奇门仓储字段,说明,string(50),,";
$returnOrder->supplier_name="奇门仓储字段,说明,string(50),,";
$returnOrder->return_order_code="R1234";
$returnOrder->return_order_id="R1234";
$returnOrder->warehouse_code="W1234";
$returnOrder->out_biz_code="OZ1234";
$returnOrder->order_type="THRK";
$returnOrder->order_confirm_time="2016-09-09 12:00:00";
$returnOrder->logistics_code="SF";
$returnOrder->logistics_name="顺丰";
$returnOrder->express_code="YD1234";
$returnOrder->return_reason="破损退货";
$returnOrder->remark="备注信息";
$senderInfo = new SenderInfo;
$senderInfo->id="奇门仓储字段,说明,string(50),,";
$senderInfo->car_no="奇门仓储字段,说明,string(50),,";
$senderInfo->fax="奇门仓储字段,说明,string(50),,";
$senderInfo->birth_date="奇门仓储字段,说明,string(50),,";
$senderInfo->career="奇门仓储字段,说明,string(50),,";
$senderInfo->nick="奇门仓储字段,说明,string(50),,";
$senderInfo->id_type="奇门仓储字段,说明,string(50),,";
$senderInfo->id_number="奇门仓储字段,说明,string(50),,";
$senderInfo->country_code_ciq="奇门仓储字段,说明,string(50),,";
$senderInfo->country_code_cus="奇门仓储字段,说明,string(50),,";
$senderInfo->gender="奇门仓储字段,说明,string(50),,";
$senderInfo->company="淘宝";
$senderInfo->name="老王";
$senderInfo->zip_code="043300";
$senderInfo->tel="81020340";
$senderInfo->mobile="13214567869";
$senderInfo->email="345@gmail.com";
$senderInfo->country_code="051532";
$senderInfo->province="浙江省";
$senderInfo->city="杭州";
$senderInfo->area="余杭";
$senderInfo->town="横加桥";
$senderInfo->detail_address="杭州市余杭区989号";
$senderInfo->remark="备注";
$returnOrder->senderInfo = $senderInfo;
$returnOrder->confirm_type="0";
$returnOrder->extend_props="";
$request->returnOrder = $returnOrder;
$orderLines = new OrderLine;
$orderLines->order_source_code="奇门仓储字段,说明,string(50),,";
$orderLines->sub_source_code="奇门仓储字段,说明,string(50),,";
$orderLines->item_name="奇门仓储字段,说明,string(50),,";
$orderLines->sku_property="奇门仓储字段,说明,string(50),,";
$orderLines->purchase_price="奇门仓储字段,说明,string(50),,";
$orderLines->retail_price="奇门仓储字段,说明,string(50),,";
$orderLines->ext_code="奇门仓储字段,说明,string(50),,";
$orderLines->actual_price="奇门仓储字段,说明,string(50),,";
$orderLines->discount_amount="奇门仓储字段,说明,string(50),,";
$orderLines->quantity="奇门仓储字段,说明,string(50),,";
$orderLines->out_biz_code="奇门仓储字段,说明,string(50),,";
$orderLines->product_code="奇门仓储字段,说明,string(50),,";
$orderLines->stock_in_qty="奇门仓储字段,说明,string(50),,";
$orderLines->stock_out_qty="奇门仓储字段,说明,string(50),,";
$orderLines->warehouse_code="奇门仓储字段,说明,string(50),,";
$orderLines->delivery_order_id="奇门仓储字段,说明,string(50),,";
$orderLines->status="奇门仓储字段,说明,string(50),,";
$orderLines->pay_no="奇门仓储字段,说明,string(50),,";
$orderLines->taobao_item_code="奇门仓储字段,说明,string(50),,";
$orderLines->discount_price="奇门仓储字段,说明,string(50),,";
$orderLines->color="奇门仓储字段,说明,string(50),,";
$orderLines->size="奇门仓储字段,说明,string(50),,";
$orderLines->standard_price="奇门仓储字段,说明,string(50),,";
$orderLines->reference_price="奇门仓储字段,说明,string(50),,";
$orderLines->discount="奇门仓储字段,说明,string(50),,";
$orderLines->standard_amount="奇门仓储字段,说明,string(50),,";
$orderLines->settlement_amount="奇门仓储字段,说明,string(50),,";
$orderLines->location_code="奇门仓储字段,说明,string(50),,";
$orderLines->amount="奇门仓储字段,说明,string(50),,";
$orderLines->move_out_location="奇门仓储字段,说明,string(50),,";
$orderLines->move_in_location="奇门仓储字段,说明,string(50),,";
$orderLines->exception_qty="奇门仓储字段,说明,string(50),,";
$orderLines->sub_delivery_order_id="奇门仓储字段,说明,string(50),,";
$orderLines->remark="备注";
$orderLines->order_line_no="D1234";
$orderLines->source_order_code="PD1224";
$orderLines->sub_source_order_code="PL1234";
$orderLines->owner_code="HZ1234";
$orderLines->item_code="I1234";
$orderLines->item_id="CK1234";
$orderLines->inventory_type="ZP";
$orderLines->plan_qty="12";
$orderLines->batch_code="P123";
$orderLines->product_date="2016-09-09";
$orderLines->expire_date="2016-09-09";
$orderLines->produce_code="P1234";
$batchs = new Batch;
$batchs->quantity="奇门仓储字段,说明,string(50),,";
$batchs->remark="备注";
$batchs->batch_code="P1234";
$batchs->product_date="2016-09-09";
$batchs->expire_date="2016-09-09";
$batchs->produce_code="P1234";
$batchs->inventory_type="ZP";
$batchs->actual_qty="12";
$batchs->extend_props="";
$orderLines->batchs = $batchs;
$orderLines->qr_code="1;1;1";
$orderLines->actual_qty="12";
$snList = new SnList;
$snList->sn="";
$orderLines->snList = $snList;
$orderLines->extend_props="";
$request->orderLines = $orderLines;
$request->extend_props="";
$req->setRequest(json_encode($request));
$resp = $c->execute($req);

curl -X POST 'http://qimenapi.tbsandbox.com/router/qimen/service?app_key=testerp_appkey&customerId=stub-cust-code&format=xml&method=taobao.qimen.returnorder.confirm&sign=5A1A858558B308ACFD75DCFEEF7225BD&sign_method=md5&timestamp=2025-05-12+03%3A37%3A11&v=2.0&version=1' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
--data \
'<request>
  <orderLines>
    <itemCode>I1234</itemCode>
    <discountAmount>奇门仓储字段,说明,string(50),,</discountAmount>
    <discount>奇门仓储字段,说明,string(50),,</discount>
    <purchasePrice>奇门仓储字段,说明,string(50),,</purchasePrice>
    <itemName>奇门仓储字段,说明,string(50),,</itemName>
    <qrCode>1;1;1</qrCode>
    <orderSourceCode>奇门仓储字段,说明,string(50),,</orderSourceCode>
    <deliveryOrderId>奇门仓储字段,说明,string(50),,</deliveryOrderId>
    <stockInQty>奇门仓储字段,说明,string(50),,</stockInQty>
    <inventoryType>ZP</inventoryType>
    <subSourceCode>奇门仓储字段,说明,string(50),,</subSourceCode>
    <productDate>2016-09-09</productDate>
    <itemId>CK1234</itemId>
    <batchs>
      <produceCode>P1234</produceCode>
      <inventoryType>ZP</inventoryType>
      <quantity>奇门仓储字段,说明,string(50),,</quantity>
      <batchCode>P1234</batchCode>
      <remark>备注</remark>
      <expireDate>2016-09-09</expireDate>
      <productDate>2016-09-09</productDate>
      <actualQty>12</actualQty>
    </batchs>
    <extCode>奇门仓储字段,说明,string(50),,</extCode>
    <size>奇门仓储字段,说明,string(50),,</size>
    <sourceOrderCode>PD1224</sourceOrderCode>
    <locationCode>奇门仓储字段,说明,string(50),,</locationCode>
    <status>奇门仓储字段,说明,string(50),,</status>
    <planQty>12</planQty>
    <color>奇门仓储字段,说明,string(50),,</color>
    <actualPrice>奇门仓储字段,说明,string(50),,</actualPrice>
    <ownerCode>HZ1234</ownerCode>
    <discountPrice>奇门仓储字段,说明,string(50),,</discountPrice>
    <stockOutQty>奇门仓储字段,说明,string(50),,</stockOutQty>
    <remark>备注</remark>
    <actualQty>12</actualQty>
    <warehouseCode>奇门仓储字段,说明,string(50),,</warehouseCode>
    <skuProperty>奇门仓储字段,说明,string(50),,</skuProperty>
    <payNo>奇门仓储字段,说明,string(50),,</payNo>
    <produceCode>P1234</produceCode>
    <referencePrice>奇门仓储字段,说明,string(50),,</referencePrice>
    <taobaoItemCode>奇门仓储字段,说明,string(50),,</taobaoItemCode>
    <expireDate>2016-09-09</expireDate>
    <amount>奇门仓储字段,说明,string(50),,</amount>
    <orderLineNo>D1234</orderLineNo>
    <quantity>奇门仓储字段,说明,string(50),,</quantity>
    <exceptionQty>奇门仓储字段,说明,string(50),,</exceptionQty>
    <batchCode>P123</batchCode>
    <standardPrice>奇门仓储字段,说明,string(50),,</standardPrice>
    <subDeliveryOrderId>奇门仓储字段,说明,string(50),,</subDeliveryOrderId>
    <subSourceOrderCode>PL1234</subSourceOrderCode>
    <moveOutLocation>奇门仓储字段,说明,string(50),,</moveOutLocation>
    <standardAmount>奇门仓储字段,说明,string(50),,</standardAmount>
    <productCode>奇门仓储字段,说明,string(50),,</productCode>
    <outBizCode>奇门仓储字段,说明,string(50),,</outBizCode>
    <moveInLocation>奇门仓储字段,说明,string(50),,</moveInLocation>
    <snList/>
    <settlementAmount>奇门仓储字段,说明,string(50),,</settlementAmount>
    <retailPrice>奇门仓储字段,说明,string(50),,</retailPrice>
  </orderLines>
  <returnOrder>
    <orderType>THRK</orderType>
    <buyerNick>奇门仓储字段,说明,string(50),,</buyerNick>
    <ownerCode>奇门仓储字段,说明,string(50),,</ownerCode>
    <remark>备注信息</remark>
    <supplierCode>奇门仓储字段,说明,string(50),,</supplierCode>
    <warehouseCode>W1234</warehouseCode>
    <preDeliveryOrderId>奇门仓储字段,说明,string(50),,</preDeliveryOrderId>
    <returnReason>破损退货</returnReason>
    <returnOrderId>R1234</returnOrderId>
    <expressCode>YD1234</expressCode>
    <confirmType>0</confirmType>
    <planArrivalTime>奇门仓储字段,说明,string(50),,</planArrivalTime>
    <supplierName>奇门仓储字段,说明,string(50),,</supplierName>
    <refOrderCode>奇门仓储字段,说明,string(50),,</refOrderCode>
    <preDeliveryOrderCode>奇门仓储字段,说明,string(50),,</preDeliveryOrderCode>
    <logisticsCode>SF</logisticsCode>
    <orderConfirmTime>2016-09-09 12:00:00</orderConfirmTime>
    <returnOrderStatus>奇门仓储字段,说明,string(50),,</returnOrderStatus>
    <logisticsName>顺丰</logisticsName>
    <actionType>奇门仓储字段,说明,string(50),,</actionType>
    <earliestArrivalTime>奇门仓储字段,说明,string(50),,</earliestArrivalTime>
    <senderInfo>
      <area>余杭</area>
      <zipCode>043300</zipCode>
      <career>奇门仓储字段,说明,string(50),,</career>
      <idType>奇门仓储字段,说明,string(50),,</idType>
      <gender>奇门仓储字段,说明,string(50),,</gender>
      <town>横加桥</town>
      <city>杭州</city>
      <mobile>13214567869</mobile>
      <countryCodeCus>奇门仓储字段,说明,string(50),,</countryCodeCus>
      <remark>备注</remark>
      <idNumber>奇门仓储字段,说明,string(50),,</idNumber>
      <birthDate>奇门仓储字段,说明,string(50),,</birthDate>
      <nick>奇门仓储字段,说明,string(50),,</nick>
      <province>浙江省</province>
      <carNo>奇门仓储字段,说明,string(50),,</carNo>
      <countryCode>051532</countryCode>
      <name>老王</name>
      <detailAddress>杭州市余杭区989号</detailAddress>
      <company>淘宝</company>
      <tel>81020340</tel>
      <id>奇门仓储字段,说明,string(50),,</id>
      <fax>奇门仓储字段,说明,string(50),,</fax>
      <countryCodeCiq>奇门仓储字段,说明,string(50),,</countryCodeCiq>
      <email>345@gmail.com</email>
    </senderInfo>
    <returnOrderCode>R1234</returnOrderCode>
    <outBizCode>OZ1234</outBizCode>
    <sourceOrderCode>奇门仓储字段,说明,string(50),,</sourceOrderCode>
    <orderFlag>奇门仓储字段,说明,string(50),,</orderFlag>
  </returnOrder>
</request>'

# -*- coding: utf-8 -*-
import top.api

req=top.api.QimenReturnorderConfirmRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.request="数据结构示例JSON格式"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.qimen.returnorder.confirm");
add_param(pRequest,"request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.qimen.returnorder.confirm', {
	'request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<response>
    <flag>success</flag>
    <code>0</code>
    <message>invalid appkey</message>
</response>

{
    "response":{
        "flag":"success",
        "code":"0",
        "message":"invalid appkey"
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isp.http-connection-timeout
isp.http-read-timeout

API测试工具错误码查询工具 SDK下载

开放平台

奇门仓储API

taobao.qimen.returnorder.confirm (退货入库单确认接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ