PUT
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters/{outboundShippingPlaceCode}v1출고지 수정
# 01
요약
API 적용 가능한 구매자 사용자 지역: 한국, 대만 출고지를 수정합니다. 출고지를 수정하려면 outboundShippingPlaceCode 및 remoteInfoId가 필요합니다. ' 출고지 조회 ' API를 사용하여 outboundShippingPlaceCode 와 remoteInfoId를 얻을 수 있습니다. ※ 출고지 등록 시 설정된 국내 또는 해외의 구분이 결정된 이후에는 국내에서 해외, 해외에서 국내로 변경이 불가합니다. 국내와 해외의 구분을 변경하기 원하실 경우 신규 출고지를 등록해주시기 바랍니다.
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국, 대만
출고지를 수정합니다.
출고지를 수정하려면 outboundShippingPlaceCode 및 remoteInfoId가 필요합니다.
'출고지 조회' API를 사용하여 outboundShippingPlaceCode 와 remoteInfoId를 얻을 수 있습니다.
출고지를 수정하려면 outboundShippingPlaceCode 및 remoteInfoId가 필요합니다.
'출고지 조회' API를 사용하여 outboundShippingPlaceCode 와 remoteInfoId를 얻을 수 있습니다.
※ 출고지 등록 시 설정된 국내 또는 해외의 구분이 결정된 이후에는 국내에서 해외, 해외에서 국내로 변경이 불가합니다. 국내와 해외의 구분을 변경하기 원하실 경우 신규 출고지를 등록해주시기 바랍니다.
Path
PUT
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters/{outboundShippingPlaceCode}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/outboundShippingCenters/123456
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
||||
| outboundShippingPlaceCode | O | Number |
수정하려는 출고지 코드
|
||||
Body Parameter
| Name | Required | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| vendorId | O | String |
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
||||||||||||
| userId | O | String |
사용자 ID(쿠팡 WING ID)
|
||||||||||||
| outboundShippingPlaceCode | Number |
출고지 코드
"null"인 경우, 출고지이름은 변하지 않습니다
|
|||||||||||||
| shippingPlaceName | String |
출고지 이름
|
|||||||||||||
| usable | Boolean |
사용 가능 여부
|
|||||||||||||
| global | Boolean |
국내 혹은 해외
|
|||||||||||||
| placeAddresses | O | Array |
출고지 주소
|
||||||||||||
| addressType | String |
주소 타입
|
|||||||||||||
| 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 |
도서산간 추가배송비
|
|||||||||||||
| remoteInfoId | Number |
새로운 배송정보를 생성시 이 필드는 입력할 필요없습니다. 배송정보를 수정/삭제시 반드시 이 필드를 입력해야합니다.
조회 API를 통해 이 필드 값을 얻을 수 있습니다. |
|||||||||||||
| deliveryCode | String |
택배사 코드
택배사는 복수 등록이 가능하지만, 중복 등록은 불가능합니다.
|
|||||||||||||
| jeju | Number |
제주 지역 배송비(원)
0원 또는 1000원~8000원까지 입력가능(100원 단위 입력), 착불배송 제외
예외 EPOST(우체국) : 0원 또는 100 ~ 400 원까지 입력가능(100원 단위 입력), 착불배송 제외 |
|||||||||||||
| notJeju | Number |
제주 외 지역 배송비(원)
제주 지역과 같습니다
|
|||||||||||||
| usable | Boolean |
사용여부
새로운 배송정보를 생성시 이 필드는 입력할 필요없습니다. 수정하신다면, "true"로 설정. 삭제하신다면, "false"로 설정.
|
|||||||||||||
Request Example
{
"vendorId": "A00012345",
"userId": "Test11",
"outboundShippingPlaceCode": 123456,
"shippingPlaceName": "테스트 출고지 코드",
"placeAddresses": [
{
"addressType": "ROADNAME",
"countryCode": "KR",
"companyContactNumber": "02-1234-5678",
"phoneNumber2": "",
"returnZipCode": "05510",
"returnAddress": "서울특별시 송파구 송파대로 570 (신천동)",
"returnAddressDetail": "테스트 주소 101동 101호"
},
{
"addressType": "JIBUN",
"countryCode": "KR",
"companyContactNumber": "02-1111-1111",
"phoneNumber2": "",
"returnZipCode": "05510",
"returnAddress": "서울특별시 송파구 신천동 7-30",
"returnAddressDetail": "테스트 주소 101동 101호"
}
],
"remoteInfos": [
{
"remoteInfoId": 176476,
"deliveryCode": "DONGBU",
"jeju": 0,
"notJeju": 0,
"usable": true
}
],
"usable": true
}Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Number |
server response status code
|
||||
| message | String |
detail info
|
||||
| data | Object |
|
||||
| resultCode | String |
code
|
||||
| resultMessage | String |
message
|
||||
Response Example
{
"code": "200",
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "Modify successfully"
}
}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자 이하로 입력합니다. |
URL API Name
UPDATE_OUTBOUND_SHIPPING_PLACECODE