淘宝开放平台

请求地址：

环境	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	DeliveryOrderFirstPackageSendRequest	可选			请求参数
└ open_user_id String 可选 3243fgtt34242 平台买家id └ mail_no String 可选 534253242452 物流单号 └ status Number 可选 200 WAIT_INBOUND(100, "等待仓库入库"), INBOUND_FAIL(-200, "入库异常"), INBOUND_SUCCESS(200,"入库成功"), CANCELED(-100,"已取消")，TRANSFER(-400,"转寄"), DESTROY(-500,"销毁") └ occur_time Number 可选 1641365460569 业务发生时间戳毫秒 └ weight Number 可选 11 包裹重量 g 拆包前 └ length Number 可选 12 包裹长 cm 拆包前 └ width Number 可选 12 包裹宽 cm 拆包前 └ height Number 可选 32 包裹高 cm 拆包前 verify_info_list DeliveryPackageVerifyInfoDTO [] 可选质检结果列表如拆包验货的结果图片等 └ pic_urls String [] 可选 - 图片外网URL数组 ["http://www.taobao.com/test",""] └ result_code String 可选 success 成功(success)/失败(fail) └ result_desc String 可选我方默认会做拆包验货验货结果正常无破损质检结果描述 goods_list FirstPackageRequestGoodDTO [] 可选商品列表（预留字段，暂不用回传） └ sku_name String 可选 - 商品名称 └ quantity Number 可选 1 数量 └ sku_code String 可选 skuCode skuCode └ weight Number 可选 23 商品重量 g └ height Number 可选 34 商品高 cm └ length Number 可选 23 商品长度 cm └ width Number 可选 53 商品宽度 cm └ pay_amount Number 可选 12 实际支付金额（单价：分） └ price Number 可选 13 商品单价（单价：分） └ category_id String 可选 123 叶子类目ID └ category_name String 可选食品叶子类目名称 └ inbound_exception_code String 可选 SIGN_FAIL_DAMAGED_OR_WEIGHT 入库异常原因编码枚举 SIGN_FAIL_DAMAGED_OR_WEIGHT("SIGN_FAIL_DAMAGED_OR_WEIGHT", "包裹破损潮湿"), SIGN_FAIL_EXCESSIVE_VOLUME("SIGN_FAIL_EXCESSIVE_VOLUME", "包裹体积过大"), SIGN_FAIL_RESTRICTED_GOODS("SIGN_FAIL_RESTRICTED_GOODS", "含禁限运商品"), OTHER("OTHER", "其他异常"); └ inbound_exception_desc String 可选拒收，包裹破损潮湿入库异常信息 └ logistic_properties String [] 可选 LogisticsPropertyEnum { ELECTRIC("electric", "带电"), PURE_ELECTRIC("pure_electric", "纯电"), LIQUID("liquid", "液体"), MAGNETIC("magnetic", "磁性"), POWDER("powder", "粉末"), FRAGILE("fragile", "易碎"), ALIVE("alive", "动植物活体"), FOOD("food", "食品"), DANGER("danger", "危险品"), LARGE("large", "大件"), MEDICINE("medicine", "药品"), SEX_AIDS("sexaids", "性用品"), POLICY_LIMIT("policylimit", "政策限制"); } 示例值 ["electric","magnetic"] un_packed_package UnPackedPackage 可选拆包后包裹信息当预报单创建的时候指定了拆包，则此字段的值必传 └ length Number 可选 23 长 cm └ width Number 可选 32 宽 cm └ height Number 可选 42 高 cm └ weight Number 可选 23 重量 g └ outer_warehouse_id String 可选 123 外部仓地址ID └ package_source Number 可选 2 包裹来源：1:千帆下单包裹，2:集运商录入包裹 └ unpack Boolean 可选 false 是否拆包 └ solution Number 可选 1 包裹异常时的建议处理方案: 1:可转仓 goods_logistic_property_list Integer [] 可选 - 异常原因为禁限运时商品维度的禁限运原因列表 └ item_id String 可选 5432345 商品id └ properties String [] 可选 - 商品禁限运属性参考logistic_properties

名称	类型	示例值	描述
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);
TmallOvsDeliveryPackageInfoSendRequest req = new TmallOvsDeliveryPackageInfoSendRequest();
TmallOvsDeliveryPackageInfoSendRequest.DeliveryOrderFirstPackageSendRequest obj1 = new TmallOvsDeliveryPackageInfoSendRequest.DeliveryOrderFirstPackageSendRequest();
obj1.setOpenUserId("3243fgtt34242");
obj1.setMailNo("534253242452");
obj1.setStatus(200L);
obj1.setOccurTime(1641365460569L);
obj1.setWeight(11L);
obj1.setLength(12L);
obj1.setWidth(12L);
obj1.setHeight(32L);
List<TmallOvsDeliveryPackageInfoSendRequest.DeliveryPackageVerifyInfoDTO> list3 = new ArrayList<TmallOvsDeliveryPackageInfoSendRequest.DeliveryPackageVerifyInfoDTO>();
TmallOvsDeliveryPackageInfoSendRequest.DeliveryPackageVerifyInfoDTO obj4 = new TmallOvsDeliveryPackageInfoSendRequest.DeliveryPackageVerifyInfoDTO();
list3.add(obj4);
obj4.setPicUrls("-");
obj4.setResultCode("success");
obj4.setResultDesc("我方默认会做拆包验货 验货结果正常 无破损");
obj1.setVerifyInfoList(list3);
List<TmallOvsDeliveryPackageInfoSendRequest.FirstPackageRequestGoodDTO> list6 = new ArrayList<TmallOvsDeliveryPackageInfoSendRequest.FirstPackageRequestGoodDTO>();
TmallOvsDeliveryPackageInfoSendRequest.FirstPackageRequestGoodDTO obj7 = new TmallOvsDeliveryPackageInfoSendRequest.FirstPackageRequestGoodDTO();
list6.add(obj7);
obj7.setSkuName("-");
obj7.setQuantity(1L);
obj7.setSkuCode("skuCode");
obj7.setWeight(23L);
obj7.setHeight(34L);
obj7.setLength(23L);
obj7.setWidth(53L);
obj7.setPayAmount(12L);
obj7.setPrice(13L);
obj7.setCategoryId("123");
obj7.setCategoryName("食品");
obj1.setGoodsList(list6);
obj1.setInboundExceptionCode("SIGN_FAIL_DAMAGED_OR_WEIGHT");
obj1.setInboundExceptionDesc("拒收，包裹破损潮湿");
obj1.setLogisticProperties("");
TmallOvsDeliveryPackageInfoSendRequest.UnPackedPackage obj8 = new TmallOvsDeliveryPackageInfoSendRequest.UnPackedPackage();
obj8.setLength(23L);
obj8.setWidth(32L);
obj8.setHeight(42L);
obj8.setWeight(23L);
obj1.setUnPackedPackage(obj8);
obj1.setOuterWarehouseId("123");
obj1.setPackageSource(2L);
obj1.setUnpack(false);
obj1.setSolution(1L);
List<TmallOvsDeliveryPackageInfoSendRequest.Integer> list10 = new ArrayList<TmallOvsDeliveryPackageInfoSendRequest.Integer>();
TmallOvsDeliveryPackageInfoSendRequest.Integer obj11 = new TmallOvsDeliveryPackageInfoSendRequest.Integer();
list10.add(obj11);
obj11.setItemId("5432345");
obj11.setProperties("-");
obj1.setGoodsLogisticPropertyList(list10);
req.setParam(obj1);
TmallOvsDeliveryPackageInfoSendResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallOvsDeliveryPackageInfoSendRequest req = new TmallOvsDeliveryPackageInfoSendRequest();
TmallOvsDeliveryPackageInfoSendRequest.DeliveryOrderFirstPackageSendRequestDomain obj1 = new TmallOvsDeliveryPackageInfoSendRequest.DeliveryOrderFirstPackageSendRequestDomain();
obj1.OpenUserId = "3243fgtt34242";
obj1.MailNo = "534253242452";
obj1.Status = 200L;
obj1.OccurTime = 1641365460569L;
obj1.Weight = 11L;
obj1.Length = 12L;
obj1.Width = 12L;
obj1.Height = 32L;
List<TmallOvsDeliveryPackageInfoSendRequest.DeliveryPackageVerifyInfoDTODomain> list3 = new List<TmallOvsDeliveryPackageInfoSendRequest.DeliveryPackageVerifyInfoDTODomain>();
TmallOvsDeliveryPackageInfoSendRequest.DeliveryPackageVerifyInfoDTODomain obj4 = new TmallOvsDeliveryPackageInfoSendRequest.DeliveryPackageVerifyInfoDTODomain();
list3.Add(obj4);
obj4.PicUrls = "-";
obj4.ResultCode = "success";
obj4.ResultDesc = "我方默认会做拆包验货 验货结果正常 无破损";
obj1.VerifyInfoList= list3;
List<TmallOvsDeliveryPackageInfoSendRequest.FirstPackageRequestGoodDTODomain> list6 = new List<TmallOvsDeliveryPackageInfoSendRequest.FirstPackageRequestGoodDTODomain>();
TmallOvsDeliveryPackageInfoSendRequest.FirstPackageRequestGoodDTODomain obj7 = new TmallOvsDeliveryPackageInfoSendRequest.FirstPackageRequestGoodDTODomain();
list6.Add(obj7);
obj7.SkuName = "-";
obj7.Quantity = 1L;
obj7.SkuCode = "skuCode";
obj7.Weight = 23L;
obj7.Height = 34L;
obj7.Length = 23L;
obj7.Width = 53L;
obj7.PayAmount = 12L;
obj7.Price = 13L;
obj7.CategoryId = "123";
obj7.CategoryName = "食品";
obj1.GoodsList= list6;
obj1.InboundExceptionCode = "SIGN_FAIL_DAMAGED_OR_WEIGHT";
obj1.InboundExceptionDesc = "拒收，包裹破损潮湿";
obj1.LogisticProperties = "";
TmallOvsDeliveryPackageInfoSendRequest.UnPackedPackageDomain obj8 = new TmallOvsDeliveryPackageInfoSendRequest.UnPackedPackageDomain();
obj8.Length = 23L;
obj8.Width = 32L;
obj8.Height = 42L;
obj8.Weight = 23L;
obj1.UnPackedPackage= obj8;
obj1.OuterWarehouseId = "123";
obj1.PackageSource = 2L;
obj1.Unpack = false;
obj1.Solution = 1L;
List<TmallOvsDeliveryPackageInfoSendRequest.IntegerDomain> list10 = new List<TmallOvsDeliveryPackageInfoSendRequest.IntegerDomain>();
TmallOvsDeliveryPackageInfoSendRequest.IntegerDomain obj11 = new TmallOvsDeliveryPackageInfoSendRequest.IntegerDomain();
list10.Add(obj11);
obj11.ItemId = "5432345";
obj11.Properties = "-";
obj1.GoodsLogisticPropertyList= list10;
req.Param_ = obj1;
TmallOvsDeliveryPackageInfoSendResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallOvsDeliveryPackageInfoSendRequest;
$param = new DeliveryOrderFirstPackageSendRequest;
$param->open_user_id="3243fgtt34242";
$param->mail_no="534253242452";
$param->status="200";
$param->occur_time="1641365460569";
$param->weight="11";
$param->length="12";
$param->width="12";
$param->height="32";
$verify_info_list = new DeliveryPackageVerifyInfoDTO;
$verify_info_list->pic_urls="-";
$verify_info_list->result_code="success";
$verify_info_list->result_desc="我方默认会做拆包验货 验货结果正常 无破损";
$param->verify_info_list = $verify_info_list;
$goods_list = new FirstPackageRequestGoodDTO;
$goods_list->sku_name="-";
$goods_list->quantity="1";
$goods_list->sku_code="skuCode";
$goods_list->weight="23";
$goods_list->height="34";
$goods_list->length="23";
$goods_list->width="53";
$goods_list->pay_amount="12";
$goods_list->price="13";
$goods_list->category_id="123";
$goods_list->category_name="食品";
$param->goods_list = $goods_list;
$param->inbound_exception_code="SIGN_FAIL_DAMAGED_OR_WEIGHT";
$param->inbound_exception_desc="拒收，包裹破损潮湿";
$param->logistic_properties="";
$un_packed_package = new UnPackedPackage;
$un_packed_package->length="23";
$un_packed_package->width="32";
$un_packed_package->height="42";
$un_packed_package->weight="23";
$param->un_packed_package = $un_packed_package;
$param->outer_warehouse_id="123";
$param->package_source="2";
$param->unpack="false";
$param->solution="1";
$goods_logistic_property_list = new Integer;
$goods_logistic_property_list->item_id="5432345";
$goods_logistic_property_list->properties="-";
$param->goods_logistic_property_list = $goods_logistic_property_list;
$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.package.info.send' \
-d 'partner_id=apidoc' \
-d 'sign=F619DB539D4ED792C6C115233620B445' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-02+22%3A47%3A31' \
-d 'v=2.0' \
-d 'param=null'

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

req=top.api.TmallOvsDeliveryPackageInfoSendRequest(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.package.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.package.info.send', {
	'param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

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

{
    "tmall_ovs_delivery_package_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.package.info.send (集运预报单回传)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ