반품지 목록 조회

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

OPENAPI 관련 안내

이 섹션의 문서

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Query String Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name

OPENAPI 관련 안내

이 섹션의 문서

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Query String Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name

관련 문서