• 淘宝API接口,交易,退款退货,物流数据获取,erp系统对接交易订单


    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

    1. TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    2. TradeGetRequest req = new TradeGetRequest();
    3. req.setFields("tid,type,status,payment,orders");
    4. req.setTid(123456789L);
    5. TradeGetResponse rsp = client.execute(req, sessionKey);
    6. System.out.println(rsp.getBody());

    响应示例

    XML

    JSON

    1. <trade_get_response>
    2. <trade>
    3. <seller_nick>我在测试</seller_nick>
    4. <buyer_nick>我在测试</buyer_nick>
    5. <title>麦包包</title>
    6. <type>fixed(一口价)</type>
    7. <created>2000-01-01 00:00:00</created>
    8. <sid>NP1021246146</sid>
    9. <tid>2231958349</tid>
    10. <seller_rate>true</seller_rate>
    11. <buyer_rate>true</buyer_rate>
    12. <status>TRADE_NO_CREATE_PAY</status>
    13. <payment>200.07</payment>
    14. <discount_fee>200.07</discount_fee>
    15. <adjust_fee>200.07</adjust_fee>
    16. <post_fee>200.07</post_fee>
    17. <total_fee>200.07</total_fee>
    18. <pay_time>2000-01-01 00:00:00</pay_time>
    19. <end_time>2000-01-01 00:00:00</end_time>
    20. <modified>2000-01-01 00:00:00</modified>
    21. <consign_time>2000-01-01 00:00:00</consign_time>
    22. <received_payment>200.07</received_payment>
    23. <commission_fee>200.07</commission_fee>
    24. <buyer_memo>上衣要大一号</buyer_memo>
    25. <seller_memo>好的</seller_memo>
    26. <alipay_no>2009112081173831</alipay_no>
    27. <buyer_message>要送的礼物的,不要忘记的哦</buyer_message>
    28. <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
    29. <num_iid>3424234</num_iid>
    30. <price>200.07</price>
    31. <cod_fee>12.07</cod_fee>
    32. <cod_status>EW_CREATED(订单已创建)</cod_status>
    33. <shipping_type>free</shipping_type>
    34. <num>1</num>
    35. <point_fee>0</point_fee>
    36. <real_point_fee>0</real_point_fee>
    37. <buyer_obtain_point_fee>0</buyer_obtain_point_fee>
    38. <is_daixiao>true</is_daixiao>
    39. <is_wt>true</is_wt>
    40. <arrive_interval>1</arrive_interval>
    41. <arrive_cut_time>16:00</arrive_cut_time>
    42. <consign_interval>48</consign_interval>
    43. <service_tags>
    44. <logistics_tag>
    45. <order_id>123456</order_id>
    46. <logistic_service_tag_list>
    47. <logistic_service_tag>
    48. <service_tag>comFee=1211;comTim=1;companyCode=SF;</service_tag>
    49. <service_type>FAST</service_type>
    50. </logistic_service_tag>
    51. </logistic_service_tag_list>
    52. </logistics_tag>
    53. </service_tags>
    54. <o2o>crm</o2o>
    55. <o2o_guide_id>123456</o2o_guide_id>
    56. <o2o_guide_name>西湖门店导购员1</o2o_guide_name>
    57. <o2o_shop_id>123456</o2o_shop_id>
    58. <o2o_shop_name>西湖门店</o2o_shop_name>
    59. <o2o_delivery>inshop</o2o_delivery>
    60. <o2o_out_trade_id>123456</o2o_out_trade_id>
    61. <orders>
    62. <order>
    63. <title>山寨版测试机器</title>
    64. <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
    65. <price>200.07</price>
    66. <num_iid>2342344</num_iid>
    67. <sku_id>5937146</sku_id>
    68. <refund_status>SUCCESS(退款成功)</refund_status>
    69. <status>TRADE_NO_CREATE_PAY</status>
    70. <oid>2231958349</oid>
    71. <total_fee>200.07</total_fee>
    72. <payment>200.07</payment>
    73. <discount_fee>200.07</discount_fee>
    74. <adjust_fee>1.01</adjust_fee>
    75. <divide_order_fee>21.00</divide_order_fee>
    76. <part_mjz_discount>21.00</part_mjz_discount>
    77. <sku_properties_name>颜色:桔色;尺码:M</sku_properties_name>
    78. <item_meal_name>M8原装电池:便携支架:M8专用座充:莫凡保护袋</item_meal_name>
    79. <num>1</num>
    80. <outer_sku_id>81893848</outer_sku_id>
    81. <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
    82. <buyer_rate>true</buyer_rate>
    83. <seller_rate>true</seller_rate>
    84. <seller_type>B(商城商家)</seller_type>
    85. <is_daixiao>true</is_daixiao>
    86. <ticket_outer_id>123456abcd</ticket_outer_id>
    87. <ticket_expdate_key>100FFFFFF02374020000002001020304000A</ticket_expdate_key>
    88. <is_www>true</is_www>
    89. <store_code>南京QDHEWL-0004</store_code>
    90. <tmser_spu_code>家装干支装服务</tmser_spu_code>
    91. <et_ser_time>2015-04-15 13:00</et_ser_time>
    92. <et_shop_name>测试预约门店地址</et_shop_name>
    93. <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
    94. <et_plate_number>浙A11111</et_plate_number>
    95. <sub_order_tax_fee>0</sub_order_tax_fee>
    96. <sub_order_tax_rate>0</sub_order_tax_rate>
    97. <zhengji_status>1</zhengji_status>
    98. <sub_order_tax_promotion_fee>0</sub_order_tax_promotion_fee>
    99. <tax_free>true</tax_free>
    100. <tax_coupon_discount>0</tax_coupon_discount>
    101. <special_refund_type>priceProtect</special_refund_type>
    102. <is_devalue_fee>true</is_devalue_fee>
    103. </order>
    104. </orders>
    105. <et_ser_time>2015-04-15 13:00</et_ser_time>
    106. <et_shop_name>接口测试新增门店_0304055043555</et_shop_name>
    107. <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
    108. <et_plate_number>浙A11111</et_plate_number>
    109. <order_tax_fee>0</order_tax_fee>
    110. <eticket_service_addr>杭州市卖鱼桥小学</eticket_service_addr>
    111. <o2o_et_order_id>193753681999224</o2o_et_order_id>
    112. <order_tax_promotion_fee>0</order_tax_promotion_fee>
    113. <pmtp>GAP_MCARD^1001|</pmtp>
    114. <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
    115. </trade>
    116. </trade_get_response>

    异常示例

    XML

    JSON

    1. <error_response>
    2. <code>50</code>
    3. <msg>Remote service error</msg>
    4. <sub_code>isv.invalid-parameter</sub_code>
    5. <sub_msg>非法参数</sub_msg>
    6. </error_response>

    错误码解释

    错误码

    错误消息

    解决方案

    isv.invalid-parameter:tid

    参数:tid无效,格式不对、非法值、越界等

    isv.trade-not-exist

    交易不存在

    订单已进入历史库,出现错误清除本地数据库该订单,不要重试

    isv.invalid-permission

    必须是此交易的买家或卖家才能获取交易详细信息

    查看是否程序出问题导致取到别的卖家的交易ID而无法查看,出现错误不要重试

    isp.trade-service-failed

    交易服务不可用

    联系淘宝技术支持

    isp.call-limited

    接口调用限制,流控

    联系淘宝技术支持

    API 工具

  • 相关阅读:
    Python3 面向对象
    RabbitMQ集群配置以及负载均衡配置
    Proof-of-Authentication,要啥PoX?
    我的128创作纪念日
    【2022.7月份停更说明 && 总结】
    基于kafka项目之Keepalived高可用详细介绍
    LDO基础知识
    用 HLS 实现 UART
    【juc】countdownlatch实现游戏进度
    Linux中的tar
  • 原文地址:https://blog.csdn.net/Anzexi123/article/details/127663138