POST
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCentersv1출고지 생성
# 01
요약
API 적용 가능한 구매자 사용자 지역: 한국, 대만 상품 출고지를 생성합니다. 판매자는 이 API를 사용하여 하나 이상의 출고지를 만들 수 있으며, 생성된 출고지는 상품 등록시 출고지를 지정할 때 사용됩니다. 동일한 주소지를 가진 출고지 생성은 제한됩니다. 출고지 생성/수정 시 usable 파라메터 값을 true(사용) 로 설정하시기 바랍니다.
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국, 대만
상품 출고지를 생성합니다. 판매자는 이 API를 사용하여 하나 이상의 출고지를 만들 수 있으며, 생성된 출고지는 상품 등록시 출고지를 지정할 때 사용됩니다.
동일한 주소지를 가진 출고지 생성은 제한됩니다.
동일한 주소지를 가진 출고지 생성은 제한됩니다.
출고지 생성/수정 시 usable 파라메터 값을 true(사용)로 설정하시기 바랍니다.
Path
POST
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/outboundShippingCenters
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | |||
|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
|||
Body Parameter
| Name | Required | Type | Description | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
|||||||||||
| userId | O | String |
사용자 아이디(쿠팡 WING 로그인 계정)
|
|||||||||||
| shippingPlaceName | O | String |
출고지 이름, 최대 50 자
동일한 명칭의 출고지 중복 등록 불가
|
|||||||||||
| usable | boolean |
사용가능여부
기본값 : true |
||||||||||||
| global | boolean |
기본값: false
국내(domestic) or 해외(overseas)
|
||||||||||||
| placeAddresses | O | Array |
출고지 주소
|
|||||||||||
| addressType | String |
주소 타입
JIBUN, ROADNAME, OVERSEA
도로명 주소 등록 시, 반드시 지번 주소를 함께 등록해야합니다.
|
||||||||||||
| countryCode | String |
국가 코드, 국내의 경우 "KR"입력. 유효길이는 2
|
||||||||||||
| companyContactNumber | String |
전화번호, e.g. : xx-yyy-zzzz,
|
||||||||||||
| phoneNumber2 | String |
보조 전화번호 (형식 : 전화번호1과 같습니다)
|
||||||||||||
| returnZipCode | String |
우편번호 : 숫자, 최소길이 5, 최대길이 6
|
||||||||||||
| returnAddress | String |
주소, 최대길이는 150
|
||||||||||||
| returnAddressDetail | String |
상세주소, 최대길이는 200
|
||||||||||||
| remoteInfos | Array |
도서산간 추가배송비
|
||||||||||||
| deliveryCode | String |
택배사 코드
택배사는 복수 등록이 가능하지만, 중복 등록은 불가능합니다.
|
||||||||||||
| jeju | Number |
제주 지역 배송비(원)
0원 또는 1000원~8000원까지 입력가능(100원 단위 입력), 착불배송 제외
예외 EPOST(우체국) : 0원 또는 100 ~ 400 원까지 입력가능(100원 단위 입력), 착불배송 제외 |
||||||||||||
| notJeju | Number |
제주 외 지역 배송비(원)
제주 지역과 같습니다
|
||||||||||||
Request Example
{
"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"
}
]
}Response Message
| Name | Type | Description | |||
|---|---|---|---|---|---|
| code | Number |
서버 응답 코드
|
|||
| message | String |
서버 응답 메시지
|
|||
| data | Object |
출고지 생성 결과
|
|||
| resultCode | String |
결과 코드
SUCCESS or FAIL
|
|||
| resultMessage | String |
결과 메시지(출고지 코드)
outbound shipping place code 출력
해당코드로 출고지 목록 조회 가능 |
|||
Response Example
{
"code": "200",
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "115"
}
}Error Spec
| HTTP 상태 코드 (오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | 배송비는 0원, 100원 이상 400원 이하만 가능합니다. | 우체국 택배사의 경우 도서산간 배송비를 0원 또는 100원 이상 400원 이하만 입력했는지 확인합니다. |
| 400 (요청변수확인) | Post code can't be empty | returnZipCode 값을 입력했는지 확인합니다. |
| 400 (중복 입력) |
[출고지중복] 이미 등록된 주소지명이 있습니다 (중복 주소지 코드:2026xxxx) |
동일한 returnAddress 값을 입력했는지 확인합니다. |
| 400 (중복 입력) | [출고지중복] Duplicated request. name:주식회사xxxxx | 동일한 shippingPlaceName 값을 입력했는지 확인합니다. |
| 400 (요청변수확인) | 배송비는 0원, 1000원 이상 20000원 이하만 가능합니다. | jeju, notJeju 값을 올바른 범위로 입력했는지 확인합니다. 도서산간배송비를 0 또는 최소 1,000원 이상 최대 20000원 이하로 입력합니다. |
| 400 (요청변수확인) | The format of postal code is invalid, it can only be number | returnZipCode 값에 숫자가 아닌 문자를 입력했는지 확인합니다. |
| 400 (요청변수확인) | params are not allowed null... | null 값을 입력했는지 확인합니다. |
| 400 (요청변수확인) | params's vendorId not equals gateway's vendorId! | 잘못된 vendorId를 입력했는지 확인합니다. |
| 400 (요청변수확인) | The max length of the shipping place name is 50, please input the correct length name | shippingPlaceName 값이 50자 이상인지 확인합니다. |
| 400 (요청변수확인) | The address detail info can't be null(placeAddress) | returnAddress 값을 입력했는지 확인합니다. |
| 400 (요청변수확인) | Must input the default phone number(phoneNumber1) | phoneNumber1 값을 입력했는지 확인합니다. |
| 400 (요청변수확인) | Must input the default address(address1) | returnAddress 값을 입력했는지 확인합니다. |
| 400 (요청변수확인) | The length of country code is 2, please input correct length country code | 올바른 countryCode 값을 입력했는지 확인합니다. |
| 400 (요청변수확인) | Please input the correct phone number format including numbers and '-' (min 9, max 13) | companyContactNumber 또는 phoneNumber2 값을 올바른 형식의 전화번호로 입력했는지 확인합니다. '-'를 포함하여 최소 9자 이상 최대 13자 이하로 입력합니다. |
| 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 (요청변수확인) |
shipping-places create error. |
택배사 계약코드(contractNumber) 값을 올바로 입력했는지 확인합니다. |
URL API Name
REGISTER_OUTBOUND_SHIPPING_CENTER