PUT
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}2609170000반품지 수정
KRTW
# 01
요약
반품지 수정
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국, 대만
반품지를 수정합니다.
반품지를 수정 시 반품지코드(returnCenterCode)가 필요하며
반품지 목록 조회 API를 사용하여 반품지코드를 얻을 수 있습니다.
경로
PUT/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}
예시 엔드포인트
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/returnShippingCenters/1100044653URL API Name
UPDATE_SHIPPING_CENTER_BY_RETURN_CENTER_CODE
# 03
Path 파라미터
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345 |
| returnCenterCode* | number | 반품지 코드
|
# 04
요청 본문
요청 파라미터
본문 파라미터
| Name | Type | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| vendorId* | string | 판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345 | ||||||||
| returnCenterCode* | string | 반품지 코드
| ||||||||
| userId* | string | 사용자 ID(쿠팡 WING ID)
| ||||||||
| shippingPlaceName | string | 반품지 이름 "null"인 경우, 반품지이름은 변하지 않습니다 | ||||||||
| usable | string | 사용 가능 여부 사용하지 않는 반품지를 사용안함처리 할 수 있습니다. 단 해당 반품지를 사용하고 있는 상품 정보도 함께 수정해주셔야 합니다.
| ||||||||
| placeAddresses* | object[] | 반품지 주소
| ||||||||
| addressType placeAddresses[].addressType | string | 주소 타입 JIBUN, JIBUN&ROADNAME
| ||||||||
| companyContactNumber placeAddresses[].companyContactNumber | string | 전화번호, e.g. : xx-yyy-zzzz,
| ||||||||
| phoneNumber2 placeAddresses[].phoneNumber2 | string | 보조 전화번호 (형식 : 전화번호1과 같습니다)
| ||||||||
| returnZipCode placeAddresses[].returnZipCode | string | 우편번호 : 숫자, 최소길이 5, 최대길이 6
| ||||||||
| returnAddress placeAddresses[].returnAddress | string | 주소, 최대길이는 150
| ||||||||
| returnAddressDetail placeAddresses[].returnAddressDetail | string | 상세주소, 최대길이는 200
| ||||||||
| goodsflowInfoDto* | object | 굿스플로 택배 연동 정보
| ||||||||
| vendorCreditFee05kg goodsflowInfoDto.vendorCreditFee05kg | number | 상품이 5kg일때의 신용요금 (판매자 신용) 0보다 커야합니다 해당 항목은 따로 사용하는 곳이 없기에 상품등록API에서 입력하는 반품배송비로 입력 대상:vendorCreditFee05kg~returnFee20kg | ||||||||
| vendorCreditFee10kg goodsflowInfoDto.vendorCreditFee10kg | number | 상품이 10kg일때의 신용요금 (판매자 신용) 0보다 커야합니다. | ||||||||
| vendorCreditFee20kg goodsflowInfoDto.vendorCreditFee20kg | number | 상품이 20kg일때의 신용요금 (판매자 신용) 0보다 커야합니다. | ||||||||
| vendorCashFee05kg goodsflowInfoDto.vendorCashFee05kg | number | 상품이 5kg일때의 선불요금 (판매자 현금) 0보다 커야합니다. | ||||||||
| vendorCashFee10kg goodsflowInfoDto.vendorCashFee10kg | number | 상품이 10kg일때의 선불요금 (판매자 현금) 0보다 커야합니다. | ||||||||
| vendorCashFee20kg goodsflowInfoDto.vendorCashFee20kg | number | 상품이 20kg일때의 선불요금 (판매자 현금) 0보다 커야합니다. | ||||||||
| consumerCashFee05kg goodsflowInfoDto.consumerCashFee05kg | number | 상품이 5kg일때의 착불요금(구매자 현금) 0보다 커야합니다. | ||||||||
| consumerCashFee10kg goodsflowInfoDto.consumerCashFee10kg | number | 상품이 10kg일때의 착불요금(구매자 현금) 0보다 커야합니다. | ||||||||
| consumerCashFee20kg goodsflowInfoDto.consumerCashFee20kg | number | 상품이 20kg일때의 착불요금(구매자 현금) 0보다 커야합니다. | ||||||||
| returnFee05kg goodsflowInfoDto.returnFee05kg | number | 상품이 5kg일때의 반품비 0보다 커야합니다. | ||||||||
| returnFee10kg goodsflowInfoDto.returnFee10kg | number | 상품이 10kg일때의 반품비 0보다 커야합니다. | ||||||||
| returnFee20kg goodsflowInfoDto.returnFee20kg | number | 상품이 20kg일때의 반품비 0보다 커야합니다. |
요청 예시application/json
{
"userId": "testId",
"vendorId": "A00012345",
"returnCenterCode": "1000558900",
"shippingPlaceName": "반품지 -20200214-2modi",
"usable": "true",
"goodsflowInfoOpenApiDto": {
"deliverCode": "CJGLS",
"vendorCreditFee05kg": "2500",
"vendorCreditFee10kg": "2500",
"vendorCreditFee20kg": "2500",
"vendorCashFee05kg": "2500",
"vendorCashFee10kg": "2500",
"vendorCashFee20kg": "2500",
"consumerCashFee05kg": "2500",
"consumerCashFee10kg": "2500",
"consumerCashFee20kg": "2500",
"returnFee05kg": "2500",
"returnFee10kg": "2500",
"returnFee20kg": "2500"
},
"placeAddresses": [
{
"addressType": "JIBUN",
"companyContactNumber": "070-****-8008",
"phoneNumber2": "010-****-7993",
"returnZipCode": "110794",
"returnAddress": "서울특별시 종로구 인사동5길 25 (인사동)",
"returnAddressDetail": "하나로빌딩"
}
]
}# 05
응답 본문
응답 메시지
| Name | Type | Description |
|---|---|---|
| code | integer | 서버 응답 코드
|
| message | string | 서버 응답 메시지
|
| data | object | 반품지 수정 결과
|
| resultCode data.resultCode | string | 결과 코드 SUCCESS or FAIL |
| resultMessage data.resultMessage | string | 결과 메시지
|
Response Example
{
"code": 200,
"message": "SUCCESS",
"data": {
"resultCode": "SUCCESS",
"resultMessage": "Modify successfully"
}
}# 06
에러 코드
| HTTP | 코드 | 메시지 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
오류 사양
| HTTP | 유형 | 오류 메시지 | 해결 방법 |
|---|---|---|---|
| 400 | 400 (요청변수확인) | params are not allowed null... | 판매자ID(vendorId), 반품지코드(returnCenterCode), 사용자ID(userId)의 입력값이 누락되지 않았는지 확인합니다. |
| 400 | 400 (요청변수확인) | 이미 등록된 주소지명이 있습니다 (중복 주소지 코드:1000*******) | 동일한 반품지이름(shippingPlaceName)의 반품지가 이미 등록되었는지 확인합니다. 반품지를 중복 등록하지 않도록 처리합니다. |
| 400 | 400 (요청변수확인) | Please input the correct phone number format including numbers and '-' (min 9, max 13) | companyContactNumber 또는 phoneNumber2 값을 올바른 형식의 전화번호로 입력했는지 확인합니다. '-'를 포함하여 최소 9자 이상 최대 13자 이하로 입력합니다. |