PUT
/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsv1상품 수정 (로켓그로스 또는 마켓플레이스/로켓그로스 동시 운영 상품)
# 01
요약
API 적용 가능한 구매자 사용자 지역 : 한국 업체상품 정보를 수정합니다. '상품 조회 API'를 이용하여 조회된 JSON 전문에서 원하는 값 만 수정 후, 전체 JSON 전문을 전송 하여 수정이 가능합니다. 이 API를 사용하면 승인 후에 반영됩니다. 기 마켓플레이스 상품수정 API를 사용하시는 경우, 동일 Endpoint를 사용하여 로켓그로스 로켓그로스 상품 또는 로켓그로스 & 마켓플레이스 동시 운영 상품에 대한 수정이 가능하지만, 본 문서에 있는 신규 schema를 활용하셔야 합니다.
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국
업체상품 정보를 수정합니다.
'상품 조회 API'를 이용하여 조회된 JSON 전문에서 원하는 값 만 수정 후, 전체 JSON 전문을 전송하여 수정이 가능합니다.
'상품 조회 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
Example Endpoint
PUT https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
Request Parameters
Body Parameter
| Name | Required | Type | Description | |||||||||||||||||||||||
| sellerProductId | O | Number |
등록상품ID
상품 생성 완료 시, 출력 된 등록상품 아이디 (data)
|
|||||||||||||||||||||||
| displayCategoryCode | O | Number |
노출카테고리코드
상품 등록 후, 셀러의 직접 변경 불가
|
|||||||||||||||||||||||
| sellerProductName | O | String |
등록상품명
발주서에 사용되는 상품명
최대 길이 : 100 자
|
|||||||||||||||||||||||
| vendorId | O | String |
판매자ID
쿠팡에서 업체에게 발급한 고유 코드
|
|||||||||||||||||||||||
| saleStartedAt | O | String |
판매시작일시
"yyyy-MM-dd'T'HH:mm:ss" 형식
|
|||||||||||||||||||||||
| saleEndedAt | O | 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 |
배송 및 반품 정보는 마켓플레이스 아이템에 대해서만 수정할 수 있습니다. |
|||||||||||||||||||||||||
| 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 아이디)
업체(Vendor)에 소속된 사용자아이디
|
|||||||||||||||||||||||
| requested | O | Boolean |
자동승인요청여부
상품 등록 시, 자동으로 판매승인요청을 진행할지 여부 선택
● false : 작성 내용만 저장. (판매를 원할 시에는 상품 승인요청 API 또는 wing에서 판매요청을 진행 해야 함) ● true : 저장 및 자동으로 판매 승인 요청 |
|||||||||||||||||||||||
| items | O | List |
업체상품옵션목록
|
|||||||||||||||||||||||
| itemName | O | String |
업체상품옵션아이디
상품 등록 후, 각 옵션에 따라 부여 된 아이디. 상품 조회 API를 통해 확인 가능
기존 옵션 수정시 필수이며, 새로운 옵션 추가 시에는 null로 입력
|
|||||||||||||||||||||||
| maximumBuyForPerson | O | Number |
인당 최대 구매 수량
1인당 최대 구매 가능한 수량.
제한이 없을 경우 ‘0’을 입력 (예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미) |
|||||||||||||||||||||||
| maximumBuyForPersonPeriod | O | Number |
최대 구매 수량 기간
1인당 해당 상품을 구매할 수 있는 주기 설정.
제한이 없을 경우 ‘1’을 입력 (예: 인당 최대 구매 수량 100, 최대 구매 수량 기간 3 입력 시, 1인당 3일 동안 최대 100개까지 구매 가능함을 의미) |
|||||||||||||||||||||||
| outboundShippingTimeDay | O | Number |
기준출고일(일)
주문일(D-Day) 이후 배송을 위한 출고예정일자를 '일' 단위로 입력. (다음날(D+1) 출고일 경우 '1' 입력)
|
|||||||||||||||||||||||
| unitCount | O | Number |
19세이상
|
|||||||||||||||||||||||
| adultOnly | O | String |
과세여부
|
|||||||||||||||||||||||
| taxType | O | String |
병행수입여부
|
|||||||||||||||||||||||
| parallelImported | O | String |
해외구매대행여부
|
|||||||||||||||||||||||
| overseasPurchased | O | String |
PCC(개인통관부호) 필수/비필수 여부
해외구매대행 상품인 경우, 상품 PCC(개인통관번호)는 반드시 true로 입력해야 함
- 기본값 : 비필수(false)
|
|||||||||||||||||||||||
| pccNeeded | O | Boolean |
판매자상품코드 (업체상품코드)
업체고유의 item 코드값을 임의로 세팅할 수 있으며, 입력값은 발주서 조회 API response 에 포함됨.
|
|||||||||||||||||||||||
| extraProperties |
업체상품옵션추가정보
Key : Value 형태로 필요한 만큼 반복입력가능
|
|||||||||||||||||||||||||
| Key | String |
Value
|
||||||||||||||||||||||||
| certifications | List |
상품인증정보
상품 인증 정보
|
||||||||||||||||||||||||
| certificationType | String |
인증정보Type
카테고리 메타정보 조회 API를 통해 등록가능한 Type을 구할 수 있다.
인증대상이 아닌 카테고리일 경우 : NOT_REQUIRED |
||||||||||||||||||||||||
| certificationCode | String |
상품인증정보코드
인증기관에서 발급받은 코드
|
||||||||||||||||||||||||
| certificationAttachments | List<Map<String,String>> |
인증정보 첨부파일
이동통신사전승낙서 및 인증대리점 인증서 등록 시 사용함
1.이동통신 사전승낙서 또는 인증대리점 인증서 2.판매점 사전승낙 인증마크 또는 이동통신사 대리점 인증마크 아래 업체이미지 경로 또는 쿠팡CDN 경로 중 하나 이상 필수 입력 필요
1. vendorPath: 업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨 2. cdnPath: 쿠팡 CDN 서버에 올린 경우 직접 입력 Example: |
||||||||||||||||||||||||
| searchTags | List |
검색어
필요한 만큼 반복입력가능. ["검색어1","검색어2"]
1개의 검색어 당 20자 이내로, 최대 20개의 검색어를 입력가능, !@#$%^&*-+;:’. 외의 특수문자는 입력불가
|
||||||||||||||||||||||||
| images | O | List |
이미지목록
필요한 만큼 반복 입력 가능
|
|||||||||||||||||||||||
| imageOrder | O | Number |
이미지표시순서
0,1,2...
|
|||||||||||||||||||||||
| imageType | O | String |
이미지타입
대표이미지 타입
3MB 이하의 정사각형 이미지를 JPG, PNG로 등록 가능 (최소 500 x 500px, 최대 5000 x 5000px) ● 필수 REPRESENTATION : 정사각형 대표이미지 ● 선택 DETAIL : 기타이미지 (최대 9개까지 등록 가능) USED_PRODUCT : 중고상태 이미지 (최대 4개까지 등록 가능) |
|||||||||||||||||||||||
| cdnPath | O | String |
쿠팡CDN경로
쿠팡 CDN 에 올린 경우 직접 입력, vendorPath와 cdnPath 중 하나 이상 필수
최대길이 : 200 자
|
|||||||||||||||||||||||
| vendorPath | O | String |
업체이미지경로
업체에서 사용하는 이미지 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨, vendorPath와 cdnPath 중 하나 이상 필수
80, 443 Port 이미지 경로만 사용가능
최대길이 : 200 자
|
|||||||||||||||||||||||
| notices | List |
상품고시정보 목록
카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능
|
||||||||||||||||||||||||
| noticeCategoryName | String |
상품고시정보카테고리명
카테고리별 입력 가능한 상품고시정보 카테고리 중 하나를 입력
카테고리 메타 정보 조회 API 또는 전체 카테고리 정보 Excel file을 통해, 필요한 고시정보 항목의 확인 및 선택 가능 |
||||||||||||||||||||||||
| noticeCategoryDetailName | String |
상품고시정보카테고리상세명
|
||||||||||||||||||||||||
| content | String |
내용
|
||||||||||||||||||||||||
| attributes | O | List |
옵션목록(속성)
카테고리 기준으로 정해진 옵션 목록을 입력하는 객체
등록하기 원하는 구매옵션 개수 만큼 반복 입력 가능 구매옵션(attribute exposed)의 모든 값이 중복될 경우 등록 불가
한개 이상 필수 등록이며, 입력을 원하지 않는 속성은 attributes 목록에서 제거 또는 attributeValueName을 ""로 입력하여 전송 |
|||||||||||||||||||||||
| attributeTypeName | O | String |
옵션타입명
카테고리 메타 정보 조회 API 또는 전체카테고리 리스트 다운로드 엑셀 파일을 통해, 카테고리에 맞는 옵션타입명 확인 및 선택 가능
최대 길이 25자 제한
|
|||||||||||||||||||||||
| attributeValueName | O | String |
옵션값
옵션타입명[attributeTypeName]에 해당하는 Value를 단위와 함께 입력 (예시 : "200ml")
최대 길이 30자 제한
|
|||||||||||||||||||||||
| contents | O | List |
컨텐츠목록
필요한 만큼 반복 입력 가능
|
|||||||||||||||||||||||
| contentsType | O | String |
컨텐츠타입
|
|||||||||||||||||||||||
| contentDetails | O | List |
상세컨텐츠목록
|
|||||||||||||||||||||||
| content | O | String |
내용
|
|||||||||||||||||||||||
| detailType | O | String |
세부타입
|
|||||||||||||||||||||||
| offerCondition | String |
상품상태
상품 생성 후에는 offerCondition 변경 불가능
|
||||||||||||||||||||||||
| offerDescription | String |
중고상품 상세설명
중고상품 상태를 설명, 700자 제한
offerCondition을 중고로 입력한 경우에만 작성 |
||||||||||||||||||||||||
| rocketGrowthItemData |
|
|||||||||||||||||||||||||
| sellerProductItemId | O | Number |
업체상품 옵션 아이디(벤더아이템 옵션 ID) |
|||||||||||||||||||||||
| vendorItemId | O | Number |
옵션ID |
|||||||||||||||||||||||
| barcode | String |
바코드 바코드 수정은 입고가 생성되지 않은 경우에만 수정 가능합니다. 입고가 생성된 경우 바코드 정보를 수정할 수 없습니다. |
||||||||||||||||||||||||
| emptyBarcodeReason | String |
바코드 없음에 대한 사유 |
||||||||||||||||||||||||
| emptyBarcode | Boolean |
바코드 없음 |
||||||||||||||||||||||||
| externalVendorSku | String | |||||||||||||||||||||||||
| modelNo | String |
모델 번호 null값으로 제공 가능 |
||||||||||||||||||||||||
| priceData | O |
할인율기준가 (정가표시) 할인율(%)표시를 위한 할인전 금액. 판매가격과 동일하게 입력시 '쿠팡가'로 노출. 승인완료 이후 할인율기준가 수정은 [옵션별 할인율기준가 변경] API를 통해 변경가능 |
||||||||||||||||||||||||
| originalPrice | O | Number |
판매가격 판매가격을 입력. '최초' 상품 등록시 판매가격은 상품 승인 요청 전에만 입력 가능. 승인완료 이후 판매가격 수정은 [옵션별 가격 변경] API를 통해 변경가능 |
|||||||||||||||||||||||
| 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입니다. | ||||||||||||||||||||||||
| length | Number | 기본 길이 단위는 mm입니다. | ||||||||||||||||||||||||
| height | Number | 기본 높이 단위는 mm입니다. | ||||||||||||||||||||||||
| quantityPerBox | Number | 기본 높이 단위는 mm입니다. 로켓그로스는 quantityPerBox(입수량)이 항상 1이어야 합니다. | ||||||||||||||||||||||||
| distributionPeriod | Number | 유통기한 - 상품을 소비해야 하는 기한. 해당 필드는 카테고리 메타정보 조회 API에 따라 "isExpirationDateRequiredForRocketGrowth = true"인 카테고리에 필수 항목입니다. | ||||||||||||||||||||||||
| expiredAtManaged | Boolean |
distributionPeriod이 0보다 크면 True distributionPeriod=0 이면 false |
||||||||||||||||||||||||
| marketplaceItemData |
마켓플레이스에 이미 등록된 기존 상품에 로켓그로스 상품을 추가하는 경우, 아래 필드에 상품, 벤더아이템 ID를 포함한 모든 정보를 제공해야 합니다. |
|||||||||||||||||||||||||
| sellerProductItemId | O | Number |
업체상품 옵션 아이디(벤더아이템 옵션 ID) |
|||||||||||||||||||||||
| vendorItemId | O | Number |
옵션ID |
|||||||||||||||||||||||
| externalVendorSku | String |
판매자 상품코드(업체 SKU 코드) |
||||||||||||||||||||||||
| maximumBuyCount | Number |
판매가능수량
판매가능한 재고수량.
상품 수정 API를 통한 판매수량 수정은 상품 승인 요청 전에만 가능 승인완료 이후 재고 수정은 [상품 아이템별 수량 변경] API를 통해 변경 가능
|
||||||||||||||||||||||||
| modelNo | String |
모델번호
판매하는 제품의 모델명
|
||||||||||||||||||||||||
| emptyBarcode | Boolean |
바코드
상품에 부착 된 유효한 표준상품 코드
|
||||||||||||||||||||||||
| barcode | String |
바코드 없음
바코드가 없으면 true
|
||||||||||||||||||||||||
| emptyBarcodeReason | String |
바코드 없음에 대한 사유
최대 길이 : 100자 제한
|
||||||||||||||||||||||||
| priceData | O | |||||||||||||||||||||||||
| originalPrice | O | Number |
할인율기준가
할인율(%)표시를 위한 할인전 금액, 판매가격과 동일하게 입력시 '쿠팡가'(saleprice)로 노출.
승인완료 이후 할인율기준가 수정은 [상품 아이템별 할인율 기준가격 변경] API를 통해 변경 가능
|
|||||||||||||||||||||||
| salePrice | O | Number |
판매가격
상품 수정 API를 통한 판매가격 수정은 상품 승인 요청 전에만 가능
승인완료 이후 판매가격 수정은 [상품 아이템별 가격 변경] API를 통해 변경 가능
|
|||||||||||||||||||||||
| requiredDocuments | List |
구비 서류 필수인 경우 입력
|
||||||||||||||||||||||||
| templateName | String |
구비서류템플릿명
|
||||||||||||||||||||||||
| documentPath | String |
구비서류 쿠팡CDN경로
documentPath 와 vendorDocumentPath 중 하나 필수
최대 길이 : 150자 |
||||||||||||||||||||||||
| vendorDocumentPath | String |
구비서류벤더경로
구비서류 경로, http://로 시작하는 경로일 경우 자동 다운로드하여 쿠팡 CDN에 추가됨. documentPath 와 vendorDocumentPath 중 하나 필수
최대 길이 : 150자 |
||||||||||||||||||||||||
| extraInfoMessage | String |
주문제작 안내 메시지
배송 방법을 '주문제작'으로 선택했을 경우, 고객에게 안내할 메시지를 입력
|
||||||||||||||||||||||||
| manufacture | String |
제조사
정확한 제조사를 기입할 수 없는 경우, [brand] 항목과 동일하게 입력 가능
|
||||||||||||||||||||||||
| additionalInformationForRocketGrowth | O | |||||||||||||||||||||||||
| rfmInboundName |
String |
입고 정보의 일부인 로켓그로스 물류 정보 이름. |
||||||||||||||||||||||||
| legalAgreement | O | String |
로켓그로스 상품 취급과 관련한 로켓그로스 계약. 본 키의 값이 "AGREE"가 아닌 다른 값인 경우 아무런 조치가 취해지지 않습니다. |
|||||||||||||||||||||||
Request Example
Rocket Growth 상품
{
"sellerProductId": 30100306501,
"sellerProductName": "test openapi rg only May8th",
"displayCategoryCode": 69515,
"vendorId": "A00013264",
"saleStartedAt": "2024-05-06T14:49:12",
"saleEndedAt": "2099-12-29T14:00:00",
"displayProductName": "test openapi rg only May8th",
"brand": "brandname",
"generalProductName": "test openapi rg only May8th",
"marketplaceShippingAndReturnInfo": null,
"vendorUserId": "et5rod_sat",
"requested": true,
"items": [
{
"offerCondition": "NEW",
"offerDescription": "",
"itemName": "s",
"maximumBuyForPerson": 0,
"outboundShippingTimeDay": 1,
"maximumBuyForPersonPeriod": 1,
"unitCount": 1,
"adultOnly": "EVERYONE",
"taxType": "TAX",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"pccNeeded": false,
"images": [
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"cdnPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg",
"vendorPath": "3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"
}
],
"notices": [
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "first"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증사항",
"content": "second"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "third"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "fourth"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "fifth"
}
],
"attributes": [
{
"attributeTypeName": "패션의류/잡화 사이즈",
"attributeValueName": "s",
"exposed": "EXPOSED",
"editable": true
}
],
"contents": [
{
"contentsType": "HTML",
"contentDetails": [
{
"content": "<p>asdf</p>",
"detailType": "TEXT"
}
]
}
],
"certifications": [
{
"certificationType": "NOT_REQUIRED",
"certificationCode": "",
"certificationAttachments": null
}
],
"searchTags": [
"tag1",
"tag2"
],
"rocketGrowthItemData": {
"sellerProductItemId": 30100598574,
"vendorItemId": 72300263641,
"externalVendorSku": "DUMMY_EXT_SKU_1"
"modelNo": "DUMMY_MODEL_NO_1",
"skuInfo": {
"fragile": false,
"year": null,
"season": null,
"height": 141,
"length": 365,
"width": 341,
"weight": 1042,
"producedAtManaged": false,
"quantityPerBox": 1,
"standAlone": null,
"distributionPeriod": 400,
"expiredAtManaged": true,
"manufacturedAtManaged": false,
"netWeight": 937,
"heatSensitive": null,
"hazardous": null,
"originalBarcode": null
},
"priceData": {
"originalPrice": 0,
"salePrice": 900000000
},
"barcode": "DEFG1231456811"
},
"marketplaceItemData": null,
"outboundShippingTime": 24
},
{
"offerCondition": "NEW",
"offerDescription": "",
"itemName": "m",
"maximumBuyForPerson": 0,
"outboundShippingTimeDay": 1,
"maximumBuyForPersonPeriod": 1,
"unitCount": 1,
"adultOnly": "EVERYONE",
"taxType": "TAX",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"pccNeeded": false,
"images": [
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"cdnPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg",
"vendorPath": "3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"
}
],
"notices": [
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "first"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증사항",
"content": "second"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "third"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "fourth"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "fifth"
}
],
"attributes": [
{
"attributeTypeName": "패션의류/잡화 사이즈",
"attributeValueName": "m",
"exposed": "EXPOSED",
"editable": true
}
],
"contents": [
{
"contentsType": "HTML",
"contentDetails": [
{
"content": "<p>asdf</p>",
"detailType": "TEXT"
}
]
}
],
"certifications": [
{
"certificationType": "NOT_REQUIRED",
"certificationCode": "",
"certificationAttachments": null
}
],
"searchTags": [
"tag1",
"tag2"
],
"rocketGrowthItemData": {
"sellerProductItemId": 30100598575,
"vendorItemId": 72300263640,
"externalVendorSku": "DUMMY_EXT_SKU_2"
"modelNo": "DUMMY_MODEL_NO_2",
"skuInfo": {
"fragile": false,
"year": null,
"season": null,
"height": 141,
"length": 365,
"width": 341,
"weight": 1042,
"producedAtManaged": false,
"quantityPerBox": 1,
"standAlone": null,
"distributionPeriod": 400,
"expiredAtManaged": true,
"manufacturedAtManaged": false,
"netWeight": 937,
"heatSensitive": null,
"hazardous": null,
"originalBarcode": null
},
"priceData": {
"originalPrice": 0,
"salePrice": 900000000
},
"barcode": "ABCD2314678181"
},
"marketplaceItemData": null,
"outboundShippingTime": 24
}
],
"requiredDocuments": [
{
"templateName": "기타인증서류",
"documentPath": "vendor_inventory/documents/2024/04/25/5/6/8116774a-896c-4482-a6a3-6f6c4329eccb.png",
"vendorDocumentPath": "8116774a-896c-4482-a6a3-6f6c4329eccb.png",
"issueDate": ""
}
],
"extraInfoMessage": null,
"manufacture": "sadf",
"registrationType": "RFM",
"rocketGrowthAdditionalInformation": {
"rfmInboundName": "test product",
"legalAgreement": "AGREE"
}
}
Rocket Growth/Marketplace 동시 운영 상품
{
"sellerProductId": 30100306335,
"sellerProductName": "test openapi hybrid product update May8th",
"displayCategoryCode": 69515,
"vendorId": "A00013264",
"saleStartedAt": "2024-04-25T05:50:56",
"saleEndedAt": "2099-12-30T07:00:00",
"displayProductName": "test openapi hybrid product update May8th",
"brand": "",
"generalProductName": "test openapi hybrid product update May8th",
"vendorUserId": "et5rod_sat",
"requested": true,
"items": [
{
"offerCondition": "NEW",
"offerDescription": "",
"itemName": "s",
"maximumBuyForPerson": 0,
"outboundShippingTimeDay": 1,
"maximumBuyForPersonPeriod": 1,
"unitCount": 1,
"adultOnly": "EVERYONE",
"taxType": "TAX",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"pccNeeded": false,
"images": [
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"cdnPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg",
"vendorPath": "3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"
}
],
"notices": [
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "first"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증사항",
"content": "second"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "third"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "fourth"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "fifth"
}
],
"attributes": [
{
"attributeTypeName": "패션의류/잡화 사이즈",
"attributeValueName": "s",
"exposed": "EXPOSED",
"editable": true
}
],
"contents": [
{
"contentsType": "HTML",
"contentDetails": [
{
"content": "<p>asdf</p>",
"detailType": "TEXT"
}
]
}
],
"certifications": [
{
"certificationType": "NOT_REQUIRED",
"certificationCode": "",
"certificationAttachments": []
}
],
"searchTags": [
"tag1",
"tag2"
],
"rocketGrowthItemData": {
"sellerProductItemId": 30100598284,
"vendorItemId": 72300263358,
"externalVendorSku": "DUMMY_EXT_SKU_2"
"modelNo": "DUMMY_MODEL_NO_2",
"skuInfo": {
"fragile": false,
"year": null,
"season": null,
"height": 141,
"length": 365,
"width": 341,
"weight": 1042,
"producedAtManaged": false,
"quantityPerBox": 1,
"standAlone": null,
"distributionPeriod": 400,
"expiredAtManaged": true,
"manufacturedAtManaged": false,
"netWeight": 937,
"heatSensitive": null,
"hazardous": null,
"originalBarcode": null
},
"skuId": 900051051,
"priceData": {
"originalPrice": 0,
"salePrice": 910000000
},
"barcode": "S0030100598284"
},
"marketplaceItemData": {
"sellerProductItemId": 30100598283,
"vendorItemId": 72300263357,
"externalVendorSku": "DUMMY_EXT_SKU_1"
"modelNo": "DUMMY_MODEL_NO_1",
"maximumBuyCount": "10,
"priceData": {
"originalPrice": 0,
"salePrice": 920000000
}
},
"outboundShippingTime": 24
}
],
"requiredDocuments": [
{
"templateName": "기타인증서류",
"documentPath": "vendor_inventory/documents/2024/04/25/5/6/8116774a-896c-4482-a6a3-6f6c4329eccb.png",
"vendorDocumentPath": "8116774a-896c-4482-a6a3-6f6c4329eccb.png",
"issueDate": ""
}
],
"extraInfoMessage": null,
"manufacture": "sadf",
"rocketGrowthAdditionalInformation":
{
"rfmInboundName": "test product",
"legalAgreement": "AGREE"
},
"marketplaceShippingAndReturnInfo": {
"deliveryMethod": "SEQUENCIAL",
"deliveryCompanyCode": "HYUNDAI",
"deliveryChargeType": "FREE",
"deliveryCharge": 0,
"freeShipOverAmount": 0,
"deliveryChargeOnReturn": 3000,
"deliverySurcharge": null,
"remoteAreaDeliverable": "Y",
"unionDeliveryType": "UNION_DELIVERY",
"returnCenterCode": "NO_RETURN_CENTERCODE",
"returnChargeName": "지모스(쿠팡)",
"companyContactNumber": "031-297-9758",
"returnZipCode": "18335",
"returnAddress": "경기도 화성시 봉담읍 복만터길72번길 48",
"returnAddressDetail": "나동 202호",
"returnCharge": 3000,
"outboundShippingPlaceCode": 63714
}
}
Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | String |
결과코드
SUCCES/ERROR
|
||||
| message | String |
메세지
|
||||
| data | Long |
업체상품아이디
생성된 업체상품아이디
|
||||
Response Example
{
"code": "200",
"message": "",
"data": {
"code": "SUCCESS",
"message": "",
"data": 427011919
}
}
Error Spec (생성/수정 동일)
| Http Status Code ( error type ) | Error message | 해결 방법 |
| 400 |
등록상품명에 허용하지 않는 특수문자가 존재합니다. 노출상품명에 허용하지 않는 특수문자가 존재합니다. |
displayProductName 및 sellerProductName
영어, 한글, 숫자, 공백 및 아래 특수 문자만 허용합니다.
!@#$%^&*()_+=-][{}';:\"/.,<>?~㈜®|°。× |
| 400 | 중복된 바코드가 존재합니다. |
다른 아이템에 바코드를 중복으로 사용할 수 없습니다. 다른 바코드 또는 자동 생성한 쿠팡 바코드를 입력하세요. |
| 400 | 입고를 생성하신 이후에는 물류(SKU)정보를 변경하실 수 없습니다. | 입고 후에는 SKU 정보 수정이 불가합니다. 필요한 경우 지원팀에 문의하세요. |
| 400 | 누락된 물류정보가 있습니다. 기존 등록된 SKU정보나 변경하실 SKU정보를 입력하여 다시 수정을 요청하세요 |
SKU 정보 필드에 일부 값이 누락되었습니다. 해당 필드에 입력해주세요. 또한 SKU 정보는 삭제할 수 없습니다. |
| 400 | 로켓그로스 검수 기준을 확인하시고 동의해주세요. 동의하지 않으면 로켓그로스 상품등록을 할 수 없습니다. | RocketGrowthAdditionalInformation.legalAgreement는 필수 입력 항목입니다. |
| 400 | 판매중인 상품은 삭제할 수 없습니다. | 아이디(vendorItemId, sellerProductItmeId) 중 일부가 누락되었으니 확인해주세요. |
URL API Name
UPDATE_PRODUCT