coupang
API 文档
商品 API品类 API品牌 API运输 / 订单 API退货 API换货 API促销 / 优惠券物流信息客服 / 咨询结算CGF / CGF liteRocket Growth
POST/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/return-exchange-invoices/manual2609170000

上传退货商品运单

# 01

简介

上传退货商品运单

# 02

详细内容

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

卖家不使用自动退货对接服务（Goodsflow），自行回收退货的情况下，

收到退换货的商品，可通过该API直接上传退货商品运单。

使用自动退货对接服务（GoodSflow）的卖家无需使用。

退货：查看退货请求列表时，退货状态（receiptStatus）为受理退货（RETURNS_UNCHECKED）时可用

换货：查看换货请求列表时，回收状态（collectStatus）为回收对接前（BeforeDirection）时可用

※ 即使已登记退货运单，未出现物流追踪信息，或快递上门回收前，顾客仍可撤回退货申请。

路径

POST/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/return-exchange-invoices/manual

示例端点

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/return-exchange-invoices/manual
# 03

Path 参数

NameTypeDescription
vendorId*object
卖家ID

酷澎分配给卖家的固有代码

ex) A00012345
# 04

请求体参数

请求参数

请求体参数

NameTypeDescription
vendorId*object
卖家ID

酷澎分配给卖家的固有代码

ex) A00012345
returnExchangeDeliveryType*string
输入退货或换货（RETURN or EXCHANGE）
receiptId*integer
退货或换货受理ID

可通过退货请求列表，换货请求列表API查看

receiptId必须为数字
deliveryCompanyCode*string
快递公司代码

跳转至快递公司代码
invoiceNumber*string
运单号
regNumberstring
快递公司回收号码（回收号码生成时输入）
codestring
HTTP
messagestring
HTTP 状态信息
dataobject
deliveryCompanyCode
data.deliveryCompanyCode
string
快递公司代码
invoiceNumber
data.invoiceNumber
string
运单号
invoiceNumberId
data.invoiceNumberId
number
内部invoiceNumberId
receiptId
data.receiptId
string
退货或换货受理ID
regNumber
data.regNumber
string
快递公司回收号码
returnDeliveryId
data.returnDeliveryId
string
内部returnDeliveryId
returnExchangeDeliveryType
data.returnExchangeDeliveryType
string
退货或换货
400 (check request parameter)string
查看是否缺少必填字段。
500 (check request parameter)string
查看您是否输入了不支持的快递公司代码（DeliveryCompanyCode） 。请先确认可支持的快递公司代码后再输入。
请求示例application/json
{
  "returnExchangeDeliveryType": "EXCHANGE",
  "receiptId": 101606005,
  "deliveryCompanyCode": "KDEXP",
  "invoiceNumber": "201805291435",
  "regNumber": "1234568"
}
# 05

响应体

响应消息

NameTypeDescription
codeinteger
HTTP
messagestring
HTTP 状态信息
dataobject
deliveryCompanyCode
data.deliveryCompanyCode
string
快递公司代码
invoiceNumber
data.invoiceNumber
string
运单号
invoiceNumberId
data.invoiceNumberId
integer
内部invoiceNumberId
receiptId
data.receiptId
integer
退货或换货受理ID
regNumber
data.regNumber
string
快递公司回收号码
returnDeliveryId
data.returnDeliveryId
integer
内部returnDeliveryId
returnExchangeDeliveryType
data.returnExchangeDeliveryType
string
退货或换货

Response Example

{
  "code": 200,
  "message": "OK",
  "data": {
    "deliveryCompanyCode": "KDEXP",
    "invoiceNumber": "201805291435",
    "invoiceNumberId": 26125633,
    "receiptId": 101606005,
    "regNumber": "1234568",
    "returnDeliveryId": 25726758,
    "returnExchangeDeliveryType": "RETURN"
  }
}
# 06

错误码

HTTP代码消息
400HTTP_400Bad Request

错误说明

HTTP类型错误消息解决方案
400400 (check request parameter)

不能输入与配送运单号相同的号码，运单号：2333*****6911。

查看输入的退货运单与首次配送时输入的运单是否相同。请输入新的退货运单号。

500500 (check request parameter)

DeliveryCompanyCodeEnum 的值无效：***

查看您是否输入了不支持的快递公司代码（DeliveryCompanyCode） 。请先确认可支持的快递公司代码后再输入。

400400 (check request parameter)

退货运单格式不正确。运单号码：1***，快递公司：CJGLS

查看您输入的退货运单和快递公司是否正确。

400400 (check request parameter)

对象为空

查看是否缺少必填字段。