상품 API 카테고리 API 브랜드 API 배송 / 주문 API 반품 API 교환 API 프로모션 / 쿠폰 물류 정보 고객 문의 정산 CGF / CGF lite Rocket Growth

물류 정보

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

반품지 단건 조회

KRTW

# 01

요약

반품지 단건 조회

# 02

상세

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

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

경로

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

예시 엔드포인트

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

URL API Name

GET_SHIPPING_BY_CENTER_CODE

# 03

Query 파라미터

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

# 04

응답 본문

응답 메시지

Name

Type

Description

code

integer

서버 응답 코드

message

string

서버 응답 메시지

data

object[]

반품지 정보

vendorId

data[].vendorId

string

업체 코드

returnCenterCode

data[].returnCenterCode

string

반품지 센터코드

shippingPlaceName

data[].shippingPlaceName

string

반품지 이름

deliverCode

data[].deliverCode

string

택배사 코드

deliverName

data[].deliverName

string

택배사명

goodsflowStatus

data[].goodsflowStatus

string

굿스플로 상태

errorMessage

data[].errorMessage

string

에러 메시지

createAt

data[].createAt

string

생성일

vendorCreditFee02kg

data[].vendorCreditFee02kg

integer

상품이 2kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.

vendorCreditFee05kg

data[].vendorCreditFee05kg

integer

상품이 5kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.

vendorCreditFee10kg

data[].vendorCreditFee10kg

integer

상품이 10kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.

vendorCreditFee20kg

data[].vendorCreditFee20kg

integer

상품이 20kg일때의 신용요금 (판매자 신용)
0보다 커야합니다.

vendorCashFee02kg

data[].vendorCashFee02kg

integer

상품이 2kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.

vendorCashFee05kg

data[].vendorCashFee05kg

integer

상품이 5kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.

vendorCashFee10kg

data[].vendorCashFee10kg

integer

상품이 10kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.

vendorCashFee20kg

data[].vendorCashFee20kg

integer

상품이 20kg일때의 선불요금 (판매자 현금)
0보다 커야합니다.

consumerCashFee02kg

data[].consumerCashFee02kg

integer

상품이 2kg일때의 착불요금(구매자 현금)
0보다 커야합니다.

consumerCashFee05kg

data[].consumerCashFee05kg

integer

상품이 5kg일때의 착불요금(구매자 현금)
0보다 커야합니다.

consumerCashFee10kg

data[].consumerCashFee10kg

integer

상품이 10kg일때의 착불요금(구매자 현금)
0보다 커야합니다.

consumerCashFee20kg

data[].consumerCashFee20kg

integer

상품이 20kg일때의 착불요금(구매자 현금)
0보다 커야합니다.

returnFee02kg

data[].returnFee02kg

integer

상품이 2kg일때의 반품비
0보다 커야합니다.

returnFee05kg

data[].returnFee05kg

integer

상품이 5kg일때의 반품비
0보다 커야합니다.

returnFee10kg

data[].returnFee10kg

integer

상품이 10kg일때의 반품비
0보다 커야합니다.

returnFee20kg

data[].returnFee20kg

integer

상품이 20kg일때의 반품비
0보다 커야합니다.

usable

data[].usable

boolean

사용여부

placeAddresses

data[].placeAddresses

object[]

반품지 주소

addressType

data[].placeAddresses[].addressType

string

주소 타입
JIBUN, JIBUN&ROADNAME

CODE	Mean
JIBUN	지번
ROADNAME	도로명

countryCode

data[].placeAddresses[].countryCode

string

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

companyContactNumber

data[].placeAddresses[].companyContactNumber

string

반품지 전화번호

phoneNumber2

data[].placeAddresses[].phoneNumber2

string

보조 전화번호

returnZipCode

data[].placeAddresses[].returnZipCode

string

반품지 우편번호

returnAddress

data[].placeAddresses[].returnAddress

string

반품지 주소

returnAddressDetail

data[].placeAddresses[].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"
        }
      ]
    }
  ]
}

# 05

에러 코드

HTTP	코드	메시지
400	HTTP_400	Bad Request

오류 사양

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