배송 및 반품지 관련 정보를 별도의 승인 절차 없이 빠르게 수정할 수 있습니다.
수정 가능한 속성은 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 |
배송비종류
초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정 ● 유료배송 설정 시 기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정 ● 조건부 무료배송 설정 시 기본배송비와 반품배송비(편도) 금액 설정 ● 착불배송 설정 시 착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다. ※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.
|
|||||||||||||||||
deliveryCompanyCode | String |
택배사 코드
|
|||||||||||||||||
deliveryMethod | String |
배송방법
“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) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (다음날(D+1) 출고일 경우 '1' 입력)
|
|||||||||||||||||
pccNeeded | Boolean |
PCC(개인통관부호) 필수/비필수 여부
해외구매대행 상품인 경우, 상품 PCC(개인통관번호)
- 기본값 : 비필수(false)
|
|||||||||||||||||
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 |
묶음 배송여부
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능) 착불배송 불가 설정 불가 |
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