coupang
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 参数

NameTypeDescription
vendorId*string
卖家ID: 酷澎分配给卖家的固有代码

e.g.A00012345
receiptId*number
退货处理号码

ReceiptId可通过“查看退货申请列表”API确认。

ReceiptId须输入数字。
# 04

请求体参数

请求参数

请求体参数

NameTypeDescription
vendorId*string
卖家代码
receiptId*integer
退货处理号码
cancelCount*integer
退货处理数量
codestring
服务器响应
messagestring
成功或失败时出现响应结果信息
dataobject
400(确认请求参数)string
顾客或客服人员取消了该退货申请,或输入的退货处理号码有误。可通过退货撤回记录API查看该退货是否有被撤回。
400 (Check requested parameter)string
请查看是否输入了正确的退货处理数量。退货处理数量与输入的cancelCount不一致时,会导致错误发生。
请求示例application/json
{
  "vendorId": "A00013264",
  "receiptId": 363585,
  "cancelCount": 1
}
# 05

响应体

响应消息

NameTypeDescription
codestring
服务器响应
messagestring
成功或失败时出现响应结果信息
dataobject

Response Example

{
  "code": "200",
  "message": "OK"
}
# 06

错误码

HTTP代码消息
400HTTP_400Bad Request

错误说明

HTTP类型错误消息解决方案
400400(确认请求参数)

无取消退货处理的详细信息。

顾客或客服人员取消了该退货申请,或输入的退货处理号码有误。可通过退货撤回记录API查看该退货是否有被撤回。

400400 (Check return status)

该订单已完成退货。

可通过单件查看退货申请API确认该处理号码(receiptId)是否是退货完成状态。查看是否为极速退款或根据退货商品回收流程来看,该订单是否是已完成退货的情况,确保不会进行重复审核。

400400 (Check requested parameter)

取消退货处理的数量与cancelCount不一致。

请查看是否输入了正确的退货处理数量。退货处理数量与输入的cancelCount不一致时,会导致错误发生。

500500 (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)是否是退货完成状态。查看是否为极速退款或根据退货商品回收流程来看,该订单是否是已完成退货的情况,确保不会进行重复审核。