淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
return_out_store_confirm_order	ReturnOutStoreConfirmOrder	必须			退货出库订单回传
└ tnum Number 可选 1 总箱数 └ order_code String 必须 986504798855761920 仓库订单编码 └ order_type String 必须 901 订单类型 └ order_source String 可选 1 订单来源 └ tweight Number 可选 0 总重量 └ tms_code String 可选 TMS001 快递编码，出库方式为快递时，该字段值不为空 └ end_flag String 可选 1 标记位，单正常完成还是异常 order_items OrderItem [] 必须订单商品信息 items Item [] 可选商品属性列表 └ produce_date String 可选 2018-04-04 00:00:00 生产日期YYYY-MM-DD hh:mm:ss └ type_name String 可选散箱出库类型名称 └ produce_code String 可选 Z020202001 生产编码,同一商品可能因商家有不同编码。 └ produce_area String 可选广东广州生产地区 └ guarantee_unit Number 可选 1 保质期单位 └ guarantee_period Number 可选 180 保质期，默认以天为单位 └ due_date String 可选 2020-11-21 00:00:00 到货日期 └ batch_code String 可选 1013329 批次号 └ quantity Number 必须 100 数量 └ inventory_type Number 必须 101 库存类型 └ item_id String 必须 981369542456774656 商品编号 └ sl_tz Number 可选 32 发货数量 └ batch_id String 可选 5325345 批次号 └ stck_in_date Date 可选 2019-12-01 00:00:00 入库时间 └ receipt_number String 可选 32323 单据报名就安排 └ specification String 可选 32323 规格 └ item_code String 可选 253345 商品编码 └ remark String 可选这是备注备注 └ total_qty Number 可选 23 批次库存总量 └ item_line_no Number 可选 1 单据行号 └ diff_reason String 可选 43434 差异原因 └ sn_code String 可选 32323 sn编码 └ is_completed Boolean 可选 true 是否完成 └ own_user_id String 可选 123456 货主ID └ order_item_id String 必须 986504906230075392 order_item_id └ length Number 可选 32 长单位 mm 采购入库单、普通入库单必传 └ height Number 可选 42 高单位 mm 采购入库单、普通入库单必传 └ weight Number 可选 2 宽单位 mm 采购入库单、普通入库单必传 └ volume Number 可选 14 体积单位立方厘米采购入库单、普通入库单必传向上取整 └ return_order_no String 可选 111111 待删除 └ logistics_code String 可选 111111 物流单号 └ po_no String 可选 poNo poNo └ own_user_id String 可选 123456 货主ID └ out_mode String 可选 1 出库方式 └ targer_store_code String 可选 1 目标仓库(良品铺子在使用) └ out_biz_code String 必须 RTMLH180418006053 外部业务编码 └ order_confirm_time String 必须 2018-04-19 17:14:31 出库时间，格式:YYYY-MM-DD hh:mm:ss └ confirm_type Number 必须 0 基本信息支持出入库单多次确认 └ customer_order_no String 可选 2018041800001 客户单号 └ time_zone String 可选 +8 时区 package_infos PackageInfo [] 可选包裹列表 └ tms_code String 可选 2323 快递公司服务编码 └ tms_order_code String 可选 3232323 运单编码 └ package_code String 可选 32323 包裹号 └ package_weight Number 可选 12 包裹质量，单位：克 └ package_length Number 可选 21 包裹长度，单位：毫米 └ package_width Number 可选 12 包裹宽度,单位：毫米 └ package_height Number 可选 12 包裹高度，单位：毫米 package_item_items PackageItem [] 可选包裹里面的商品信息列表 └ item_id String 可选 23232323 商品ID └ item_quantity Number 可选 1 此包裹里该商品的数量 check_items StockOutCheckItem [] 可选出库单商品校验信息列表 └ order_item_id String 可选 4343 出库单明细id └ quantity Number 可选 12 该商品实际出库总量

名称	类型	示例值	描述
module	Boolean	true	同步成功或失败

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallLuxuryStockOutOrderConfirmRequest req = new TmallLuxuryStockOutOrderConfirmRequest();
TmallLuxuryStockOutOrderConfirmRequest.ReturnOutStoreConfirmOrder obj1 = new TmallLuxuryStockOutOrderConfirmRequest.ReturnOutStoreConfirmOrder();
obj1.setTnum(1L);
obj1.setOrderCode("986504798855761920");
obj1.setOrderType("901");
obj1.setOrderSource("1");
obj1.setTweight(0L);
obj1.setTmsCode("TMS001");
obj1.setEndFlag("1");
List<TmallLuxuryStockOutOrderConfirmRequest.OrderItem> list3 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.OrderItem>();
TmallLuxuryStockOutOrderConfirmRequest.OrderItem obj4 = new TmallLuxuryStockOutOrderConfirmRequest.OrderItem();
list3.add(obj4);
List<TmallLuxuryStockOutOrderConfirmRequest.Item> list7 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.Item>();
TmallLuxuryStockOutOrderConfirmRequest.Item obj8 = new TmallLuxuryStockOutOrderConfirmRequest.Item();
list7.add(obj8);
obj8.setProduceDate("2018-04-04 00:00:00");
obj8.setTypeName("散箱出库");
obj8.setProduceCode("Z020202001");
obj8.setProduceArea("广东广州");
obj8.setGuaranteeUnit(1L);
obj8.setGuaranteePeriod(180L);
obj8.setDueDate("2020-11-21 00:00:00");
obj8.setBatchCode("1013329");
obj8.setQuantity(100L);
obj8.setInventoryType(101L);
obj8.setItemId("981369542456774656");
obj8.setSlTz(32L);
obj8.setBatchId("5325345");
obj8.setStckInDate(StringUtils.parseDateTime("2019-12-01 00:00:00"));
obj8.setReceiptNumber("32323");
obj8.setSpecification("32323");
obj8.setItemCode("253345");
obj8.setRemark("这是备注");
obj8.setTotalQty(23L);
obj8.setItemLineNo(1L);
obj8.setDiffReason("43434");
obj8.setSnCode("32323");
list5.setItems(list7);
obj4.setIsCompleted(true);
obj4.setOwnUserId("123456");
obj4.setOrderItemId("986504906230075392");
obj4.setLength(32L);
obj4.setHeight(42L);
obj4.setWeight(2L);
obj4.setVolume(14L);
obj1.setOrderItems(list3);
obj1.setReturnOrderNo("111111");
obj1.setLogisticsCode("111111");
obj1.setPoNo("poNo");
obj1.setOwnUserId("123456");
obj1.setOutMode("1");
obj1.setTargerStoreCode("1");
obj1.setOutBizCode("RTMLH180418006053");
obj1.setOrderConfirmTime("2018-04-19 17:14:31");
obj1.setConfirmType(0L);
obj1.setCustomerOrderNo("2018041800001");
obj1.setTimeZone("+8");
List<TmallLuxuryStockOutOrderConfirmRequest.PackageInfo> list10 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.PackageInfo>();
TmallLuxuryStockOutOrderConfirmRequest.PackageInfo obj11 = new TmallLuxuryStockOutOrderConfirmRequest.PackageInfo();
list10.add(obj11);
obj11.setTmsCode("2323");
obj11.setTmsOrderCode("3232323");
obj11.setPackageCode("32323");
obj11.setPackageWeight(12L);
obj11.setPackageLength(21L);
obj11.setPackageWidth(12L);
obj11.setPackageHeight(12L);
List<TmallLuxuryStockOutOrderConfirmRequest.PackageItem> list14 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.PackageItem>();
TmallLuxuryStockOutOrderConfirmRequest.PackageItem obj15 = new TmallLuxuryStockOutOrderConfirmRequest.PackageItem();
list14.add(obj15);
obj15.setItemId("23232323");
obj15.setItemQuantity(1L);
list12.setPackageItemItems(list14);
obj1.setPackageInfos(list10);
List<TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItem> list17 = new ArrayList<TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItem>();
TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItem obj18 = new TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItem();
list17.add(obj18);
obj18.setOrderItemId("4343");
obj18.setQuantity(12L);
obj1.setCheckItems(list17);
req.setReturnOutStoreConfirmOrder(obj1);
TmallLuxuryStockOutOrderConfirmResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallLuxuryStockOutOrderConfirmRequest req = new TmallLuxuryStockOutOrderConfirmRequest();
TmallLuxuryStockOutOrderConfirmRequest.ReturnOutStoreConfirmOrderDomain obj1 = new TmallLuxuryStockOutOrderConfirmRequest.ReturnOutStoreConfirmOrderDomain();
obj1.Tnum = 1L;
obj1.OrderCode = "986504798855761920";
obj1.OrderType = "901";
obj1.OrderSource = "1";
obj1.Tweight = 0L;
obj1.TmsCode = "TMS001";
obj1.EndFlag = "1";
List<TmallLuxuryStockOutOrderConfirmRequest.OrderItemDomain> list3 = new List<TmallLuxuryStockOutOrderConfirmRequest.OrderItemDomain>();
TmallLuxuryStockOutOrderConfirmRequest.OrderItemDomain obj4 = new TmallLuxuryStockOutOrderConfirmRequest.OrderItemDomain();
list3.Add(obj4);
List<TmallLuxuryStockOutOrderConfirmRequest.ItemDomain> list6 = new List<TmallLuxuryStockOutOrderConfirmRequest.ItemDomain>();
TmallLuxuryStockOutOrderConfirmRequest.ItemDomain obj7 = new TmallLuxuryStockOutOrderConfirmRequest.ItemDomain();
list6.Add(obj7);
obj7.ProduceDate = "2018-04-04 00:00:00";
obj7.TypeName = "散箱出库";
obj7.ProduceCode = "Z020202001";
obj7.ProduceArea = "广东广州";
obj7.GuaranteeUnit = 1L;
obj7.GuaranteePeriod = 180L;
obj7.DueDate = "2020-11-21 00:00:00";
obj7.BatchCode = "1013329";
obj7.Quantity = 100L;
obj7.InventoryType = 101L;
obj7.ItemId = "981369542456774656";
obj7.SlTz = 32L;
obj7.BatchId = "5325345";
obj7.StckInDate = DateTime.Parse(2019-12-01 00:00:00");
obj7.ReceiptNumber = "32323";
obj7.Specification = "32323";
obj7.ItemCode = "253345";
obj7.Remark = "这是备注";
obj7.TotalQty = 23L;
obj7.ItemLineNo = 1L;
obj7.DiffReason = "43434";
obj7.SnCode = "32323";
obj4.Items= list6;
obj4.IsCompleted = true;
obj4.OwnUserId = "123456";
obj4.OrderItemId = "986504906230075392";
obj4.Length = 32L;
obj4.Height = 42L;
obj4.Weight = 2L;
obj4.Volume = 14L;
obj1.OrderItems= list3;
obj1.ReturnOrderNo = "111111";
obj1.LogisticsCode = "111111";
obj1.PoNo = "poNo";
obj1.OwnUserId = "123456";
obj1.OutMode = "1";
obj1.TargerStoreCode = "1";
obj1.OutBizCode = "RTMLH180418006053";
obj1.OrderConfirmTime = "2018-04-19 17:14:31";
obj1.ConfirmType = 0L;
obj1.CustomerOrderNo = "2018041800001";
obj1.TimeZone = "+8";
List<TmallLuxuryStockOutOrderConfirmRequest.PackageInfoDomain> list9 = new List<TmallLuxuryStockOutOrderConfirmRequest.PackageInfoDomain>();
TmallLuxuryStockOutOrderConfirmRequest.PackageInfoDomain obj10 = new TmallLuxuryStockOutOrderConfirmRequest.PackageInfoDomain();
list9.Add(obj10);
obj10.TmsCode = "2323";
obj10.TmsOrderCode = "3232323";
obj10.PackageCode = "32323";
obj10.PackageWeight = 12L;
obj10.PackageLength = 21L;
obj10.PackageWidth = 12L;
obj10.PackageHeight = 12L;
List<TmallLuxuryStockOutOrderConfirmRequest.PackageItemDomain> list12 = new List<TmallLuxuryStockOutOrderConfirmRequest.PackageItemDomain>();
TmallLuxuryStockOutOrderConfirmRequest.PackageItemDomain obj13 = new TmallLuxuryStockOutOrderConfirmRequest.PackageItemDomain();
list12.Add(obj13);
obj13.ItemId = "23232323";
obj13.ItemQuantity = 1L;
obj10.PackageItemItems= list12;
obj1.PackageInfos= list9;
List<TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItemDomain> list15 = new List<TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItemDomain>();
TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItemDomain obj16 = new TmallLuxuryStockOutOrderConfirmRequest.StockOutCheckItemDomain();
list15.Add(obj16);
obj16.OrderItemId = "4343";
obj16.Quantity = 12L;
obj1.CheckItems= list15;
req.ReturnOutStoreConfirmOrder_ = obj1;
TmallLuxuryStockOutOrderConfirmResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallLuxuryStockOutOrderConfirmRequest;
$return_out_store_confirm_order = new ReturnOutStoreConfirmOrder;
$return_out_store_confirm_order->tnum="1";
$return_out_store_confirm_order->order_code="986504798855761920";
$return_out_store_confirm_order->order_type="901";
$return_out_store_confirm_order->order_source="1";
$return_out_store_confirm_order->tweight="0";
$return_out_store_confirm_order->tms_code="TMS001";
$return_out_store_confirm_order->end_flag="1";
$order_items = new OrderItem;
$items = new Item;
$items->produce_date="2018-04-04 00:00:00";
$items->type_name="散箱出库";
$items->produce_code="Z020202001";
$items->produce_area="广东广州";
$items->guarantee_unit="1";
$items->guarantee_period="180";
$items->due_date="2020-11-21 00:00:00";
$items->batch_code="1013329";
$items->quantity="100";
$items->inventory_type="101";
$items->item_id="981369542456774656";
$items->sl_tz="32";
$items->batch_id="5325345";
$items->stck_in_date="2019-12-01 00:00:00";
$items->receipt_number="32323";
$items->specification="32323";
$items->item_code="253345";
$items->remark="这是备注";
$items->total_qty="23";
$items->item_line_no="1";
$items->diff_reason="43434";
$items->sn_code="32323";
$order_items->items = $items;
$order_items->is_completed="true";
$order_items->own_user_id="123456";
$order_items->order_item_id="986504906230075392";
$order_items->length="32";
$order_items->height="42";
$order_items->weight="2";
$order_items->volume="14";
$return_out_store_confirm_order->order_items = $order_items;
$return_out_store_confirm_order->return_order_no="111111";
$return_out_store_confirm_order->logistics_code="111111";
$return_out_store_confirm_order->po_no="poNo";
$return_out_store_confirm_order->own_user_id="123456";
$return_out_store_confirm_order->out_mode="1";
$return_out_store_confirm_order->targer_store_code="1";
$return_out_store_confirm_order->out_biz_code="RTMLH180418006053";
$return_out_store_confirm_order->order_confirm_time="2018-04-19 17:14:31";
$return_out_store_confirm_order->confirm_type="0";
$return_out_store_confirm_order->customer_order_no="2018041800001";
$return_out_store_confirm_order->time_zone="+8";
$package_infos = new PackageInfo;
$package_infos->tms_code="2323";
$package_infos->tms_order_code="3232323";
$package_infos->package_code="32323";
$package_infos->package_weight="12";
$package_infos->package_length="21";
$package_infos->package_width="12";
$package_infos->package_height="12";
$package_item_items = new PackageItem;
$package_item_items->item_id="23232323";
$package_item_items->item_quantity="1";
$package_infos->package_item_items = $package_item_items;
$return_out_store_confirm_order->package_infos = $package_infos;
$check_items = new StockOutCheckItem;
$check_items->order_item_id="4343";
$check_items->quantity="12";
$return_out_store_confirm_order->check_items = $check_items;
$req->setReturnOutStoreConfirmOrder(json_encode($return_out_store_confirm_order));
$resp = $c->execute($req);

XML示例
JSON示例

<tmall_luxury_stock_out_order_confirm_response>
    <module>true</module>
</tmall_luxury_stock_out_order_confirm_response>

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>

错误码	错误描述	解决方案

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

开放平台

魅力惠API

tmall.luxury.stock.out.order.confirm (天猫奢品B2B退货出库订单回传)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ