淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
trace_info	CtsInfo	可选			入参traceInfo
carriage CtsCarriage 可选托运 └ begin Date 可选 2017-01-01 00:00:00 托运开始时间 └ carriage_no String 可选 foo 托运单号 └ company_name String 可选 foo 托运公司名称 └ end Date 可选 2017-01-01 00:00:00 托运结束时间 completed_ngtc CtsNgtc 可选成品证书 └ report_no String 可选 foo ngtc证书编号 └ report_verify_no String 可选 foo ngtc证书防伪码 delivery CtsDelivery 可选国内物流 └ company_name String 可选 foo 快递公司名称 └ delivery_no String 可选 foo 快递单号 └ delivery_time Date 可选 2017-01-01 00:00:00 发件时间 diamond_ngtc CtsNgtc 可选裸钻证书 └ report_no String 可选 foo ngtc证书编号 └ report_verify_no String 可选 foo ngtc证书防伪码 └ item_id String 可选 foo 货品ID └ order_no String 可选 foo 订单号 └ product_id String 可选 foo 商品ID ring CtsRing 可选戒托信息 └ completed_time Date 可选 2017-01-01 00:00:00 成品生产完成时间 └ ext_info 可选 {} 额外信息 └ item_id String 可选 foo 戒托货品ID └ mount_time Date 可选 2017-01-01 00:00:00 戒托镶嵌完成时间 └ order_no String 可选 foo 戒托订单号 └ product_id String 可选 foo 戒托商品Id └ ring_time Date 可选 2017-01-01 00:00:00 戒托生产完成时间 └ sub_order_no String 可选 foo 戒托子订单号 shipment CtsShipment 可选国内报关 └ begin Date 可选 2017-01-01 00:00:00 报关开始时间 └ end Date 可选 2017-01-01 00:00:00 报关结束时间 └ shipment_no String 可选 foo 报关单号 └ sub_order_no String 可选 foo 子订单号 └ trace_code String 可选 foo 溯源码

名称	类型	示例值	描述
result	DataResult		result
└ code String foo 参数code └ msg String foo 参数msg └ success Boolean false 是否正常

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallTraceplatformCtsInfoUploadRequest req = new TmallTraceplatformCtsInfoUploadRequest();
TmallTraceplatformCtsInfoUploadRequest.CtsInfo obj1 = new TmallTraceplatformCtsInfoUploadRequest.CtsInfo();
TmallTraceplatformCtsInfoUploadRequest.CtsCarriage obj2 = new TmallTraceplatformCtsInfoUploadRequest.CtsCarriage();
obj2.setBegin(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj2.setCarriageNo("foo");
obj2.setCompanyName("foo");
obj2.setEnd(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj1.setCarriage(obj2);
TmallTraceplatformCtsInfoUploadRequest.CtsNgtc obj3 = new TmallTraceplatformCtsInfoUploadRequest.CtsNgtc();
obj3.setReportNo("foo");
obj3.setReportVerifyNo("foo");
obj1.setCompletedNgtc(obj3);
TmallTraceplatformCtsInfoUploadRequest.CtsDelivery obj4 = new TmallTraceplatformCtsInfoUploadRequest.CtsDelivery();
obj4.setCompanyName("foo");
obj4.setDeliveryNo("foo");
obj4.setDeliveryTime(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj1.setDelivery(obj4);
TmallTraceplatformCtsInfoUploadRequest.CtsNgtc obj5 = new TmallTraceplatformCtsInfoUploadRequest.CtsNgtc();
obj5.setReportNo("foo");
obj5.setReportVerifyNo("foo");
obj1.setDiamondNgtc(obj5);
obj1.setItemId("foo");
obj1.setOrderNo("foo");
obj1.setProductId("foo");
TmallTraceplatformCtsInfoUploadRequest.CtsRing obj6 = new TmallTraceplatformCtsInfoUploadRequest.CtsRing();
obj6.setCompletedTime(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj6.setItemId("foo");
obj6.setMountTime(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj6.setOrderNo("foo");
obj6.setProductId("foo");
obj6.setRingTime(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj6.setSubOrderNo("foo");
obj1.setRing(obj6);
TmallTraceplatformCtsInfoUploadRequest.CtsShipment obj7 = new TmallTraceplatformCtsInfoUploadRequest.CtsShipment();
obj7.setBegin(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj7.setEnd(StringUtils.parseDateTime("2017-01-01 00:00:00"));
obj7.setShipmentNo("foo");
obj1.setShipment(obj7);
obj1.setSubOrderNo("foo");
obj1.setTraceCode("foo");
req.setTraceInfo(obj1);
TmallTraceplatformCtsInfoUploadResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallTraceplatformCtsInfoUploadRequest req = new TmallTraceplatformCtsInfoUploadRequest();
TmallTraceplatformCtsInfoUploadRequest.CtsInfoDomain obj1 = new TmallTraceplatformCtsInfoUploadRequest.CtsInfoDomain();
TmallTraceplatformCtsInfoUploadRequest.CtsCarriageDomain obj2 = new TmallTraceplatformCtsInfoUploadRequest.CtsCarriageDomain();
obj2.Begin = DateTime.Parse(2017-01-01 00:00:00");
obj2.CarriageNo = "foo";
obj2.CompanyName = "foo";
obj2.End = DateTime.Parse(2017-01-01 00:00:00");
obj1.Carriage= obj2;
TmallTraceplatformCtsInfoUploadRequest.CtsNgtcDomain obj3 = new TmallTraceplatformCtsInfoUploadRequest.CtsNgtcDomain();
obj3.ReportNo = "foo";
obj3.ReportVerifyNo = "foo";
obj1.CompletedNgtc= obj3;
TmallTraceplatformCtsInfoUploadRequest.CtsDeliveryDomain obj4 = new TmallTraceplatformCtsInfoUploadRequest.CtsDeliveryDomain();
obj4.CompanyName = "foo";
obj4.DeliveryNo = "foo";
obj4.DeliveryTime = DateTime.Parse(2017-01-01 00:00:00");
obj1.Delivery= obj4;
TmallTraceplatformCtsInfoUploadRequest.CtsNgtcDomain obj5 = new TmallTraceplatformCtsInfoUploadRequest.CtsNgtcDomain();
obj5.ReportNo = "foo";
obj5.ReportVerifyNo = "foo";
obj1.DiamondNgtc= obj5;
obj1.ItemId = "foo";
obj1.OrderNo = "foo";
obj1.ProductId = "foo";
TmallTraceplatformCtsInfoUploadRequest.CtsRingDomain obj6 = new TmallTraceplatformCtsInfoUploadRequest.CtsRingDomain();
obj6.CompletedTime = DateTime.Parse(2017-01-01 00:00:00");
obj6.ItemId = "foo";
obj6.MountTime = DateTime.Parse(2017-01-01 00:00:00");
obj6.OrderNo = "foo";
obj6.ProductId = "foo";
obj6.RingTime = DateTime.Parse(2017-01-01 00:00:00");
obj6.SubOrderNo = "foo";
obj1.Ring= obj6;
TmallTraceplatformCtsInfoUploadRequest.CtsShipmentDomain obj7 = new TmallTraceplatformCtsInfoUploadRequest.CtsShipmentDomain();
obj7.Begin = DateTime.Parse(2017-01-01 00:00:00");
obj7.End = DateTime.Parse(2017-01-01 00:00:00");
obj7.ShipmentNo = "foo";
obj1.Shipment= obj7;
obj1.SubOrderNo = "foo";
obj1.TraceCode = "foo";
req.TraceInfo_ = obj1;
TmallTraceplatformCtsInfoUploadResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

XML示例
JSON示例

<tmall_traceplatform_cts_info_upload_response>
    <result>
        <code>foo</code>
        <msg>foo</msg>
        <success>false</success>
    </result>
</tmall_traceplatform_cts_info_upload_response>

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>

错误码	错误描述	解决方案

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

天猫国际API

tmall.traceplatform.cts.info.upload (CTS提交溯源信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ