获取订单列表

搜索当前会话用户作为卖家已卖出的交易数据(只能获取到三个月以内的交易信息)

  1. 返回的数据结果是以订单的创建时间倒序排列的。
  2. 返回的数据结果只包含了订单的部分数据,可通过接口“获取订单详情”获取订单的详细内容。

1.请求参数:

请求URL:

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

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
sign String 接口签名 如何计算生成见示例代码
start_created 必填, Date 查询三个月内交易创建时间开始。格式:yyyy-MM-dd HH:mm:ss
end_created 必填, Date 查询交易创建时间结束。格式:yyyy-MM-dd HH:mm:ss
buyer_nick 非必填, String 买家昵称,如果不按某个买家查询,此值可传空字符串
status String 可选, 交易状态 ,默认查询所有交易状态的数据, 除了默认值外每次只能查询一种状态。WAIT_BUYER_PAY:等待买家付款 WAIT_SELLER_SEND_GOODS:等待卖家发货 、 SELLER_CONSIGNED_PART:卖家部分发货 WAIT_BUYER_CONFIRM_GOODS:等待买家确认收货 TRADE_BUYER_SIGNED:买家已签收(货到付款专用) TRADE_FINISHED:交易成功 TRADE_CLOSED:交易关闭
page_no int 可选, 当前页,默认1
page_size int 可选, 每页大小, 最大30
use_has_next bool 是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数total_results(此值一直为0) ,但是会新增一个是否存在下一页的的字段has_next,通过此种方式获取增量交易,接口调用成功率在原有的基础上有所提升。
type string 交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade,auto_delivery,ec,cod,step 这5 种的交易类型的数据;查询所有交易类型的数据,需要设置下面全部可选值。可选值:fixed(一口价)auction(拍卖)guarantee_trade(一口价、拍卖)step(分阶段付款,万人团,阶梯团订单)independent_simple_trade(旺店入门版交易)independent_shop_trade(旺店标准版交易)auto_delivery(自动发货)ec(直冲)cod(货到付款)game_equipment(游戏装备)shopex_trade(ShopEX交易)netcn_trade(万网交易)external_trade(统一外部交易)instant_trade (即时到账)b2c_cod(大商家货到付款)hotel_trade(酒店类型交易)super_market_trade(商超交易)super_market_cod_trade(商超货到付款交易)taohua(淘花网交易类型)waimai(外卖交易类型)o2o_offlinetrade(O2O交易)nopaid(即时到帐/趣味猜交易类型)step (万人团) eticket(电子凭证) tmall_i18n(天猫国际);nopaid (无付款交易)insurance_plus(保险)finance(基金)注:guarantee_trade是一个组合查询条件,并不是一种交易类型,获取批量或单个订单中不会返回此种类型的订单。pre_auth_type(预授权0元购) lazada(获取lazada订单类型)
sysid String 可空, 代表不同的应用,具体请咨询客服

2. 请求示例代码(Java)

   @Test
    public void getTradeList() throws Exception { 
        String tb_seller_nick = Config.TBSellerNick ; //要查询的淘宝商家 
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
    //  data.put("sysid", "103"); // 代表不同的应用,具体请咨询客服
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString()); 
        Calendar calendar=Calendar.getInstance();
        calendar.add(Calendar.DAY_OF_MONTH, -14);
        SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        data.put("start_created", df.format(calendar.getTime()));
        Date end = new Date();
        data.put("end_created",  df.format(end));
        data.put("status",  "");
        data.put("buyer_nick",  "");
        data.put("page_no", "1");
        data.put("page_size","20");
        data.put("use_has_next","false");  
     //  data.put("type", "guarantee_trade,auto_delivery,ec,cod,step,o2o_offlinetrade");
        data.put("sign", Utils.Sign(data,Config.AppSecret)); 
        // 调用服务API
        doHttpRequest(Config.TaoBaoOrderListUrl ,data);

    }

3. 返回结果如下:

{
    "code": 0,
    "message": "ok",
    "data": {
        "request_id": "wp2nnhmkffap",
        "total_results": 1, //搜索到的交易信息总数 
        "has_next": true, // 表示是否还有下一页,取决于入参数use_has_next的值,如果为true,则返回has_next字段
        "trades": {
            "trade": [
                {
                    "adjust_fee": "0.00", //卖家手工调整金额
                    "alipay_id": 2088002269364279,
                    "alipay_no": "2020082022001164271458231416",
                    "buyer_area": "移动",
                    "buyer_nick": "superman",
                    "buyer_obtain_point_fee": 0,
                    "buyer_rate": false,
                    "cod_fee": "0.00",
                    "cod_status": "NEW_CREATED",
                    "created": "2020-08-20 01:24:21",
                    "discount_fee": "0.00",
                    "encrypt_alipay_id": "2088002269364279",
                    "is_brand_sale": false,
                    "is_force_wlb": false,
                    "is_lgtype": false,
                    "modified": "2020-08-20 01:24:29",
                    "num": 1, // 购买数量
                    "num_iid": 544876335798, // 宝贝ID
                    "orders": {    // 订单明细
                        "order": [ 
                            {
                                "adjust_fee": "0.00",
                                "buyer_rate": false,
                                "cid": 50015766,
                                "discount_fee": "0.00",
                                "divide_order_fee": "0.50",
                                "is_daixiao": false,
                                "num": 1, // 购买数量
                                "num_iid": 544876335798, // 宝贝ID
                                "oid": "1189348257255565830",
                                "outer_iid": "lianhua007",
                                "outer_sku_id": "red35",  // sku商家编码
                                "payment": "0.50", // 付款金额
                                "pic_path": "https://img.alicdn.com/bao/uploaded/i2/661153176/TB23bWverBmpuFjSZFuXXaG_XXa_!!661153176.jpg",
                                "price": "0.50", // 价格
                                "refund_status": "NO_REFUND",
                                "seller_rate": false,
                                "seller_type": "C",
                                "sku_id": "3977338583164",
                                "sku_properties_name": "尺码:35;颜色:red",   //sku属性
                                "status": "WAIT_SELLER_SEND_GOODS",   // 订单状态 
                                "title": "联华超市提取货券xx",  // 宝贝名称
                                "total_fee": "0.50" // 小计金额
                            }
                        ]
                    },
                    "pay_time": "2020-08-20 01:24:28",
                    "payment": "0.50",  // 实付金额
                    "pic_path": "https://img.alicdn.com/bao/uploaded/i2/661153176/TB23bWverBmpuFjSZFuXXaG_XXa_!!661153176.jpg",
                    "point_fee": 0,
                    "post_fee": "0.00",
                    "price": "0.50",
                    "real_point_fee": 0,
                    "received_payment": "0.00",
                    "receiver_address": "世纪大道200号", // 收货人的详细地址
                    "receiver_city": "上海市", // 城市
                    "receiver_town":"XX镇", //收件人镇
                    "receiver_district": "浦东新区", // 区
                    "receiver_mobile": "13816121231",  //收货人手机
                    "receiver_phone": "",
                    "receiver_name": "陈先生", //收货人姓名 
                    "receiver_state": "上海", //  收货人省份
                    "receiver_zip": "200120",   //收货人邮编
                    "seller_flag": 0, // 卖家插的旗帜,  1 :红 ,2: 黄 ,3: 绿 ,4: 蓝 ,5: 紫
                    "has_buyer_message":true, //是否有买家留言 ,如果是的话,可通过订单详情接口获取具体的买家留言。
                    "seller_nick": "百鞋",
                    "seller_rate": false,
                    "shipping_type": "post",
                    "status": "WAIT_SELLER_SEND_GOODS",  // 订单状态
                    "tid": "1189348257255565831",  // 订单号
                    "title": "d[s64535320]",    // 交易标题,以店铺名作为此标题的值
                    "total_fee": "0.50", //商家金额
                    "type": "fixed",
                    "oaid": "1h12M4LqkhUkt1ibEk6VyZv2gRsECYSQayzH33CwBP1s3CmkVyx1m4SItNJ6ZhgUibyzr9RA",
                    "buyer_open_uid":"AAEt90gYAAjcqSrFKsJnK_Ba"
                }
            ]
        }
    }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含订单列表的数据。返回字段说明:https://open.taobao.com/api.htm?cid=1&docId=46&docType=2

文档更新时间: 2023-10-18 16:41   作者:admin