该API在顾客取消订单,通过退货请求列表查看到状态为申请停止出库(RELEASE_STOP_UNCHECKED)或退货处理未确认(RETURNS_UNCHECKED),且releaseStatus为“N”时才可使用。 可在卖家已将商品发货时使用该API。
<注意!>即使顾客已申请停止出库,商品若已发货,往返退货配送费由卖家承担。
路径
PATCH PUT
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/returnRequests/{receiptId}/completedShipment
示例
请求参数
Name |
Required |
Type |
Description |
receiptId |
O |
Number |
受理ID |
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g.) A00012345 |
请求体参数
Name |
Required |
Type |
Description |
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g.) A00012345 |
receiptId |
O |
Number |
受理ID |
deliveryCompanyCode |
O |
String |
快递公司代码 |
invoiceNumber |
O |
String |
运单号 |
请求体示例
{
"vendorId": "TESTVENDORID",
"receiptId": 12346897,
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": "70432743577"
}
返回消息
名称 | 数据类型 | 描述 | ||||
---|---|---|---|---|---|---|
code | String |
服务器返回码
|
||||
message | String |
服务器返回消息
|
||||
data | Object |
|
||||
resultCode | String |
成功/失败
|
||||
resultMessage | String |
处理结果
|
返回消息示例
{
"data": {
"code": "200",
"message": "OK",
"resultCode": "SUCCESS",
"resultMessage": "Released status changed successfully."}
}
错误代码
HTTP 状态码 (错误类型) |
错误消息 |
解决方法 |
400 (Check the requested variable) |
已有保存的运单号,因此无法登记运单号。(上传相同运单号的条件:收件人信息相同)[合并配送号码:10275****15] |
查看该运单号是否已在酷澎登记。参考FAQ |
400 (Check the requested variable) |
运单号无效。 [合并配送号码:1167***03] |
查看输入的运单号(invoiceNumber)是否正确。 |
接口名称
STOP_RETURN_REQUEST_BY_RECEIPT