Coupang Developer Center

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

请求参数

Name

Required

Type

Description

vendorId

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

退货归责方

CODE	Mean
COM	卖家
CUS	顾客
COU	Coupang

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

按时间段查看退货撤回记录

简介

详细内容

路径

示例