获取售后列表

售后列表接口

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/dd/after/list

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String oms38 xxxxx 商家账号
sign String

业务参数

字段名 类型 说明
aftersaleid String 售后单号
aftersaleStatusToFinalEndTime String 售后完结时间结束,单位为秒(包含开始值)。仅支持近6个月内售后单。生成规则由平台综合判断,有完结时间返回后不可再操作。
aftersaleStatusToFinalStartTime String 售后完结时间开始,单位为秒(包含开始值)。仅支持近6个月内售后单。生成规则由平台综合判断,有完结时间返回后不可再操作。
aftersaleSubType String 售后子类型;8001-以换代修。
aftersaleType String 售后类型;0-退货退款;1-已发货仅退款;2-未发货仅退款;3-换货;6-价保;7-补寄;8-维修
agreeRefuseSign String[] 是否拒签后退款(1:已同意拒签, 2:未同意拒签)
amountEnd String 金额上限,单位为分(查询范围不包含结束值)
amountStart String 金额下限,单位为分(查询范围包含开始值)
appKey String 无注释
arbitrateStatus String[] 仲裁状态:0(未介入), 1(客服处理中), 2(支持买家), 3(支持卖家), 4(待商家举证), 5(待协商), 6(仲裁结束), 255(取消)
endTime Long 申请时间结束,单位为秒(查询范围不包含结束值)
logisticsStatus String 退货物流状态:1(全部), 2(已发货), 3(未发货)
needSpecialType Boolean 是否展示特殊售后
orderBy String[] 排序方式。字段支持 “status_deadline”、”apply_time”、”update_time”;方式支持 “asc”、”desc”。
orderFlag String[] 插旗信息:0:灰 1:紫 2:青 3:绿 4:橙 5:红
orderLogisticsState String[] 正向物流状态(拒签场景):1:买家已拒签;2:买家已签收;3:快递退回中;4:商家已签收
orderLogisticsTrackingNo String[] 正向物流单号
ownerId String 店铺Id
page String 页数,从1开始
payType String 付款方式:1(全部), 2(货到付款), 3(线上付款)
reason String 售后理由:1-七天无理由退货;2-非七天无理由退货
refundType String 退款类型:0(原路退款), 1(线下退款), 2(备用金), 3(保证金), 4(无需退款)
riskFlag String 风控标签:-1(退货正常), 1(退货异常)
sendTime String 无注释
sign String 无注释
size String 固定50
standardAftersaleStatus String 售后状态:6-待商家同意;7-待买家退货;8-待商家发货;11-待商家二次同意;12-成功;13-换/补/修待收货;14-换/补/修成功;27-商家拒一;28-失败;29-商家拒二;支持英文逗号分隔。
startTime Long 申请时间开始,单位为秒(查询范围包含开始值)
updateEndTime String 更新时间结束,单位为秒(包含开始值)。需配合 order_by=update_time 使用以防漏单。
updateStartTime String 更新时间开始,单位为秒(包含开始值)。需配合 order_by=update_time 使用以防漏单。

 

2. 请求示例代码(Java)

    @Test
    public void  GetAfterList() throws Exception {
        Map<String, Object> data = new HashMap<String, Object>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("seller_nick", Config.DDSellerNick);
       data.put("page", "1");
        data.put("size", "50");
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDTradeListUrl, data);
        System.out.println(resp); 
    }

3. 返回结果如下:

{
  "code": 0,
  "message": "ok",
  "data": {
    "items": [
       {"xxxx","xxxxx"}
      ]
  }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含列表的数据,返回字段说明参见https://op.jinritemai.com/docs/api-docs/17/1295

文档更新时间: 2026-03-06 12:17   作者:admin