获取售后列表
售后列表接口
1.请求参数:
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| 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