商品 API 品類 API 運輸 / 訂單 API 退貨 API 換貨 API 物流資訊客服 / 諮詢

退貨 API

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

退貨商品確認入庫

# 01

簡介

退貨商品確認入庫

# 02

詳細內容

API 適用的买方用户區域：韓國、台灣

檢視退貨請求陣列時，可處理receiptStatus 為RETURNS_UNCHECKED 的退貨。

請針對“不符合極速退款條件的商品”或“回收商品運單無物流跟蹤資訊”的訂單進行【退貨商品確認入庫】。

※ 使用退貨自動對接服務時

極速退款商品：因回收商品運單有物流跟蹤資訊，所以無需進行‘退貨商品確認入庫’（回收的商品到貨後立即退款。）
不符合極速退款條件的商品：需進行“退貨商品確認入庫”和“批准退貨申請”

如果您進行【退貨商品確認入庫】，無運單物流跟蹤資訊的極速退款商品可以立即退款，並處理為完成退貨。

因此，如果是極速退款商品，使用 GoodSflow 時無需另外進行“批准退貨申請”。

極速退款商品：一般配送商品且商品價格在10萬韓元以下（不包括生鮮食品、定製商品等）

*為便於理解，請檢視退貨API的workflow。

*【退貨商品確認入庫】後完成了退款，但回收的商品或運費出現問題，請向WING提交“酷澎確認請求”。

路徑

PATCH PUT

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/receiveConfirmation

例子

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/returnRequests/363585/receiveConfirmation

請求引數

路徑引數

名稱	是否必須	型別	描述
vendorId	O	String	賣家ID：酷澎分配給賣家的固有程式碼 e.g. A00012345
receiptId	O	Number	取消（退貨）受理ID ReceiptId可透過退貨請求陣列API檢視。 ReceiptId必須為數字。

請求體引數

名稱	必須	資料型別	描述
vendorId	O	String	賣家ID：酷澎分配給賣家的固有程式碼 e.g. A00012345
receiptId	O	Number	取消（退貨）受理ID

請求體例子

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

返回訊息

名稱	型別	描述
code	Number	HTTP請求狀態程式碼例子: 200, 400, 500
message	String	成功或失敗時會顯示相應結果資訊。
data	Object

返回訊息例子

{

"code": "200",

"message": "OK"

}

介面名稱

GET_RETURN_REQUEST_CONFIRMATION

路徑

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

範例端點

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/returnRequests/363585/receiveConfirmation

# 03

Path 參數

Name	Type	Description
vendorId*	string	賣家ID：酷澎分配給賣家的固有程式碼 e.g. A00012345
receiptId*	number	取消（退貨）受理ID ReceiptId可透過退貨請求陣列API檢視。 ReceiptId必須為數字。

# 04

請求內容

請求參數

請求內容參數

Name	Type	Description
vendorId*	string	賣家ID：酷澎分配給賣家的固有程式碼 e.g. A00012345
receiptId*	integer	取消（退貨）受理ID

請求範例application/json

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

# 05

回應內容

回應訊息

Name	Type	Description
code	string	HTTP請求狀態程式碼例子: 200, 400, 500
message	string	成功或失敗時會顯示相應結果資訊。
data	object

Response Example

{
  "code": "200",
  "message": "OK"
}

# 06

錯誤碼

HTTP	代碼	訊息
--