查看退货申请列表,可处理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