淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
printer_model	String	可选	惠普打印机	打印机型号
province_full_name	String	可选	陕西省	省名称
district_code	Number	可选	1001	区编码
pay_time	String	可选	2020-10-05 22:21:36	支付时间
city_code	Number	可选	1001	市编码
manager_price	String	可选	12.11	门店分成(最多支持两位小数)
discount_price	String	可选	12.34	优惠金额(最多支持两位小数)
city_full_name	String	可选	西安市	市名称
shop_name	String	可选	测试店铺	店铺名称
business_price	String	可选	12.21	彩萝卜分成(最多支持两位小数)
district_full_name	String	可选	雁塔区	区名称
withdrawn_time	String	可选	2020-10-05 22:21:36	分账时间
client_type	String	可选	端口类型	端口类型
available_type_name	String	可选	介质名称	介质名称
design_count	Number	可选	10	打印页数
price	String	可选	13.24	金额(最多支持两位小数)
pay_price	String	可选	12.00	支付金额(最多支持两位小数)
order_price	String	可选	11.11	结算金额(最多支持两位小数)
sn	String	必须	10001	订单编号
shop_sn	String	必须	10001	门店sn
state	String	可选	paid	订单状态
refund_price	String	可选	12.11	退款金额(最多支持两位小数)
base_price	String	可选	12.11	第三方接口费(最多支持两位小数)
printer_maker	String	可选	惠普打印机厂商	打印机厂商
channel_merchant_price	String	可选	1.2	经销商分成(最多支持两位小数)
manager	String	可选	{"phone":"13456790918","name":"测试店铺"}	manager
province_code	Number	可选	10001	省编码
patfee	String	可选	0.01	手续费(最多支持两位小数)
group_promoter_price	String	可选	0.2	地推分成(最多支持两位小数)
third_number	String	可选	456	门店编号
sys_price	String	可选	0.9	系统抽成(最多支持两位小数)
is_withdrawn	Boolean	可选	true	是否完成分账(true:完成 fasle:未完成)
client_num	String	可选	001	绑定的端口号
update_time	String	必须	2020-10-05 22:21:36	更新时间

名称	类型	示例值	描述
trace_id	String	2340984084058043850348950	traceId，xx位，链路追踪排查问题使用
e_code	String	xxx	错误编码
e_msg	String	xxx	错误信息
is_success	Boolean	true	是否调用成功
model	Boolean	true	业务内部是否处理成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoCntecLocallifePrintOrderSyncRequest req = new CainiaoCntecLocallifePrintOrderSyncRequest();
req.setPrinterModel("惠普打印机");
req.setProvinceFullName("陕西省");
req.setDistrictCode(1001L);
req.setPayTime("2020-10-05 22:21:36");
req.setCityCode(1001L);
req.setManagerPrice("12.11");
req.setDiscountPrice("12.34");
req.setCityFullName("西安市");
req.setShopName("测试店铺");
req.setBusinessPrice("12.21");
req.setDistrictFullName("雁塔区");
req.setWithdrawnTime("2020-10-05 22:21:36");
req.setClientType("端口类型");
req.setAvailableTypeName("介质名称");
req.setDesignCount(10L);
req.setPrice("13.24");
req.setPayPrice("12.00");
req.setOrderPrice("11.11");
req.setSn("10001");
req.setShopSn("10001");
req.setState("paid");
req.setRefundPrice("12.11");
req.setBasePrice("12.11");
req.setPrinterMaker("惠普打印机厂商");
req.setChannelMerchantPrice("1.2");
req.setManager("{\"phone\":\"13456790918\",\"name\":\"测试店铺\"}");
req.setProvinceCode(10001L);
req.setPatfee("0.01");
req.setGroupPromoterPrice("0.2");
req.setThirdNumber("456");
req.setSysPrice("0.9");
req.setIsWithdrawn(true);
req.setClientNum("001");
req.setUpdateTime("2020-10-05 22:21:36");
CainiaoCntecLocallifePrintOrderSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
CainiaoCntecLocallifePrintOrderSyncRequest req = new CainiaoCntecLocallifePrintOrderSyncRequest();
req.PrinterModel = "惠普打印机";
req.ProvinceFullName = "陕西省";
req.DistrictCode = 1001L;
req.PayTime = "2020-10-05 22:21:36";
req.CityCode = 1001L;
req.ManagerPrice = "12.11";
req.DiscountPrice = "12.34";
req.CityFullName = "西安市";
req.ShopName = "测试店铺";
req.BusinessPrice = "12.21";
req.DistrictFullName = "雁塔区";
req.WithdrawnTime = "2020-10-05 22:21:36";
req.ClientType = "端口类型";
req.AvailableTypeName = "介质名称";
req.DesignCount = 10L;
req.Price = "13.24";
req.PayPrice = "12.00";
req.OrderPrice = "11.11";
req.Sn = "10001";
req.ShopSn = "10001";
req.State = "paid";
req.RefundPrice = "12.11";
req.BasePrice = "12.11";
req.PrinterMaker = "惠普打印机厂商";
req.ChannelMerchantPrice = "1.2";
req.Manager = "{\"phone\":\"13456790918\",\"name\":\"测试店铺\"}";
req.ProvinceCode = 10001L;
req.Patfee = "0.01";
req.GroupPromoterPrice = "0.2";
req.ThirdNumber = "456";
req.SysPrice = "0.9";
req.IsWithdrawn = true;
req.ClientNum = "001";
req.UpdateTime = "2020-10-05 22:21:36";
CainiaoCntecLocallifePrintOrderSyncResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new CainiaoCntecLocallifePrintOrderSyncRequest;
$req->setPrinterModel("惠普打印机");
$req->setProvinceFullName("陕西省");
$req->setDistrictCode("1001");
$req->setPayTime("2020-10-05 22:21:36");
$req->setCityCode("1001");
$req->setManagerPrice("12.11");
$req->setDiscountPrice("12.34");
$req->setCityFullName("西安市");
$req->setShopName("测试店铺");
$req->setBusinessPrice("12.21");
$req->setDistrictFullName("雁塔区");
$req->setWithdrawnTime("2020-10-05 22:21:36");
$req->setClientType("端口类型");
$req->setAvailableTypeName("介质名称");
$req->setDesignCount("10");
$req->setPrice("13.24");
$req->setPayPrice("12.00");
$req->setOrderPrice("11.11");
$req->setSn("10001");
$req->setShopSn("10001");
$req->setState("paid");
$req->setRefundPrice("12.11");
$req->setBasePrice("12.11");
$req->setPrinterMaker("惠普打印机厂商");
$req->setChannelMerchantPrice("1.2");
$req->setManager("{\"phone\":\"13456790918\",\"name\":\"测试店铺\"}");
$req->setProvinceCode("10001");
$req->setPatfee("0.01");
$req->setGroupPromoterPrice("0.2");
$req->setThirdNumber("456");
$req->setSysPrice("0.9");
$req->setIsWithdrawn("true");
$req->setClientNum("001");
$req->setUpdateTime("2020-10-05 22:21:36");
$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=cainiao.cntec.locallife.print.order.sync' \
-d 'partner_id=apidoc' \
-d 'sign=21E9AEC1A736B02F38288E60FEC27F18' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-01+06%3A57%3A17' \
-d 'v=2.0' \
-d 'available_type_name=%E4%BB%8B%E8%B4%A8%E5%90%8D%E7%A7%B0' \
-d 'base_price=12.11' \
-d 'business_price=12.21' \
-d 'channel_merchant_price=1.2' \
-d 'city_code=1001' \
-d 'city_full_name=%E8%A5%BF%E5%AE%89%E5%B8%82' \
-d 'client_num=001' \
-d 'client_type=%E7%AB%AF%E5%8F%A3%E7%B1%BB%E5%9E%8B' \
-d 'design_count=10' \
-d 'discount_price=12.34' \
-d 'district_code=1001' \
-d 'district_full_name=%E9%9B%81%E5%A1%94%E5%8C%BA' \
-d 'group_promoter_price=0.2' \
-d 'is_withdrawn=true' \
-d 'manager=%7B%5C%22phone%5C%22%3A%5C%2213456790918%5C%22%2C%5C%22name%5C%22%3A%5C%22%E6%B5%8B%E8%AF%95%E5%BA%97%E9%93%BA%5C%22%7D' \
-d 'manager_price=12.11' \
-d 'order_price=11.11' \
-d 'patfee=0.01' \
-d 'pay_price=12.00' \
-d 'pay_time=2020-10-05+22%3A21%3A36' \
-d 'price=13.24' \
-d 'printer_maker=%E6%83%A0%E6%99%AE%E6%89%93%E5%8D%B0%E6%9C%BA%E5%8E%82%E5%95%86' \
-d 'printer_model=%E6%83%A0%E6%99%AE%E6%89%93%E5%8D%B0%E6%9C%BA' \
-d 'province_code=10001' \
-d 'province_full_name=%E9%99%95%E8%A5%BF%E7%9C%81' \
-d 'refund_price=12.11' \
-d 'shop_name=%E6%B5%8B%E8%AF%95%E5%BA%97%E9%93%BA' \
-d 'shop_sn=10001' \
-d 'sn=10001' \
-d 'state=paid' \
-d 'sys_price=0.9' \
-d 'third_number=456' \
-d 'update_time=2020-10-05+22%3A21%3A36' \
-d 'withdrawn_time=2020-10-05+22%3A21%3A36'

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

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

req.printer_model="惠普打印机"
req.province_full_name="陕西省"
req.district_code=1001
req.pay_time="2020-10-05 22:21:36"
req.city_code=1001
req.manager_price="12.11"
req.discount_price="12.34"
req.city_full_name="西安市"
req.shop_name="测试店铺"
req.business_price="12.21"
req.district_full_name="雁塔区"
req.withdrawn_time="2020-10-05 22:21:36"
req.client_type="端口类型"
req.available_type_name="介质名称"
req.design_count=10
req.price="13.24"
req.pay_price="12.00"
req.order_price="11.11"
req.sn="10001"
req.shop_sn="10001"
req.state="paid"
req.refund_price="12.11"
req.base_price="12.11"
req.printer_maker="惠普打印机厂商"
req.channel_merchant_price="1.2"
req.manager="{\"phone\":\"13456790918\",\"name\":\"测试店铺\"}"
req.province_code=10001
req.patfee="0.01"
req.group_promoter_price="0.2"
req.third_number="456"
req.sys_price="0.9"
req.is_withdrawn=true
req.client_num="001"
req.update_time="2020-10-05 22:21:36"
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,"cainiao.cntec.locallife.print.order.sync");
add_param(pRequest,"printer_model","惠普打印机");
add_param(pRequest,"province_full_name","陕西省");
add_param(pRequest,"district_code","1001");
add_param(pRequest,"pay_time","2020-10-05 22:21:36");
add_param(pRequest,"city_code","1001");
add_param(pRequest,"manager_price","12.11");
add_param(pRequest,"discount_price","12.34");
add_param(pRequest,"city_full_name","西安市");
add_param(pRequest,"shop_name","测试店铺");
add_param(pRequest,"business_price","12.21");
add_param(pRequest,"district_full_name","雁塔区");
add_param(pRequest,"withdrawn_time","2020-10-05 22:21:36");
add_param(pRequest,"client_type","端口类型");
add_param(pRequest,"available_type_name","介质名称");
add_param(pRequest,"design_count","10");
add_param(pRequest,"price","13.24");
add_param(pRequest,"pay_price","12.00");
add_param(pRequest,"order_price","11.11");
add_param(pRequest,"sn","10001");
add_param(pRequest,"shop_sn","10001");
add_param(pRequest,"state","paid");
add_param(pRequest,"refund_price","12.11");
add_param(pRequest,"base_price","12.11");
add_param(pRequest,"printer_maker","惠普打印机厂商");
add_param(pRequest,"channel_merchant_price","1.2");
add_param(pRequest,"manager","{\"phone\":\"13456790918\",\"name\":\"测试店铺\"}");
add_param(pRequest,"province_code","10001");
add_param(pRequest,"patfee","0.01");
add_param(pRequest,"group_promoter_price","0.2");
add_param(pRequest,"third_number","456");
add_param(pRequest,"sys_price","0.9");
add_param(pRequest,"is_withdrawn","true");
add_param(pRequest,"client_num","001");
add_param(pRequest,"update_time","2020-10-05 22:21:36");
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('cainiao.cntec.locallife.print.order.sync', {
	'printer_model':'惠普打印机',
	'province_full_name':'陕西省',
	'district_code':'1001',
	'pay_time':'2020-10-05 22:21:36',
	'city_code':'1001',
	'manager_price':'12.11',
	'discount_price':'12.34',
	'city_full_name':'西安市',
	'shop_name':'测试店铺',
	'business_price':'12.21',
	'district_full_name':'雁塔区',
	'withdrawn_time':'2020-10-05 22:21:36',
	'client_type':'端口类型',
	'available_type_name':'介质名称',
	'design_count':'10',
	'price':'13.24',
	'pay_price':'12.00',
	'order_price':'11.11',
	'sn':'10001',
	'shop_sn':'10001',
	'state':'paid',
	'refund_price':'12.11',
	'base_price':'12.11',
	'printer_maker':'惠普打印机厂商',
	'channel_merchant_price':'1.2',
	'manager':'{\"phone\":\"13456790918\",\"name\":\"测试店铺\"}',
	'province_code':'10001',
	'patfee':'0.01',
	'group_promoter_price':'0.2',
	'third_number':'456',
	'sys_price':'0.9',
	'is_withdrawn':'true',
	'client_num':'001',
	'update_time':'2020-10-05 22:21:36'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<cainiao_cntec_locallife_print_order_sync_response>
    <trace_id>2340984084058043850348950</trace_id>
    <e_code>xxx</e_code>
    <e_msg>xxx</e_msg>
    <is_success>true</is_success>
    <model>true</model>
</cainiao_cntec_locallife_print_order_sync_response>

{
    "cainiao_cntec_locallife_print_order_sync_response":{
        "trace_id":"2340984084058043850348950",
        "e_code":"xxx",
        "e_msg":"xxx",
        "is_success":true,
        "model":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"
	}
}

错误码	错误描述	解决方案

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

开放平台

菜鸟末端商业

cainiao.cntec.locallife.print.order.sync (彩萝卜打印订单数据回流)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ