Coupang Developer Center

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

请求参数

Name

Required

Type

Description

vendorId

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

上传退货商品运单

简介

详细内容

路径

示例