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

물류 정보

PUT/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters/{outboundShippingPlaceCode}2609170000

출고지 수정

KRTW

# 01

요약

출고지 수정

# 02

상세

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

출고지를 수정합니다.
출고지를 수정하려면 outboundShippingPlaceCode 및 remoteInfoId가 필요합니다.
'출고지 조회' API를 사용하여 outboundShippingPlaceCode 와 remoteInfoId를 얻을 수 있습니다.

※ 출고지 등록 시 설정된 국내 또는 해외의 구분이 결정된 이후에는 국내에서 해외, 해외에서 국내로 변경이 불가합니다. 국내와 해외의 구분을 변경하기 원하실 경우 신규 출고지를 등록해주시기 바랍니다.

경로

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

예시 엔드포인트

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

URL API Name

UPDATE_OUTBOUND_SHIPPING_PLACECODE

# 03

Path 파라미터

Name	Type	Description
vendorId*	string	판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345
outboundShippingPlaceCode*	number	수정하려는 출고지 코드

# 04

요청 본문

요청 파라미터

본문 파라미터

Name

Type

Description

vendorId*

string

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

userId*

string

사용자 ID(쿠팡 WING ID)

outboundShippingPlaceCode

integer

출고지 코드
"null"인 경우, 출고지이름은 변하지 않습니다

shippingPlaceName

string

출고지 이름

usable

boolean

사용 가능 여부

global

boolean

국내 혹은 해외

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

placeAddresses*

object[]

출고지 주소

addressType

placeAddresses[].addressType

string

주소 타입

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[]

도서산간 추가배송비

remoteInfoId

remoteInfos[].remoteInfoId

integer

새로운 배송정보를 생성시 이 필드는 입력할 필요없습니다. 배송정보를 수정/삭제시 반드시 이 필드를 입력해야합니다.
조회 API를 통해 이 필드 값을 얻을 수 있습니다.

deliveryCode

remoteInfos[].deliveryCode

string

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

jeju

remoteInfos[].jeju

integer

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

notJeju

remoteInfos[].notJeju

integer

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

usable

remoteInfos[].usable

boolean

사용여부
새로운 배송정보를 생성시 이 필드는 입력할 필요없습니다. 수정하신다면, "true"로 설정. 삭제하신다면, "false"로 설정.

요청 예시application/json

{
  "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
}

# 05

응답 본문

응답 메시지

Name	Type	Description
code	string	server response status code
message	string	detail info
data	object
resultCode data.resultCode	string	code
resultMessage data.resultMessage	string	message

Response Example

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

# 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자 이하로 입력합니다.