PATCH
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approval2609170000退货申请审核
# 01
简介
退货申请审核
# 02
详细内容
API支持的买家用户地区:韩国、台湾
查看退货申请列表,可处理receiptStatus为入库完成(VENDOR_WAREHOUSE_CONFIRM)的退货订单。
您在[退货商品确认入库]后,进行[退货申请审核]即可。根据急速退款政策进行退款,或退货商品已确认入库的情况,一定时间后酷澎系统将批准退货。此时无需调用该API。
*参考退货API 工作流程以便更好理解。
路径
PATCH/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approval
示例端点
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00013264/returnRequests/363585/approval# 03
Path 参数
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 卖家ID: 酷澎分配给卖家的固有代码 e.g.A00012345 |
| receiptId* | number | 退货处理号码 ReceiptId可通过“查看退货申请列表”API确认。 ReceiptId须输入数字。 |
# 04
请求体参数
请求参数
请求体参数
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 卖家代码
|
| receiptId* | integer | 退货处理号码
|
| cancelCount* | integer | 退货处理数量
|
| code | string | 服务器响应
|
| message | string | 成功或失败时出现响应结果信息
|
| data | object | |
| 400(确认请求参数) | string | 顾客或客服人员取消了该退货申请,或输入的退货处理号码有误。可通过退货撤回记录API查看该退货是否有被撤回。
|
| 400 (Check requested parameter) | string | 请查看是否输入了正确的退货处理数量。退货处理数量与输入的cancelCount不一致时,会导致错误发生。
|
请求示例application/json
{
"vendorId": "A00013264",
"receiptId": 363585,
"cancelCount": 1
}# 05
响应体
响应消息
| Name | Type | Description |
|---|---|---|
| code | string | 服务器响应
|
| message | string | 成功或失败时出现响应结果信息
|
| data | object |
Response Example
{
"code": "200",
"message": "OK"
}# 06
错误码
| HTTP | 代码 | 消息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
错误说明
| HTTP | 类型 | 错误消息 | 解决方案 |
|---|---|---|---|
| 400 | 400(确认请求参数) | 无取消退货处理的详细信息。 | 顾客或客服人员取消了该退货申请,或输入的退货处理号码有误。可通过退货撤回记录API查看该退货是否有被撤回。 |
| 400 | 400 (Check return status) | 该订单已完成退货。 | 可通过单件查看退货申请API确认该处理号码(receiptId)是否是退货完成状态。查看是否为极速退款或根据退货商品回收流程来看,该订单是否是已完成退货的情况,确保不会进行重复审核。 |
| 400 | 400 (Check requested parameter) | 取消退货处理的数量与cancelCount不一致。 | 请查看是否输入了正确的退货处理数量。退货处理数量与输入的cancelCount不一致时,会导致错误发生。 |
| 500 | 500 (Check return status) | Refund approval (waiting)/reception of the requested coupon is in a state that cannot be approved or the quantity is incorrect(Pending)/Withdrawal 退款审核(暂停)/申请撤回的优惠券处于无法审核的状态或数量不正确。 | 可通过单件查看退货申请API确认该处理号码(receiptId)是否是退货完成状态。查看是否为极速退款或根据退货商品回收流程来看,该订单是否是已完成退货的情况,确保不会进行重复审核。 |