쿠팡에서 판매할 상품을 등록하는 API 입니다.
로켓그로스 상품 생성의 경우 API를 성공적으로 호출하려면 먼저 WING 플랫폼 > 판매자 정보 메뉴 > 추가 정보 메뉴 > "OPEN API 키 발급" 영역 우측에 있는 "로켓그로스 상품 생성 API 이용 및 검수 기준 동의"를 클릭하여 동의 처리 후 사용 가능합니다.
기 마켓플레이스 상품생성 API를 사용하시는 경우, 동일 Endpoint로 로켓그로스 로켓그로스 상품 또는 로켓그로스 & 마켓플레이스 동시 운영 상품 생성이 가능하지만, 본 문서에 있는 신규 schema를 활용하셔야 합니다. 기존 상품생성 API에서 추가/변경된 parameter는 초록색 텍스트를 참고하실 수 있습니다. 기존 마켓플레이스 상품에 로켓그로스 상품을 추가하시는 경우, 상품수정 API를 활용하여 추가하실 수 있습니다.
상품을 생성할 때는 상품 카테고리 별 고시정보, 옵션 정보 등이 필요합니다.
아래 상품등록 가이드를 다운받으시면, 보다 상세하게 확인하실 수 있습니다.
[Download] 쿠팡 OPENAPI 상품등록가이드
Path
POST
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
Example Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
Request Parameters
Body Parameter
Name |
Required |
Type |
Description |
|||||||||||||||||||||||
displayCategoryCode |
O |
Number |
노출카테고리코드 카테고리 목록 조회 API 또는 카테고리 정보 excel을 다운받아 노출카테고리코드 확인 가능 ※ 미입력 시, 카테고리 자동매칭 서비스에 의해 자동으로 카테고리가 등록될 수 있습니다. 자세한 사항은 여기를 확인하세요. |
|||||||||||||||||||||||
sellerProductName |
O |
String |
등록상품명 발주서에 사용되는 상품명 최대 길이 : 100 자 |
|||||||||||||||||||||||
vendorId |
O |
String |
판매자ID (=업체코드) 쿠팡에서 업체에게 발급한 고유 코드. Wing 로그인 후 확인 가능 |
|||||||||||||||||||||||
saleStartedAt |
O |
String |
판매시작일시 "yyyy-MM-dd'T'HH:mm:ss" 형식 |
|||||||||||||||||||||||
saleEndedAt |
O |
String |
판매종료일시 "yyyy-MM-dd'T'HH:mm:ss" 형식, *2099년 까지 길게 선택 가능 |
|||||||||||||||||||||||
displayProductName |
|
String |
노출상품명 실제 쿠팡 판매페이지에서 노출되는 상품명.
최대 길이 : 100 자 |
|||||||||||||||||||||||
brand |
|
String |
브랜드 브랜드명은 한글/영어 표준이름 입력 |
|||||||||||||||||||||||
generalProductName |
|
String |
제품명 구매옵션[Attribute exposed] 정보(사이즈, 색상 등)를 포함하지 않는 상품명. 모델명 추가 기입 가능 |
|||||||||||||||||||||||
productGroup |
|
String |
상품군 상품의 종류를 나타내는 명칭으로 노출카테고리의 최하위명을 참고하여 입력 가능. |
|||||||||||||||||||||||
marketplaceShippingAndReturnInfo |
|
|
마켓플레이스 아이템을 생성하려면 배송 및 반품 정보가 필요합니다. 로켓그로스의 경우 쿠팡이 배송 및 반품을 담당하므로 본 내용은 로켓그로스 등록상품 생성 시에는 유효하지 않을 수 있습니다. |
|||||||||||||||||||||||
|
deliveryMethod |
O |
String |
배송 방법
|
||||||||||||||||||||||
|
deliveryCompanyCode |
O |
String |
택배사 코드 |
||||||||||||||||||||||
|
deliveryChargeType |
O |
String |
배송비 유형
|
||||||||||||||||||||||
|
deliveryCharge |
O |
Number |
기본배송비 |
||||||||||||||||||||||
|
freeShipOverAmount |
O |
Number |
무료배송을 위한 조건 금액 |
||||||||||||||||||||||
|
deliveryChargeOnReturn |
O |
Number |
초도반품배송비 |
||||||||||||||||||||||
|
remoteAreaDeliverable |
O |
String |
도서산간 배송여부
|
||||||||||||||||||||||
|
unionDeliveryType |
O |
String |
묶음 배송여부
|
||||||||||||||||||||||
|
returnCenterCode |
O |
String |
반품지센터코드 |
||||||||||||||||||||||
|
returnChargeName |
O |
String |
반품지명 |
||||||||||||||||||||||
|
companyContactNumber |
O |
String |
반품지연락처 |
||||||||||||||||||||||
|
returnZipCode |
O |
String |
반품지우편번호 |
||||||||||||||||||||||
|
returnAddress |
O |
String |
반품지주소 |
||||||||||||||||||||||
|
returnAddressDetail |
O |
String |
반품지주소상세 |
||||||||||||||||||||||
|
returnCharge |
O |
Number |
반품배송비 |
||||||||||||||||||||||
|
outboundShippingPlaceCode |
O |
Number |
출고지주소코드 |
||||||||||||||||||||||
vendorUserId |
O |
String |
실사용자아이디(쿠팡 Wing ID) 업체(Vendor)에 소속된 사용자아이디 |
|||||||||||||||||||||||
requested |
O |
Boolean |
자동승인요청여부 상품 등록 시, 자동으로 판매승인요청을 진행할지 여부 선택 |
|||||||||||||||||||||||
items |
O |
List |
업체상품옵션목록 최대 200개 옵션 등록 가능 |
|||||||||||||||||||||||
|
itemName |
O |
String |
업체상품옵션명 각각의 아이템에 중복되지 않도록 기입 최대 길이 : 150자 제한 |
||||||||||||||||||||||
|
maximumBuyForPerson |
O |
Number |
할인율기준가 (정가표시) 할인율(%)표시를 위한 할인전 금액으로, 판매가격과 동일하게 입력시 '쿠팡가'로 노출. 승인완료 이후 할인율기준가 수정은 [옵션별 할인율기준가 변경] API를 통해 변경가능 |
||||||||||||||||||||||
|
maximumBuyForPersonPeriod |
O |
Number |
판매가격 판매가격을 입력. |
||||||||||||||||||||||
|
outboundShippingTimeDay |
O |
Number |
판매가능수량 판매가능한 재고수량을 입력. 최대값 : 99999 |
||||||||||||||||||||||
|
unitCount |
O |
Number |
인당 최대 구매 수량 1인당 최대 구매 가능한 수량. |
||||||||||||||||||||||
|
adultOnly |
O |
String |
최대 구매 수량 기간 1인당 해당 상품을 구매할 수 있는 주기 설정. |
||||||||||||||||||||||
|
taxType |
O |
String |
기준출고일(일) 주문일(D-Day) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (다음날(D+1) 출고일 경우 '1' 입력) |
||||||||||||||||||||||
|
parallelImported |
O |
String |
단위수량 상품에 포함된 수량을 입력하면 (판매가격 ÷ 단위수량) 로 계산하여 (1개당 가격 #,000원) 으로 노출. 개당가격이 필요하지 않은 상품은 '0'을 입력 |
||||||||||||||||||||||
|
overseasPurchased |
O |
String |
19세이상
|
||||||||||||||||||||||
|
pccNeeded |
O |
Boolean |
과세여부
|
||||||||||||||||||||||
|
extraProperties |
|
|
업체상품옵션추가정보 Key : Value 형태로 필요한 만큼 반복입력가능 |
||||||||||||||||||||||
|
|
Key |
|
String |
Value |
|||||||||||||||||||||
|
certifications |
|
List |
상품인증정보 상품 인증 정보 |
||||||||||||||||||||||
|
|
certificationType |
|
String |
인증정보Type 카테고리 메타정보 조회 API를 통해 등록가능한 Type을 구할 수 있다. |
|||||||||||||||||||||
|
|
certificationCode |
|
String |
상품인증정보코드 인증기관에서 발급받은 코드 |
|||||||||||||||||||||
|
|
certificationAttachments |
|
List<Map<String,String>> |
인증정보 첨부파일 이동통신사전승낙서 및 인증대리점 인증서 등록 시 사용함
아래 업체이미지 경로 또는 쿠팡CDN 경로 중 하나 이상 필수 입력 필요
Example: |
|||||||||||||||||||||
|
searchTags |
|
List |
검색어 필요한 만큼 반복입력가능. ["검색어1","검색어2"] 1개의 검색어 당 20자 이내로, 최대 20개의 검색어를 입력가능, !@#$%^&*-+;:’. 외의 특수문자는 입력불가 |
||||||||||||||||||||||
|
images |
O |
List |
이미지목록 필요한 만큼 반복 입력 가능 |
||||||||||||||||||||||
|
|
imageOrder |
O |
Number |
이미지표시순서 0,1,2... |
|||||||||||||||||||||
|
|
imageType |
O |
String |
이미지타입 대표이미지 타입 |
|||||||||||||||||||||
|
|
cdnPath |
O |
String |
쿠팡CDN경로 쿠팡 CDN 에 올린 경우 직접 입력, vendorPath와 cdnPath 중 하나 이상 필수 |
|||||||||||||||||||||
|
|
vendorPath |
O |
String |
업체이미지경로 업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨, vendorPath와 cdnPath 중 하나 이상 필수 80, 443 Port 이미지 경로만 사용가능 |
|||||||||||||||||||||
|
notices |
|
List |
상품고시정보 목록 카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능 |
||||||||||||||||||||||
|
|
noticeCategoryName |
|
String |
상품고시정보카테고리명 카테고리별 입력 가능한 상품고시정보 카테고리 중 하나를 입력 |
|||||||||||||||||||||
|
|
noticeCategoryDetailName |
|
String |
상품고시정보카테고리상세명 |
|||||||||||||||||||||
|
|
content |
|
String |
내용 |
|||||||||||||||||||||
|
attributes |
O |
List |
옵션목록(속성) 카테고리 기준으로 정해진 옵션 목록을 입력하는 객체 ● 구매옵션(attribute exposed)의 모든 값이 중복될 경우 등록 불가
※ 자유로운 구매옵션 구성(open attribute) 은 아래의 가이드에서 확인할 수 있습니다.
※ 음료 카테고리의 경우 카테고리 메타정보에서 정의한 필수구매옵션만 등록이 가능하며, 구매 옵션이 없거나 자유로운 구매옵션은 제한 됩니다. (카테고리 확인) |
||||||||||||||||||||||
|
|
attributeTypeName |
O |
String |
옵션타입명 카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 다운로드 엑셀 파일을 통해, 카테고리에 맞는 옵션타입명 확인 및 선택 가능 (구매옵션은 자유롭게 입력 가능) 최대 길이 25자 제한 |
|||||||||||||||||||||
|
|
attributeValueName |
O |
String |
옵션값 옵션타입명[attributeTypeName]에 해당하는 Value를 단위와 함께 입력 (예시 : "200ml") 최대 길이 30자 제한 |
|||||||||||||||||||||
|
contents |
O |
List |
옵션과 검색필터를 구분하는 항목 해당 항목을 제외하고 등록할 경우, 옵션으로 등록되고 해당 항목에 "NONE"이라는 값을 작성할 경우 필터로 등록 됨 검색필터는 반드시 등록하는 카테고리와 일치하는 필터명만 사용 가능 |
||||||||||||||||||||||
|
|
contentsType |
O |
String |
컨텐츠목록 필요한 만큼 반복 입력 가능 |
|||||||||||||||||||||
|
|
contentDetails |
O |
List |
컨텐츠타입
|
|||||||||||||||||||||
|
|
|
content |
O |
String |
상세컨텐츠목록 |
||||||||||||||||||||
|
|
|
detailType |
O |
String |
내용 |
||||||||||||||||||||
|
offerCondition |
|
String |
세부타입
|
||||||||||||||||||||||
|
offerDescription |
|
String |
상품상태 상품 생성 후에는 offerCondition 변경 불가능
|
||||||||||||||||||||||
|
rocketGrowthItemData |
O |
|
로켓그로스 상품 또는 로켓그로스와 마켓플레이스 상품 양쪽 모두에 대해 생성을 요청하는 경우 본 객체의 파라미터가 필요합니다. 마켓플레이스 아이템 생성만 요청하는 경우 해당 파라미터들은 null이어야 합니다. |
||||||||||||||||||||||
|
|
barcode |
|
String |
바코드
아래 사례의 경우 유효한 바코드로 간주됩니다:
|
|||||||||||||||||||||
|
|
emptyBarcodeReason |
|
String |
바코드 없음에 대한 사유
쿠팡 바코드 생성을 원할 경우, 사유에 "AUTO_GENERATED"를 입력 |
|||||||||||||||||||||
|
|
emptyBarcode |
|
Boolean |
상품 생성 API를 통해 SKU 정보를 제공하는 경우 바코드를 필수 정보로 제공해야 합니다.
|
|||||||||||||||||||||
|
|
externalVendorSku |
|
String |
|
|||||||||||||||||||||
|
|
modelNo |
|
String |
모델 번호 null값으로 제공 가능 |
|||||||||||||||||||||
|
|
priceData |
O |
|
할인율기준가 (정가표시) |
|||||||||||||||||||||
|
|
|
originalPrice |
O |
Number |
판매가격 |
||||||||||||||||||||
|
|
|
salePrice |
O |
Number |
아이템 생성 요청 시 사용하는 optional object입니다. 해당 정보는 아이템 생성 또는 입고 생성 시 제공될 수 있습니다(본 서비스는 현재 WING에서 이용 가능합니다). 아이템 생성 시 SKU 정보를 제공하도록 선택할 경우 본 객체 아래의 모든 파라미터가 필요하며, 일부 정보만 제공하면 오류가 발생합니다.
skuInfo를 제공하려면, "additionalInformationForRocketGrowth" > "rfmInboundName" 항목은 필수 정보입니다. skuInfo에 값이 있는데 "rfmInboundName"이 없는 경우 오류가 발생합니다.
|
||||||||||||||||||||
|
|
skuInfo |
|
|
아이템 생성 요청 시 사용하는 optional object입니다. 해당 정보는 아이템 생성 또는 입고 생성 시 제공될 수 있습니다(본 서비스는 현재 WING에서 이용 가능합니다). 아이템 생성 시 SKU 정보를 제공하도록 선택할 경우 본 객체 아래의 모든 파라미터가 필요하며, 일부 정보만 제공하면 오류가 발생합니다.
skuInfo를 제공하려면, "additionalInformationForRocketGrowth" > "rfmInboundName" 항목은 필수 정보입니다. skuInfo에 값이 있는데 "rfmInboundName"이 없는 경우 오류가 발생합니다.
|
|||||||||||||||||||||
|
|
|
fragile |
|
Boolean |
취급주의 상품 여부 |
||||||||||||||||||||
|
|
|
weight |
|
Number |
기본 중량 단위는 g입니다. |
||||||||||||||||||||
|
|
|
netWeight |
|
Number |
기본 순중량 단위는 g입니다. |
||||||||||||||||||||
|
|
|
width |
|
Number |
기본 너비 단위는 mm입니다. |
||||||||||||||||||||
|
|