/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approvalv1退货申请审核
简介
API 支持的买家用户地区：韩国、台湾 查 看退 货申请 列表，可 处 理 receiptStatus 为 入库完成（ VENDOR_WAREHOUSE_CONFIRM ） 的退 货订单 。 您 在 [ 退 货 商品确认入库 ] 后 ， 进行 [ 退 货申请审核 ] 即可。根据急速退款政策 进行 退款， 或退货商品 已确 认 入库的情 况 ，一定 时间 后酷澎系 统将 批准退 货 。 此时无需 调用该 API 。 * 参考 退货 API 工作流程以便更好理解。
详细内容
API支持的买家用户地区：韩国、台湾
查看退货申请列表，可处理receiptStatus为入库完成（VENDOR_WAREHOUSE_CONFIRM）的退货订单。
您在[退货商品确认入库]后，进行[退货申请审核]即可。根据急速退款政策进行退款，或退货商品已确认入库的情况，一定时间后酷澎系统将批准退货。此时无需调用该API。
*参考退货API 工作流程以便更好理解。
路径
PATCH PUT
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approval
示例
请求参数
|
名称 |
必须 |
数据类型 |
描述 |
|
vendorId |
O |
String |
卖家ID： 酷澎分配给卖家的固有代码 e.g.A00012345 |
|
receiptId |
O |
Number |
退货处理号码 ReceiptId可通过“查看退货申请列表”API确认。 ReceiptId须输入数字。 |
请求体参数
|
名称 |
必须 |
数据类型 |
描述 |
|
vendorId |
O |
String |
卖家代码 |
|
receiptId |
O |
Number |
退货处理号码 |
|
cancelCount |
O |
Number |
退货处理数量 |
请求体示例
{
"vendorId": "A00013264",
"receiptId": 363585,
"cancelCount": 1
}返回消息
|
Name |
Type |
Description |
|
code |
Number |
服务器响应状态代码 |
|
message |
String |
成功或失败时出现响应结果信息 |
|
data |
Object |
|
返回消息示例
{
"code": "200",
"message": "OK"
}错误代码
|
HTTP状态代码(错误类型)) |
错误信息 |
解决方案 |
|
400（确认请求参数） |
无取消退货处理的详细信息。 |
顾客或客服人员取消了该退货申请，或输入的退货处理号码有误。可通过退货撤回记录API查看该退货是否有被撤回。 |
|
400 (Check return status) |
该订单已完成退货。 |
可通过单件查看退货申请API确认该处理号码(receiptId)是否是退货完成状态。查看是否为极速退款或根据退货商品回收流程来看，该订单是否是已完成退货的情况，确保不会进行重复审核。 |
|
400 (Check requested parameter) |
取消退货处理的数量与cancelCount不一致。 |
请查看是否输入了正确的退货处理数量。退货处理数量与输入的cancelCount不一致时，会导致错误发生。 |
|
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)是否是退货完成状态。查看是否为极速退款或根据退货商品回收流程来看，该订单是否是已完成退货的情况，确保不会进行重复审核。 |
接口名称
APPROVE_RETURN_REQUEST_BY_RECEIPT