获取订单详情

获取单笔交易的详细信息

  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字段不能获取积分红包,淘宝没有开放非淘系的红包字段, 对于想获取订单的实付金额,也可以通过开票金额接口,这个接口淘宝会返回扣除红包之后的,发票开票金额 。 http://doc.fw199.com/docs/h7b/tb-invocie-amount-get

1.请求参数:

请求URL:

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

参数名 类型 说明 示例
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