API 適用的买方用户區域:韓國、台灣
檢視退貨申請陣列,可處理receiptStatus為入庫完成(VENDOR_WAREHOUSE_CONFIRM)的退貨訂單。
您在[退貨商品確認入庫]後,進行[退貨申請稽核]即可。根據急速退款政策進行退款,或退貨商品已確認入庫的情況,一定時間後酷澎系統將批准退貨。此時無需呼叫該API。
*參考退貨API 工作流程以便更好理解。
路徑
PATCH PUT
/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
請求引數
路徑引數
| 名稱 | 是否必須 | 型別 | 描述 |
| vendorId | O | String | 賣家ID: 酷澎分配給賣家的固有程式碼 e.g.A00012345 |
| receiptId | O | Number | 退貨處理號碼 ReceiptId可透過“檢視退貨申請陣列”API確認。 ReceiptId須輸入數字。 |
請求體引數
| 名稱 | 是否必須 | 型別 | 描述 |
| vendorId | O | String | 賣家程式碼 |
| receiptId | O | Number | 退貨處理號碼 |
| cancelCount | O | Number | 退貨處理數量 |
請求體例子
返回訊息
| 名稱 | 型別 | 描述 |
| 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