coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산Rocket Growth
PUT/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partialv1

상품 수정 (승인불필요)

# 01

요약

API 적용 가능한 구매자 사용자 지역: 한국, 대만 배송 및 반품지 관련 정보를 별도의 승인 절차 없이 빠르게 수정할 수 있습니다. 수정 가능한 속성은 Body Parameter 를 참고해 주시기 바랍니다. '임시저장중', '승인대기중' 인 상품은 수정할 수 없습니다.

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국, 대만
배송 및 반품지 관련 정보를 별도의 승인 절차 없이 빠르게 수정할 수 있습니다. 
수정 가능한 속성은 Body Parameter를 참고해 주시기 바랍니다. 
 

'임시저장중', '승인대기중' 인 상품은 수정할 수 없습니다.

Path

PUT

/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial

Example Endpoint

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/30100208559/partial

Request Parameters

Path Segment Parameter

Name Required Type Description
sellerProductId O String
등록상품ID
상품 생성 완료 시, 출력 된 등록상품 ID

Body Parameter

Name Required Type Description
sellerProductId O Number
등록상품ID
상품 생성 완료 시, 출력 된 등록상품 아이디 (data)
companyContactNumber   String
반품지연락처
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
deliveryCharge   Number
기본배송비
유료배송 또는 조건부 무료배송 시, 편도 배송비 금액 입력
deliveryChargeOnReturn   Number
초도반품배송비
무료배송인 경우 반품시 소비자가 지불하는 배송비
deliveryChargeType   String
배송비종류
Parameter Name Status
FREE 무료배송
NOT_FREE 유료배송
CHARGE_RECEIVED 착불배송
CONDITIONAL_FREE 조건부 무료배송

● 무료배송 설정 시
초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정
● 유료배송 설정 시
기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정
● 조건부 무료배송 설정 시
기본배송비와 반품배송비(편도) 금액 설정
● 착불배송 설정 시
착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다.

※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.
deliveryCompanyCode   String
deliveryMethod   String
배송방법
Parameter Name Status
SEQUENCIAL 일반배송
(순차배송)
COLD_FRESH 신선냉동
MAKE_ORDER 주문제작
AGENT_BUY 구매대행
VENDOR_DIRECT 설치배송 또는 판매자 직접 전달
“INSTRUCTURE”와 “MAKE_ORDER_DIRECT”는 “VENDOR_DIRECT”로 통합되었습니다.
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   Object 당일배송 설정
    sameDayShipping.active   Boolean 당일배송설정 가능여부
    sameDayShipping.cutOffTimeHour   Integer 당일출고주문마감시간은 10시에서 23시입니다. 
   

sameDayShipping.cutOffTimeMinute

  

Integer

마감 시간(분). active=true인 경우 0이어야 합니다.
   

sameDayShipping.cutOffTimeZone

  

String

시스템에서 관리되며, active=true일 경우 기본값은 "KR"입니다.
pccNeeded   Boolean 
PCC(개인통관부호) 필수/비필수 여부
해외구매대행 상품인 경우, 상품 PCC(개인통관번호)
- 기본값 : 비필수(false)
true 고객이 PCC 입력 후 구매 가능 (PCC는 발주서에 포함 됨) 
false 고객이 PCC를 입력하지 않고 상품 구매 가능
remoteAreaDeliverable   String
도서산간 배송여부
Parameter Name Status
Y 도서산간 배송
N 도서산간 배송안함
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 
묶음 배송여부
Parameter Name Status
UNION_DELIVERY 묶음 배송 가능
NOT_UNION_DELIVERY 묶음 배송 불가능

※ 묶음 배송 조건
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능)
착불배송 불가 설정 불가

 

Request Example

{
        "sellerProductId": 30100201234,
        "deliveryMethod": "SEQUENCIAL",
        "deliveryCompanyCode": "HYUNDAI",
        "deliveryChargeType": "CONDITIONAL_FREE",
        "deliveryCharge": 2500,
        "freeShipOverAmount": 10000,
        "deliveryChargeOnReturn": 0,
        "remoteAreaDeliverable": "N",
        "unionDeliveryType": "UNION_DELIVERY",
        "returnCenterCode": "1000274592",
        "returnChargeName": "반품지명_1",
        "companyContactNumber": "02-123-1234",
        "returnZipCode": "15200",
        "returnAddress": "서울특별시 송파구 송파대로 12길",
        "returnAddressDetail": "123호",
        "returnCharge": 2500,
        "outboundShippingPlaceCode": 63714,
        "extraInfoMessage": "",
        "pccNeeded": false,
        "outboundShippingTimeDay": 2,
    }

sellerProductId를 제외한 모든 항목은 비필수이기 때문에 원하는 항목만 입력하여 수정할 수 있습니다. 

{
        "sellerProductId": 30100208559,
        "deliveryCharge": 3000
    }

Response Message

Name Type Description
code String
결과코드
SUCCES/ERROR
message String
메세지
data Long
등록상품ID
=sellerProductId

Response Example

{
  "code": "200",
  "message": "",
  "data": {
    "code": "SUCCESS",
    "message": "",
    "data": 30100201234
  }
}

Error Spec

HTTP 상태 코드
(오류 유형)		 오류 메시지 해결 방법
400 업체상품아이디를 다시 확인해주세요. url path 상의 sellerProductId와 request body의 sellerProductId가 일치하는지 확인
400 업체상품아이디를 반드시 입력해주세요. requestBody에 sellerProductId를 입력했는지 확인
400 존재하지 않는 등록상품아이디 [xxxxxx]입니다. 존재하지 않는 sellerProductId를 입력했는지 확인
400 삭제된 상품은 변경이 불가능합니다. 삭제된 상품이 아닌지 확인
400 승인 대기중 상품은 수정할 수 없습니다. 등록상품의 상태가 '승인대기중'인지 확인
400 생성이 진행중인 상품은 수정할 수 없습니다. 등록상품의 상태가 '임시저장중'인지 확인
500 상품 수정이 실패했습니다. 쿠팡관리자에게 문의해주세요 예상하지 못한 시스템 에러가 발생한 경우, 온라인 문의로 쿠팡에 문의필요
  
 

URL API Name

UPDATE_PARTIAL_PRODUCT