coupang
PATCH/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approvalv1

退貨申請稽核

# 01

簡介

API 適用的买方用户區域:韓國、台灣 檢視退貨申請陣列,可處理receiptStatus為入庫完成(VENDOR_WAREHOUSE_CONFIRM)的退貨訂單。 您在[退貨商品確認入庫]後,進行[退貨申請稽核]即可。根據急速退款政策進行退款,或退貨商品已確認入庫的情況,一定時間後酷澎系統將批准退貨。此時無需呼叫該API。 *參考退貨API 工作流程以便更好理解。

# 02

詳細內容

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  String 

賣家ID: 酷澎分配給賣家的固有程式碼 

e.g.A00012345 

receiptId  Number 

退貨處理號碼 

ReceiptId可透過“檢視退貨申請陣列”API確認。 

ReceiptId須輸入數字。 

請求體引數

名稱 是否必須  型別  描述 
vendorId  String  賣家程式碼 
receiptId  Number  退貨處理號碼 
cancelCount  Number  退貨處理數量 

請求體例子

{
"vendorId": "A00013264",
"receiptId": 363585,
"cancelCount": 1
}

返回訊息

名稱  型別 描述 
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