API 적용 가능한 구매자 사용자 지역: 한국,대만
해당 상품의 배송 및 반품지 등의 관련 정보를 조회할 수 있습니다.
본 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 | 배송비종류
● 무료배송 설정 시 ※ [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