跳转到内容
Cheeli 文档
返回官网

拼多多售后列表增量查询

售后列表增量查询

一、请求参数

POST https://kf.fw199.com/gateway/pdd/refund/list/increment/get

基础参数

参数名类型说明示例
appidString合作伙伴AppIduwkahf@jfs92
timestampString当前时间戳
signString接口签名如何计算生成见示例代码
seller_nickString拼多多卖家账号，非店铺名称kingdo

业务参数

参数接口参数类型是否必填说明
after_sales_statusINTEGER必填必填，售后状态 0：无售后 2：买家申请退款，待商家处理 3：退货退款，待商家处理 4：商家同意退款，退款中 5：平台同意退款，退款中 6：驳回退款，待买家处理 7：已同意退货退款,待用户发货 8：平台处理中 9：平台拒绝退款，退款关闭 10：退款成功 11：买家撤销 12：买家逾期未处理，退款失败 13：买家逾期，超过有效期 14：换货补寄待商家处理 15：换货补寄待用户处理 16：换货补寄成功 17：换货补寄失败 18：换货补寄待用户确认完成 21：待商家同意维修 22：待用户确认发货 24：维修关闭 25：维修成功 27：待用户确认收货 31：已同意拒收退款，待用户拒收 32：补寄待商家发货 33：待商家召回
after_sales_typeINTEGER必填必填，售后类型 1：全部 2：仅退款 3：退货退款 4：换货 5：缺货补寄 6：维修
end_updated_atLONG必填必填，最后更新时间结束时间的UNIX时间戳，指格林威治时间 1970 年01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时00 分 00 秒)起至现在的总秒数 PS：开始时间结束时间间距不超过 30 分钟
order_snSTRING非必填订单号。若入参含订单号，则可查询订单下的全部售后单。且入参中除订单号，page，page_size外的其他查询条件不起作用（标记必填的仍旧需要输入）。
pageINTEGER非必填返回页码 默认 1，页码从 1 开始 PS：当前采用分页返回，数量和页数会一起传，如果不传，则采用 默认值
page_sizeINTEGER非必填返回数量，默认 100。最大 100
start_updated_atLONG必填必填，最后更新时间开始时间的UNIX时间戳，指格林威治时间 1970 年01月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00分 00 秒)起至现在的总秒数

二、请求示例代码

Java

@Test
    public void PddRefundListIncrementGet() throws Exception {


        String seller_nick = Config.PddSellerNick; // 拼多多卖家账号
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("seller_nick", seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("after_sales_status", "0");
        data.put("after_sales_type", "1");
        Long start = System.currentTimeMillis() / 1000 -  60 * 30; // 30分钟前
        Long end = System.currentTimeMillis() / 1000;
        data.put("start_updated_at", start.toString());
        data.put("end_updated_at", end.toString());
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.PddRefundListIncrementGetUrl, data);


    }

三、返回结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "refund_list": [
      {
        "after_sale_reason": "商品款式选错了",
        "after_sales_status": 10,
        "after_sales_type": 2,
        "confirm_time": "2024-02-22 17:58:05",
        "created_time": "2024-03-05 14:59:09",
        "discount_amount": "2.00",
        "dispute_refund_status": 0,
        "good_image": "https://t16img.yangkeduo.com/garner-api/70ec7360c13688309252f88a9ce49965.jpeg",
        "goods_id": 160210883299,
        "goods_name": "A4白纸一张十圆不支持退货,不要乱拍!",
        "goods_number": "1",
        "goods_price": "10.00",
        "id": 33850871519,
        "order_amount": "8.00",
        "order_sn": "240222-251978075062221",
        "outer_goods_id": "",
        "outer_id": "s50cm",
        "refund_amount": "8.00",
        "refund_operator_role": 4,
        "sku_id": "648106686604",
        "speed_refund_flag": 1,
        "tracking_number": "",
        "updated_time": "2024-03-05 14:59:20",
        "user_shipping_status": "1"
      }
    ],
    "request_id": "17096219644095536",
    "total_count": 1
  }
}

说明： code为0表示成功，非0为失败，message会包含失败原因。失败时一定要注意，可能商户授权过期，或是参数有误。 成功时，data包含订单列表的相关信息。

四、返回字段说明

参数接口参数类型例子说明
refund_listOBJECT[]售后列表对象
after_sale_reasonSTRING不想要了售后原因
after_sales_statusINTEGER1售后状态 0：无售后 2：买家申请退款，待商家处理 3：退货退款，待商家处理 4：商家同意退款，退款中 5：平台同意退款，退款中 6：驳回退款，待买家处理 7：已同意退货退款,待用户发货 8：平台处理中 9：平台拒绝退款，退款关闭 10：退款成功 11：买家撤销 12：买家逾期未处理，退款失败 13：买家逾期，超过有效期 14：换货补寄待商家处理 15：换货补寄待用户处理 16：换货补寄成功 17：换货补寄失败 18：换货补寄待用户确认完成 21：待商家同意维修 22：待用户确认发货 24：维修关闭 25：维修成功 27：待用户确认收货 31：已同意拒收退款，待用户拒收 32：补寄待商家发货
after_sales_typeINTEGER1售后类型
confirm_timeSTRING1551612204成团时间
created_timeSTRING1551612204创建时间
discount_amountSTRING1订单折扣金额（元）
dispute_refund_statusINTEGER1纠纷退款 0非纠纷退款
good_imageSTRING1商品图片
goods_idLONG1商品编码
goods_nameSTRING1商品名称
goods_numberSTRING1商品数量
goods_priceSTRING1商品单价
idLONG1售后编号
order_amountSTRING1订单金额（元）
order_snSTRING190228-355530178612389订单编号
outer_goods_idSTRING1商家外部编码（商品）
outer_idSTRING1商家外部编码（sku）
refund_amountSTRING1退款金额（元）
refund_operator_roleINTEGER1同意退款操作人角色0:”默认”,1:”用户”,2:”商家”,3:”平台”,4:”系统”,5:”团长”,6:”司机”,7:”代理人”
shipping_nameSTRING退货物流公司名称
sku_idSTRING1商品规格ID
speed_refund_flagINTEGER极速退款标志位 1：极速退款，0：非极速退款
speed_refund_statusSTRING1极速退款状态，”1”：有极速退款资格，”2”：极速退款失败, “3” 表示极速退款成功，其他表示非极速退款
tracking_numberSTRING1快递运单号
updated_timeSTRING1551612204更新时间
user_shipping_statusSTRING0-未勾选 1-消费者选择的收货状态为未收到货 2-消费者选择的收货状态为已收到货
total_countINTEGER1返回的售后订单列表总数