淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
feature	String	可选	identCode=tid1:123,456;machineCode=tid2:aaaa	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地址
tid	Number	必须	255582	淘宝交易ID

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

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsDummySendRequest req = new LogisticsDummySendRequest();
req.setFeature("identCode=tid1:123,456;machineCode=tid2:aaaa");
req.setSellerIp("192.168.1.10");
req.setTid(255582L);
LogisticsDummySendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
LogisticsDummySendRequest req = new LogisticsDummySendRequest();
req.Feature = "identCode=tid1:123,456;machineCode=tid2:aaaa";
req.SellerIp = "192.168.1.10";
req.Tid = 255582L;
LogisticsDummySendResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new LogisticsDummySendRequest;
$req->setFeature("identCode=tid1:123,456;machineCode=tid2:aaaa");
$req->setSellerIp("192.168.1.10");
$req->setTid("255582");
$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.dummy.send' \
-d 'partner_id=apidoc' \
-d 'session=939f939e-6bfd-4fa6-be1d-92f182e04144' \
-d 'sign=F4FB2FFB68C02025E80DD110DC6F5977' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+16%3A47%3A45' \
-d 'v=2.0' \
-d 'feature=identCode%3Dtid1%3A123%2C456%3BmachineCode%3Dtid2%3Aaaaa' \
-d 'seller_ip=192.168.1.10' \
-d 'tid=255582'

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

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

req.feature="identCode=tid1:123,456;machineCode=tid2:aaaa"
req.seller_ip="192.168.1.10"
req.tid=255582
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.dummy.send");
add_param(pRequest,"feature","identCode=tid1:123,456;machineCode=tid2:aaaa");
add_param(pRequest,"seller_ip","192.168.1.10");
add_param(pRequest,"tid","255582");
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.dummy.send', {
	'feature':'identCode=tid1:123,456;machineCode=tid2:aaaa',
	'seller_ip':'192.168.1.10',
	'tid':'255582'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<logistics_dummy_send_response>
    <shipping>
        <is_success>true</is_success>
    </shipping>
</logistics_dummy_send_response>

{
    "logistics_dummy_send_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-dummy-service-error:B01	物流订单不存在	调用发货接口前要先判断tid是不是属于自身的tid，并且需要判断tid是否存在，最好用搜索出来的tid列表里面的数据传入。
isv.logistics-dummy-service-error:B02	没有权限进行发货	在发货前要判断好订单的状态，只有交易存在、属于自己、并且是等待卖家发货的才能发，其余的状态无需调用这个接口。
isv.logistics-dummy-service-error:B04	物流订单状态不对	1.遇到isv开头的错误不要在程序重试； 2.建议在发货前先调用交易API如：taobao.logistics.orders.detail.get来查询这个物流订单的状态，根据订单状态再做相应的处理，避免状态为已发货订单进行重复发货
isv.logistics-dummy-service-error:P01	参数为空	必填参数为空，如tid为空，请确保传入的必选参数不为空,请对照参数表
isv.invalid-parameter	参数无效，格式不对、非法值、越界等	请对照参数表，
isv.logistics-dummy-service-error:B98	发货类型不匹配	非虚拟物品，不能用虚拟发货。
isv.logistics-dummy-service-error:P03	没有用户ID	检查用户是否登录，或session过期
isv.logistics-dummy-service-error:B55	该交易状态不正确，不能发货	建议在发货前先调用交易API如：taobao.trade.fullinfo.get来查询这个订单的状态，根据订单状态再做相应的处理，避免状态为已发货订单进行重复发货
isv.logistics-dummy-service-error:B27	已生成发货单	已经生成发货单的订单不能发货
isv.logistics-dummy-service-error:S01	系统异常	比如同步交易失败系统之间依赖调用超时了一般情况下重试可以解决
isv.logistics-dummy-service-error:P25	top 接口不允许对拆单订单操作	top 接口不允许对拆单订单进行操作
isv.logistics-dummy-service-error:CD21	已拆单订单不能进行无需物流发货	top 接口不允许对拆单订单进行操作
isv.logistics-dummy-service-error:B54	不支持该种发货方式	这个错误，提示目前的订单是不能用虚拟发货方式发货，请用非虚拟发货接口发货。
isv.logistics-offline-service-error:B150	发货异常，请稍等后重试	发货异常，请稍等后重试
isv.logistics-dummy-service-error:AT0011	物流订单状态不为新建状态,无需发货处理	物流订单状态不为新建状态,无需发货处理
isv.logistics-offline-service-error:ORDER_NOT_FOUND_ERROR	没有找到对应的订单	请核对订单号是否输入正确
isv.logistics-dummy-service-error:CONSIGN_FAIL	发货失败	发货失败，请重试。重试多次依旧失败，请联系相关小二处理
isv.logistics-dummy-service-error:AT0112	推荐物流的订单状态为关闭状态,无需发货处理	推荐物流的订单状态为关闭状态,无需发货处理
isv.logistics-delivery-service-error:B02	没有权限进行发货	没有权限进行发货
isv.logistics-dummy-service-error:P38	拆单校验未通过	请检查拆单参数是否正确
B01	不能进行操作，当前状态：等待确认	不能进行操作，当前状态：等待确认
CD74	未找到该淘系订单	请确认当前订单是否正确
BN01	销售商品为实物商品时，将无法使用无需物流方式发货，请选择正确的发货方式。	销售商品为实物商品时，将无法使用无需物流方式发货，请选择正确的发货方式。
CD06	推荐物流的订单状态为关闭状态,无需发货处理	推荐物流的订单状态为关闭状态,无需发货处理
B150	发货异常,发货请求存在并发情况，请稍后重试	发货异常,发货请求存在并发情况，请稍控制频率后重试
CD21	已拆单订单不能进行无需物流发货	已拆单订单不能进行无需物流发货
CD04	没有权限进行发货	没有权限进行发货,请确认下当前订单状态
CD01	系统错误	如果一直发生请联系平台技术并提供请求返还的requestId
CONSIGN_FUZZY_QUERY_ORDER_ERROR	查询订单系统出现异常,请重试	如果一直发生请联系平台技术并提供请求返还的requestId
CONSIGN_SYS_ERROR	系统异常	如果一直发生请联系平台技术并提供请求返还的requestId

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

开放平台

淘宝物流API

taobao.logistics.dummy.send (无需物流（虚拟）发货处理)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ