卖家不使用自动退货对接服务(Goodsflow),自行回收退货的情况下,
收到退换货的商品,可通过该API直接上传退货商品运单。
使用自动退货对接服务(GoodSflow)的卖家无需使用。
退货:查看退货请求列表时,退货状态(receiptStatus)为受理退货(RETURNS_UNCHECKED)时可用
换货:查看换货请求列表时,回收状态(collectStatus)为回收对接前(BeforeDirection)时可用
※ 即使已登记退货运单,未出现物流追踪信息,或快递上门回收前,顾客仍可撤回退货申请。
路径
POST
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/return-exchange-invoices/manual
示例
请求参数
Name |
|
Required |
Type |
Description |
vendorId |
O |
|
String |
卖家ID 酷澎分配给卖家的固有代码 ex) A00012345 |
请求体参数
Name |
Required |
Type |
Description |
returnExchangeDeliveryType |
O |
String |
输入退货或换货(RETURN or EXCHANGE) |
receiptId |
O |
Number |
退货或换货受理ID 可通过退货请求列表,换货请求列表API查看 receiptId必须为数字 |
deliveryCompanyCode |
O |
String |
快递公司代码 |
invoiceNumber |
O |
String |
运单号 |
regNumber |
|
String |
快递公司回收号码(回收号码生成时输入) |
请求体示例
{
"returnExchangeDeliveryType": "EXCHANGE",
"receiptId": 101606005,
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": "201805291435",
"regNumber": "1234568"
}
返回消息
Name |
Type |
Description |
|
code |
Number |
HTTP 状态代码 |
|
message |
String |
HTTP 状态信息 |
|
data |
InvoiceNumberCreateDto |
|
|
|
deliveryCompanyCode |
String |
快递公司代码 |
|
invoiceNumber |
String |
运单号 |
|
invoiceNumberId |
Number |
内部invoiceNumberId |
|
receiptId |
Number |
退货或换货受理ID |
|
regNumber |
String |
快递公司回收号码 |
|
returnDeliveryId |
Number |
内部returnDeliveryId |
|
returnExchangeDeliveryType |
String |
退货或换货 |
返回消息示例
{
"code": 200,
"message": "OK",
"data": {
"deliveryCompanyCode": "KDEXP",
"invoiceNumber": "201805291435",
"invoiceNumberId": 26125633,
"receiptId": 101606005,
"regNumber": "1234568",
"returnDeliveryId": 25726758,
"returnExchangeDeliveryType": "RETURN"
}
}
错误代码
HTTP status code (error type) |
Error message |
How to resolve |
400 (check request parameter) |
不能输入与配送运单号相同的号码,运单号:2333*****6911。 |
查看输入的退货运单与首次配送时输入的运单是否相同。请输入新的退货运单号。 |
500 (check request parameter) |
DeliveryCompanyCodeEnum 的值无效:*** |
查看您是否输入了不支持的快递公司代码(DeliveryCompanyCode) 。请先确认可支持的快递公司代码后再输入。 * 快递公司代码 |
400 (check request parameter) |
退货运单格式不正确。运单号码:1***,快递公司:CJGLS |
查看您输入的退货运单和快递公司是否正确。 |
400 (check request parameter) |
对象为空 |
查看是否缺少必填字段。 |
接口名称
CREATE_RETURN_EXCHANGE_INVOICE