PATCH
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/stoppedShipment2609170000“停止出库”处理
# 01
简介
“停止出库”处理
# 02
详细内容
API支持的买家用户地区:韩国
该API在顾客取消订单,通过退货请求列表查看到状态为申请停止出库(RELEASE_STOP_UNCHECKED)或退货处理未确认(RETURNS_UNCHECKED),且releaseStatus为“N”时才可使用。
商品若还未发货,则可按照顾客要求,使用该功能停止该商品的出库。
<注意!>申请停止出库的商品若已发货,往返退货配送费由卖家承担。
路径
PATCH/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/stoppedShipment
示例端点
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/returnRequests/363667/stoppedShipment# 03
Path 参数
| Name | Type | Description |
|---|---|---|
| receiptId* | number | 受理ID
|
| vendorId* | string | 卖家ID 酷澎分配给卖家的固有代码 e.g.) A00012345 |
# 04
请求体参数
请求参数
请求体参数
| Name | Type | Description |
|---|---|---|
| receiptId* | integer | 受理ID
|
| vendorId* | string | 卖家ID 酷澎分配给卖家的固有代码 e.g.) A00012345 |
| cancelCount* | integer | 出库数量
|
| code | string | 服务器响应代码
|
| message | string | 服务器响应信息
|
| data | object | |
| resultCode data.resultCode | string | SUCCESS/FAIL
|
| resultMessage data.resultMessage | string | 结果信息
|
| 400 (Check requested variable) | string | 查看输入的受理号码(receiptid)及退货状态是否正确,且不要继续停止出库的操作。
|
| 500 (Check requested variable) | string | 通过单件查看退货申请API查看受理号码(receiptid)的退货状态是否完成。若已完成,就不要继续停止出库的操作。
|
请求示例application/json
{
"vendorId": "A00012345",
"receiptId": 363667,
"cancelCount": 2
}# 05
响应体
响应消息
| Name | Type | Description |
|---|---|---|
| code | string | 服务器响应代码
|
| message | string | 服务器响应信息
|
| data | object | |
| resultCode data.resultCode | string | SUCCESS/FAIL
|
| resultMessage data.resultMessage | string | 结果信息
|
Response Example
{
"code": "200",
"message": "OK",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "Request for release stop succeeded"
}
}# 06
错误码
| HTTP | 代码 | 消息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
错误说明
| HTTP | 类型 | 错误消息 | 解决方案 |
|---|---|---|---|
| 400 | 400 (Check requested variable) | 退货已完成。 | 通过单件查看退货申请API查看受理号码(receiptid)的退货状态是否完成。若已完成,就不要继续停止出库的操作。 |
| 400 | 400 (Check requested variable) | 取消退货受理数量及cancelCount不一致。 | 查看要停止出库的数量(cancelCount)是否与退货受理数量一致。 |
| 400 | 400 (Check requested variable) | 非商品准备中或带配送状态。配送完成 | 查看要停止出库的订单是否处于商品准备中或待配送状态。如果是配送完成的状态,处理时会出现错误。 |
| 400 | 400 (Check requested variable) | cancelType不是A或RA。 | 查看输入的受理号码(receiptid)及退货状态是否正确,且不要继续停止出库的操作。 |
| 500 | 500 (Check requested variable) | 已出库,无法继续处理。 | 通过单件查看退货申请API查看受理号码(receiptid)的退货状态是否完成。若已完成,就不要继续停止出库的操作。 |