taobao.trade.get 获取单笔交易的部分信息
公共请求参数:
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| method | String | 是 | API接口名称,例如:taobao.trade.get |
| app_key | String | 是 | TOP分配给应用的AppKey,例如:12345678 |
| session | String | 否 | 用户登录授权成功后,TOP颁发给应用的授权信息,详细介绍请点击这里。当此API的标签上注明:“需要授权”,则此参数必传;“不需要授权”,则此参数不需要传;“可选授权”,则此参数为可选 |
| timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟 |
| v | String | 是 | API协议版本,可选值:2.0 |
| sign_method | String | 是 | 签名的摘要算法,可选值为:hmac,md5,hmac-sha256。 |
| sign | String | 是 | API输入参数签名结果,签名算法介绍请点击这里 |
| format | String | 否 | 响应格式。默认为xml格式,可选值:xml,json。 |
| simplify | Boolean | 否 | 是否采用精简JSON返回格式,仅当format=json时有效,默认值为:false |
公共响应参数:
| 名称 | 类型 | 描述 |
|---|---|---|
| request_id | String | 平台颁发的每次请求访问的唯一标识 |
| error_response | String | 请求访问失败时返回的根节点 |
| code | String | 请求失败返回的错误码 |
| msg | String | 请求失败返回的错误信息 |
| sub_code | String | 请求失败返回的子错误码 |
| sub_msg | String | 请求失败返回的子错误信息 |
| ***_response | String | 请求成功返回的根节点,'***' 为API名称的下划线模式 |
请求参数

响应参数







请求示例
JAVA
PHP
.NET
CURL
Python
NodeJS
C/C++
Python3
GO
PHP7
JAVA8
.NET6
- TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
- TradeGetRequest req = new TradeGetRequest();
- req.setFields("tid,type,status,payment,orders");
- req.setTid(123456789L);
- TradeGetResponse rsp = client.execute(req, sessionKey);
- System.out.println(rsp.getBody());
XML
JSON
- <trade_get_response>
- <trade>
- <seller_nick>我在测试</seller_nick>
- <buyer_nick>我在测试</buyer_nick>
- <title>麦包包</title>
- <type>fixed(一口价)</type>
- <created>2000-01-01 00:00:00</created>
- <sid>NP1021246146</sid>
- <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>
- <commission_fee>200.07</commission_fee>
- <buyer_memo>上衣要大一号</buyer_memo>
- <seller_memo>好的</seller_memo>
- <alipay_no>2009112081173831</alipay_no>
- <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>
- <cod_fee>12.07</cod_fee>
- <cod_status>EW_CREATED(订单已创建)</cod_status>
- <shipping_type>free</shipping_type>
- <num>1</num>
- <point_fee>0</point_fee>
- <real_point_fee>0</real_point_fee>
- <buyer_obtain_point_fee>0</buyer_obtain_point_fee>
- <is_daixiao>true</is_daixiao>
- <is_wt>true</is_wt>
- <arrive_interval>1</arrive_interval>
- <arrive_cut_time>16:00</arrive_cut_time>
- <consign_interval>48</consign_interval>
- <service_tags>
- <logistics_tag>
- <order_id>123456</order_id>
- <logistic_service_tag_list>
- <logistic_service_tag>
- <service_tag>comFee=1211;comTim=1;companyCode=SF;</service_tag>
- <service_type>FAST</service_type>
- </logistic_service_tag>
- </logistic_service_tag_list>
- </logistics_tag>
- </service_tags>
- <o2o>crm</o2o>
- <o2o_guide_id>123456</o2o_guide_id>
- <o2o_guide_name>西湖门店导购员1</o2o_guide_name>
- <o2o_shop_id>123456</o2o_shop_id>
- <o2o_shop_name>西湖门店</o2o_shop_name>
- <o2o_delivery>inshop</o2o_delivery>
- <o2o_out_trade_id>123456</o2o_out_trade_id>
- <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>
- <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>
- <item_meal_name>M8原装电池:便携支架:M8专用座充:莫凡保护袋</item_meal_name>
- <num>1</num>
- <outer_sku_id>81893848</outer_sku_id>
- <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
- <buyer_rate>true</buyer_rate>
- <seller_rate>true</seller_rate>
- <seller_type>B(商城商家)</seller_type>
- <is_daixiao>true</is_daixiao>
- <ticket_outer_id>123456abcd</ticket_outer_id>
- <ticket_expdate_key>100FFFFFF02374020000002001020304000A</ticket_expdate_key>
- <is_www>true</is_www>
- <store_code>南京QDHEWL-0004</store_code>
- <tmser_spu_code>家装干支装服务</tmser_spu_code>
- <et_ser_time>2015-04-15 13:00</et_ser_time>
- <et_shop_name>测试预约门店地址</et_shop_name>
- <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
- <et_plate_number>浙A11111</et_plate_number>
- <sub_order_tax_fee>0</sub_order_tax_fee>
- <sub_order_tax_rate>0</sub_order_tax_rate>
- <zhengji_status>1</zhengji_status>
- <sub_order_tax_promotion_fee>0</sub_order_tax_promotion_fee>
- <tax_free>true</tax_free>
- <tax_coupon_discount>0</tax_coupon_discount>
- <special_refund_type>priceProtect</special_refund_type>
- <is_devalue_fee>true</is_devalue_fee>
- </order>
- </orders>
- <et_ser_time>2015-04-15 13:00</et_ser_time>
- <et_shop_name>接口测试新增门店_0304055043555</et_shop_name>
- <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
- <et_plate_number>浙A11111</et_plate_number>
- <order_tax_fee>0</order_tax_fee>
- <eticket_service_addr>杭州市卖鱼桥小学</eticket_service_addr>
- <o2o_et_order_id>193753681999224</o2o_et_order_id>
- <order_tax_promotion_fee>0</order_tax_promotion_fee>
- <pmtp>GAP_MCARD^1001|</pmtp>
- <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
- </trade>
- </trade_get_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>
| 错误码 | 错误消息 | 解决方案 |
|---|---|---|
| isv.invalid-parameter:tid | 参数:tid无效,格式不对、非法值、越界等 | |
| isv.trade-not-exist | 交易不存在 | 订单已进入历史库,出现错误清除本地数据库该订单,不要重试 |
| isv.invalid-permission | 必须是此交易的买家或卖家才能获取交易详细信息 | 查看是否程序出问题导致取到别的卖家的交易ID而无法查看,出现错误不要重试 |
| isp.trade-service-failed | 交易服务不可用 | 联系淘宝技术支持 |
| isp.call-limited | 接口调用限制,流控 | 联系淘宝技术支持 |