coupang
PUT/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/stoppedShipmentv1

“停止出库”处理

# 01

简介

API 支持的买家用户地区:韩国 该API在顾客取消订单,通过退货请求列表查看到状态为申请停止出库( RELEASE_STOP_UNCHECKED )或退货处理未确认( RETURNS_UNCHECKED ),且 releaseStatus 为“N ” 时才可使用。 商品若还未发货,则可按照顾客要求,使用该功能停止该商品的出库。 < 注意 !> 申请停止出库的商品若已发货,往返退货配送费由卖家承担。

# 02

详细内容

API支持的买家用户地区:韩国

该API在顾客取消订单,通过退货请求列表查看到状态为申请停止出库(RELEASE_STOP_UNCHECKED)或退货处理未确认(RETURNS_UNCHECKED),且releaseStatus为“N时才可使用。 

商品若还未发货,则可按照顾客要求,使用该功能停止该商品的出库。 

<注意!>申请停止出库的商品若已发货,往返退货配送费由卖家承担。 

路径

PATCH PUT

/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

请求参数

名称

必须 

数据类型 

描述

receiptId 

O 

Number 

受理ID 

vendorId 

O 

String  

卖家ID 

酷澎分配给卖家的固有代 

e.g.) A00012345 

请求体参数

名称

必须

数据类型

描述

vendorId 

O 

String 

卖家ID 

酷澎分配给卖家的固有代 

e.g.) A00012345 

receiptId 

 

Number 

受理ID  

cancelCount 

 

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不是ARA 

查看输入的受理号码(receiptid及退货状态是否正确,且不要继续停止出库的操作。 

500 (Check requested variable) 

已出库,无法继续处理。 

过单件查看退API查看受理号码(receiptid)的退货状态是否完成。若已完成,就不要继续停止出库的操作。 

接口名称

STOP_RETURN_REQUEST_SHIPMENT