coupang
GET/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests/{receiptId}v1

单件退货申请查询

# 01

简介

API支持的买家用户地区:韩国、台湾 通过退货受理编号 查询单件退货情况。

# 02

详细内容

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

通过退货受理编号查询单件退货情况。

路径

GET

/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests/{receiptId}

示例

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v6/vendors/A00012697/returnRequests/363585

请求参数

名称 必须  数据类型  描述 
vendorId  O   String  卖家ID 
receiptId  O   Number 

退货受理编号(不支持取消编号)

您可通过退货申请列表查询API查看ReceiptId  

ReceiptId必须为number类型。 

请求体

无 

返回消息

名称  数据类型  描述
code  String 

Http request status code 

Example: 200, 400, 500 

message  String  成功或失败时显示的结果信息 
data  Array    
   receiptId  Number  退请编号  
   orderId  Number  订单号 
   paymentId  Number  付款编号 
   receiptType  String 

取消类型 

RETURN 

 

   receiptStatus  String 

退状态 

code  description 
RELEASE_STOP_UNCHECKED  停止发货  
RETURNS_UNCHECKED  接收退货申请 
VENDOR_WAREHOUSE_CONFIRM  已入 
REQUEST_COUPANG_CHECK  酷澎介入  
RETURNS_COMPLETED  已退 

 

   createdAt  String 

取消(退)受理时间 (符合ISO-8601標準)

格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

   modifiedAt  String 

取消(退)状态最终变更时间  (符合ISO-8601標準)

格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

   requesterName  String  退人姓名  
   requesterPhoneNumber  String  退电话号码 
   requesterRealPhoneNumber  String 

退真实号码 

null 

   requesterAddress  String  退回收地址 
   requesterAddressDetail  String  退回收详细地址  
   requesterZipCode  String  退回收地邮政编码 
   cancelReasonCategory1  String  退理由品1 
   cancelReasonCategory2  String    退理由品2 
   cancelReason  String     取消理由详情 
   cancelCountSum  Number     取消总数  
   returnDeliveryId  Number    退配送编号 
   returnDeliveryType  String 

回收 

  • 专职物流 
  • 联动物流 
  • 人工管理 

顾客直接发送退货商品或没有可回收商品时,会显“ ” 

   releaseStopStatus  String 

停止发货处理状态 

  • 未处理 
  • 已处理(已发货) 
  • 已处理(停止发货) 
  • 自动处理(已发货) 
  • 不是处理对象 
   enclosePrice  Object  同封配送 
    currencyCode String 货币码(符合ISO-4217标准),3位大写字母
    units Number 货币整数部分,64-bit
    nanos Number 货币小数部分,32-bit,取值范围 [-999999999, 999999999]
   faultByType  String 

归责类型 

   Value 
酷澎  COUPANG 

合作方 (卖家) 

过失 

VENDOR 
顾客过失  CUSTOMER 
物流过失  WMS 
一般  GENERAL 

 

   preRefund  Boolean  是否极速退款 
   completeConfirmType  String 

认类型 

   Value 
合作方确  VENDOR_CONFIRM 
未确  UNDEFINED 
CS代理确  CS_CONFIRM 
CS认损失  CS_LOSS_CONFIRM 

 

   completeConfirmDate  String 

认时间 

yyyy-MM-ddTHH:mm:ss 

   returnItems  Array  退商品列表 
      vendorItemPackageId  Number 

Deal 编号 

*不使用 

      vendorItemPackageName  String 

Deal  

*不使用 

      vendorItemId  Number 

属性ID 

*"vendorItemId"为单位受理退货商品。 受理时请务必确认属性ID。 

      vendorItemName  String  属性名 
      cancelCount  Number 

取消 

*可部分取消商品。请务必确认取消(退货)数量。 

      purchaseCount  Number  订单数量 
      shipmentBoxId  Number  原始配送编号  
      sellerProductId  Number  卖家注册商品编号 
      sellerProductName  String  卖家注册商品名 
      releaseStatus  String 

商品发货状态 

Code  Status 
Y  发货 
N   未发货
S  停止发货 
A  发过货 

 

      cancelCompleteUser  String 

订单取消负责人 

(3P_CANCEL: 在商品准状态下取消时) 

   returnDeliveryDtos  Array 

回收运单号信息 

receiptId可能个回收运单信息 

      deliveryCompanyCode  String  回收物流公司代 
      deliveryInvoiceNo  String 

回收运单号 

回收运单号数值为“”或null时,则可忽略 

   reasonCode  String 

退货原因代码 

请下载并确认退货申请列表页面上方的VOC原因代码 

   reasonCodeText  String  退原因说明 
   returnShippingCharge  Object 

预估退货运费  

形式  收取配送 
(+)  卖家承担 
负数(-)  顾客承担 

 

    currencyCode String 货币码(符合ISO-4217标准),3位大写字母
    units Number 货币整数部分,64-bit
    nanos Number 货币小数部分,32-bit,取值范围 [-999999999, 999999999]

返回消息示例

{
   "code": "200",
   "message": "OK",
   "data": [
       {
           "receiptId": 365937,
           "orderId": 500004398,
           "paymentId": 700003957,
           "receiptType": "반품",
           "receiptStatus": "RELEASE_STOP_UNCHECKED",
           "createdAt": "025-01-15T14:17:13.973885-08:00",
           "modifiedAt": "025-01-15T14:17:13.973885-08:00",
           "requesterName": "임송이",
           "requesterPhoneNumber": "+1(555)444-1234",
           "requesterRealPhoneNumber": null,
           "requesterAddress": "서울특별시 송파구 송파대로 570 (신천동)",
           "requesterAddressDetail": "Tower 730",
           "requesterZipCode": "05510",
           "cancelReasonCategory1": "고객변심",
           "cancelReasonCategory2": "단순변심(사유없음)",
           "cancelReason": "테스트",
           "cancelCountSum": 1,
           "returnDeliveryId": 40453,
           "returnDeliveryType": "연동택배",
           "releaseStopStatus": "미처리",
           "enclosePrice": {
               "currencyCode": "KRW",
               "units": 0,
               "nanos": 0
           },
           "faultByType": "CUSTOMER",
           "preRefund": false,
           "completeConfirmDate": "",
           "completeConfirmType": "미확인",
           "returnItems": [
               {
                   "vendorItemPackageId": 0,
                   "vendorItemPackageName": "객지/한씨연대기/삼포 가는 길/섬섬옥수/몰개월의 새",
                   "vendorItemId": 3000001893,
                   "vendorItemName": "객지/한씨연대기/삼포 가는 길/섬섬옥수/몰개월의 새 1",
                   "purchaseCount": 1,
                   "cancelCount": 1,
                   "shipmentBoxId": 123456789012345678,
                   "sellerProductId": 130,
                   "sellerProductName": "객지/한씨연대기/삼포 가는 길/섬섬옥수/몰개월의 새 1",
                   "releaseStatus": "S",
                   "cancelCompleteUser": "l******"
               }
           ],
           "returnDeliveryDtos": [
               {
                   "deliveryCompanyCode": "DIRECT",
                   "deliveryInvoiceNo": "201807261200"
               },
               {
                   "deliveryCompanyCode": "DIRECT",
                   "deliveryInvoiceNo": "201807261200"
               }
           ],
           "reasonCode": "CHANGEMIND",
           "reasonCodeText": "필요 없어짐 (단순 변심)",
           "returnShippingCharge": {
               "currencyCode": "KRW",
               "units": -3000,
               "nanos": 0
           }
       }
   ]
}

错误代码

HTTP状态(错误类)  错误信息  方案 
400 (认请参数)  ReceiptId doesn't belong to the vendorId, or cannot find the Receipt by the given id  请确认您查询的退受理编号(receiptId)是否已被顾客撤回。您可通过退货撤回记录受理编号查询API 确认撤回详情。已撤回的退货受理编号将无法再被查询到 

接口名称

GET_RETURN_REQUEST_BY_RECEIPT