상품 수정 (승인불필요)

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

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

OPENAPI 관련 안내

이 섹션의 문서

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name

OPENAPI 관련 안내

이 섹션의 문서

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Body Parameter

Request Example

Response Message

Response Example

Error Spec

URL API Name

관련 문서