公告2026-09-24active

[Open API] 限制退貨（不可退貨）品類之「拒絕顧客取消申請」功能及 API 規格變更通知

您好，我們是 Coupang Open API。

配合 MyCoupang App 內限制退貨（不可退貨）品類新增「顧客申請取消訂單」功能，透過 Open API 處理「拒絕顧客取消申請 (Reject customer cancellation request)」之作業方式及 API 規格將進行調整，特此通知。

1. 適用品類及條件 (Target Category Details)
本次 API 規格變更適用於符合以下限制退貨（不可退貨）品類 ID 及配送／商品條件篩選之訂單。

品類識別碼 (Category Identifier)：

kan_category_id: 5128, 9733
displayCategoryCode: 53375, 71693, 71694, 71695, 71696, 72279, 76838

kancategoryname: 純金/其他純金

配送及商品條件篩選 (Shipping Method / Category Filter)：

生鮮/冷凍 (Fresh/Frozen): COLD_FRESH

賣家直送 (Direct Shipping): VENDOR_DIRECT

客製化商品 (Custom-made): MAKE_ORDER

2. 主要變更事項及處理選項
針對處於「停止出貨 (Cancel Stage B)」狀態之不可退貨訂單，若欲拒絕顧客之取消申請，除既有之「已出貨 (Already Released)」外，新增「商品準備中 (Items in Preparation)」原因選項，供賣家執行「拒絕顧客取消申請 (Reject customer cancellation request)」。

可退貨之一般訂單：

行為與先前相同。（輸入物流單號資訊時，處理為已出貨／退貨）

限制退貨（不可退貨）訂單：

調用相同 API 時，系統將處理為「拒絕顧客取消申請」，而非單純建立退貨申請。

為使原材料加工、客製化製作、生鮮食品包裝等作業已開始但尚未開立物流單號之「商品準備中」狀態亦能拒絕取消申請，deliveryCompanyCode（物流公司代碼）及 invoiceNumber（物流單號）欄位將轉為非必填 (Optional)。

3. API 規格及 Request Spec 變更
[適用 API]
PATCH /v4/vendors/{vendorId}/returnRequests/{receiptId}/completedShipment (已出貨及拒絕取消處理)

[未變更之 API]
PUT/PATCH .../stoppedShipment (確認停止出貨／同意取消)

其他訂單取消相關之 API Endpoint

[Request Spec 詳細說明]
vendorId, receiptId: 必填（與先前相同）

deliveryCompanyCode, invoiceNumber: 必填 → 非必填 (Optional)

備註：若已有開立之物流單號，仍可照常輸入單號資訊後進行調用。

4. 賣家及 ERP 開發商注意事項
僅串接／使用可退貨品類者：無需修改 API 程式碼。

目前對不可退貨商品調用本 API 者：

先前調用時會立即轉為退貨受理狀態，變更後將處理為「拒絕顧客取消申請」。

被拒絕取消之訂單將不會被取消，且須完成正常配送。若既有 ERP 系統係以「退貨受理」為前提進行開發，請務必進行修正。

新 Endpoint 串接與否：無新增 API URL，請繼續使用既有 Endpoint。

5. 生效時程
預計生效日： 2026 年 10 月 6 日 (2026-10-06)（經 A/B 測試及 Ramp-up 後全面上線）

開發者文件： Coupang Open API Developer Portal

謝謝。

影響範圍PATCH /v4/vendors/{vendorId}/returnRequests/{receiptId}/completedShipment

SlugNotice-of-Customer-Cancellation-Request-Rejection-Feature

[Open API] 限制退貨（不可退貨）品類之「拒絕顧客取消申請」功能及 API 規格變更通知

相關公告