상품 API 카테고리 API 브랜드 API 배송 / 주문 API 반품 API 교환 API 프로모션 / 쿠폰 물류 정보 고객 문의 정산 CGF / CGF lite Rocket Growth

Rocket Growth

PUT/v2/providers/seller_api/apis/api/v1/marketplace/seller-products2609170000

상품 수정 (로켓그로스 또는 마켓플레이스/로켓그로스 동시 운영 상품)

KRTW

# 01

요약

# 02

상세

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

업체상품 정보를 수정합니다.
'상품 조회 API'를 이용하여 조회된 JSON 전문에서 원하는 값 만 수정 후, 전체 JSON 전문을 전송하여 수정이 가능합니다.

이 API를 사용하면 승인 후에 반영됩니다.

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

상품 생성 시 사용한 request body에, [sellerProductId]와 [sellerProductItemId]를 삽입하여 수정 가능

옵션 수정 : 수정하고 싶은 옵션의 아이템 상단에 [sellerProductItemId]와 [vendorItemId] 삽입 후, 원하는 [attributeValueName]으로 수정하여 전송
옵션 삭제 : 삭제하고 싶은 옵션의 'items 배열 하위 값'을 제거하고, 남기고 싶은 아이템 상단에 [sellerProductItemId] 삽입 후 전송 (이미 승인완료된 이력이 있는 옵션은 삭제 불가)
옵션 추가 : [sellerProductItemId]를 입력하지 않고 items 배열을 추가하여 전송

※ [sellerProductItemId]는 상품 조회 API를 이용해 확인가능합니다.
※ 승인 완료된 상품의 판매가격, 재고수량, 판매상태, 할인율 기준가는 상품수정API가 아닌, [상품 아이템별 수량/가격/판매여부/할인율기준가 변경] API를 통해 가능합니다.

Path

PUT

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

경로

PUT/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

UPDATE_PRODUCT

# 03

요청 본문

요청 파라미터

본문 파라미터

Name Type Description

sellerProductId*

number

등록상품ID
상품 생성 완료 시, 출력 된 등록상품 아이디 (data)

displayCategoryCode*

number

노출카테고리코드
상품 등록 후, 셀러의 직접 변경 불가

sellerProductName*

string

등록상품명
발주서에 사용되는 상품명
최대 길이 : 100 자

vendorId*

string

판매자ID
쿠팡에서 업체에게 발급한 고유 코드

saleStartedAt*

string

판매시작일시
"yyyy-MM-dd'T'HH:mm:ss" 형식

saleEndedAt*

string

판매종료일시
"yyyy-MM-dd'T'HH:mm:ss" 형식, *2099년 까지 길게 선택 가능

displayProductName

string

노출상품명
실제 쿠팡 판매페이지에서 노출되는 상품명.
[brand]+[generalProductName]과 동일하게 입력할 것을 권장, 미입력 상태로도 등록 가능
미입력 시 [brand]+[generalProductName]이 노출되거나, [sellerProductName]이 노출될 수 있음
최대 길이 : 100 자

brand

string

브랜드
브랜드명은 한글/영어 표준이름 입력
띄어쓰기 및 특수문자 없이 입력

generalProductName

string

제품명
구매옵션[Attribute exposed] 정보(사이즈, 색상 등)를 포함하지 않는 상품명. 모델명 추가 기입 가능

productGroup

string

상품군
상품의 종류를 나타내는 명칭으로 노출카테고리의 최하위명을 참고하여 입력 가능.
제품명[generalProductName]과 중복될 경우, 입력 불필요

marketplaceShippingAndReturnInfo

object

배송 및 반품 정보는 마켓플레이스 아이템에 대해서만 수정할 수 있습니다.

deliveryMethod*

marketplaceShippingAndReturnInfo.deliveryMethod

string

배송 방법

Parameter Name	Status
SEQUENCIAL	정상 배송 (순차배송)
COLD_FRESH	신선냉동
MAKE_ORDER	주문제작
AGENT_BUY	구매대행
VENDOR_DIRECT	설치배송 또는 업체직송

신선식품의 경우 일반 배송이 아닌 신선냉동 유형을 선택해야 합니다.

Parameter Name	Status
SEQUENCIAL	정상 배송 (순차배송)
COLD_FRESH	신선냉동
MAKE_ORDER	주문제작
AGENT_BUY	구매대행
VENDOR_DIRECT	설치배송 또는 업체직송

deliveryCompanyCode*

marketplaceShippingAndReturnInfo.deliveryCompanyCode

string

택배사 코드
택배사 코드 링크

deliveryChargeType*

marketplaceShippingAndReturnInfo.deliveryChargeType

string

배송비 유형

Parameter Name	Status
FREE	무료배송
NOT_FREE	유료배송
CHARGE_RECEIVED	착불배송
CONDITIONAL_FREE	조건부 무료배송

● 무료배송 설정 시:
초도반품배송비(편도)[deliveryChargeOnReturn]와, 반품배송비(편도)[returnCharge] 금액 설정
● 유료배송 설정 시
기본배송비[deliveryCharge]와 반품배송비(편도) 금액 설정
● 조건부 무료배송 설정 시
기본배송비와 반품배송비(편도) 금액 설정
●착불배송 설정 시
착불배송 가능 카테고리는 따로 정리되어 있으며, 판매자 안내를 위해 판매자콜센터에 공유가 되었습니다.
※ [CONDITIONAL_FREE] 사용 시, 원하는 조건부 무료배송 금액을 별도로 설정할 수 있습니다.

Parameter Name	Status
FREE	무료배송
NOT_FREE	유료배송
CHARGE_RECEIVED	착불배송
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 Name	Status
Y	도서산간 배송
N	도서산간 배송안함

Parameter Name	Status
Y	도서산간 배송
N	도서산간 배송안함

unionDeliveryType*

marketplaceShippingAndReturnInfo.unionDeliveryType

string

묶음 배송여부

Parameter Name	Status
UNION_DELIVERY	묶음 배송 가능
NOT_UNION_DELIVERY	묶음 배송 불가능

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

Parameter Name	Status
UNION_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 아이디)
업체(Vendor)에 소속된 사용자아이디

requested*

boolean

자동승인요청여부
상품 등록 시, 자동으로 판매승인요청을 진행할지 여부 선택
● false : 작성 내용만 저장. (판매를 원할 시에는 상품 승인요청 API 또는 wing에서 판매요청을 진행 해야 함)
● true : 저장 및 자동으로 판매 승인 요청

items*

object[]

업체상품옵션목록

itemName*

items[].itemName

string

업체상품옵션아이디
상품 등록 후, 각 옵션에 따라 부여 된 아이디. 상품 조회 API를 통해 확인 가능
기존 옵션 수정시 필수이며, 새로운 옵션 추가 시에는 null로 입력

maximumBuyForPerson*

items[].maximumBuyForPerson

number

인당 최대 구매 수량
1인당 최대 구매 가능한 수량.
제한이 없을 경우 ‘0’을 입력
(예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미)

maximumBuyForPersonPeriod*

items[].maximumBuyForPersonPeriod

number

최대 구매 수량 기간
1인당 해당 상품을 구매할 수 있는 주기 설정.
제한이 없을 경우 ‘1’을 입력
(예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미)

outboundShippingTimeDay*

items[].outboundShippingTimeDay

number

기준출고일(일)
주문일(D-Day) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (다음날(D+1) 출고일 경우 '1' 입력)

unitCount*

items[].unitCount

number

19세이상

Parameter Name	Status
ADULT_ONLY	19세이상 구입 가능 상품
EVERYONE	전연령 구입 가능 상품

adultOnly*

items[].adultOnly

string

과세여부

Parameter Name	Status
TAX	과세
FREE	비과세

taxType*

items[].taxType

string

병행수입여부

Parameter Name	Status
PARALLEL_IMPORTED	병행수입
NOT_PARALLEL_IMPORTED	병행수입 아님

parallelImported*

items[].parallelImported

string

해외구매대행여부

Parameter Name	Status
OVERSEAS_PURCHASED	구매대행
NOT_OVERSEAS_PURCHASED	구매대행 아님

overseasPurchased*

items[].overseasPurchased

string

PCC(개인통관부호) 필수/비필수 여부
해외구매대행 상품인 경우, 상품 PCC(개인통관번호)는 반드시 true로 입력해야 함

기본값 : 비필수(false)

true	고객이 PCC 입력 후 구매 가능 (PCC는 발주서에 포함 됨)
false	고객이 PCC를 입력하지 않고 상품 구매 가능

pccNeeded*

items[].pccNeeded

boolean

판매자상품코드 (업체상품코드)
업체고유의 item 코드값을 임의로 세팅할 수 있으며, 입력값은 발주서 조회 API response 에 포함됨.

Parameter Name	Status
true	고객이 PCC 입력 후 구매 가능 (PCC는 발주서에 포함 됨)
false	고객이 PCC를 입력하지 않고 상품 구매 가능

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 경로 중 하나 이상 필수 입력 필요

vendorPath: 업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨
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)의 모든 값이 중복될 경우 등록 불가
한개 이상 필수 등록이며, 입력을 원하지 않는 속성은 attributes 목록에서 제거 또는 attributeValueName을 ""로 입력하여 전송

attributeTypeName*

items[].attributes[].attributeTypeName

string

옵션타입명
카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 다운로드 엑셀 파일을 통해, 카테고리에 맞는 옵션타입명 확인 및 선택 가능
최대 길이 25자 제한

attributeValueName*

items[].attributes[].attributeValueName

string

옵션값
옵션타입명[attributeTypeName]에 해당하는 Value를 단위와 함께 입력 (예시 : "200ml")
최대 길이 30자 제한

contents*

items[].contents

object[]

컨텐츠목록
필요한 만큼 반복 입력 가능

contentsType*

items[].contents[].contentsType

string

컨텐츠타입

Parameter Name	Status
IMAGE	이미지
IMAGE_NO_SPACE	이미지(공백없음)
TEXT	텍스트
IMAGE_TEXT	이미지-텍스트
TEXT_IMAGE	텍스트-이미지
IMAGE_IMAGE	이미지-이미지
TEXT_TEXT	텍스트-텍스트
TITLE	제목
HTML	HTML

contentDetails*

items[].contents[].contentDetails

object[]

상세컨텐츠목록

content*

items[].contents[].contentDetails[].content

string

내용

detailType*

items[].contents[].contentDetails[].detailType

string

세부타입

Parameter Name	Status
IMAGE	이미지
TEXT	텍스트

offerCondition

items[].offerCondition

string

상품상태
상품 생성 후에는 offerCondition 변경 불가능

offerDescription

items[].offerDescription

string

중고상품 상세설명
중고상품 상태를 설명, 700자 제한
offerCondition을 중고로 입력한 경우에만 작성

rocketGrowthItemData

items[].rocketGrowthItemData

object

sellerProductItemId*

items[].rocketGrowthItemData.sellerProductItemId

number

업체상품 옵션 아이디(벤더아이템 옵션 ID)

vendorItemId*

items[].rocketGrowthItemData.vendorItemId

number

옵션ID
임시저장 상태일 경우 값이 null 입니다. 상품 승인완료 시에 값이 표시됩니다.

barcode

items[].rocketGrowthItemData.barcode

string

바코드
상품에 부착된 유효한 표준상품 코드

바코드 수정은 입고가 생성되지 않은 경우에만 수정 가능합니다. 입고가 생성된 경우 바코드 정보를 수정할 수 없습니다.

emptyBarcodeReason

items[].rocketGrowthItemData.emptyBarcodeReason

string

바코드 없음에 대한 사유
최대 길이: 100자 제한

emptyBarcode

items[].rocketGrowthItemData.emptyBarcode

boolean

바코드 없음
바코드가 없으면 true

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를 제공하려면, "additionalInformationForRocketGrowth" > "rfmInboundName" 항목은 필수 정보입니다. skuInfo에 값이 있는데 "rfmInboundName"이 없는 경우 오류가 발생합니다.

skuInfo

items[].rocketGrowthItemData.skuInfo

object

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

마켓플레이스에 이미 등록된 기존 상품에 로켓그로스 상품을 추가하는 경우, 아래 필드에 상품, 벤더아이템 ID를 포함한 모든 정보를 제공해야 합니다.

sellerProductItemId*

items[].marketplaceItemData.sellerProductItemId

number

업체상품 옵션 아이디(벤더아이템 옵션 ID)

vendorItemId*

items[].marketplaceItemData.vendorItemId

number

옵션ID
임시저장 상태일 경우 값이 null 입니다. 상품 승인완료 시에 값이 표시됩니다.

externalVendorSku

items[].marketplaceItemData.externalVendorSku

string

판매자 상품코드(업체 SKU 코드)
업체 고유의 아이템 코드 값을 임의로 설정 가능. 입력값은 발주서(PO) 조회 API response 에 포함됨.

maximumBuyCount

items[].marketplaceItemData.maximumBuyCount

number

판매가능수량

판매가능한 재고수량.
상품 수정 API를 통한 판매수량 수정은 상품 승인 요청 전에만 가능

승인완료 이후 재고 수정은 [상품 아이템별 수량 변경] API를 통해 변경 가능

modelNo

items[].marketplaceItemData.modelNo

string

모델번호
판매하는 제품의 모델명

emptyBarcode

items[].marketplaceItemData.emptyBarcode

boolean

바코드
상품에 부착 된 유효한 표준상품 코드

barcode

items[].marketplaceItemData.barcode

string

바코드 없음
바코드가 없으면 true

emptyBarcodeReason

items[].marketplaceItemData.emptyBarcodeReason

string

바코드 없음에 대한 사유
최대 길이 : 100자 제한

priceData*

items[].marketplaceItemData.priceData

object

originalPrice*

items[].marketplaceItemData.priceData.originalPrice

number

할인율기준가
할인율(%)표시를 위한 할인전 금액, 판매가격과 동일하게 입력시 '쿠팡가'(saleprice)로 노출.
승인완료 이후 할인율기준가 수정은 [상품 아이템별 할인율 기준가격 변경] API를 통해 변경 가능

salePrice*

items[].marketplaceItemData.priceData.salePrice

number

판매가격
상품 수정 API를 통한 판매가격 수정은 상품 승인 요청 전에만 가능
승인완료 이후 판매가격 수정은 [상품 아이템별 가격 변경] API를 통해 변경 가능

requiredDocuments

object[]

구비 서류 필수인 경우 입력

templateName

requiredDocuments[].templateName

string

구비서류템플릿명

documentPath

requiredDocuments[].documentPath

string

구비서류 쿠팡CDN경로
documentPath 와 vendorDocumentPath 중 하나 필수
최대 길이 : 150자

vendorDocumentPath

requiredDocuments[].vendorDocumentPath

string

구비서류벤더경로
구비서류 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨. documentPath 와 vendorDocumentPath 중 하나 필수
최대 길이 : 150자

extraInfoMessage

string

주문제작 안내 메시지
배송 방법을 '주문제작'으로 선택했을 경우, 고객에게 안내할 메시지를 입력

manufacture

string

제조사
정확한 제조사를 기입할 수 없는 경우, [brand] 항목과 동일하게 입력 가능

additionalInformationForRocketGrowth*

object

rfmInboundName

additionalInformationForRocketGrowth.rfmInboundName

string

입고 정보의 일부인 로켓그로스 물류 정보 이름.

legalAgreement*

additionalInformationForRocketGrowth.legalAgreement

string

로켓그로스 상품 취급과 관련한 로켓그로스 계약. 본 키의 값이 "AGREE"가 아닌 다른 값인 경우 아무런 조치가 취해지지 않습니다.

# 04

응답 본문

응답 메시지

Name	Type	Description
code	string	결과코드 SUCCES/ERROR
message	string	메세지
data	object	업체상품아이디 생성된 업체상품아이디
code data.code	string
message data.message	string
data data.data	integer

Response Example

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

# 05

에러 코드

HTTP	코드	메시지
--