Coupang Developer Center

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

반품지를 수정합니다.
반품지를 수정 시 반품지코드(returnCenterCode)가 필요하며
[반품지 목록 조회] API를 사용하여 반품지코드를 얻을 수 있습니다.

Path

PUT

/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}

Example Endpoint

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

Request Parameters

Path Segment Parameter

Name					Required	Type	Description
vendorId					O	String	판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345
returnCenterCode					O	Number	반품지 코드

Body Parameter

Name

Required

Type

Description

vendorId

String

판매자 ID

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

returnCenterCode

Number

반품지 코드

userId

String

사용자 ID(쿠팡 WING ID)

shippingPlaceName

String

반품지 이름

"null"인 경우, 반품지이름은 변하지 않습니다

usable

boolean

사용 가능 여부

사용하지 않는 반품지를 사용안함처리 할 수 있습니다.

단 해당 반품지를 사용하고 있는 상품 정보도 함께 수정해주셔야 합니다.

사용가능	true
사용안함	false

placeAddresses

Array

반품지 주소

addressType

String

주소 타입
JIBUN, JIBUN&ROADNAME

CODE	Mean
JIBUN	지번
ROADNAME	도로명

companyContactNumber

String

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

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

phoneNumber2

String

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

returnZipCode

String

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

returnAddress

String

주소, 최대길이는 150

returnAddressDetail

String

상세주소, 최대길이는 200

goodsflowInfoDto

Object

굿스플로 택배 연동 정보

vendorCreditFee05kg

Number

상품이 5kg일때의 신용요금 (판매자 신용)

0보다 커야합니다
해당 항목은 따로 사용하는 곳이 없기에
상품등록API에서 입력하는 반품배송비로 입력

대상:vendorCreditFee05kg~returnFee20kg

vendorCreditFee10kg

Number

상품이 10kg일때의 신용요금 (판매자 신용)

0보다 커야합니다.

vendorCreditFee20kg

Number

상품이 20kg일때의 신용요금 (판매자 신용)

0보다 커야합니다.

vendorCashFee05kg

Number

상품이 5kg일때의 선불요금 (판매자 현금)

0보다 커야합니다.

vendorCashFee10kg

Number

상품이 10kg일때의 선불요금 (판매자 현금)

0보다 커야합니다.

vendorCashFee20kg

Number

상품이 20kg일때의 선불요금 (판매자 현금)

0보다 커야합니다.

consumerCashFee05kg

Number

상품이 5kg일때의 착불요금(구매자 현금)

0보다 커야합니다.

consumerCashFee10kg

Number

상품이 10kg일때의 착불요금(구매자 현금)

0보다 커야합니다.

consumerCashFee20kg

Number

상품이 20kg일때의 착불요금(구매자 현금)

0보다 커야합니다.

returnFee05kg

Number

상품이 5kg일때의 반품비

0보다 커야합니다.

returnFee10kg

Number

상품이 10kg일때의 반품비

0보다 커야합니다.

returnFee20kg

Number

상품이 20kg일때의 반품비

0보다 커야합니다.

Request Example

{
	"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":"하나로빌딩"
	}]
}

Response Message

Name		Type	Description
code		Number	서버 응답 코드
message		String	서버 응답 메시지
data		Array	반품지 수정 결과
	resultCode	String	결과 코드 SUCCESS or FAIL
	resultMessage	String	결과 메시지

Response Example

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

Error Spec

HTTP 상태 코드(오류 유형)	오류 메시지	해결 방법
400 (요청변수확인)	params are not allowed null...	판매자ID(vendorId), 반품지코드(returnCenterCode), 사용자ID(userId)의 입력값이 누락되지 않았는지 확인합니다.
400 (요청변수확인)	이미 등록된 주소지명이 있습니다 (중복 주소지 코드:1000*******)	동일한 반품지이름(shippingPlaceName)의 반품지가 이미 등록되었는지 확인합니다. 반품지를 중복 등록하지 않도록 처리합니다.
400 (요청변수확인)	Please input the correct phone number format including numbers and '-' (min 9, max 13)	companyContactNumber 또는 phoneNumber2 값을 올바른 형식의 전화번호로 입력했는지 확인합니다. '-'를 포함하여 최소 9자 이상 최대 13자 이하로 입력합니다.

URL API Name

UPDATE_SHIPPING_CENTER_BY_RETURN_CENTER_CODE

반품지 수정

요약

상세

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name