飞猪 - 开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
tid	Number	必须	123456	最小值：1000	淘宝交易ID
sub_tid	Number []	可选	1,2,3	最大列表长度：50	拆单子订单列表，对应的数据是：子订单号列表。可以不传，但是如果传了则必须符合传递的规则。子订单必须是操作的物流订单的子订单的真子集！
is_split	Number	可选	0	默认值：0	表明是否是拆单，默认值0，1表示拆单
out_sid	String	必须	123456789		运单号.具体一个物流公司的真实运单号码。淘宝官方物流会校验，请谨慎传入；
company_code	String	必须	POST		物流公司代码.如"POST"代表中国邮政,"ZJS"代表宅急送。调用 taobao.logistics.companies.get 获取。如果是货到付款订单，选择的物流公司必须支持货到付款发货方式
feature	String	可选	identCode=tid:aaa,bbb;machineCode=tid2:aaa		feature参数格式范例: identCode=tid1:识别码1,识别码2\|tid2:识别码3;machineCode=tid3:3C机器号A,3C机器号B identCode为识别码的KEY,machineCode为3C的KEY,多个key之间用”;”分隔 “tid1:识别码1,识别码2\|tid2:识别码3”为identCode对应的value。"\|"不同商品间的分隔符。例1商品和2商品，之间就用"\|"分开。 TID就是商品代表的子订单号，对应taobao.trade.fullinfo.get 接口获得的oid字段。(通过OID可以唯一定位到当前商品上) ":"TID和具体传入参数间的分隔符。冒号前表示TID,之后代表该商品的参数属性。 "," 属性间分隔符。（对应商品数量，当存在一个商品的数量超过1个时，用逗号分开）。具体:当订单中A商品的数量为2个，其中手机串号分别为"12345","67890"。参数格式：identCode=TIDA:12345,67890。TIDA对应了A宝贝，冒号后用逗号分隔的"12345","67890".说明本订单A宝贝的数量为2，值分别为"12345","67890"。当存在"\|"时，就说明订单中存在多个商品，商品间用"\|"分隔了开来。\|"之后的内容含义同上。
seller_ip	String	可选	192.168.1.10		商家的IP地址

名称	类型	示例值	描述
shipping	Shipping		返回发货是否成功is_success
└ is_success Boolean true 返回发货是否成功。

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsConsignResendRequest req = new LogisticsConsignResendRequest();
req.setTid(123456L);
req.setSubTid("1,2,3");
req.setIsSplit(0L);
req.setOutSid("123456789");
req.setCompanyCode("POST");
req.setFeature("identCode=tid:aaa,bbb;machineCode=tid2:aaa");
req.setSellerIp("192.168.1.10");
LogisticsConsignResendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
LogisticsConsignResendRequest req = new LogisticsConsignResendRequest();
req.Tid = 123456L;
req.SubTid = "1,2,3";
req.IsSplit = 0L;
req.OutSid = "123456789";
req.CompanyCode = "POST";
req.Feature = "identCode=tid:aaa,bbb;machineCode=tid2:aaa";
req.SellerIp = "192.168.1.10";
LogisticsConsignResendResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new LogisticsConsignResendRequest;
$req->setTid("123456");
$req->setSubTid("1,2,3");
$req->setIsSplit("0");
$req->setOutSid("123456789");
$req->setCompanyCode("POST");
$req->setFeature("identCode=tid:aaa,bbb;machineCode=tid2:aaa");
$req->setSellerIp("192.168.1.10");
$resp = $c->execute($req, $sessionKey);

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=taobao.logistics.consign.resend' \
-d 'partner_id=apidoc' \
-d 'session=decef405-6f71-463d-bf51-c35358d1b766' \
-d 'sign=7155D99994E2AE6393A0211C9490B8DB' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-09-27+12%3A15%3A48' \
-d 'v=2.0' \
-d 'company_code=POST' \
-d 'feature=identCode%3Dtid%3Aaaa%2Cbbb%3BmachineCode%3Dtid2%3Aaaa' \
-d 'is_split=0' \
-d 'out_sid=123456789' \
-d 'seller_ip=192.168.1.10' \
-d 'sub_tid=1%2C2%2C3' \
-d 'tid=123456'

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

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

req.tid=123456
req.sub_tid="1,2,3"
req.is_split=0
req.out_sid="123456789"
req.company_code="POST"
req.feature="identCode=tid:aaa,bbb;machineCode=tid2:aaa"
req.seller_ip="192.168.1.10"
try:
	resp= req.getResponse(sessionkey)
	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.logistics.consign.resend");
add_param(pRequest,"tid","123456");
add_param(pRequest,"sub_tid","1,2,3");
add_param(pRequest,"is_split","0");
add_param(pRequest,"out_sid","123456789");
add_param(pRequest,"company_code","POST");
add_param(pRequest,"feature","identCode=tid:aaa,bbb;machineCode=tid2:aaa");
add_param(pRequest,"seller_ip","192.168.1.10");
pResponse = top_execute(pClient,pRequest,sessionKey);
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.logistics.consign.resend', {
	'tid':'123456',
	'sub_tid':'1,2,3',
	'is_split':'0',
	'out_sid':'123456789',
	'company_code':'POST',
	'feature':'identCode=tid:aaa,bbb;machineCode=tid2:aaa',
	'seller_ip':'192.168.1.10'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<logistics_consign_resend_response>
    <shipping>
        <is_success>true</is_success>
    </shipping>
</logistics_consign_resend_response>

{
    "logistics_consign_resend_response":{
        "shipping":{
            "is_success":true
        }
    }
}

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

错误码	错误描述	解决方案
isv.logistics-online-service-error:B01	物流订单不存在	调用发货接口前要先判断tid是不是属于自身的tid，并且需要判断tid是否存在，最好用搜索出来的tid列表里面的数据传入。
isv.logistics-online-service-error:B02	没有权限进行发货	在发货前要判断好订单的状态，只有交易存在、属于自己、并且是等待卖家发货的才能发，其余的状态无需调用这个接口。
isv.logistics-online-service-error:B04	订单状态不对	1.遇到isv开头的错误不要在程序重试； 2.建议在发货前先调用交易API如：taobao.trade.fullinfo.get来查询这个订单的状态，根据订单状态再做相应的处理，避免状态为已发货订单进行重复发货
isv.logistics-online-service-error:B56	没有选择物流公司	在前端对是否选择物流公司(company_code)做好校验，没有选择company_code的不允许其发货。
isv.logistics-online-service-error:B59	运单号为空	在前端对是否填写运单号(out_sid)进行校验，没有传入out_sid不允许其发货。
isv.logistics-online-service-error:B60	运单号不符合规则	每个物流公司都有特定的运单号规则，参照该运单号规则在前端对运单号是否符合对应的规则进行校验，不符合规则的不允许其发货。
isv.invalid-parameter	参数无效，格式不对、非法值、越界等	请对照参数表
isv.logistics-online-service-error:B101	地址库不存在或该地址库不属于当前用户	可以通过此接口查询地址库taobao.logistics.address.search
isv.logistics-online-service-error:P01	参数为空	必填参数为空，如tid为空，请确保传入的必选参数不为空,请对照参数表
isv.logistics-online-service-error:B27	已生成发货单	已经生成发货单的订单不能发货
isv.logistics-online-service-error:B52	物流公司不存在或被禁用	通过taobao.logistics.companies.get查询支持自已在线下单或货到款的物流公司
isv.logistics-online-service-error:B03	物流订单来源错误	非c2c的订单不支持款到付款发货
isv.logistics-online-service-error:p16	未补签货到付款补充协议	请与客服联系，补签补充协议!
isv.logistics-online-service-error:B86	该物流公司未开通COD服务	该物流公司不支持货到付款,通过taobao.logistics.partners.get查询支持货到付款的物流公司
isv.logistics-online-service-error:B79	该物流公司揽收或派送范围不支持	可以通过此接口taobao.logistics.partners.get，查询支持揽收或派送范围的物流公司
isp.logistics-online-service-error:S01	系统异常	系统异常
isv.logistics-online-service-error:B105	该物流公司不支持在线下单	该物流公司不支持在线下单,通过taobao.logistics.companies.get查询支持在线下单的物流公司
isv.logistics-online-service-error:B55	该交易状态不正确，不能发货	建议在发货前先调用交易API如：taobao.trade.fullinfo.get来查询这个订单的状态，根据订单状态再做相应的处理，避免状态为已发货订单进行重复发货
isv.logistics-offline-service-error:B01	物流订单不存在	调用发货接口前要先判断tid是不是属于自身的tid，并且需要判断tid是否存在，最好用搜索出来的tid列表里面的数据传入。
isv.logistics-offline-service-error:B02	没有权限进行发货	在发货前要判断好订单的状态，只有交易存在、属于自己、并且是等待卖家发货的才能发，其余的状态无需调用这个接口。
isv.logistics-offline-service-error:B04	订单状态不对	1.遇到isv开头的错误不要在程序重试； 2.建议在发货前先调用交易API如：taobao.trade.fullinfo.get来查询这个订单的状态，根据订单状态再做相应的处理，避免状态为已发货订单进行重复发货
isv.logistics-offline-service-error:B56	没有选择物流公司	在前端对是否选择物流公司(company_code)做好校验，没有选择company_code的不允许其发货。
isv.logistics-offline-service-error:B59	运单号为空	在前端对是否填写运单号(out_sid)进行校验，没有传入out_sid不允许其发货。
isv.logistics-offline-service-error:B60	运单号不符合规则	每个物流公司都有特定的运单号规则，参照该运单号规则在前端对运单号是否符合对应的规则进行校验，不符合规则的不允许其发货。
isv.logistics-offline-service-error:P01	参数为空	必填参数为空，如tid为空，请确保传入的必选参数不为空,请对照参数表
isv.logistics-offline-service-error:B101	地址库不存在或该地址库不属于当前用户	可以通过此接口查询地址库taobao.logistics.address.search
isv.logistics-offline-service-error:P03	没有用户ID	检查用户是否登录，或session过期
isv.logistics-offline-service-error:B27	已生成发货单	已经生成发货单的订单不能发货
isv.logistics-offline-service-error:B58	物流公司名称过长	物流公司名称过长,长度在20个字符
isv.logistics-offline-service-error:B57	该物流公司不支持自己联系	该物流公司不支持自己联系,通过taobao.logistics.companies.get查询支持自已联系的物流公司
isv.logistics-offline-service-error:B55	该交易状态不正确，不能发货	建议在发货前先调用交易API如：taobao.trade.fullinfo.get来查询这个订单的状态，根据订单状态再做相应的处理，避免状态为已发货订单进行重复发货
isv.logistics-offline-service-error:B109	对不起，您尚未成功订购E速宝物流服务	订购E速宝服务
isv.logistics-offline-service-error:B110	对不起，该订单超出了E速宝的服务范围，请联系小二处理	检查收货地址和发货地址
isv.logistics-update-company-or-mailno-error:P01	参数错误	校验入参是否正确
isv.logistics-update-company-or-mailno-error:P02	物流订单不存在	检查订单是否存在
isv.logistics-update-company-or-mailno-error:P03	无效的物流公司	物流公司和不合法，请选择一个正确的物流公司
isv.logistics-update-company-or-mailno-error:P04	无效的订单类型	检验logist_type不合法
isv.logistics-update-company-or-mailno-error:CD19	订单未发货	请先发货后再修改
isv.logistics-update-company-or-mailno-error:P05	不支持的订单类型	只支持在线，COD,自己联系和保障速递的订单
isv.logistics-update-company-or-mailno-error:P06	当前订单状态不支持修改	检验订单状态
isv.logistics-update-company-or-mailno-error:P07	未作修改	确认是否需要调用本接口
isv.logistics-update-company-or-mailno-error:P08	该订单不支持修改。如不虚拟发货方式，这种方式该api 是不支持修改的	报错后应用程序做好控制，禁止重试，并做相应提示。
isv.logistics-offline-service-error:P25	top 接口不允许对拆单订单操作	top 接口不允许对拆单订单进行操作
isv.logistics-update-company-or-mailno-error:F	运单号被识别为假，无法发货	请使用正确的运单号
isv.logistics-update-company-or-mailno-error:F01	您填写的运单号已经过期无效，不允许用此物流运单号发货	请使用正确的运单号
isv.logistics-update-company-or-mailno-error:F02	您此笔交易订单付款时间晚于快递公司揽收时间，此物流运单号不能使用	请使用正确的运单号
isv.logistics-update-company-or-mailno-error:F03	您此笔交易订单收货人地址信息与快递公司签收地址信息不匹配，此物流运单号不能使用	请使用正确的运单号
isv.logistics-update-company-or-mailno-error:F04	运单号已被使用，当前订单非真，此物流单号不能使用	请使用正确的运单号
isv.logistics-update-company-or-mailno-error:F05	您填写的运单号已被使用，不允许用此物流运单号发货	请使用正确的运单号
isv.logistics-update-company-or-mailno-error:F06	您的收货人信息与发货人信息一致，不允许发货	请确认信息
isv.logistics-update-company-or-mailno-error:CD22	订单已拆单，必须传入子交易号列表	这个是已经被拆单的，操作这个订单发货时，必须带有子订单列表
isv.logistics-update-company-or-mailno-error:CD23	订单已拆单，请走拆单逻辑	订单已拆单，请走拆单逻辑,issplit和子订单列表必须都传入
isv.logistics-update-company-or-mailno-error:CD24	入参传入的主子交易号组合逻辑非法	入参传入的主子交易号组合逻辑非法，子订单列表不在对应的物流订单中，请传入对应的子订单列表
isv.logistics-update-company-or-mailno-error:CD25	拆单标记和子订单列表两者必须都填或者都不填	拆单标记和子订单列表两者必须都填或者都不填
isv.logistics-update-company-or-mailno-error:CD26	子订单交易号为空	当传递isSplit 为1后，必须传递该订单下的子订单交易号。
isv.logistics-update-company-or-mailno-error:CD27	订单已经被拆单,isSplit 必须是1	订单已经被拆单,isSplit 必须是1
isv.logistics-update-company-or-mailno-error:CD28	接入拆单异常	拆单逻辑未知错误，请确认发货参数
isv.logistics-update-company-or-mailno-error:B05	未查到物流订单	拆单订单校验子订单过程中未查到物流订单
isv.logistics-update-company-or-mailno-error:B03	传入的子订单号不同时在一个物流包裹中	传入的子订单号不同时在一个物流包裹中。传入订单时请输入同一个
isv.logistics-update-company-or-mailno-error:B04	其他异常	请确认输入订单参数后重试
isv.logistics-update-company-or-mailno-error:CD29	当前操作的订单不是拆单订单，拆单标记和子订单列表都不能带入	当前操作的订单不是拆单订单，拆单标记和子订单列表都不能带入
isv.logistics-update-company-or-mailno-error:B06	子订单号没有精确匹配	传入的子订单交易号必须完全匹配物流包裹中的子订单
isv.logistics-update-company-or-mailno-error:CD30	输入的用户Id或交易订单号不正确,未查到交易订单	请输入正确的用户ID和交易订单号
isv.logistics-update-company-or-mailno-error:CD31	非拆单订单的物流订单数不等于1	请联系淘宝物流开发
isv.logistics-update-company-or-mailno-error:P10	运单号错误或已经被使用	请检查运单号是否正确，或联系物流公司更换运单号
isv.logistics-offline-service-error:isv.logistics-offline-service-error:B60	运单号错误或已经被使用	请检查运单号是否正确，或联系物流公司更换运单号
isv.logistics-update-company-or-mailno-error:P09	不支持切换为该物流公司	请检查新切换的物流公司信息是否正确
isv.logistics-offline-service-error:isv.logistics-offline-service-error:B52	物流公司不存在或被禁用	请检查新更换的物流公司信息是否正确
isv.logistics-online-service-error:AT0011	物流订单状态不为新建状态,无需发货处理	物流订单状态不为新建状态,无需发货处理
isp.top-remote-unknown-error	远程调用发生未知错误	请重试，重试不成功，联系相关小二解决
isv.logistics-offline-service-error:isv.logistics-offline-service-error:CONSIGN_FAIL	发货失败	请重试，重试不成功，联系相关小二解决
isv.logistics-offline-service-error:isv.logistics-offline-service-error:AT0011	物流订单状态不为新建状态,无需发货处理	物流订单状态不为新建状态,无需发货处理
isv.logistics-offline-service-error:isv.logistics-offline-service-error:B109	对不起，您尚未成功订购E速宝物流服务	请先订购E速宝物流服务，再进行发货
CD01	系统异常，请重试	如果长时间一直出现，请联系平台技术，并提供api请求的requestId
B60	运单号不符合规则或已经被使用	运单号不符合规则或已经被使用,请确认运单号是否正确
P06	当前订单状态不支持修改	当前订单状态不支持修改
S01	查询订单系统出现异常,请重试	如果长时间一直出现，请联系平台技术，并提供api请求的requestId
CD68	该物流单号为无法识别或快递公司未同平台对接	该物流单号为无法识别或快递公司未同平台对接
P05	不支持的订单类型	不支持的订单类型
CD02	参数为空	参数为空,请确认没有未传的参数
B06	传入的子订单交易号必须完全匹配物流包裹中的子订单,请检查子交易ID是否一致	传入的子订单交易号必须完全匹配物流包裹中的子订单,请检查子交易ID是否一致
B150	发货异常,发货请求存在并发情况，请稍后重试	如果长时间一直出现，请联系平台技术，并提供api请求的requestId
CD04	没有权限进行发货	没有权限进行发货，请确认订单状态
CD69	该物流公司不支持这种服务	该物流公司不支持这种服务

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

开放平台

物流API

taobao.logistics.consign.resend (修改物流公司和运单号)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ