GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnWithdrawRequests2609170000按时间段查看退货撤回记录
# 01
简介
按时间段查看退货撤回记录
# 02
详细内容
API支持的买家用户地区：韩国
按时间段查看撤回退货的历史记录。
最多可以查看7天的记录。
（注：开始日期和结束日期都包含在查看时间段内）
路径
GET/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnWithdrawRequests
示例端点
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/returnWithdrawRequests?sizePerPage=3&pageIndex=1&dateFrom=2022-02-17&dateTo=2018-02-23# 03
Path 参数
| Name | Type | Description |
|---|---|---|
| vendorId* | object | 卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
# 04
Query 参数
| Name | Type | Description |
|---|---|---|
| dateFrom* | string | 开始日期(yyyy-MM-dd)
|
| dateTo* | string | 结束日期(yyyy-MM-dd)
|
| pageIndex | number | 查看下一页的索引值 默认值: 1 如果是最后一页，则会显示空值(“”) |
| sizePerPage | number | 每页最多可请求查看的值 默认: 10, 最多: 100 |
# 05
响应体
响应消息
| Name | Type | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| code | integer | HTTP 请求返回代码 例: 200, 400, 500 | ||||||||
| message | string | 在请求失败或成功时会显示消息
| ||||||||
| data | object[] | |||||||||
| cancelId data[].cancelId | integer | 退货受理ID
| ||||||||
| orderId data[].orderId | integer | 订单ID
| ||||||||
| vendorId data[].vendorId | string | 卖家ID 酷澎提供给卖家的固有代码 ex) A00012345 | ||||||||
| refundDeliveryDuty data[].refundDeliveryDuty | string | 退货归责方
| ||||||||
| createdAt data[].createdAt | string | 撤回退货的时间 yyyy-MM-ddThh:mm:ss | ||||||||
| vendorItemIds data[].vendorItemIds | object[] | 退货属性ID 列表
| ||||||||
| nextPageIndex | string | 查看下一页的索引值 如果是最后一页，则会显示空值(“”) |
Response Example
{
"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"
}# 06
错误码
| HTTP | 代码 | 消息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
错误说明
| HTTP | 类型 | 错误消息 | 解决方案 |
|---|---|---|---|
| 400 | 400 (check request metric) | 无效vendor ID | 查看输入的卖家ID（vendorID）是否正确。 |
| 400 | 400 (check request metric) | 最多查看7天的值 | 查看输入的数字是否小于7。 |
| 400 | 400 (check request metric) | 结束时间应晚于或等同于开始时间 | 查看开始时间和结束时间是否输入正确。 |
| 400 | 400 (check request metric) | 每页的最大显示数量 (sizePerPage) 为 100。 | 查看每页输入的最大请求值(sizePerPage) 是否小于100。 |
| 400 | 400 (check request metric) | pageindex 不能为负数或0。 | 查看pageindex是否为复数或0。 |
| 400 | 400 (check request metric) | 请检查日期输入格式。 (yyyy-MM-dd) | 确认您输入的开始日期和结束日期格式是否正确。 |
| 400 | 400 (check request metric) | 必需的字符串参数“dateFrom”不存在 | 确认您是否输入了开始日期。 |
| 400 | 400 (check request metric) | 必需的字符串参数“dateTo”不存在 | 确认您是否输入了结束日期。 |