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

물류 정보

POST/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters2609170000

출고지 생성

KRTW

# 01

요약

출고지 생성

# 02

상세

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

상품 출고지를 생성합니다. 판매자는 이 API를 사용하여 하나 이상의 출고지를 만들 수 있으며, 생성된 출고지는 상품 등록시 출고지를 지정할 때 사용됩니다.
동일한 주소지를 가진 출고지 생성은 제한됩니다.

출고지 생성/수정 시 usable 파라메터 값을 true(사용)로 설정하시기 바랍니다.

경로

POST/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/outboundShippingCenters

URL API Name

REGISTER_OUTBOUND_SHIPPING_CENTER

# 03

Path 파라미터

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

# 04

요청 본문

요청 파라미터

본문 파라미터

Name

Type

Description

vendorId*

string

판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345

userId*

string

사용자 아이디(쿠팡 WING 로그인 계정)

shippingPlaceName*

string

출고지 이름, 최대 50 자
동일한 명칭의 출고지 중복 등록 불가

usable

string

사용가능여부

true	사용가능
false	사용불가

기본값 : true

global

string

기본값: false
국내(domestic) or 해외(overseas)

CODE	Mean
false	국내(domestic)
true	해외(overseas)

placeAddresses*

object[]

출고지 주소

addressType

placeAddresses[].addressType

string

주소 타입
JIBUN, ROADNAME, OVERSEA

CODE	Mean
JIBUN	지번
ROADNAME	도로명
OVERSEA	해외

도로명 주소 등록 시, 반드시 지번 주소를 함께 등록해야합니다.

countryCode

placeAddresses[].countryCode

string

국가 코드, 국내의 경우 "KR"입력. 유효길이는 2

companyContactNumber

placeAddresses[].companyContactNumber

string

전화번호, e.g. : xx-yyy-zzzz,

구분	Min~Max
x	2~4자
y	3~4자
z	4자

phoneNumber2

placeAddresses[].phoneNumber2

string

보조 전화번호 (형식 : 전화번호1과 같습니다)

returnZipCode

placeAddresses[].returnZipCode

string

우편번호 : 숫자, 최소길이 5, 최대길이 6

returnAddress

placeAddresses[].returnAddress

string

주소, 최대길이는 150

returnAddressDetail

placeAddresses[].returnAddressDetail

string

상세주소, 최대길이는 200

remoteInfos

object[]

도서산간 추가배송비

deliveryCode

remoteInfos[].deliveryCode

string

택배사 코드
택배사 코드 바로가기
택배사는 복수 등록이 가능하지만, 중복 등록은 불가능합니다.

jeju

remoteInfos[].jeju

string

제주 지역 배송비(원)

0원 또는 1000원~8000원까지 입력가능(100원 단위 입력), 착불배송 제외
예외 EPOST(우체국) : 0원 또는 100 ~ 400 원까지 입력가능(100원 단위 입력), 착불배송 제외

notJeju

remoteInfos[].notJeju

string

제주 외 지역 배송비(원)
제주 지역과 같습니다

요청 예시application/json

{
  "vendorId": "A00011620",
  "userId": "testId",
  "shippingPlaceName": "상품출고지 생성",
  "global": "false",
  "usable": "true",
  "placeAddresses": [
    {
      "addressType": "JIBUN",
      "countryCode": "KR",
      "companyContactNumber": "02-15**-1234",
      "phoneNumber2": "010-12**-**78",
      "returnZipCode": "10516",
      "returnAddress": "경기도 파주시 탄현면 월롱산로",
      "returnAddressDetail": "294-58"
    }
  ],
  "remoteInfos": [
    {
      "deliveryCode": "KGB",
      "jeju": "5000",
      "notJeju": "2500"
    },
    {
      "deliveryCode": "CJGLS",
      "jeju": "5000",
      "notJeju": "2500"
    }
  ]
}

# 05

응답 본문

응답 메시지

Name	Type	Description
code	string	서버 응답 코드
message	string	서버 응답 메시지
data	object	출고지 생성 결과
resultCode data.resultCode	string	결과 코드 SUCCESS or FAIL
resultMessage data.resultMessage	string	결과 메시지(출고지 코드) outbound shipping place code 출력 해당코드로 출고지 목록 조회 가능

Response Example

{
  "code": "200",
  "message": "SUCCESS",
  "data": {
    "resultCode": "SUCCESS",
    "resultMessage": "115"
  }
}

# 06

에러 코드

HTTP	코드	메시지
400	HTTP_400	Bad Request

오류 사양

HTTP	유형	오류 메시지	해결 방법
400	400 (요청변수확인)	배송비는 0원, 100원 이상 400원 이하만 가능합니다.	우체국 택배사의 경우 도서산간 배송비를 0원 또는 100원 이상 400원 이하만 입력했는지 확인합니다.
400	400 (요청변수확인)	Post code can't be empty	returnZipCode 값을 입력했는지 확인합니다.
400	400 (중복 입력)	[출고지중복] 이미 등록된 주소지명이 있습니다 (중복 주소지 코드:2026xxxx)	동일한 returnAddress 값을 입력했는지 확인합니다.
400	400 (중복 입력)	[출고지중복] Duplicated request. name:주식회사xxxxx	동일한 shippingPlaceName 값을 입력했는지 확인합니다.
400	400 (요청변수확인)	배송비는 0원, 1000원 이상 20000원 이하만 가능합니다.	jeju, notJeju 값을 올바른 범위로 입력했는지 확인합니다. 도서산간배송비를 0 또는 최소 1,000원 이상 최대 20000원 이하로 입력합니다.
400	400 (요청변수확인)	The format of postal code is invalid, it can only be number	returnZipCode 값에 숫자가 아닌 문자를 입력했는지 확인합니다.
400	400 (요청변수확인)	params are not allowed null...	null 값을 입력했는지 확인합니다.
400	400 (요청변수확인)	params's vendorId not equals gateway's vendorId!	잘못된 vendorId를 입력했는지 확인합니다.
400	400 (요청변수확인)	The max length of the shipping place name is 50, please input the correct length name	shippingPlaceName 값이 50자 이상인지 확인합니다.
400	400 (요청변수확인)	The address detail info can't be null(placeAddress)	returnAddress 값을 입력했는지 확인합니다.
400	400 (요청변수확인)	Must input the default phone number(phoneNumber1)	phoneNumber1 값을 입력했는지 확인합니다.
400	400 (요청변수확인)	Must input the default address(address1)	returnAddress 값을 입력했는지 확인합니다.
400	400 (요청변수확인)	The length of country code is 2, please input correct length country code	올바른 countryCode 값을 입력했는지 확인합니다.
400	400 (요청변수확인)	Please input the correct phone number format including numbers and '-' (min 9, max 13)	companyContactNumber 또는 phoneNumber2 값을 올바른 형식의 전화번호로 입력했는지 확인합니다. '-'를 포함하여 최소 9자 이상 최대 13자 이하로 입력합니다.
400	400 (요청변수확인)	The format of postal code is invalid, it can only be number, min length is 5 and max length is 6	returnZipCode 값을 올바르게 입력했는지 확인합니다. 숫자로만 최소 5, 최대 6자 이하로 입력합니다.
500	500 (요청변수확인)	shipping-places create error.	택배사 계약코드(contractNumber) 값을 올바로 입력했는지 확인합니다.