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

상품 조회 (승인불필요)

# 01

요약

API 적용 가능한 구매자 사용자 지역: 한국,대만 해당 상품의 배송 및 반품지 등의 관련 정보를 조회할 수 있습니다. 본 API의 응답 메시지를 활용하여, [상품 수정 API (승인불필요)]에서 빠르게 정보를 수정할 수 있습니다.

# 02

상세

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
배송비종류
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를 통해 조회 가능
  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 묶음 배송 불가능

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

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