获取售后列表 - 小红书 API

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \ --header 'Content-Type: application/json;charset=utf-8' \ --data-raw '{ "status": 1, "pageNo": 1, "pageSize": 50, "startTime": 1617724800000, "endTime": 1617811200000, "timeType": 1, "useHasNext": true, "reasonId": "", "returnType": "" }'

{ "total": 100, "pageNo": 1, "pageSize": 50, "haxNext": true, "simpleAfterSaleList": [ { "returnsId": "R7488183140002901", "returnType": "", "reasonId": "", "reason": "质量问题", "status": 1, "subStatus": 301, "receiveAbnormalType": "", "orderId": "P617****941", "exchangeOrderId": "P617****941", "userId": "4912831012", "createdTime": 1619332984285, "returnExpressNo": "6112***4748", "returnExpressCompany": "中通", "returnAddress": "上海市徐汇区*****", "shipNeeded": 1, "refunded": true, "refundStatus": 108, "autoReceiveDeadline": 1619332984285, "useFastRefund": true, "updateTime": 1619332984285, "returnExpressCompanyCode": "", "expectedRefundAmount": 100 } ], "maxPageNo": 10 }

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

status

integer

可选

售后状态 1：待审核；2:待用户寄回；3:待收货；4:完成；5:取消；6:关闭；9:拒绝；9999:删除，不传默认全部

pageNo

integer

可选

返回页码默认 1，页码从 1 开始 PS：当前采用分页返回，数量和页数会一起传，如果不传，则采用默认值

pageSize

integer

可选

返回数量，默认50最大100

startTime

integer

查询时间起点

必需

endTime

integer

查询时间终点

必需

timeType

integer

必需

时间类型，1：根据创建时间查询 end-start<=24h；2：根据更新时间查询 end-start<=30min

useHasNext

boolean

可选

是否返回所有数据,true 不返会total 返回 hasNext = true 表示仍有数据，false 返回total

reasonId

string

编号

可选

returnType

string

可选

售后类型不传/0:全部；1:退货退款；2:换货；3:仅退款(old) 4:仅退款(new) 理论上不会有3出现；5:未发货仅退款

timestamp

string

必需

接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（1970年1月1日) 以秒计算的时间，即unix-timestamp

appId

string

必需

第三方获取到的appid

sign

string

输入参数的签名结果

必需

version

string

必需

版本号，采用oauth2授权后均填入2.0

method

string

具体调用方法

必需

accessToken

string

可选

业务接口鉴权。非必须，调用商家业务接口必须使用

示例

返回响应

🟢200成功

application/json

Body

total

integer

必需

查询到的总数，useHasNext=true时为0

pageNo

integer

当前页数

必需

pageSize

integer

页大小

必需

haxNext

boolean

是否有下一页

必需

simpleAfterSaleList

array [object {22}]

售后信息列表

必需

returnsId

string

售后ID

可选

returnType

string

售后类型

可选

reasonId

string

售后原因ID

可选

reason

string

售后原因

可选

status

integer

可选

售后状态 1:待审核 2:待用户寄回 3:待收货 4:完成 5:取消 6:关闭 9:拒绝 12:包裹商家已确认收货，等待商家发货 13:包裹商家已发货，等待用户确认收货

subStatus

integer

可选

售后子状态 301-待审核 302-快递已签收 304-收货异常

receiveAbnormalType

string

可选

收货异常类型 1:商家已开工单 2:仓库质检异常 3:收货地异常 4:寄回包裹物流超时 5:仓库反向创建退货 6:快递轨迹异常 7:拒收退仓超时 8:退款金额超限 9:收货地不一致 10:仓库质检假货 11:已退款，未收货 21:未收到货 22:退货数量不符 23:退货商品不符 24:退货质检异常 25:其他

packageId

string

订单ID

可选

exchangePackageId

string

换货订单ID

可选

userId

string

用户ID

可选

createdTime

integer

可选

售后创建时间戳（毫秒）

returnExpressNo

string

售后快递单号

可选

returnExpressCompany

string

售后快递公司

可选

returnAddress

string

售后退货地址

可选

shipNeeded

integer

可选

是否需要寄回 1-需要 0-不需要

refunded

boolean

是否已退款

可选

refundStatus

integer

可选

退款状态 108触发退款 1退款中 3退款失败 2退款成功 401已取消 101已创建 201待审核 301审核通过 302审核不通过 402自动关闭

autoReceiveDeadline

integer

自动确认收货时间

可选

useFastRefund

boolean

可选

是否急速退款，已经废弃

updateTime

integer

可选

售后更新时间戳（毫秒）

returnExpressCompanyCode

string

退货快递公司编号

可选

expectedRefundAmount

integer

可选

预期退款金额，单位元

maxPageNo

integer

最大页码数

必需