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

상품 조회 (승인불필요)

KRTW
# 01

요약

상품 조회 (승인불필요)

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국,대만

해당 상품의 배송 및 반품지 등의 관련 정보를 조회할 수 있습니다.

본 API의 응답 메시지를 활용하여, [상품 수정 API (승인불필요)]에서 빠르게 정보를 수정할 수 있습니다.

경로

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/{sellerProductId}/partial

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/30100201234/partial

URL API Name

GET_PARTIAL_PRODUCT_BY_PRODUCT_ID
# 03

Path 파라미터

NameTypeDescription
sellerProductId*string
등록상품ID
상품 생성 완료 시, 출력 된 등록상품 ID
# 04

응답 본문

응답 메시지

NameTypeDescription
codestring
결과코드
SUCCES/ERROR
messagestring
메세지
dataobject
sellerProductId
data.sellerProductId
integer
등록상품ID
상품 생성 완료 시, 출력 된 등록상품 아이디 (data)
companyContactNumber
data.companyContactNumber
string
반품지연락처
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
deliveryCharge
data.deliveryCharge
integer
기본배송비
유료배송 또는 조건부 무료배송 시, 편도 배송비 금액 입력
deliveryChargeOnReturn
data.deliveryChargeOnReturn
integer
초도반품배송비
무료배송인 경우 반품시 소비자가 지불하는 배송비
deliveryChargeType
data.deliveryChargeType
string
배송비종류
Parameter Name Status
FREE 무료배송
NOT_FREE 유료배송
CHARGE_RECEIVED 착불배송
CONDITIONAL_FREE 조건부 무료배송
● 무료배송 설정 시
초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정
● 유료배송 설정 시
기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정
● 조건부 무료배송 설정 시
기본배송비와 반품배송비(편도) 금액 설정
● 착불배송 설정 시
착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다.

※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.
Parameter NameStatus
FREE무료배송
NOT_FREE유료배송
CHARGE_RECEIVED착불배송
CONDITIONAL_FREE조건부 무료배송
deliveryCompanyCode
data.deliveryCompanyCode
string
택배사 코드
택배사 코드 바로가기
deliveryMethod
data.deliveryMethod
string
배송방법
Parameter Name Status
SEQUENCIAL 일반배송(순차배송)
COLD_FRESH 신선냉동
MAKE_ORDER 주문제작
AGENT_BUY 구매대행
VENDOR_DIRECT 설치배송 또는 판매자 직접 전달
“INSTRUCTURE”와 “MAKE_ORDER_DIRECT”는 “VENDOR_DIRECT”로 통합되었습니다.
Parameter NameStatus
SEQUENCIAL일반배송(순차배송)
COLD_FRESH신선냉동
MAKE_ORDER주문제작
AGENT_BUY구매대행
VENDOR_DIRECT설치배송 또는 판매자 직접 전달
extraInfoMessage
data.extraInfoMessage
string
주문제작 안내 메시지
배송 방법을 '주문제작'으로 선택했을 경우, 고객에게 안내할 메시지를 입력
freeShipOverAmount
data.freeShipOverAmount
integer
무료배송을 위한 조건 금액
● 예시 : 10,000원 이상 조건부 무료배송을 설정하기 원할 경우 [deliveryChargeType]을 'CONDITIONAL_FREE'로 설정 후, [freeShipOverAmount]에 10000을 입력
※ 100원 이상 단위로 입력 가능
※ 무료배송인 경우, 0 입력
outboundShippingPlaceCode
data.outboundShippingPlaceCode
integer
출고지주소코드
묶음 배송 선택할 경우 필수, 출고지 조회 API를 통해 조회 가능
pccNeeded
data.pccNeeded
boolean
PCC(개인통관부호) 필수/비필수 여부
해외구매대행 상품인 경우, 상품 PCC(개인통관번호)
  • 기본값 : 비필수(false)
true 고객이 PCC 입력 후 구매 가능 (PCC는 발주서에 포함 됨)
false 고객이 PCC를 입력하지 않고 상품 구매 가능
Parameter NameStatus
true고객이 PCC 입력 후 구매 가능 (PCC는 발주서에 포함 됨)
false고객이 PCC를 입력하지 않고 상품 구매 가능
remoteAreaDeliverable
data.remoteAreaDeliverable
string
도서산간 배송여부
Parameter Name Status
Y 도서산간 배송
N 도서산간 배송안함
Parameter NameStatus
Y도서산간 배송
N도서산간 배송안함
returnAddress
data.returnAddress
string
반품지주소
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
returnAddressDetail
data.returnAddressDetail
string
반품지주소상세
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
returnCenterCode
data.returnCenterCode
string
반품지센터코드
반품지 생성 후, 추출 된 반품지 센터코드를 입력
● 반품지 생성은 Wing 또는 반품지 생성 API를 통해 가능
● 반품지 생성이 불가능한 경우, "NO_RETURN_CENTERCODE"를 입력하여 직접 반품지 정보 등록 가능
※ 반품자동연동 서비스(굿스플로우)는 계약한 택배사가 있어야만 이용이 가능하며, 반품지 센터코드 입력 필수
returnCharge
data.returnCharge
integer
반품배송비
반품회수시 편도 배송비
returnChargeName
data.returnChargeName
string
반품지명
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
returnZipCode
data.returnZipCode
string
반품지우편번호
쿠팡 Wing 또는 반품지 생성 API를 통해 반품지 등록 후 확인
unionDeliveryType
data.unionDeliveryType
string
묶음 배송여부
Parameter Name Status
UNION_DELIVERY 묶음 배송 가능
NOT_UNION_DELIVERY 묶음 배송 불가능
※ 묶음 배송 조건
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능)
착불배송 불가 설정 불가
Parameter NameStatus
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
  }
}
# 05

에러 코드

HTTP코드메시지
400HTTP_400Bad Request

오류 사양

HTTP유형오류 메시지해결 방법
400400

상품(XXXXXXXXX)의 데이터가 없습니다

존재하는 상품의 sellerProductId인지 확인