公告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 规范变更通知

相关 Notice