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

상품 생성 (로켓그로스 및 마켓플레이스/로켓그로스 동시 운영 상품)

KRTW
# 01

요약

상품 생성 (로켓그로스 및 마켓플레이스/로켓그로스 동시 운영 상품)

# 02

상세

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

쿠팡에서 판매할 상품을 등록하는 API 입니다.

로켓그로스 상품 생성의 경우 API를 성공적으로 호출하려면 먼저 WING 플랫폼 > 판매자 정보 메뉴 > 추가 정보 메뉴 > "OPEN API 키 발급" 영역 우측에 있는 "로켓그로스 상품 생성 API 이용 및 검수 기준 동의"를 클릭하여 동의 처리 후 사용 가능합니다.

기 마켓플레이스 상품생성 API를 사용하시는 경우, 동일 Endpoint로 로켓그로스 로켓그로스 상품 또는 로켓그로스 & 마켓플레이스 동시 운영 상품 생성이 가능하지만, 본 문서에 있는 신규 schema를 활용하셔야 합니다. 기존 상품생성 API에서 추가/변경된 parameter는 초록색 텍스트를 참고하실 수 있습니다. 기존 마켓플레이스 상품에 로켓그로스 상품을 추가하시는 경우, 상품수정 API를 활용하여 추가하실 수 있습니다.

상품을 생성할 때는 상품 카테고리 별 고시정보, 옵션 정보 등이 필요합니다.
아래 상품등록 가이드를 다운받으시면, 보다 상세하게 확인하실 수 있습니다.
Download 쿠팡 OPENAPI 상품등록가이드

경로

POST/v2/providers/seller_api/apis/api/v1/marketplace/seller-products

예시 엔드포인트

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

URL API Name

CREATE_PRODUCT
# 03

요청 본문

요청 파라미터

본문 파라미터

NameTypeDescription
displayCategoryCode*number
노출카테고리코드카테고리 목록 조회 API 또는 카테고리 정보 excel을 다운받아 노출카테고리코드 확인 가능※ 미입력 시, 카테고리 자동매칭 서비스에 의해 자동으로 카테고리가 등록될 수 있습니다. 자세한 사항은 여기를 확인하세요.
sellerProductName*string
등록상품명발주서에 사용되는 상품명최대 길이 : 100 자
vendorId*string
판매자ID (=업체코드) 쿠팡에서 업체에게 발급한 고유 코드. Wing 로그인 후 확인 가능
saleStartedAt*string
판매시작일시"yyyy-MM-dd'T'HH:mm:ss" 형식
saleEndedAt*string
판매종료일시"yyyy-MM-dd'T'HH:mm:ss" 형식, *2099년 까지 길게 선택 가능
displayProductNamestring
노출상품명실제 쿠팡 판매페이지에서 노출되는 상품명.
[brand]+[generalProductName]과 동일하게 입력할 것을 권장, 미입력 상태로도 등록 가능
미입력 시 [brand]+[generalProductName]이 노출되거나, [sellerProductName]이 노출될 수 있음 최대 길이 : 100 자
brandstring
브랜드브랜드명은 한글/영어 표준이름 입력
띄어쓰기 및 특수문자 없이 입력
brandIdstring
상품에 연결된 브랜드 ID. 브랜드 정보가 있는 경우 반환됩니다.
generalProductNamestring
제품명구매옵션[Attribute exposed] 정보(사이즈, 색상 등)를 포함하지 않는 상품명. 모델명 추가 기입 가능
productGroupstring
상품군상품의 종류를 나타내는 명칭으로 노출카테고리의 최하위명을 참고하여 입력 가능.
제품명[generalProductName]과 중복될 경우, 입력 불필요
marketplaceShippingAndReturnInfoobject
마켓플레이스 아이템을 생성하려면 배송 및 반품 정보가 필요합니다. 로켓그로스의 경우 쿠팡이 배송 및 반품을 담당하므로 본 내용은 로켓그로스 등록상품 생성 시에는 유효하지 않을 수 있습니다.
deliveryMethod*
marketplaceShippingAndReturnInfo.deliveryMethod
string
배송 방법 Parameter NameStatusSEQUENCIAL정상 배송
(순차배송)COLD_FRESH신선냉동MAKE_ORDER주문제작AGENT_BUY구매대행VENDOR_DIRECT설치배송 또는 업체직송
신선식품의 경우 일반 배송이 아닌 신선냉동 유형을 선택해야 합니다.
deliveryCompanyCode*
marketplaceShippingAndReturnInfo.deliveryCompanyCode
string
택배사 코드
택배사 코드 링크
deliveryChargeType*
marketplaceShippingAndReturnInfo.deliveryChargeType
string
배송비 유형 Parameter NameStatusFREE무료배송NOT_FREE유료배송CHARGE_RECEIVED착불배송CONDITIONAL_FREE조건부 무료배송
● 무료배송 설정 시:
초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정
● 유료배송 설정 시
기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정
● 조건부 무료배송 설정 시
기본배송비와 반품배송비(편도) 금액 설정
●착불배송 설정 시
착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다.
※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.
deliveryCharge*
marketplaceShippingAndReturnInfo.deliveryCharge
number
기본배송비
유료배송 또는 조건부 무료배송 시, 편도 배송비 금액 입력
freeShipOverAmount*
marketplaceShippingAndReturnInfo.freeShipOverAmount
number
무료배송을 위한 조건 금액
● 예시) 10,000원 이상 조건부 무료배송을 설정하기 원할 경우 [deliveryChargeType]을 'CONDITIONAL_FREE'로 설정 후, [freeShipOverAmount]에 10000을 입력
※ 100원 이상 단위로 입력 가능
※ 무료배송인 경우, 0 입력
deliveryChargeOnReturn*
marketplaceShippingAndReturnInfo.deliveryChargeOnReturn
number
초도반품배송비
무료배송인 경우 반품시 고객이 지불하는 배송비
remoteAreaDeliverable*
marketplaceShippingAndReturnInfo.remoteAreaDeliverable
string
도서산간 배송여부 Parameter NameStatusY도서산간 배송N도서산간 배송안함
unionDeliveryType*
marketplaceShippingAndReturnInfo.unionDeliveryType
string
묶음 배송여부 Parameter NameStatusUNION_DELIVERY묶음 배송 가능NOT_UNION_DELIVERY묶음 배송 불가능
※ 묶음 배송 조건
출고지 정보 필수 입력 (출고지 정보가 같은 상품만 묶음 배송 가능)
착불배송 불가 설정 불가
returnCenterCode*
marketplaceShippingAndReturnInfo.returnCenterCode
string
반품지센터코드
반품지 생성 후, 추출된 반품지 센터코드를 입력
● 반품지 생성은 WING 또는 반품지 생성 API를 통해 가능
● 반품지 생성이 불가능한 경우, "NO_RETURN_CENTERCODE"를 입력하여 직접 반품지 정보 등록 가능
※ 반품자동연동 서비스(굿스플로우)는 계약한 택배사가 있어야만 이용이 가능하며, 반품지 센터코드 입력 필수
※ 해외배송 상품은 한국 반품지 주소와 계약한 택배사 코드를 입력해야 반품지 센터코드가 생성됩니다. *해외배송 반품지 가이드(클릭)
returnChargeName*
marketplaceShippingAndReturnInfo.returnChargeName
string
반품지명
쿠팡 WING 또는 반품지 조회 API를 통해 반품지 등록 후 확인
'반품지 조회 시, shippingPlaceName으로 노출되는 값 입력'
companyContactNumber*
marketplaceShippingAndReturnInfo.companyContactNumber
string
반품지연락처
쿠팡 Wing 또는 반품지 조회 API를 통해 반품지 등록 후 확인
returnZipCode*
marketplaceShippingAndReturnInfo.returnZipCode
string
반품지우편번호
쿠팡 Wing 또는 반품지 조회 API를 통해 반품지 등록 후 확인
returnAddress*
marketplaceShippingAndReturnInfo.returnAddress
string
반품지주소
쿠팡 Wing 또는 반품지 조회 API를 통해 반품지 등록 후 확인
returnAddressDetail*
marketplaceShippingAndReturnInfo.returnAddressDetail
string
반품지주소상세
쿠팡 Wing 또는 반품지 조회 API를 통해 반품지 등록 후 확인
returnCharge*
marketplaceShippingAndReturnInfo.returnCharge
number
반품배송비
반품 회수 시 편도 배송비
*초도반품배송비와 비교 시, 100~150%까지만 입력 가능
outboundShippingPlaceCode*
marketplaceShippingAndReturnInfo.outboundShippingPlaceCode
number
출고지주소코드
묶음 배송 선택할 경우 필수. 출고지 조회 API를 통해 조회 가능
해외구매대행(AGENT_BUY) 선택시 해외 주소지만 입력 가능함
vendorUserId*string
실사용자아이디(쿠팡 Wing ID)업체(Vendor)에 소속된 사용자아이디
requested*boolean
자동승인요청여부상품 등록 시, 자동으로 판매승인요청을 진행할지 여부 선택
● false : 작성 내용만 저장하고 판매요청 전 상태 (판매를 원할 시에는 상품 승인요청 API 또는 wing에서 판매요청을 진행 해야 함)
● true : 저장 및 자동으로 판매 승인 요청
items*object[]
업체상품옵션목록최대 200개 옵션 등록 가능
itemName*
items[].itemName
string
업체상품옵션명각각의 아이템에 중복되지 않도록 기입
사이트에 노출되는 옵션명이 아니며, 구매옵션에 따라 변경될 수 있음최대 길이 : 150자 제한
maximumBuyForPerson*
items[].maximumBuyForPerson
number
할인율기준가 (정가표시)할인율(%)표시를 위한 할인전 금액으로, 판매가격과 동일하게 입력시 '쿠팡가'로 노출. 승인완료 이후 할인율기준가 수정은 [옵션별 할인율기준가 변경] API를 통해 변경가능
maximumBuyForPersonPeriod*
items[].maximumBuyForPersonPeriod
number
판매가격판매가격을 입력.
'최초' 업체상품 등록시 판매가격은 상품 승인 요청 전에만 가능하며, 승인완료 이후 판매가격 수정은 [옵션별 가격 변경] API를 통해 변경가능
outboundShippingTimeDay*
items[].outboundShippingTimeDay
number
판매가능수량판매가능한 재고수량을 입력.
'최초' 업체상품 등록시 판매수량은 상품 승인 요청 전에만 가능하며, 승인완료 이후 재고 수정은 [옵션별 수량 변경] API를 통해 변경가능최대값 : 99999
unitCount*
items[].unitCount
number
인당 최대 구매 수량1인당 최대 구매 가능한 수량.
제한이 없을 경우 ‘0’을 입력
(예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미)
adultOnly*
items[].adultOnly
string
최대 구매 수량 기간1인당 해당 상품을 구매할 수 있는 주기 설정.
제한이 없을 경우 ‘1’을 입력
(예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미)
taxType*
items[].taxType
string
기준출고일(일)주문일(D-Day) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (다음날(D+1) 출고일 경우 '1' 입력)
parallelImported*
items[].parallelImported
string
단위수량상품에 포함된 수량을 입력하면 (판매가격 ÷ 단위수량) 로 계산하여 (1개당 가격 #,000원) 으로 노출. 개당가격이 필요하지 않은 상품은 '0'을 입력
overseasPurchased*
items[].overseasPurchased
string
19세이상 Parameter NameStatusADULT_ONLY19세이상 구입 가능 상품EVERYONE전연령 구입 가능 상품 (기본값)
pccNeeded*
items[].pccNeeded
boolean
과세여부 Parameter NameStatusTAX과세 (기본값)FREE비과세
extraProperties
items[].extraProperties
object
업체상품옵션추가정보Key : Value 형태로 필요한 만큼 반복입력가능
Key
items[].extraProperties.Key
string
Value
certifications
items[].certifications
object[]
상품인증정보상품 인증 정보
certificationType
items[].certifications[].certificationType
string
인증정보Type카테고리 메타정보 조회 API를 통해 등록가능한 Type을 구할 수 있다.
인증대상이 아닌 카테고리일 경우 : NOT_REQUIRED
certificationCode
items[].certifications[].certificationCode
string
상품인증정보코드인증기관에서 발급받은 코드
certificationAttachments
items[].certifications[].certificationAttachments
object[]
인증정보 첨부파일이동통신사전승낙서 및 인증대리점 인증서 등록 시 사용함
1.이동통신 사전승낙서 또는 인증대리점 인증서
2.판매점 사전승낙 인증마크 또는 이동통신사 대리점 인증마크
아래 업체이미지 경로 또는 쿠팡CDN 경로 중 하나 이상 필수 입력 필요
  1. vendorPath: 업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨
  2. cdnPath: 쿠팡 CDN 서버에 올린 경우 직접 입력 Example:
    "certifications": [
    {
    "certificationType": "MOBILE_DEVICE_DEALER_PERMIT",
    "certificationCode": "",
    "certificationAttachments": [
    {
    "vendorPath": "http://vendor.com/image/vendoritem/3001519145/cert.jpg"
    },
    {
    "vendorPath": "http://vendor.com/image/vendoritem/3001519145/logo.jpg"
    }
    ]
    }
    ]
searchTags
items[].searchTags
object[]
검색어필요한 만큼 반복입력가능. ["검색어1","검색어2"]1개의 검색어 당 20자 이내로, 최대 20개의 검색어를 입력가능, !@#$%^&*-+;:’. 외의 특수문자는 입력불가
images*
items[].images
object[]
이미지목록필요한 만큼 반복 입력 가능
imageOrder*
items[].images[].imageOrder
number
이미지표시순서0,1,2...
imageType*
items[].images[].imageType
string
이미지타입대표이미지 타입
3MB 이하의 정사각형 이미지를 JPG, PNG로 등록 가능 (최소 500 x 500px, 최대 5000 x 5000px)

● 필수
REPRESENTATION : 정사각형 대표이미지
● 선택
DETAIL : 기타이미지 (최대 9개까지 등록 가능)
USED_PRODUCT : 중고상태 이미지 (최대 4개까지 등록 가능)
cdnPath*
items[].images[].cdnPath
string
쿠팡CDN경로쿠팡 CDN 에 올린 경우 직접 입력, vendorPath와 cdnPath 중 하나 이상 필수
최대 길이 : 200 자
vendorPath*
items[].images[].vendorPath
string
업체이미지경로업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨, vendorPath와 cdnPath 중 하나 이상 필수80, 443 Port 이미지 경로만 사용가능
최대 길이 : 200 자
notices
items[].notices
object[]
상품고시정보 목록카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능
noticeCategoryName
items[].notices[].noticeCategoryName
string
상품고시정보카테고리명카테고리별 입력 가능한 상품고시정보 카테고리 중 하나를 입력
카테고리 메타 정보 조회 API 또는 전체 카테고리 정보 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능
noticeCategoryDetailName
items[].notices[].noticeCategoryDetailName
string
상품고시정보카테고리상세명
content
items[].notices[].content
string
내용
attributes*
items[].attributes
object[]
옵션목록(속성)카테고리 기준으로 정해진 옵션 목록을 입력하는 객체
등록하기 원하는 구매옵션 개수 만큼 반복 입력 가능● 구매옵션(attribute exposed)의 모든 값이 중복될 경우 등록 불가
● 한개 이상 필수 등록 ※ 자유로운 구매옵션 구성(open attribute) 은 아래의 가이드에서 확인할 수 있습니다.
구매옵션 자유 입력 가이드 (20201012 변경사항) ※ 음료 카테고리의 경우 카테고리 메타정보에서 정의한 필수구매옵션만 등록이 가능하며, 구매 옵션이 없거나 자유로운 구매옵션은 제한 됩니다. (카테고리 확인)
attributeTypeName*
items[].attributes[].attributeTypeName
string
옵션타입명카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 다운로드 엑셀 파일을 통해, 카테고리에 맞는 옵션타입명 확인 및 선택 가능 (구매옵션은 자유롭게 입력 가능)최대 길이 25자 제한
attributeValueName*
items[].attributes[].attributeValueName
string
옵션값옵션타입명[attributeTypeName]에 해당하는 Value를 단위와 함께 입력 (예시 : "200ml")최대 길이 30자 제한
contents*
items[].contents
object[]
옵션과 검색필터를 구분하는 항목해당 항목을 제외하고 등록할 경우, 옵션으로 등록되고해당 항목에 "NONE"이라는 값을 작성할 경우 필터로 등록 됨검색필터는 반드시 등록하는 카테고리와 일치하는 필터명만 사용 가능
contentsType*
items[].contents[].contentsType
string
컨텐츠목록필요한 만큼 반복 입력 가능
contentDetails*
items[].contents[].contentDetails
object[]
컨텐츠타입 Parameter NameStatusIMAGE이미지IMAGE_NO_SPACE이미지(공백없음)TEXT텍스트IMAGE_TEXT이미지-텍스트TEXT_IMAGE텍스트-이미지IMAGE_IMAGE이미지-이미지TEXT_TEXT텍스트-텍스트TITLE제목HTMLHTML
content*
items[].contents[].contentDetails[].content
string
상세컨텐츠목록
detailType*
items[].contents[].contentDetails[].detailType
string
내용
offerCondition
items[].offerCondition
string
세부타입 Parameter NameStatusIMAGE이미지TEXT텍스트
offerDescription
items[].offerDescription
string
상품상태상품 생성 후에는 offerCondition 변경 불가능
노출카테고리 코드에 따라 아래 값을 선택가능, 없을 경우 NEW로 취급함 Parameter NameMeanNEW새 상품REFURBISHED리퍼USED_BEST중고(최상)USED_GOOD중고(상)USED_NORMAL중고(중)
rocketGrowthItemData*
items[].rocketGrowthItemData
object
로켓그로스 상품 또는 로켓그로스와 마켓플레이스 상품 양쪽 모두에 대해 생성을 요청하는 경우 본 객체의 파라미터가 필요합니다. 마켓플레이스 아이템 생성만 요청하는 경우 해당 파라미터들은 null이어야 합니다.
barcode
items[].rocketGrowthItemData.barcode
string
바코드
상품에 부착된 유효한 표준상품 코드 아래 사례의 경우 유효한 바코드로 간주됩니다:소문자 없음 19자리 미만(8, 12, 13, 14, 18자리 허용)이중 공백 없음 하이픈을 제외한 특수 문자 없음문자 앞뒤에 공백 없음
emptyBarcodeReason
items[].rocketGrowthItemData.emptyBarcodeReason
string
바코드 없음에 대한 사유
최대 길이: 100자 제한 쿠팡 바코드 생성을 원할 경우, 사유에 "AUTO_GENERATED"를 입력
emptyBarcode
items[].rocketGrowthItemData.emptyBarcode
boolean
상품 생성 API를 통해 SKU 정보를 제공하는 경우 바코드를 필수 정보로 제공해야 합니다. Parameter NameMeanTRUE SKU 정보가 제공되지 않습니다.FALSE or null바코드 정보가 없습니다. 쿠팡 바코드를 생성하려면 “emptyBarcodeReason” 아래 "AUTO_GENERATED"를 입력하세요.
externalVendorSku
items[].rocketGrowthItemData.externalVendorSku
string
modelNo
items[].rocketGrowthItemData.modelNo
string
모델 번호null값으로 제공 가능
priceData*
items[].rocketGrowthItemData.priceData
object
할인율기준가 (정가표시)
할인율(%)표시를 위한 할인전 금액. 판매가격과 동일하게 입력시 '쿠팡가'로 노출. 승인완료 이후 할인율기준가 수정은 [옵션별 할인율기준가 변경] API를 통해 변경가능
originalPrice*
items[].rocketGrowthItemData.priceData.originalPrice
number
판매가격
판매가격을 입력.
'최초' 상품 등록시 판매가격은 상품 승인 요청 전에만 입력 가능. 승인완료 이후 판매가격 수정은 [옵션별 가격 변경] API를 통해 변경가능
salePrice*
items[].rocketGrowthItemData.priceData.salePrice
number
아이템 생성 요청 시 사용하는 optional object입니다. 해당 정보는 아이템 생성 또는 입고 생성 시 제공될 수 있습니다(본 서비스는 현재 WING에서 이용 가능합니다). 아이템 생성 시 SKU 정보를 제공하도록 선택할 경우 본 객체 아래의 모든 파라미터가 필요하며, 일부 정보만 제공하면 오류가 발생합니다. skuInfo를 제공하려면, "rocketGrowthAdditionalInformation" > "rfmInboundName" 항목은 필수 정보입니다. skuInfo에 값이 있는데 "rfmInboundName"이 없는 경우 오류가 발생합니다.
skuInfo
items[].rocketGrowthItemData.skuInfo
object
아이템 생성 요청 시 사용하는 optional object입니다. 해당 정보는 아이템 생성 또는 입고 생성 시 제공될 수 있습니다(본 서비스는 현재 WING에서 이용 가능합니다). 아이템 생성 시 SKU 정보를 제공하도록 선택할 경우 본 객체 아래의 모든 파라미터가 필요하며, 일부 정보만 제공하면 오류가 발생합니다. skuInfo를 제공하려면, "rocketGrowthAdditionalInformation" > "rfmInboundName" 항목은 필수 정보입니다. skuInfo에 값이 있는데 "rfmInboundName"이 없는 경우 오류가 발생합니다.
fragile
items[].rocketGrowthItemData.skuInfo.fragile
boolean
취급주의 상품 여부
weight
items[].rocketGrowthItemData.skuInfo.weight
number
기본 중량 단위는 g입니다.
netWeight
items[].rocketGrowthItemData.skuInfo.netWeight
number
기본 순중량 단위는 g입니다.
width
items[].rocketGrowthItemData.skuInfo.width
number
기본 너비 단위는 mm입니다.
length
items[].rocketGrowthItemData.skuInfo.length
number
기본 길이 단위는 mm입니다.
height
items[].rocketGrowthItemData.skuInfo.height
number
기본 높이 단위는 mm입니다.
quantityPerBox
items[].rocketGrowthItemData.skuInfo.quantityPerBox
number
기본 높이 단위는 mm입니다. 로켓그로스는 quantityPerBox(입수량)이 항상 1이어야 합니다.
distributionPeriod
items[].rocketGrowthItemData.skuInfo.distributionPeriod
number
유통기한 - 상품을 소비해야 하는 기한. 해당 필드는 카테고리 메타정보 조회 API에 따라 "isExpirationDateRequiredForRocketGrowth = true"인 카테고리에 필수 항목입니다.
expiredAtManaged
items[].rocketGrowthItemData.skuInfo.expiredAtManaged
boolean
distributionPeriod이 0보다 크면 True distributionPeriod=0 이면 false
marketplaceItemData*
items[].marketplaceItemData
object
마켓플레이스아이템 또는 로켓그로스와 마켓플레이스 아이템 양쪽 모두에 대해 생성을 요청하는 경우 본 객체의 파라미터가 필요합니다. 로켓그로스 아이템 생성만 요청하는 경우 해당 파라미터는 null이어야 합니다.
externalVendorSku
items[].marketplaceItemData.externalVendorSku
string
판매자 상품코드(업체 SKU 코드)
업체 고유의 아이템 코드 값을 임의로 설정 가능. 입력값은 발주서(PO) 조회 API response 에 포함됨.
items[].marketplaceItemData.externalVendorSku.
object
Number
items[].marketplaceItemData.externalVendorSku..Number
object
판매가능수량판매가능한 재고수량을 입력.
'최초' 업체상품 등록시 판매수량은 상품 승인 요청 전에만 가능하며, 승인완료 이후 재고 수정은 [옵션별 수량 변경] API를 통해 변경가능최대값 : 99999
modelNo
items[].marketplaceItemData.modelNo
string
모델번호
emptyBarcode
items[].marketplaceItemData.emptyBarcode
boolean
바코드 없음
바코드가 없으면 true
barcode
items[].marketplaceItemData.barcode
string
바코드
상품에 부착된 유효한 표준상품 코드
emptyBarcodeReason
items[].marketplaceItemData.emptyBarcodeReason
string
바코드 없음에 대한 사유
최대 길이: 100자 제한
priceData*
items[].marketplaceItemData.priceData
object
originalPrice*
items[].marketplaceItemData.priceData.originalPrice
number
할인율기준가 (정가표시)
할인율(%)표시를 위한 할인전 금액. 판매가격과 동일하게 입력시 '쿠팡가'로 노출. 승인완료 이후 할인율기준가 수정은 [옵션별 할인율기준가 변경] API를 통해 변경가능
salePrice*
items[].marketplaceItemData.priceData.salePrice
number
판매가격
판매가격을 입력.
'최초' 상품 등록시 판매가격은 상품 승인 요청 전에만 입력 가능. 승인완료 이후 판매가격 수정은 [옵션별 가격 변경] API를 통해 변경가능
requiredDocumentsobject[]
구비 서류 필수인 경우 입력.
구비 서류는 5MB 이하의 파일 가능(PDF, HWP, DOC, DOCX, TXT, PNG, JPG, JPEG)
templateName
requiredDocuments[].templateName
string
구비서류템플릿명
카테고리 메타 정보 조회 API에서 확인 가능
documentPath
requiredDocuments[].documentPath
string
구비서류 쿠팡CDN경로
documentPath 와 vendorDocumentPath 중 하나 필수
최대 길이: 150자
vendorDocumentPath
requiredDocuments[].vendorDocumentPath
string
구비서류벤더경로
구비서류 경로가 http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨. documentPath 와 vendorDocumentPath 중 하나 필수
최대 길이: 150자
extraInfoMessagestring
주문제작 안내 메시지
배송유형을 '주문제작'으로 선택했을 경우, 고객에게 안내할 메시지를 입력
manufacturestring
제조사
정확한 제조사 정보를 기입할 수 없는 경우, [brand] 항목과 동일한 정보 입력
rocketGrowthAdditionalInformation*object
rfmInboundName
rocketGrowthAdditionalInformation.rfmInboundName
string
입고 정보의 일부인 로켓그로스 물류 정보 이름. "skuInfo"를 제공하려면, 이는 필수 정보입니다. skuInfo에 값이 있는데 "rfmInboundName"이 없는 경우 오류가 발생합니다.
legalAgreement*
rocketGrowthAdditionalInformation.legalAgreement
string
로켓그로스 상품 취급과 관련한 동의. 본 키의 값이 "AGREE"가 아닌 다른 값이면 오류가 발생합니다. 모든 로켓그로스 아이템은 생성 시 정책에 대한 동의 정보가 필요합니다. 아래 "로켓그로스 상품 검수 기준 동의" 내용을 참조하세요.
# 04

응답 본문

응답 메시지

NameTypeDescription
codestring
결과코드
SUCCES/ERROR
messagestring
메세지
경고 및 에러 메세지가 포함되어 있으며, 여러 개 포함되어 있을 수 있습니다.
dataobject
등록상품ID
=sellerProductId
code
data.code
string
message
data.message
string
data
data.data
integer
detailsstring
에러 및 경고 상황에 대해 상세 설명되어 있습니다.
errorItemsobject[]
상품등록 실패가 될 수 있는 상품이 나열되어져 있습니다.
Item Type Description
itemIndex Integer ItemIndex = 0 as element index position of items List
itemName String 등록상품명
attributes List Attribute Type Description attributeTypename String attributeValuename String message String 유효하지 않은 데이터 타입, 단위

Response Example

{
  "code": "200",
  "message": "",
  "data": {
    "code": "SUCCESS",
    "message": "",
    "data": 427011919
  }
}
# 05

에러 코드

HTTP코드메시지
400HTTP_400Bad Request

오류 사양

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

등록상품명에 허용하지 않는 특수문자가 존재합니다.

노출상품명에 허용하지 않는 특수문자가 존재합니다.

displayProductName 및 sellerProductName

영어, 한글, 숫자, 공백 및 아래 특수 문자만 허용합니다.

!@#$%^&*()_+=-][{}';:"/.,<>?~㈜®|°。×

400400

중복된 바코드가 존재합니다.

다른 아이템에 바코드를 중복으로 사용할 수 없습니다.

다른 바코드 또는 자동 생성한 쿠팡 바코드를 입력하세요.

400400

입고를 생성하신 이후에는 물류(SKU)정보를 변경하실 수 없습니다.

입고 후에는 SKU 정보 수정이 불가합니다. 필요한 경우 지원팀에 문의하세요.

400400

누락된 물류정보가 있습니다. 기존 등록된 SKU정보나 변경하실 SKU정보를 입력하여 다시 수정을 요청하세요

SKU 정보 필드에 일부 값이 누락되었습니다. 해당 필드에 입력해주세요. 또한 SKU 정보는 삭제할 수 없습니다.

400400

로켓그로스 검수 기준을 확인하시고 동의해주세요. 동의하지 않으면 로켓그로스 상품등록을 할 수 없습니다.

RocketGrowthAdditionalInformation.legalAgreement는 필수 입력 항목입니다.

400400

판매중인 상품은 삭제할 수 없습니다.

아이디(vendorItemId, sellerProductItmeId) 중 일부가 누락되었으니 확인해주세요.