淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
fields	String	必须	tid,type,status,payment,orders,promotion_details		需要返回的字段列表，多个字段用半角逗号分隔，可选值为返回示例中能看到的所有字段。
tid	Number	必须	123456789		交易编号

名称	类型	示例值	描述
trade	Trade		交易主订单信息
└ buyer_open_uid String AAHk5d-EAAeGwJedwSFu0XXX 买家OpenUid └ title String 麦包包交易标题，以店铺名作为此标题的值。注:taobao.trades.get接口返回的Trade中的title是商品名称 └ type String fixed(一口价) 交易类型列表，同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade, auto_delivery, ec, cod的4种交易类型的数据可选值 fixed(一口价) auction(拍卖) guarantee_trade(一口价、拍卖) auto_delivery(自动发货) independent_simple_trade(旺店入门版交易) independent_shop_trade(旺店标准版交易) ec(直冲) cod(货到付款) fenxiao(分销) game_equipment(游戏装备) shopex_trade(ShopEX交易) netcn_trade(万网交易) external_trade(统一外部交易)o2o_offlinetrade（O2O交易）step (万人团)nopaid(无付款订单)pre_auth_type(预授权0元购机交易) └ created Date 2000-01-01 00:00:00 交易创建时间。格式:yyyy-MM-dd HH:mm:ss └ tid String 2231958349 交易编号 (父订单的交易编号) └ seller_rate Boolean true 卖家是否已评价。可选值:true(已评价),false(未评价) └ buyer_rate Boolean true 买家是否已评价。可选值:true(已评价),false(未评价)。如买家只评价未打分，此字段仍返回false └ status String TRADE_NO_CREATE_PAY 交易状态。可选值: * TRADE_NO_CREATE_PAY(没有创建支付宝交易) * WAIT_BUYER_PAY(等待买家付款) * SELLER_CONSIGNED_PART(卖家部分发货) * WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) * WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) * TRADE_BUYER_SIGNED(买家已签收,货到付款专用) * TRADE_FINISHED(交易成功) * TRADE_CLOSED(付款以后用户退款成功，交易自动关闭) * TRADE_CLOSED_BY_TAOBAO(付款以前，卖家或买家主动关闭交易) * PAY_PENDING(国际信用卡支付付款确认中) * WAIT_PRE_AUTH_CONFIRM(0元购合约中) * PAID_FORBID_CONSIGN(拼团中订单或者发货强管控的订单，已付款但禁止发货) └ payment String 200.07 实付金额。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ discount_fee String 200.07 建议使用trade.promotion_details查询系统优惠系统优惠金额（如打折，VIP，满就送等），精确到2位小数，单位：元。如：200.07，表示：200元7分 └ adjust_fee String 200.07 卖家手工调整金额，精确到2位小数，单位：元。如：200.07，表示：200元7分。来源于订单价格修改，如果有多笔子订单的时候，这个为0，单笔的话则跟[order].adjust_fee一样 └ post_fee String 200.07 邮费。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ total_fee String 200.07 商品金额（商品价格乘以数量的总金额）。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ pay_time Date 2000-01-01 00:00:00 付款时间。格式:yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。 └ end_time Date 2000-01-01 00:00:00 交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间。格式:yyyy-MM-dd HH:mm:ss └ modified Date 2000-01-01 00:00:00 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss └ consign_time Date 2000-01-01 00:00:00 卖家发货时间。格式:yyyy-MM-dd HH:mm:ss └ received_payment String 200.07 卖家实际收到的支付宝打款金额（由于子订单可以部分确认收货，这个金额会随着子订单的确认收货而不断增加，交易成功后等于买家实付款减去退款金额）。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ buyer_memo String 上衣要大一号买家备注（与淘宝网上订单的买家备注对应，只有买家才能查看该字段） └ seller_memo String 好的卖家备注（与淘宝网上订单的卖家备注对应，只有卖家才能查看该字段） └ buyer_message String 要送的礼物的，不要忘记的哦买家留言 └ pic_path String http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg 商品图片绝对途径 └ num_iid Number 3424234 商品数字编号 └ price String 200.07 商品价格。精确到2位小数；单位：元。如：200.07，表示：200元7分 └ shipping_type String free 创建交易时的物流方式（交易完成前，物流方式有可能改变，但系统里的这个字段一直不变）。可选值：free(卖家包邮),post(平邮),express(快递),ems(EMS),virtual(虚拟发货)，25(次日必达)，26(预约配送)。 └ num Number 1 商品购买数量。取值范围：大于零的整数,对于一个trade对应多个order的时候（一笔主订单，对应多笔子订单），num=0，num是一个跟商品关联的属性，一笔订单对应多比子订单的时候，主订单上的num无意义。 └ receiver_state String 浙江省收货人的所在省份 └ receiver_city String 杭州市收货人的所在城市注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的receiver_city的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了receiver_district里面建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有receiver_district参数，该参数作为城市 └ available_confirm_fee String 200.07 交易中剩余的确认收货金额（这个金额会随着子订单确认收货而不断减少，交易成功后会变为零）。精确到2位小数;单位:元。如:200.07，表示:200 元7分 └ has_post_fee Boolean true 是否包含邮费。与available_confirm_fee同时使用。可选值:true(包含),false(不包含) └ timeout_action_time Date 2000-01-01 00:00:00 超时到期时间。格式:yyyy-MM-dd HH:mm:ss。业务规则：前提条件：只有在买家已付款，卖家已发货的情况下才有效如果申请了退款，那么超时会落在子订单上；比如说3笔ABC，A申请了，那么返回的是BC的列表, 主定单不存在如果没有申请过退款，那么超时会挂在主定单上；比如ABC，返回主定单，ABC的超时和主定单相同 └ snapshot_url String T1mURbXopZXXXe3rLI.1257513712679_snap 交易快照地址 └ step_trade_status String FRONT_NOPAID_FINAL_NOPAID 分阶段付款的订单状态（例如万人团订单等），目前有三返回状态FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未付)，FRONT_PAID_FINAL_NOPAID(定金已付尾款未付)，FRONT_PAID_FINAL_PAID(定金和尾款都付) └ step_paid_fee String 525.70 分阶段付款的已付金额（万人团订单已付金额） └ can_rate Boolean true 买家可以通过此字段查询是否当前交易可以评论，can_rate=true可以评价，false则不能评价。 └ seller_can_rate Boolean true 卖家是否可以对订单进行评价 orders Order [] 订单列表 └ title String 山寨版测试机器商品标题 └ pic_path String http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg 商品图片的绝对路径 └ price String 200.07 商品价格。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ num_iid Number 2342344 商品数字ID └ sku_id String 5937146 商品的最小库存单位Sku的id.可以通过taobao.item.sku.get获取详细的Sku信息 └ outer_iid String 152e442aefe88dd41cb0879232c0dcb0 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品Item的id，可以通过taobao.items.custom.get获取商品的Item的信息 └ outer_sku_id String 81893848 外部网店自己定义的Sku编号 └ refund_status String SUCCESS(退款成功) 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款，等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款，等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货，等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功) └ status String TRADE_NO_CREATE_PAY 订单状态（请关注此状态，如果为TRADE_CLOSED_BY_TAOBAO状态，则不要对此订单进行发货，切记啊！）。可选值: TRADE_NO_CREATE_PAY(没有创建支付宝交易) WAIT_BUYER_PAY(等待买家付款) WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) TRADE_BUYER_SIGNED(买家已签收,货到付款专用) TRADE_FINISHED(交易成功) TRADE_CLOSED(付款以后用户退款成功，交易自动关闭) TRADE_CLOSED_BY_TAOBAO(付款以前，卖家或买家主动关闭交易) PAY_PENDING(国际信用卡支付付款确认中) └ oid Number 2231958349 子订单编号 └ total_fee String 200.07 应付金额（商品价格 * 商品数量 + 手工调整金额 - 子订单级订单优惠金额）。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ payment String 200.07 子订单实付金额。精确到2位小数，单位:元。如:200.07，表示:200元7分。对于多子订单的交易，计算公式如下：payment = price * num + adjust_fee - discount_fee ；单子订单交易，payment与主订单的payment一致，对于退款成功的子订单，由于主订单的优惠分摊金额，会造成该字段可能不为0.00元。建议使用退款前的实付金额减去退款单中的实际退款金额计算。 └ discount_fee String 200.07 子订单级订单优惠金额。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ adjust_fee String 1.01 手工调整金额.格式为:1.01;单位:元;精确到小数点后两位. └ divide_order_fee String 21.00 分摊之后的实付金额 └ part_mjz_discount String 21.00 优惠分摊 └ sku_properties_name String 颜色:桔色;尺码:M SKU的值。如：机身颜色:黑色;手机套餐:官方标配 └ num Number 1 购买数量。取值范围:大于零的整数 └ snapshot_url String T1mURbXopZXXXe3rLI.1257513712679_snap 订单快照URL └ timeout_action_time Date 2000-01-01 00:00:00 订单超时到期时间。格式:yyyy-MM-dd HH:mm:ss └ buyer_rate Boolean true 买家是否已评价。可选值：true(已评价)，false(未评价) └ seller_rate Boolean true 卖家是否已评价。可选值：true(已评价)，false(未评价) └ refund_id String 2231958349 最近退款ID └ cid Number 123456 交易商品对应的类目ID └ is_oversold Boolean true 是否超卖 └ end_time Date 2012-04-07 00:00:00 子订单的交易结束时间说明：子订单有单独的结束时间，与主订单的结束时间可能有所不同，在有退款发起的时候或者是主订单分阶段付款的时候，子订单的结束时间会早于主订单的结束时间，所以开放这个字段便于订单结束状态的判断 └ order_from String jhs 子订单来源,如jhs(聚划算)、taobao(淘宝)、wap(无线) └ consign_time String 2013-01-13 15:23:00 子订单发货时间，当卖家对订单进行了多次发货，子订单的发货时间和主订单的发货时间可能不一样了，那么就需要以子订单的时间为准。（没有进行多次发货的订单，主订单的发货时间和子订单的发货时间都一样） └ shipping_type String post 子订单的运送方式（卖家对订单进行多次发货之后，一个主订单下的子订单的运送方式可能不同，用order.shipping_type来区分子订单的运送方式） └ logistics_company String 顺风快递子订单发货的快递公司名称 └ invoice_no String 05432465 子订单所在包裹的运单号 └ bind_oids String 193741211090019,193741211080019 bind_oid字段的升级，支持返回绑定的多个子订单，多个子订单以半角逗号分隔 └ item_meal_id String 2564854632 套餐ID └ expand_card_expand_price_used_suborder String 10.01 购物金核销子订单权益金分摊金额（单位为元） └ expand_card_basic_price_used_suborder String 10.01 购物金核销子订单本金分摊金额（单位为元） └ customization String { "itemId": 123, "skuId": 123, "text": [ { "id": 44, "content": "home" } ], "pic": [ { "id": 44, "url": "sn" } ] ,"dingzhi":";pluginId:182;dingzhiId:157886;"} 定制信息 └ is_idle String 1 是否为闲鱼订单 1是0否 promotion_details PromotionDetails [] 优惠详情 └ id Number 22331764490705 交易的主订单或子订单号 └ promotion_name String 满就减钱优惠信息的名称 └ discount_fee String 10.00 优惠金额（免运费、限时打折时为空）,单位：元 └ gift_item_name String 晨光签字笔满就送商品时，所送商品的名称 └ gift_item_id String 13233791195 赠品的宝贝id └ gift_item_num String 1 满就送礼物的礼物数量 └ promotion_desc String 双11促销，满就送优惠活动的描述 └ promotion_id String mjs 优惠id，(由营销工具id、优惠活动id和优惠详情id组成，结构为：营销工具id-优惠活动id_优惠详情id，如mjs-123024_211143） service_orders ServiceOrders [] 服务子订单列表 └ oid Number 110770592823138 虚拟服务子订单订单号 └ item_oid Number 110770592803138 服务所属的交易订单号。如果服务为一年包换，则item_oid这笔订单享受改服务的保护 └ service_id Number 2342344 服务数字id └ service_detail_url String http://wt.taobao.com/plan.htm?plan_id=planId 服务详情的URL地址 └ num Number 1 购买数量，取值范围为大于0的整数 └ price String 39.09 服务价格，精确到小数点后两位：单位:元 └ payment String 29.98 子订单实付金额。精确到2位小数，单位:元。如:200.07，表示:200元7分。 └ title String 滚筒洗衣机商品名称 └ total_fee String 39.09 服务子订单总费用 └ refund_id String 2231958349 最近退款的id └ seller_nick String 麦包包卖家昵称 └ pic_path String http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg 服务图片地址 └ tmser_spu_code String 家装干支装服务支持家装类物流的类型 └ trade_from String WAP,JHS 交易内部来源。WAP(手机);HITAO(嗨淘);TOP(TOP平台);TAOBAO(普通淘宝);JHS(聚划算)一笔订单可能同时有以上多个标记，则以逗号分隔 └ seller_nick String 我在测试 sellerNick expandcard_info ExpandCardInfo 1 购物金信息输出 └ basic_price String 0.01 买卡订单本金 └ expand_price String 0.01 买卡订单权益金 └ basic_price_used String 0.01 用卡订单使用的本金 └ expand_price_used String 0.01 用卡订单使用的权益金 └ expand_card_basic_price String 0.01 买卡订单本金 └ expand_card_expand_price String 0.01 买卡订单权益金 └ expand_card_basic_price_used String 0.01 用卡订单所用的本金 └ expand_card_expand_price_used String 0.01 用卡订单所用的权益金 └ is_part_consign Boolean true 是否是多次发货的订单如果卖家对订单进行多次发货，则为true否则为false └ rx_audit_status String 0 处方药审核状态 └ coupon_fee Number 100 使用红包付款金额 └ seller_flag Number 1 卖家备注旗帜（与淘宝网上订单的卖家备注旗帜对应，只有卖家才能查看该字段）红、黄、绿、蓝、紫分别对应 1、2、3、4、5 └ ouid String AAHk5d123 CRM系统中特有的ouid └ real_receiver_open_id String AAEnVKOdAOIduo9TH9hjf-zb 收件人淘宝加密openId └ real_receiver_display_nick String 这是一个昵称收件人淘宝加密昵称 └ post_fee_type String giftprepaid 邮费类型，giftprepaid代表送礼玩法预付，normal代表订单buyer付款邮费或平台包邮订单 └ real_post_fee String 11 实际邮费，单位：分，没有发生邮费退款不返回该字段 └ refund_post_fee String 8 邮费退款金额，单位：分，没有发生邮费退款不返回该字段 └ gift_post_fee_role String 0 送礼邮费支付角色，0为送礼人支付邮费，1为收礼人支付邮费，免邮场景、平台补贴邮费场景不返回该字段

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradeSimpleGetRequest req = new TradeSimpleGetRequest();
req.setFields("tid,type,status,payment,orders,promotion_details");
req.setTid(123456789L);
TradeSimpleGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TradeSimpleGetRequest req = new TradeSimpleGetRequest();
req.Fields = "tid,type,status,payment,orders,promotion_details";
req.Tid = 123456789L;
TradeSimpleGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TradeSimpleGetRequest;
$req->setFields("tid,type,status,payment,orders,promotion_details");
$req->setTid("123456789");
$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.trade.simple.get' \
-d 'partner_id=apidoc' \
-d 'session=b5cdbb77-619c-4c2d-88ca-c17e6d5fab2f' \
-d 'sign=B2E7EA0186A0C39B9133493004AD02D4' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-03-05+06%3A18%3A39' \
-d 'v=2.0' \
-d 'fields=tid%2Ctype%2Cstatus%2Cpayment%2Corders%2Cpromotion_details' \
-d 'tid=123456789'

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

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

req.fields="tid,type,status,payment,orders,promotion_details"
req.tid=123456789
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.trade.simple.get");
add_param(pRequest,"fields","tid,type,status,payment,orders,promotion_details");
add_param(pRequest,"tid","123456789");
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.trade.simple.get', {
	'fields':'tid,type,status,payment,orders,promotion_details',
	'tid':'123456789'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<trade_simple_get_response>
    <trade>
        <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
        <title>麦包包</title>
        <type>fixed(一口价)</type>
        <created>2000-01-01 00:00:00</created>
        <tid>2231958349</tid>
        <seller_rate>true</seller_rate>
        <buyer_rate>true</buyer_rate>
        <status>TRADE_NO_CREATE_PAY</status>
        <payment>200.07</payment>
        <discount_fee>200.07</discount_fee>
        <adjust_fee>200.07</adjust_fee>
        <post_fee>200.07</post_fee>
        <total_fee>200.07</total_fee>
        <pay_time>2000-01-01 00:00:00</pay_time>
        <end_time>2000-01-01 00:00:00</end_time>
        <modified>2000-01-01 00:00:00</modified>
        <consign_time>2000-01-01 00:00:00</consign_time>
        <received_payment>200.07</received_payment>
        <buyer_memo>上衣要大一号</buyer_memo>
        <seller_memo>好的</seller_memo>
        <buyer_message>要送的礼物的，不要忘记的哦</buyer_message>
        <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
        <num_iid>3424234</num_iid>
        <price>200.07</price>
        <shipping_type>free</shipping_type>
        <num>1</num>
        <receiver_state>浙江省</receiver_state>
        <receiver_city>杭州市</receiver_city>
        <available_confirm_fee>200.07</available_confirm_fee>
        <has_post_fee>true</has_post_fee>
        <timeout_action_time>2000-01-01 00:00:00</timeout_action_time>
        <snapshot_url>T1mURbXopZXXXe3rLI.1257513712679_snap</snapshot_url>
        <step_trade_status>FRONT_NOPAID_FINAL_NOPAID</step_trade_status>
        <step_paid_fee>525.70</step_paid_fee>
        <can_rate>true</can_rate>
        <seller_can_rate>true</seller_can_rate>
        <orders>
            <order>
                <title>山寨版测试机器</title>
                <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
                <price>200.07</price>
                <num_iid>2342344</num_iid>
                <sku_id>5937146</sku_id>
                <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
                <outer_sku_id>81893848</outer_sku_id>
                <refund_status>SUCCESS(退款成功)</refund_status>
                <status>TRADE_NO_CREATE_PAY</status>
                <oid>2231958349</oid>
                <total_fee>200.07</total_fee>
                <payment>200.07</payment>
                <discount_fee>200.07</discount_fee>
                <adjust_fee>1.01</adjust_fee>
                <divide_order_fee>21.00</divide_order_fee>
                <part_mjz_discount>21.00</part_mjz_discount>
                <sku_properties_name>颜色:桔色;尺码:M</sku_properties_name>
                <num>1</num>
                <snapshot_url>T1mURbXopZXXXe3rLI.1257513712679_snap</snapshot_url>
                <timeout_action_time>2000-01-01 00:00:00</timeout_action_time>
                <buyer_rate>true</buyer_rate>
                <seller_rate>true</seller_rate>
                <refund_id>2231958349</refund_id>
                <cid>123456</cid>
                <is_oversold>true</is_oversold>
                <end_time>2012-04-07 00:00:00</end_time>
                <order_from>jhs</order_from>
                <consign_time>2013-01-13 15:23:00</consign_time>
                <shipping_type>post</shipping_type>
                <logistics_company>顺风快递</logistics_company>
                <invoice_no>05432465</invoice_no>
                <bind_oids>193741211090019,193741211080019</bind_oids>
                <item_meal_id>2564854632</item_meal_id>
                <expand_card_expand_price_used_suborder>10.01</expand_card_expand_price_used_suborder>
                <expand_card_basic_price_used_suborder>10.01</expand_card_basic_price_used_suborder>
                <customization>{ &quot;itemId&quot;: 123, &quot;skuId&quot;: 123, &quot;text&quot;: [ { &quot;id&quot;: 44, &quot;content&quot;: &quot;home&quot; } ], &quot;pic&quot;: [ { &quot;id&quot;: 44, &quot;url&quot;: &quot;sn&quot; } ] ,&quot;dingzhi&quot;:&quot;;pluginId:182;dingzhiId:157886;&quot;}</customization>
                <is_idle>1</is_idle>
            </order>
        </orders>
        <promotion_details>
            <promotion_details>
                <id>22331764490705</id>
                <promotion_name>满就减钱</promotion_name>
                <discount_fee>10.00</discount_fee>
                <gift_item_name>晨光签字笔</gift_item_name>
                <gift_item_id>13233791195</gift_item_id>
                <gift_item_num>1</gift_item_num>
                <promotion_desc>双11促销，满就送</promotion_desc>
                <promotion_id>mjs</promotion_id>
            </promotion_details>
        </promotion_details>
        <service_orders>
            <service_orders>
                <oid>110770592823138</oid>
                <item_oid>110770592803138</item_oid>
                <service_id>2342344</service_id>
                <service_detail_url>http://wt.taobao.com/plan.htm?plan_id=planId</service_detail_url>
                <num>1</num>
                <price>39.09</price>
                <payment>29.98</payment>
                <title>滚筒洗衣机</title>
                <total_fee>39.09</total_fee>
                <refund_id>2231958349</refund_id>
                <seller_nick>麦包包</seller_nick>
                <pic_path>http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg</pic_path>
                <tmser_spu_code>家装干支装服务</tmser_spu_code>
            </service_orders>
        </service_orders>
        <trade_from>WAP,JHS</trade_from>
        <seller_nick>我在测试</seller_nick>
        <expandcard_info>
            <basic_price>0.01</basic_price>
            <expand_price>0.01</expand_price>
            <basic_price_used>0.01</basic_price_used>
            <expand_price_used>0.01</expand_price_used>
        </expandcard_info>
        <expand_card_basic_price>0.01</expand_card_basic_price>
        <expand_card_expand_price>0.01</expand_card_expand_price>
        <expand_card_basic_price_used>0.01</expand_card_basic_price_used>
        <expand_card_expand_price_used>0.01</expand_card_expand_price_used>
        <is_part_consign>true</is_part_consign>
        <rx_audit_status>0</rx_audit_status>
        <coupon_fee>100</coupon_fee>
        <seller_flag>1</seller_flag>
        <ouid>AAHk5d123</ouid>
        <real_receiver_open_id>AAEnVKOdAOIduo9TH9hjf-zb</real_receiver_open_id>
        <real_receiver_display_nick>这是一个昵称</real_receiver_display_nick>
        <post_fee_type>giftprepaid</post_fee_type>
        <real_post_fee>11</real_post_fee>
        <refund_post_fee>8</refund_post_fee>
        <gift_post_fee_role>0</gift_post_fee_role>
    </trade>
</trade_simple_get_response>

{
    "trade_simple_get_response":{
        "trade":{
            "buyer_open_uid":"AAHk5d-EAAeGwJedwSFu0XXX",
            "title":"麦包包",
            "type":"fixed(一口价)",
            "created":"2000-01-01 00:00:00",
            "tid":"2231958349",
            "seller_rate":true,
            "buyer_rate":true,
            "status":"TRADE_NO_CREATE_PAY",
            "payment":"200.07",
            "discount_fee":"200.07",
            "adjust_fee":"200.07",
            "post_fee":"200.07",
            "total_fee":"200.07",
            "pay_time":"2000-01-01 00:00:00",
            "end_time":"2000-01-01 00:00:00",
            "modified":"2000-01-01 00:00:00",
            "consign_time":"2000-01-01 00:00:00",
            "received_payment":"200.07",
            "buyer_memo":"上衣要大一号",
            "seller_memo":"好的",
            "buyer_message":"要送的礼物的，不要忘记的哦",
            "pic_path":"http:\/\/img08.taobao.net\/bao\/uploaded\/i8\/T1jVXXXePbXXaoPB6a_091917.jpg",
            "num_iid":3424234,
            "price":"200.07",
            "shipping_type":"free",
            "num":1,
            "receiver_state":"浙江省",
            "receiver_city":"杭州市",
            "available_confirm_fee":"200.07",
            "has_post_fee":true,
            "timeout_action_time":"2000-01-01 00:00:00",
            "snapshot_url":"T1mURbXopZXXXe3rLI.1257513712679_snap",
            "step_trade_status":"FRONT_NOPAID_FINAL_NOPAID",
            "step_paid_fee":"525.70",
            "can_rate":true,
            "seller_can_rate":true,
            "orders":{
                "order":[
                    {
                        "title":"山寨版测试机器",
                        "pic_path":"http:\/\/img08.taobao.net\/bao\/uploaded\/i8\/T1jVXXXePbXXaoPB6a_091917.jpg",
                        "price":"200.07",
                        "num_iid":2342344,
                        "sku_id":"5937146",
                        "outer_iid":"152e442aefe88dd41cb0879232c0dcb0",
                        "outer_sku_id":"81893848",
                        "refund_status":"SUCCESS(退款成功)",
                        "status":"TRADE_NO_CREATE_PAY",
                        "oid":2231958349,
                        "total_fee":"200.07",
                        "payment":"200.07",
                        "discount_fee":"200.07",
                        "adjust_fee":"1.01",
                        "divide_order_fee":"21.00",
                        "part_mjz_discount":"21.00",
                        "sku_properties_name":"颜色:桔色;尺码:M",
                        "num":1,
                        "snapshot_url":"T1mURbXopZXXXe3rLI.1257513712679_snap",
                        "timeout_action_time":"2000-01-01 00:00:00",
                        "buyer_rate":true,
                        "seller_rate":true,
                        "refund_id":"2231958349",
                        "cid":123456,
                        "is_oversold":true,
                        "end_time":"2012-04-07 00:00:00",
                        "order_from":"jhs",
                        "consign_time":"2013-01-13 15:23:00",
                        "shipping_type":"post",
                        "logistics_company":"顺风快递",
                        "invoice_no":"05432465",
                        "bind_oids":"193741211090019,193741211080019",
                        "item_meal_id":"2564854632",
                        "expand_card_expand_price_used_suborder":"10.01",
                        "expand_card_basic_price_used_suborder":"10.01",
                        "customization":"{ \"itemId\": 123, \"skuId\": 123, \"text\": [ { \"id\": 44, \"content\": \"home\" } ], \"pic\": [ { \"id\": 44, \"url\": \"sn\" } ] ,\"dingzhi\":\";pluginId:182;dingzhiId:157886;\"}",
                        "is_idle":"1"
                    }
                ]
            },
            "promotion_details":{
                "promotion_details":[
                    {
                        "id":22331764490705,
                        "promotion_name":"满就减钱",
                        "discount_fee":"10.00",
                        "gift_item_name":"晨光签字笔",
                        "gift_item_id":"13233791195",
                        "gift_item_num":"1",
                        "promotion_desc":"双11促销，满就送",
                        "promotion_id":"mjs"
                    }
                ]
            },
            "service_orders":{
                "service_orders":[
                    {
                        "oid":110770592823138,
                        "item_oid":110770592803138,
                        "service_id":2342344,
                        "service_detail_url":"http:\/\/wt.taobao.com\/plan.htm?plan_id=planId",
                        "num":1,
                        "price":"39.09",
                        "payment":"29.98",
                        "title":"滚筒洗衣机",
                        "total_fee":"39.09",
                        "refund_id":"2231958349",
                        "seller_nick":"麦包包",
                        "pic_path":"http:\/\/img08.taobao.com\/bao\/upload\/i8\/T1jVXXXePb_a0908.jpg",
                        "tmser_spu_code":"家装干支装服务"
                    }
                ]
            },
            "trade_from":"WAP,JHS",
            "seller_nick":"我在测试",
            "expandcard_info":{
                "basic_price":"0.01",
                "expand_price":"0.01",
                "basic_price_used":"0.01",
                "expand_price_used":"0.01"
            },
            "expand_card_basic_price":"0.01",
            "expand_card_expand_price":"0.01",
            "expand_card_basic_price_used":"0.01",
            "expand_card_expand_price_used":"0.01",
            "is_part_consign":true,
            "rx_audit_status":"0",
            "coupon_fee":100,
            "seller_flag":1,
            "ouid":"AAHk5d123",
            "real_receiver_open_id":"AAEnVKOdAOIduo9TH9hjf-zb",
            "real_receiver_display_nick":"这是一个昵称",
            "post_fee_type":"giftprepaid",
            "real_post_fee":"11",
            "refund_post_fee":"8",
            "gift_post_fee_role":"0"
        }
    }
}

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.invalid-permission	必须是此交易的买家或卖家才能获取交易详细信息	保证传入的订单ID和卖家SessionKey信息是一致的
isv.trade-not-exist	交易不存在	订单已进入历史库，不再提供实时查询，出现此错误请清除本地数据库该订单，不要重试
isv.invalid-parameter:tid	订单ID不存在，或者使用了子订单ID来查询	请填写正确的订单ID，或使用主订单ID来查询
isv.trade-service-access-frequency	交易慢查询访问太频繁	缩短查询订单的时间范围，减少超时查询的次数，或者等待一段时间后再来查询
isp.trade-service-degrade	单位时间内慢查询过多，服务被降级	请稍后重试。
isp.commission-service-unavailable	佣金服务不可用	重试
isp.trade-service-unavailable	交易服务不可用	适当重试
isp.trade-service-failed	服务不可用	重试
isp.call-limited	交易服务限流	请稍后重试
isp.remote-connection-error	交易服务连接依赖的远程服务错误	请稍后重试
isp.remote-service-timeout	交易服务处理超时	请稍后重试
isv.invalid-parameter	请求参数有误	请传入正确的参数
isv.astrolabe-trade-closured	门店发货拦截订单	重试
isp.contextPrepareError	交易服务不可用	重试
isv.trade-hold	订单已经被星盘拦截	对接星盘发货系统

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

交易API

taobao.trade.simple.get (获取交易订单的简易信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ