商品 API 品類 API 品牌 API 運輸 / 訂單 API 退貨 API 換貨 API 促銷 / 優惠券物流資訊客服 / 諮詢結算 CGF / CGF lite Rocket Growth

退貨 API

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

單件退貨查詢

KRTW

# 01

簡介

單件退貨查詢

# 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

# 03

Path 參數

Name	Type	Description
vendorId*	string	賣家ID
receiptId*	number	退貨受理編號 (不支持取消編號 ) 您可透過退貨申請陣列查詢API檢視ReceiptId 。 ReceiptId必須為number型別。
vendorId*	string	賣家ID
receiptId*	number	退貨受理編號 (不支持取消編號 ) 您可透過退貨申請陣列查詢API檢視ReceiptId 。 ReceiptId必須為number型別。

# 04

回應內容

回應訊息

Name

Type

Description

code

string

Http響應狀態碼

例子: 200, 400, 500

message

string

成功或失敗時顯示的結果資訊

data

object[]

receiptId

data[].receiptId

integer

退貨申請編號

orderId

data[].orderId

integer

訂單號

paymentId

data[].paymentId

integer

付款編號

receiptType

data[].receiptType

string

取消型別

RETURN

receiptStatus

data[].receiptStatus

string

退貨狀態

程式碼	描述
RELEASE_STOP_UNCHECKED	申請停止發貨
RETURNS_UNCHECKED	接收退貨申請
VENDOR_WAREHOUSE_CONFIRM	已入庫
REQUEST_COUPANG_CHECK	申請酷澎介入
RETURNS_COMPLETED	已退貨

Response Example

{
  "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": 123456789012345680,
          "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
      }
    }
  ]
}

# 05

錯誤碼

HTTP	代碼	訊息
400	HTTP_400	Bad Request

錯誤說明

HTTP	類型	錯誤訊息	解決方案
400	400 (確認請求引數)	ReceiptId doesn't belong to the vendorId, or cannot find the Receipt by the given id	請確認您查詢的退貨受理編號(receiptId)是否已被顧客撤回。您可透過退貨撤回記錄受理編號查詢API 確認撤回詳情。已撤回的退貨受理編號將無法再被查詢到。