获取订单详情
获取单笔交易的详细信息
-
只有单笔订单的情况下Trade数据结构中才包含商品相关的信息
-
获取到的Order中的payment字段在单笔子订单时包含物流费用,多笔子订单时不包含物流费用
-
获取红包优惠金额可以使用字段 coupon_fee,对应的红包:
T_CASH_COUPON:商家红包
ALIMAMA_ZTC_COUPON:阿里妈妈直通车红包
P_LUCKY_MONEY:淘宝红包
TMALL_COUPON_SP:天猫现金红包_指定退款
TMALL_COUPON:天猫购物券
T_FIN_PL_COUPON_OUTAX:S62阿里云
ALIMAMA_COUPON:阿里妈妈CPA红包
T_FIN_PL_COUPON_OUTAXBK:电视淘宝
CN_ALLIANCE_COUPON:菜鸟无金额门槛红包账号
P_TMALL_INTERNATIONAL :天猫国际红包注意:coupon_fee字段不能获取积分红包,淘宝没有开放非淘系的红包字段, 对于想获取订单的实付金额,也可以通过开票金额接口,这个接口淘宝会返回扣除红包之后的,发票开票金额 。 tb-invocie-amount-get
一、请求参数
请求URL:
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
| tid | String | 必填, 订单号 | |
| sysid | String | 必填, 代表不同的应用,具体请咨询客服 |
二、请求示例代码
Java
@Test public void getTradeDetail() throws Exception { String tb_seller_nick = Config.TBSellerNick ; //要查询支付宝的淘宝商家 //业务参数 Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); data.put("tb_seller_nick", tb_seller_nick); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); data.put("tid", "1189348257255565830"); // data.put("sysid", ""); 传什么参数请咨询客服 data.put("sign", Utils.Sign(data,Config.AppSecret)); // 调用服务API doHttpRequest(Config.TaoBaoOrderDetailUrl ,data); }三、返回结果
{ "code": 0, "message": "ok", "data": { "request_id": "5fbvcygq0dkq", "trade": { "adjust_fee": "0.00", "alipay_no": "2021072822001164271459246446", "buyer_area": "上海上海杨浦区 电信", "buyer_nick": "supercode", "buyer_obtain_point_fee": 0, "buyer_open_uid": "AAGM90gYAAjcqSrFKsJi7Izh", "buyer_rate": false, "buyer_message": "", "cod_fee": "0.00", "cod_status": "NEW_CREATED", "created": "2021-07-28 17:36:22", "discount_fee": "0.00", "paid_coupon_fee": "", "order_tax_fee": "", "credit_card_fee": "", "coupon_fee": 0, "is_brand_sale": false, "is_force_wlb": false, "is_lgtype": false, "modified": "2021-08-04 17:23:52", "new_presell": false, "num": 1, "num_iid": 544876335798, "orders": { "order": [{ "adjust_fee": "0.00", "buyer_rate": false, "cid": 50015766, "discount_fee": "0.00", "divide_order_fee": "5.00", "is_daixiao": false, "is_oversold": false, "nr_outer_iid": "lianhua007", "num": 1, "num_iid": 544876335798, "oid": "1984565594911565830", "oid_str": "1984565594911565830", "order_from": "WAP,WAP", "outer_iid": "lianhua007", "outer_sku_id": "red36", "payment": "10.00", "pic_path": "https://img.alicdn.com/bao/uploaded/i2/661153176/TB23bWverBmpuFjSZFuXXaG_XXa_!!661153176.jpg", "price": "5.00", "refund_status": "SUCCESS", "seller_rate": false, "seller_type": "C", "sku_id": "3977338583163", "sku_properties_name": "尺码:36;颜色:red", "snapshot_url": "t:1984565594911565830_1", "status": "TRADE_CLOSED", "title": "联华超市提取货券xx", "total_fee": "5.00", "invoice_no": "", "logistics_company": "", "part_mjz_discount": "", "fqg_num": 0, "is_fqg_s_fee": false, "recharge_fee": "", "credit_buy": "", "consign_time": "", "modified": "", "refund_id": "123898682213563058", "end_time": "2021-08-04 17:23:53", "shipping_type": "" }] }, "pay_time": "2021-07-28 17:36:26", "payment": "10.00", "pic_path": "https://img.alicdn.com/bao/uploaded/i2/661153176/TB23bWverBmpuFjSZFuXXaG_XXa_!!661153176.jpg", "point_fee": 0, "post_fee": "5.00", "price": "5.00", "real_point_fee": 0, "received_payment": "0.00", "receiver_address": "陆**街道**路***号****室", "receiver_city": "上海市", "receiver_district": "浦东新区", "receiver_mobile": "*******7333", "receiver_phone": "", "receiver_name": "赵**", "receiver_state": "上海", "receiver_zip": "200120", "seller_flag": 2, "seller_memo": "22222xx222 效果明显", "seller_nick": "百鞋馆", "seller_rate": false, "shipping_type": "post", "status": "TRADE_CLOSED", "tid": "1984565594911565830", "tid_str": "1984565594911565830", "title": "d[s64535320]", "total_fee": "5.00", "type": "fixed", "you_xiang": false, "trade_from": "WAP,WAP", "app_name": "", "oaid": "1h12M4LqkhUkt1ibEk6VyZv2gRsECYSQayzH33CwBP1s3Cmlrwx1t2f4E3RaZdsLD3O7ehf", "consign_time": "", "has_post_fee": false, "timeout_action_time": "", "snapshot_url": "t:1984565594911565830_1", "end_time": "2021-08-04 17:23:53", "platform_subsidy_fee": "0.00", "buyer_open_uid":"AAEt90gYAAjcqSrFKsJnK_Ba" } }, "trace_id": ""}说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含订单列表的数据, 详细字段说明见文档
| 返回字段 | 类型 | 说明 |
|---|---|---|
| order.refund_status | string | 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功) |
| order.adjust_fee | string | 手工调整金额.格式为:1.01;单位:元;精确到小数点后两位. |