淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param	DeliveryOrderSendRequest	可选			请求入参
└ open_user_id String 可选 335e5tfg43535 平台买家id 已加密 └ platform_order_id String 可选 43546574633 平台集运单id └ status String 可选 ISSUE_SUCCEEDED 工单状态打包中("PACKAGING","打包中-非仓库初始值此状态的单不允许用户取消") ,打包完成("PACK_FINISH"), 打包异常("PACK_FAIL") , 集运单状态出库异常（ABNORMAL_DELIVERY）, 出库成功（ISSUE_SUCCEEDED） └ mail_no String 可选 - 物流单号 └ length Number 可选 45 包裹长度 cm └ width Number 可选 64 包裹宽度 cm └ height Number 可选 34 包裹高度 cm └ weight Number 可选 23 包裹重 g goods_list DeliveryGoodDTO [] 可选 - 商品列表 └ sku_name String 可选测试商品商品名称 └ quantity Number 可选 3 数量 └ sku_code String 可选 535253252 sku code 平台sku 已加密 └ length Number 可选 32 商品长 cm └ width Number 可选 32 商品宽 cm └ height Number 可选 44 商品高 cm └ weight Number 可选 120 商品重 g └ order_id String 可选 64353424 废弃 └ mail_company String 可选顺丰物流公司名称 └ end_mail_no String 可选 VL924523452 非集运场景的时候会使用，末端物流单号 └ end_mail_company String 可选 - 非集运场景的时候会使用，末端物流公司名称 └ exception_desc String 可选 - 如状态异常时，填入详细的异常原因 package_list DeliveryOrderRequestPackageDTO [] 可选 - 包裹列表拆包发货时使用存放所有集运包裹信息表示打包发货的包裹情况优先使用该字段数据。回传工单时outer_package_id标识拆包包裹，length、width、height、weight用于费用计算，mailNo可选；回传集运单时如果是二次打包，根据outer_package_id回传状态、更新mailNo，但outer_package_id数量和值无法修改，体积重量无法改变；普通集运单时，回传outer_package_id、状态、mailNo，可覆盖。 └ origin_package_mail_nos String [] 可选 - 预报单的物流单号数组即合包发货前的包裹物流单号 └ mail_no String 可选 756444 物流单号 └ outer_package_id String 可选 12345678 外部拆包包裹id └ length Number 可选 20 包裹长度 cm 用于工单物流服务运费计算 └ width Number 可选 20 包裹宽度 cm 用于工单物流服务运费计算 └ height Number 可选 20 包裹高度 cm 用于工单物流服务运费计算 └ weight Number 可选 1000 包裹重 g 用于工单物流服务运费计算 └ status String 可选 ISSUE_SUCCEEDED 出库异常（ABNORMAL_DELIVERY）, 出库成功（ISSUE_SUCCEEDED） service_fulfil_result LogisticServiceFulfilDTO [] 可选 - 物流服务产品履行情况 └ service_code String 可选 AS53 服务产品code └ pic_urls String [] 可选 ["url1","url2"] 图片数组["url1","url2"] └ remark String 可选 - 备注限制100字符 └ length Number 可选 2400 长 cm 计费要素chargeType = volumeWeight时长宽高必须回传 └ width Number 可选 2400 宽 cm 计费要素chargeType = volumeWeight时长宽高必须回传 └ height Number 可选 2400 高 cm 计费要素chargeType = volumeWeight时长宽高必须回传 └ weight Number 可选 2500 重量 g 计费要素chargeType = weight时重量必须回传 └ package_count Number 可选 12 包裹数量，当计费要素类型chargeType=packageNum时，当前数量必回传 └ item_count Number 可选 7 商品数量，当计费要素类型chargeType=itemNum时，当前数量必回传 └ charge_type String 可选 volumeWeight 计费要素, 计费要素为当前值则体积的长宽高重量必须回传 volumeWeight("volumeWeight","体积重"), 计费要素为当前值则重量必须回传 weight("weight","体积重"), 计费要素为当前值则包裹数量必回传 packageNum("packageNum","包裹数量"), 计费要素为当前值则商品数量必回传 itemNum("itemNum","商品数量"), └ sub_ticket_id Number 可选 5353523 子单号，集运单下发接口中有传该值给集运商，返给平台即可。注意：对于非增值服务（标准物流服务即物流渠道），当前值传1即可。 └ result_fail Boolean 可选 false 当前服务是否履约失败 └ fail_msg String 可选当前服务无法履行，木架材料不够了服务履行失败描述 └ ticket_id String 可选 T42353535 ticketId 工单号，针对远洋地区会先下发这个单号，此时不会下发platformOrderId字段，等仓库完成打包称重并完成了增值服务之后。再回传打包状态给平台，之后平台算出运费并通知用户支付运费。支付完成运费好，再下发platformOrderId字段给集运商。 ticket_id和platform_order_id必传其一。 └ other_fee Number 可选 2040 其他费用分如用户通过备注方式，下发了一些非平台标准的增值服务而产生的额外费用，放在这儿，平台会累加到运费上去支付。会把这个费用加进平台计算出来的物流费用里，让用户支付 └ other_fee_desc String 可选 - 其他费用描述 └ error_code String 可选 ITEM_LOST 异常类型当status= pack_fail 或 ABNORMAL_DELIVERY 时，必传。枚举值： CANT_SHIP :("CANT_SHIP"，“有禁限运商品”）， ITEM_WORN :("ITEM_WORN"，“商品有破损”） ITEM_LOST : ("ITEM_LOST","丢件") RECEIVE_ADS_ERROR("RECEIVE_ADS_ERROR","邮编/地址错误") OTHER : ("OTHER","其他问题"), ,USER_CHANGE_SERVICE("USER_CHANGE_SERVICE", "需修改渠道"), ,USER_INFO_ERROR("USER_INFO_ERROR", "收件人信息有误")

名称	类型	示例值	描述
result	ResultDO		响应
└ success Boolean false 成功失败 true/false └ fail_code String 1100 错误码 └ fail_message String 系统异常错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallOvsDeliveryOrderInfoSendRequest req = new TmallOvsDeliveryOrderInfoSendRequest();
TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderSendRequest obj1 = new TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderSendRequest();
obj1.setOpenUserId("335e5tfg43535");
obj1.setPlatformOrderId("43546574633");
obj1.setStatus("ISSUE_SUCCEEDED");
obj1.setMailNo("-");
obj1.setLength(45L);
obj1.setWidth(64L);
obj1.setHeight(34L);
obj1.setWeight(23L);
List<TmallOvsDeliveryOrderInfoSendRequest.DeliveryGoodDTO> list3 = new ArrayList<TmallOvsDeliveryOrderInfoSendRequest.DeliveryGoodDTO>();
TmallOvsDeliveryOrderInfoSendRequest.DeliveryGoodDTO obj4 = new TmallOvsDeliveryOrderInfoSendRequest.DeliveryGoodDTO();
list3.add(obj4);
obj4.setSkuName("测试商品");
obj4.setQuantity(3L);
obj4.setSkuCode("535253252");
obj4.setLength(32L);
obj4.setWidth(32L);
obj4.setHeight(44L);
obj4.setWeight(120L);
obj1.setGoodsList(list3);
obj1.setOrderId("64353424");
obj1.setMailCompany("顺丰");
obj1.setEndMailNo("VL924523452");
obj1.setEndMailCompany("-");
obj1.setExceptionDesc("-");
List<TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderRequestPackageDTO> list6 = new ArrayList<TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderRequestPackageDTO>();
TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderRequestPackageDTO obj7 = new TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderRequestPackageDTO();
list6.add(obj7);
obj7.setOriginPackageMailNos("-");
obj7.setMailNo("756444");
obj7.setOuterPackageId("12345678");
obj7.setLength(20L);
obj7.setWidth(20L);
obj7.setHeight(20L);
obj7.setWeight(1000L);
obj7.setStatus("ISSUE_SUCCEEDED");
obj1.setPackageList(list6);
List<TmallOvsDeliveryOrderInfoSendRequest.LogisticServiceFulfilDTO> list9 = new ArrayList<TmallOvsDeliveryOrderInfoSendRequest.LogisticServiceFulfilDTO>();
TmallOvsDeliveryOrderInfoSendRequest.LogisticServiceFulfilDTO obj10 = new TmallOvsDeliveryOrderInfoSendRequest.LogisticServiceFulfilDTO();
list9.add(obj10);
obj10.setServiceCode("AS53");
obj10.setPicUrls(""url1","url2"");
obj10.setRemark("-");
obj10.setLength(2400L);
obj10.setWidth(2400L);
obj10.setHeight(2400L);
obj10.setWeight(2500L);
obj10.setPackageCount(12L);
obj10.setItemCount(7L);
obj10.setChargeType("volumeWeight");
obj10.setSubTicketId(5353523L);
obj10.setResultFail(false);
obj10.setFailMsg("当前服务无法履行，木架材料不够了");
obj1.setServiceFulfilResult(list9);
obj1.setTicketId("T42353535");
obj1.setOtherFee(2040L);
obj1.setOtherFeeDesc("-");
obj1.setErrorCode("ITEM_LOST");
req.setParam(obj1);
TmallOvsDeliveryOrderInfoSendResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallOvsDeliveryOrderInfoSendRequest req = new TmallOvsDeliveryOrderInfoSendRequest();
TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderSendRequestDomain obj1 = new TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderSendRequestDomain();
obj1.OpenUserId = "335e5tfg43535";
obj1.PlatformOrderId = "43546574633";
obj1.Status = "ISSUE_SUCCEEDED";
obj1.MailNo = "-";
obj1.Length = 45L;
obj1.Width = 64L;
obj1.Height = 34L;
obj1.Weight = 23L;
List<TmallOvsDeliveryOrderInfoSendRequest.DeliveryGoodDTODomain> list3 = new List<TmallOvsDeliveryOrderInfoSendRequest.DeliveryGoodDTODomain>();
TmallOvsDeliveryOrderInfoSendRequest.DeliveryGoodDTODomain obj4 = new TmallOvsDeliveryOrderInfoSendRequest.DeliveryGoodDTODomain();
list3.Add(obj4);
obj4.SkuName = "测试商品";
obj4.Quantity = 3L;
obj4.SkuCode = "535253252";
obj4.Length = 32L;
obj4.Width = 32L;
obj4.Height = 44L;
obj4.Weight = 120L;
obj1.GoodsList= list3;
obj1.OrderId = "64353424";
obj1.MailCompany = "顺丰";
obj1.EndMailNo = "VL924523452";
obj1.EndMailCompany = "-";
obj1.ExceptionDesc = "-";
List<TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderRequestPackageDTODomain> list6 = new List<TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderRequestPackageDTODomain>();
TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderRequestPackageDTODomain obj7 = new TmallOvsDeliveryOrderInfoSendRequest.DeliveryOrderRequestPackageDTODomain();
list6.Add(obj7);
obj7.OriginPackageMailNos = "-";
obj7.MailNo = "756444";
obj7.OuterPackageId = "12345678";
obj7.Length = 20L;
obj7.Width = 20L;
obj7.Height = 20L;
obj7.Weight = 1000L;
obj7.Status = "ISSUE_SUCCEEDED";
obj1.PackageList= list6;
List<TmallOvsDeliveryOrderInfoSendRequest.LogisticServiceFulfilDTODomain> list9 = new List<TmallOvsDeliveryOrderInfoSendRequest.LogisticServiceFulfilDTODomain>();
TmallOvsDeliveryOrderInfoSendRequest.LogisticServiceFulfilDTODomain obj10 = new TmallOvsDeliveryOrderInfoSendRequest.LogisticServiceFulfilDTODomain();
list9.Add(obj10);
obj10.ServiceCode = "AS53";
obj10.PicUrls = ""url1","url2"";
obj10.Remark = "-";
obj10.Length = 2400L;
obj10.Width = 2400L;
obj10.Height = 2400L;
obj10.Weight = 2500L;
obj10.PackageCount = 12L;
obj10.ItemCount = 7L;
obj10.ChargeType = "volumeWeight";
obj10.SubTicketId = 5353523L;
obj10.ResultFail = false;
obj10.FailMsg = "当前服务无法履行，木架材料不够了";
obj1.ServiceFulfilResult= list9;
obj1.TicketId = "T42353535";
obj1.OtherFee = 2040L;
obj1.OtherFeeDesc = "-";
obj1.ErrorCode = "ITEM_LOST";
req.Param_ = obj1;
TmallOvsDeliveryOrderInfoSendResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallOvsDeliveryOrderInfoSendRequest;
$param = new DeliveryOrderSendRequest;
$param->open_user_id="335e5tfg43535";
$param->platform_order_id="43546574633";
$param->status="ISSUE_SUCCEEDED";
$param->mail_no="-";
$param->length="45";
$param->width="64";
$param->height="34";
$param->weight="23";
$goods_list = new DeliveryGoodDTO;
$goods_list->sku_name="测试商品";
$goods_list->quantity="3";
$goods_list->sku_code="535253252";
$goods_list->length="32";
$goods_list->width="32";
$goods_list->height="44";
$goods_list->weight="120";
$param->goods_list = $goods_list;
$param->order_id="64353424";
$param->mail_company="顺丰";
$param->end_mail_no="VL924523452";
$param->end_mail_company="-";
$param->exception_desc="-";
$package_list = new DeliveryOrderRequestPackageDTO;
$package_list->origin_package_mail_nos="-";
$package_list->mail_no="756444";
$package_list->outer_package_id="12345678";
$package_list->length="20";
$package_list->width="20";
$package_list->height="20";
$package_list->weight="1000";
$package_list->status="ISSUE_SUCCEEDED";
$param->package_list = $package_list;
$service_fulfil_result = new LogisticServiceFulfilDTO;
$service_fulfil_result->service_code="AS53";
$service_fulfil_result->pic_urls="[\"url1\",\"url2\"]";
$service_fulfil_result->remark="-";
$service_fulfil_result->length="2400";
$service_fulfil_result->width="2400";
$service_fulfil_result->height="2400";
$service_fulfil_result->weight="2500";
$service_fulfil_result->package_count="12";
$service_fulfil_result->item_count="7";
$service_fulfil_result->charge_type="volumeWeight";
$service_fulfil_result->sub_ticket_id="5353523";
$service_fulfil_result->result_fail="false";
$service_fulfil_result->fail_msg="当前服务无法履行，木架材料不够了";
$param->service_fulfil_result = $service_fulfil_result;
$param->ticket_id="T42353535";
$param->other_fee="2040";
$param->other_fee_desc="-";
$param->error_code="ITEM_LOST";
$req->setParam(json_encode($param));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=tmall.ovs.delivery.order.info.send' \
-d 'partner_id=apidoc' \
-d 'sign=3A100D7BF191A1B7BE8663A0CB21FF3E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-02+22%3A23%3A02' \
-d 'v=2.0' \
-d 'param=null'

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

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

req.param="数据结构示例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,"tmall.ovs.delivery.order.info.send");
add_param(pRequest,"param","数据结构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('tmall.ovs.delivery.order.info.send', {
	'param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tmall_ovs_delivery_order_info_send_response>
    <result>
        <success>false</success>
        <fail_code>1100</fail_code>
        <fail_message>系统异常</fail_message>
    </result>
</tmall_ovs_delivery_order_info_send_response>

{
    "tmall_ovs_delivery_order_info_send_response":{
        "result":{
            "success":false,
            "fail_code":"1100",
            "fail_message":"系统异常"
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案

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

千帆计划

tmall.ovs.delivery.order.info.send (物流单信息回传)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ