coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산Rocket Growth
GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCentersv1

반품지 목록 조회

# 01

요약

API 적용 가능한 구매자 사용자 지역: 한국 대만 업체 코드를 통해 반품지를 조회한다.

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국 대만
업체 코드를 통해 반품지를 조회한다.

Path

GET

/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters

Example Endpoint

https://api-gateway.coupang.com/v5/providers/openapi/apis/api/v5/vendors/A00012345/returnShippingCenters?pageNum=1&pageSize=50

Request Parameters

Path Segment Parameter

Name Required Type Description
vendorId O String
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345

Query String Parameter

Name Required Type Description
pageNum   Number
페이지 수
기본값 1
pageSize   Number
페이지당 건수
기본값 10, 최대값 50

Request Example

 
not require body

Response Message 

Name Type Description
code Number
서버 응답 코드
message String
서버 응답 메시지
data Array
반품지 목록 데이터
  vendorId String
업체 코드
  returnCenterCode String
반품지 센터코드
  shippingPlaceName String
반품지 이름
  deliverCode String
택배사 코드
  deliverName String
택배사명
  goodsflowStatus String
굿스플로 상태
  errorMessage String
에러 메시지
  createAt String
생성일
  vendorCreditFee02kg Number
상품이 2kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
  vendorCreditFee05kg Number
상품이 5kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
  vendorCreditFee10kg Number
상품이 10kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
  vendorCreditFee20kg Number
상품이 20kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.
  vendorCashFee02kg Number
상품이 2kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
  vendorCashFee05kg Number
상품이 5kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
  vendorCashFee10kg Number
상품이 10kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
  vendorCashFee20kg Number
상품이 20kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.
  consumerCashFee02kg Number
상품이 2kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
  consumerCashFee05kg Number
상품이 5kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
  consumerCashFee10kg Number
상품이 10kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
  consumerCashFee20kg Number
상품이 20kg일때의 착불요금(구매자 현금)
0보다 커야합니다.
  returnFee02kg Number
상품이 2kg일때의 반품비
0보다 커야합니다.
  returnFee05kg Number
상품이 5kg일때의 반품비
0보다 커야합니다.
  returnFee10kg Number
상품이 10kg일때의 반품비
0보다 커야합니다.
  returnFee20kg Number
상품이 20kg일때의 반품비
0보다 커야합니다.
  usable boolean
사용여부
  placeAddresses Array
반품지 주소
    addressType String
주소 타입 
JIBUN, JIBUN&ROADNAME
CODE Mean
JIBUN 지번
ROADNAME 도로명
OVERSEA 해외
    countryCode String
국가코드, 국내의 경우 "KR"
    companyContactNumber String
반품지 전화번호
    phoneNumber2 String
보조 전화번호
    returnZipCode String
반품지 우편번호
    returnAddress String
반품지 주소
    returnAddressDetail String
반품지 상세주소

Response Example


{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "content": [
      {
        "vendorId": "A00012345",
        "returnCenterCode": "1000557004",
        "shippingPlaceName": "32777 R",
        "deliverCode": "HANJIN",
        "deliverName": "한진택배",
        "goodsflowStatus": "승인",
        "errorMessage": "",
        "createdAt": 1581195908000,
        "vendorCreditFee02kg": null,
        "vendorCreditFee05kg": 3000,
        "vendorCreditFee10kg": 3000,
        "vendorCreditFee20kg": 3000,
        "vendorCashFee02kg": null,
        "vendorCashFee05kg": 3000,
        "vendorCashFee10kg": 3000,
        "vendorCashFee20kg": 3000,
        "consumerCashFee02kg": null,
        "consumerCashFee05kg": 3000,
        "consumerCashFee10kg": 3000,
        "consumerCashFee20kg": 3000,
        "returnFee02kg": null,
        "returnFee05kg": 3000,
        "returnFee10kg": 3000,
        "returnFee20kg": 3000,
        "usable": true,
        "placeAddresses": [
          {
            "addressType": "JIBUN",
            "countryCode": "KR",
            "companyContactNumber": "02-111-1111",
            "phoneNumber2": "000-0000-0000",
            "returnZipCode": "42701",
            "returnAddress": "대구시 달서구 성서공단로",
            "returnAddressDetail": "235"
          }
        ]
      },
      {
        "vendorId": "A00012345",
        "returnCenterCode": "1000557003",
        "shippingPlaceName": "32776 R",
        "deliverCode": "HANJIN",
        "deliverName": "한진택배",
        "goodsflowStatus": "승인",
        "errorMessage": "",
        "createdAt": 1581195906000,
        "vendorCreditFee02kg": null,
        "vendorCreditFee05kg": 3000,
        "vendorCreditFee10kg": 3000,
        "vendorCreditFee20kg": 3000,
        "vendorCashFee02kg": null,
        "vendorCashFee05kg": 3000,
        "vendorCashFee10kg": 3000,
        "vendorCashFee20kg": 3000,
        "consumerCashFee02kg": null,
        "consumerCashFee05kg": 3000,
        "consumerCashFee10kg": 3000,
        "consumerCashFee20kg": 3000,
        "returnFee02kg": null,
        "returnFee05kg": 3000,
        "returnFee10kg": 3000,
        "returnFee20kg": 3000,
        "usable": true,
        "placeAddresses": [
          {
            "addressType": "JIBUN",
            "countryCode": "KR",
            "companyContactNumber": "010-9857-****",
            "phoneNumber2": "010-9857-****",
            "returnZipCode": "28805",
            "returnAddress": "충청북도 청주시 서원구 장성동",
            "returnAddressDetail": "111"
          }
        ]
      },
      {
        "vendorId": "A00012345",
        "returnCenterCode": "1000555466",
        "shippingPlaceName": "27487 R",
        "deliverCode": "HANJIN",
        "deliverName": "한진택배",
        "goodsflowStatus": "승인",
        "errorMessage": "",
        "createdAt": 1580795274000,
        "vendorCreditFee02kg": null,
        "vendorCreditFee05kg": 3000,
        "vendorCreditFee10kg": 3000,
        "vendorCreditFee20kg": 3000,
        "vendorCashFee02kg": null,
        "vendorCashFee05kg": 3000,
        "vendorCashFee10kg": 3000,
        "vendorCashFee20kg": 3000,
        "consumerCashFee02kg": null,
        "consumerCashFee05kg": 3000,
        "consumerCashFee10kg": 3000,
        "consumerCashFee20kg": 3000,
        "returnFee02kg": null,
        "returnFee05kg": 3000,
        "returnFee10kg": 3000,
        "returnFee20kg": 3000,
        "usable": true,
        "placeAddresses": [
          {
            "addressType": "JIBUN",
            "countryCode": "KR",
            "companyContactNumber": "02-722-****",
            "phoneNumber2": "000-0000-0000",
            "returnZipCode": "12615",
            "returnAddress": "경기도 여주시 북내면 가정1길",
            "returnAddressDetail": "62  (가정리)"
          }
        ]
      },
      {
        "vendorId": "A00012345",
        "returnCenterCode": "1000552893",
        "shippingPlaceName": "32759 R",
        "deliverCode": "HANJIN",
        "deliverName": "한진택배",
        "goodsflowStatus": "승인",
        "errorMessage": "",
        "createdAt": 1579813508000,
        "vendorCreditFee02kg": null,
        "vendorCreditFee05kg": 3000,
        "vendorCreditFee10kg": 3000,
        "vendorCreditFee20kg": 3000,
        "vendorCashFee02kg": null,
        "vendorCashFee05kg": 3000,
        "vendorCashFee10kg": 3000,
        "vendorCashFee20kg": 3000,
        "consumerCashFee02kg": null,
        "consumerCashFee05kg": 3000,
        "consumerCashFee10kg": 3000,
        "consumerCashFee20kg": 3000,
        "returnFee02kg": null,
        "returnFee05kg": 3000,
        "returnFee10kg": 3000,
        "returnFee20kg": 3000,
        "usable": true,
        "placeAddresses": [
          {
            "addressType": "JIBUN",
            "countryCode": "KR",
            "companyContactNumber": "000-1588-0***",
            "phoneNumber2": "000-0000-0000",
            "returnZipCode": "07345",
            "returnAddress": "서울시 영등포구 63로",
            "returnAddressDetail": "50 "
          }
        ]
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 749,
      "totalElements": 7488,
      "countPerPage": 10
    }
  }
}

Error Spec

HTTP 상태 코드(오류 유형) 오류 메시지 해결 방법
400 (요청변수확인) The vendorId in path or requestBody doesn't match the one got from api-gateway. 판매자ID(VendorId)가 올바로 입력됐는지 확인합니다.
500 (서버오류) Read timed out 조회기간을 줄여서 일정시간 이후 재호출합니다. 관련 FAQ 클릭!

URL API Name

GET_SHIPPING_CENTER_BY_VENDOR