该API在顾客取消订单,通过退货请求列表查看到状态为申请停止出库(RELEASE_STOP_UNCHECKED)或退货处理未确认(RETURNS_UNCHECKED),且releaseStatus为“N”时才可使用。
商品若还未发货,则可按照顾客要求,使用该功能停止该商品的出库。
<注意!>申请停止出库的商品若已发货,往返退货配送费由卖家承担。
路径
PATCH PUT
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/stoppedShipment
示例
请求参数
名称 |
必须 |
数据类型 |
描述 |
receiptId |
O |
Number |
受理ID |
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g.) A00012345 |
请求体参数
名称 |
必须 |
数据类型 |
描述 |
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g.) A00012345 |
receiptId |
O |
Number |
受理ID |
cancelCount |
O |
Number |
出库数量 |
请求体示例
{
"vendorId": "A00012345",
"receiptId": 363667,
"cancelCount": 2
}
返回消息
名称 |
数据类型 |
描述 |
|
code |
Number |
服务器响应代码 |
|
message |
String |
服务器响应信息 |
|
data |
Object |
|
|
|
resultCode |
String |
SUCCESS/FAIL |
|
resultMessage |
String |
结果信息 |
返回消息示例
{
"code": "200",
"message": "OK",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "Request for release stop succeeded" }
}
错误代码
HTTP 状态码(错误类型) |
错误消息 |
解决方法 |
400 (Check requested variable) |
退货已完成。 |
通过单件查看退货申请API查看受理号码(receiptid)的退货状态是否完成。若已完成,就不要继续停止出库的操作。 |
400 (Check requested variable) |
取消退货受理数量及cancelCount不一致。 |
查看要停止出库的数量(cancelCount)是否与退货受理数量一致。 |
400 (Check requested variable) |
非商品准备中或带配送状态。配送完成 |
查看要停止出库的订单是否处于商品准备中或待配送状态。如果是配送完成的状态,处理时会出现错误。 |
400 (Check requested variable) |
cancelType不是A或RA。 |
查看输入的受理号码(receiptid)及退货状态是否正确,且不要继续停止出库的操作。 |
500 (Check requested variable) |
已出库,无法继续处理。 |
通过单件查看退货申请API查看受理号码(receiptid)的退货状态是否完成。若已完成,就不要继续停止出库的操作。 |
接口名称
STOP_RETURN_REQUEST_SHIPMENT