coupang
API 文件
商品 API品類 API運輸 / 訂單 API退貨 API換貨 API物流資訊客服 / 諮詢
PATCH/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/approval2609170000

退貨申請稽核

# 01

簡介

退貨申請稽核

# 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 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
}

返回訊息

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

路徑

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
退貨處理數量
請求範例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)是否是退貨完成狀態。檢視是否為極速退款或根據退貨商品回收流程來看，該訂單是否是已完成退貨的情況，確保不會進行重複稽核。