按时间段查看撤回退货的历史记录。
最多可以查看7天的记录。
(注:开始日期和结束日期都包含在查看时间段内)
路径
GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnWithdrawRequests
示例
请求参数
Name |
|
Required |
Type |
Description |
vendorId |
O |
|
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
链接查询参数
Name |
Required |
Type |
Description |
dateFrom |
O |
String |
开始日期(yyyy-MM-dd) |
dateTo |
O |
String |
结束日期(yyyy-MM-dd) |
pageIndex |
|
Number |
查看下一页的索引值 默认值: 1 如果是最后一页,则会显示空值(“”) |
sizePerPage |
|
Number |
每页最多可请求查看的值 默认: 10, 最多: 100 |
请求体
无
返回消息
名称 | 数据类型 | 描述 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
code | Number |
HTTP 请求返回代码
例: 200, 400, 500
|
||||||||||||
message | String |
在请求失败或成功时会显示消息
|
||||||||||||
data | Array |
|
||||||||||||
cancelId | Number |
退货受理ID
|
||||||||||||
orderId | Number |
订单ID
|
||||||||||||
vendorId | String |
卖家ID 酷澎提供给卖家的固有代码 ex) A00012345 |
||||||||||||
refundDeliveryDuty | String |
退货归责方
|
||||||||||||
createdAt | String |
撤回退货的时间 yyyy-MM-ddThh:mm:ss |
||||||||||||
vendorItemIds | Array |
退货属性ID 列表
|
||||||||||||
nextPageIndex | String |
查看下一页的索引值 如果是最后一页,则会显示空值(“”) |
返回消息
{
"code": 200,
"message": "OK",
"data": [
{
"cancelId": 116607450,
"orderId": 29000024470847,
"vendorId": "A00123456",
"refundDeliveryDuty": "COM",
"createdAt": "2018-11-06T23:50:39",
"vendorItemIds": [
3838728011
]
},
{
"cancelId": 116600657,
"orderId": 7000024098976,
"vendorId": "A00123456",
"refundDeliveryDuty": "CUS",
"createdAt": "2018-11-06T23:03:40",
"vendorItemIds": [
3930729129
]
},
{
"cancelId": 116590024,
"orderId": 27000024100568,
"vendorId": "A00123456",
"refundDeliveryDuty": "COM",
"createdAt": "2018-11-06T21:39:57",
"vendorItemIds": [
3841979364
]
}
],
"nextPageIndex": "2"
}
错误代码
HTTP status code (error type) |
Error message |
Solution |
400 (check request metric) |
无效vendor ID |
查看输入的卖家ID(vendorID)是否正确。 |
400 (check request metric) |
最多查看7天的值 |
查看输入的数字是否小于7。 |
400 (check request metric) |
结束时间应晚于或等同于开始时间 |
查看开始时间和结束时间是否输入正确。 |
400 (check request metric) |
每页的最大显示数量 (sizePerPage) 为 100。 |
查看每页输入的最大请求值(sizePerPage) 是否小于100。 |
400 (check request metric) |
pageindex 不能为负数或0。 |
查看pageindex是否为复数或0。 |
400 (check request metric) |
请检查日期输入格式。 (yyyy-MM-dd) |
确认您输入的开始日期和结束日期格式是否正确。 |
400 (check request metric) |
必需的字符串参数“dateFrom”不存在 |
确认您是否输入了开始日期。 |
400 (check request metric) |
必需的字符串参数“dateTo”不存在 |
确认您是否输入了结束日期。 |
接口名称
GET_RETURNWITHDRAW_REQUEST