跳转到内容
返回官网

获取订单详情

获取单笔交易的详细信息

  1. 只有单笔订单的情况下Trade数据结构中才包含商品相关的信息

  2. 获取到的Order中的payment字段在单笔子订单时包含物流费用,多笔子订单时不包含物流费用

  3. 获取红包优惠金额可以使用字段 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:

POST https://kf.fw199.com/gateway/taobao/order/detail

参数名类型说明示例
appidString合作伙伴AppIduwkahf@jfs92
timestampString当前时间戳
tb_seller_nickString淘宝卖家店铺登录账号,非店铺名称kingdo
signString接口签名如何计算生成见示例代码
tidString必填, 订单号
sysidString必填, 代表不同的应用,具体请咨询客服

二、请求示例代码

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_statusstring退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
order.adjust_feestring手工调整金额.格式为:1.01;单位:元;精确到小数点后两位.