Coupang Developer Center

API 적용 가능한 구매자 사용자 지역: 한국, 대만

반품지 센터코드(returncenterCode)로 반품지 정보를 조회합니다.

Path

GET

/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code

Example Endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code?returnCenterCodes=1000000051,1000006047

Request Parameters

Query String Parameter

Name					Required	Type	Description
returnCenterCodes					O	String	반품지 센터코드 일괄 조회가능한 returnCenterCodes의 최대 개수는 100. 예) 1000554021,1000554704

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	도로명

countryCode

String

국가코드, 국내의 경우 "KR"

companyContactNumber

String

반품지 전화번호

phoneNumber2

String

보조 전화번호

returnZipCode

String

반품지 우편번호

returnAddress

String

반품지 주소

returnAddressDetail

String

반품지 상세주소

Response Example

{
  "code": 200,
  "message": "OK",
  "data": [
    {
      "vendorId": "A00123456",
      "returnCenterCode": "1000552675",
      "shippingPlaceName": "32757 R",
      "deliverCode": "HANJIN",
      "deliverName": "한진택배",
      "goodsflowStatus": "승인",
      "errorMessage": "",
      "createdAt": 1579727107000,
      "vendorCreditFee02kg": 3000,
      "vendorCreditFee05kg": 3000,
      "vendorCreditFee10kg": 3000,
      "vendorCreditFee20kg": 3000,
      "vendorCashFee02kg": 3000,
      "vendorCashFee05kg": 3000,
      "vendorCashFee10kg": 3000,
      "vendorCashFee20kg": 3000,
      "consumerCashFee02kg": 3000,
      "consumerCashFee05kg": 3000,
      "consumerCashFee10kg": 3000,
      "consumerCashFee20kg": 3000,
      "returnFee02kg": 3000,
      "returnFee05kg": 3000,
      "returnFee10kg": 3000,
      "returnFee20kg": 3000,
      "usable": true,
      "placeAddresses": [
        {
          "addressType": "JIBUN",
          "countryCode": "KR",
          "companyContactNumber": "051-261-6120",
          "phoneNumber2": "000-0000-0000",
          "returnZipCode": "49525",
          "returnAddress": "부산시 사하구 다대로",
          "returnAddressDetail": "613"
        }
      ]
    }
  ]
}

Error Spec

HTTP 상태 코드(오류 유형)	오류 메시지	해결 방법
400 (요청변수확인)	center code should not be empty...	반품지 센터코드(returnCenterCodes) 입력이 누락되지 않았는지 확인합니다.
500 (서버오류)	Read timed out	반품지 조회 시 오류가 발생했습니다. 일정시간 이후 재호출 하거나 입력 값을 수정합니다. 관련 FAQ 클릭!

URL API Name

GET_SHIPPING_BY_CENTER_CODE

반품지 단건 조회

요약

상세

Path

Example Endpoint

Request Parameters

Query String Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name