获取售后列表
售后列表接口
一、请求参数
请求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` 使用以防漏单。 |
二、请求示例代码
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); }三、返回结果
{ "code": 0, "message": "ok", "data": { "items": [ {"xxxx","xxxxx"} ] }}说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含列表的数据,返回字段说明参见https://op.jinritemai.com/docs/api-docs/17/1295