해당 상품의 배송 및 반품지 등의 관련 정보를 조회할 수 있습니다.
본 API의 응답 메시지를 활용하여, [상품 수정 API (승인불필요)]에서 빠르게 정보를 수정할 수 있습니다.
Path
GET
/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/30100201234/partial
Request Parameters
Path Segment Parameter
Name | Required | Type | Description | ||||
---|---|---|---|---|---|---|---|
sellerProductId | O | String |
등록상품ID
상품 생성 완료 시, 출력 된 등록상품 ID
|
Request Example
not require body
Response Message
Name | Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
code | String |
결과코드
SUCCES/ERROR
|
||||||||||||||||
message | String |
메세지
|
||||||||||||||||
data | ||||||||||||||||||
sellerProductId | 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를 통해 조회 가능
|
||||||||||||||||
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 |
묶음 배송여부
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능) 착불배송 불가 설정 불가 |
Response Example
{
"code": "SUCCESS",
"message": "",
"data": {
"sellerProductId": 30100201234,
"deliveryMethod": "SEQUENCIAL",
"deliveryCompanyCode": "HYUNDAI",
"deliveryChargeType": "NOT_FREE",
"deliveryCharge": 2500,
"freeShipOverAmount": 0,
"deliveryChargeOnReturn": 0,
"remoteAreaDeliverable": "N",
"unionDeliveryType": "NOT_UNION_DELIVERY",
"returnCenterCode": "56642",
"returnChargeName": "타워730",
"companyContactNumber": "02-123-7678",
"returnZipCode": "13590",
"returnAddress": "서울특별시 송파구 송파대로 570 (신천동)",
"returnAddressDetail": "타워",
"returnCharge": 2500,
"outboundShippingPlaceCode": 63714,
"extraInfoMessage": "",
"pccNeeded": false
}
}
Error Spec
HTTP 상태 코드 (오류 유형) | 오류 메시지 | 해결 방법 |
---|---|---|
400 | 상품(XXXXXXXXX)의 데이터가 없습니다 | 존재하는 상품의 sellerProductId인지 확인 |
URL API Name
GET_PARTIAL_PRODUCT_BY_PRODUCT_ID