PUT
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial2609170000상품 수정 (승인불필요)
KRTW
# 01
요약
상품 수정 (승인불필요)
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국, 대만
배송 및 반품지 관련 정보를 별도의 승인 절차 없이 빠르게 수정할 수 있습니다.
수정 가능한 속성은 Body Parameter를 참고해 주시기 바랍니다.
'임시저장중', '승인대기중' 인 상품은 수정할 수 없습니다.
경로
PUT/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial
예시 엔드포인트
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/30100208559/partialURL API Name
UPDATE_PARTIAL_PRODUCT
# 03
Path 파라미터
| Name | Type | Description |
|---|---|---|
| sellerProductId* | string | 등록상품ID 상품 생성 완료 시, 출력 된 등록상품 ID |
# 04
요청 본문
요청 파라미터
본문 파라미터
| Name | Type | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| sellerProductId* | integer | 등록상품ID 상품 생성 완료 시, 출력 된 등록상품 아이디 (data) | ||||||||||||||||||||||||
| companyContactNumber | string | 반품지연락처 쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인 | ||||||||||||||||||||||||
| deliveryCharge | integer | 기본배송비 유료배송 또는 조건부 무료배송 시, 편도 배송비 금액 입력 | ||||||||||||||||||||||||
| deliveryChargeOnReturn | number | 초도반품배송비 무료배송인 경우 반품시 소비자가 지불하는 배송비 | ||||||||||||||||||||||||
| deliveryChargeType | string | 배송비종류
초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정 ● 유료배송 설정 시 기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정 ● 조건부 무료배송 설정 시 기본배송비와 반품배송비(편도) 금액 설정 ● 착불배송 설정 시 착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다. ※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.
| ||||||||||||||||||||||||
| deliveryCompanyCode | string | 택배사 코드 택배사 코드 바로가기 | ||||||||||||||||||||||||
| deliveryMethod | string | 배송방법
| ||||||||||||||||||||||||
| extraInfoMessage | string | 주문제작 안내 메시지 배송 방법을 '주문제작'으로 선택했을 경우, 고객에게 안내할 메시지를 입력 | ||||||||||||||||||||||||
| freeShipOverAmount | number | 무료배송을 위한 조건 금액 ● 예시 : 10,000원 이상 조건부 무료배송을 설정하기 원할 경우 [deliveryChargeType]을 'CONDITIONAL_FREE'로 설정 후, [freeShipOverAmount]에 10000을 입력 ※ 100원 이상 단위로 입력 가능 ※ 무료배송인 경우, 0 입력 | ||||||||||||||||||||||||
| outboundShippingPlaceCode | number | 출고지주소코드 묶음 배송 선택할 경우 필수, 출고지 조회 API를 통해 조회 가능 | ||||||||||||||||||||||||
| outboundShippingTimeDay | number | 기준출고일(일) 주문일(D-Day) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (당일출고를 하는 경우 '1'을 입력하세요.다음날(D+1) 출고일 경우 '1' 입력하시기 바랍니다.) | ||||||||||||||||||||||||
| sameDayShipping outboundShippingTimeDay.sameDayShipping | object | 당일배송 설정
| ||||||||||||||||||||||||
| active outboundShippingTimeDay.sameDayShipping.active | boolean | 당일배송설정 가능여부
| ||||||||||||||||||||||||
| cutOffTimeHour outboundShippingTimeDay.sameDayShipping.cutOffTimeHour | integer | 당일출고주문마감시간은 10시에서 23시입니다.
| ||||||||||||||||||||||||
| cutOffTimeMinute outboundShippingTimeDay.sameDayShipping.cutOffTimeMinute | integer | 마감 시간(분). active=true인 경우 0이어야 합니다.
| ||||||||||||||||||||||||
| cutOffTimeZone outboundShippingTimeDay.sameDayShipping.cutOffTimeZone | string | 시스템에서 관리되며, active=true일 경우 기본값은 "KR"입니다.
| ||||||||||||||||||||||||
| pccNeeded | boolean | PCC(개인통관부호) 필수/비필수 여부 해외구매대행 상품인 경우, 상품 PCC(개인통관번호)
| ||||||||||||||||||||||||
| remoteAreaDeliverable | string | 도서산간 배송여부
| ||||||||||||||||||||||||
| returnAddress | string | 반품지주소 쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인 | ||||||||||||||||||||||||
| returnAddressDetail | string | 반품지주소상세 쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인 | ||||||||||||||||||||||||
| returnCenterCode | string | 반품지센터코드 반품지 생성 후, 추출 된 반품지 센터코드를 입력 ● 반품지 생성은 Wing 또는 반품지 생성 API를 통해 가능 ● 반품지 생성이 불가능한 경우, "NO_RETURN_CENTERCODE"를 입력하여 직접 반품지 정보 등록 가능 ※ 반품자동연동 서비스(굿스플로우)는 계약한 택배사가 있어야만 이용이 가능하며, 반품지 센터코드 입력 필수 | ||||||||||||||||||||||||
| returnCharge | number | 반품배송비 반품회수시 편도 배송비 | ||||||||||||||||||||||||
| returnChargeName | string | 반품지명 쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인 | ||||||||||||||||||||||||
| returnZipCode | string | 반품지우편번호 쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인 | ||||||||||||||||||||||||
| unionDeliveryType | string | 묶음 배송여부
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능) 착불배송 불가 설정 불가
|
요청 예시application/json
{
"sellerProductId": 30100208559,
"deliveryCharge": 3000
}# 05
응답 본문
응답 메시지
| Name | Type | Description |
|---|---|---|
| code | string | 결과코드 SUCCES/ERROR |
| message | string | 메세지
|
| data | object | 등록상품ID =sellerProductId |
| code data.code | string | |
| message data.message | string | |
| data data.data | integer |
Response Example
{
"code": "200",
"message": "",
"data": {
"code": "SUCCESS",
"message": "",
"data": 30100201234
}
}# 06
에러 코드
| HTTP | 코드 | 메시지 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
오류 사양
| HTTP | 유형 | 오류 메시지 | 해결 방법 |
|---|---|---|---|
| 400 | 400 | 업체상품아이디를 다시 확인해주세요. | url path 상의 sellerProductId와 request body의 sellerProductId가 일치하는지 확인 |
| 400 | 400 | 업체상품아이디를 반드시 입력해주세요. | requestBody에 sellerProductId를 입력했는지 확인 |
| 400 | 400 | 존재하지 않는 등록상품아이디 [xxxxxx]입니다. | 존재하지 않는 sellerProductId를 입력했는지 확인 |
| 400 | 400 | 삭제된 상품은 변경이 불가능합니다. | 삭제된 상품이 아닌지 확인 |
| 400 | 400 | 승인 대기중 상품은 수정할 수 없습니다. | 등록상품의 상태가 '승인대기중'인지 확인 |
| 400 | 400 | 생성이 진행중인 상품은 수정할 수 없습니다. | 등록상품의 상태가 '임시저장중'인지 확인 |
| 500 | 500 | 상품 수정이 실패했습니다. 쿠팡관리자에게 문의해주세요 | 예상하지 못한 시스템 에러가 발생한 경우, 온라인 문의로 쿠팡에 문의필요 |