获取订单详情
获取单笔交易的详细信息
只有单笔订单的情况下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字段不能获取积分红包,淘宝没有开放非淘系的红包字段, 对于想获取订单的实付金额,也可以通过开票金额接口,这个接口淘宝会返回扣除红包之后的,发票开票金额 。 http://doc.fw199.com/docs/h7b/tb-invocie-amount-get
1.请求参数:
请求URL:
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
sign | String | 接口签名 | 如何计算生成见示例代码 |
tid | String | 必填, 订单号 | |
sysid | String | 可空, 代表不同的应用,具体请咨询客服 |
2. 请求示例代码(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);
}
3. 返回结果如下:
{
"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;单位:元;精确到小数点后两位. |
文档更新时间: 2023-09-28 16:39 作者:admin