/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsv1商品修改 (Rocket Growth 与 Rocket Growth/Marketplace 同步运营产品)
简介
API 支持的买家用户地区：韩国 修改卖家商品信息。 使用 “ 商品查询 API”， 修改 JSON 文本中您所需的值，然后 发送整个 JSON 文本 进行修改。 如果您使用现有的商城产品修改API，您可以使用相同的端点编辑Rocket Growth的Rocket Growth产品或Rocket Growth与Marketplace同步操作的产品，但必须使用本文档中的新架构。现有产品修改API中新增/变更的参数可参考 绿色 文字。当向现有市场产品添加 Rocket Growth 产品时，您可以使用产品修改 API 通过输入与 Rocket Growth 产品相关的参数值来添加产品。
详细内容
API支持的买家用户地区：韩国
修改卖家商品信息。
使用“商品查询API”，修改JSON文本中您所需的值，然后发送整个 JSON文本进行修改。
您可在创建商品时使用的request body中插入[sellerProductId]和 [sellerProductItemId]进行修改。
- 更新/修改属性：请在想要修改的属性商品上方插入[sellerProductItemId]和[vendorItemId]，将其修改为想要的[attributeValueName]并发送
- 删除属性： 请删除您想要移除的属性“商品子数值”，然后在想保留的商品上方插入 [sellerProductItemId]并发送（商品有“已批准”记录时，无法删除）
- 添加属性：通过添加商品数组发送，无需输入 [sellerProductItemId]
※ 您可通过“商品查询API”查询 [sellerProductItemId]。
※已完成审批的商品售价、库存数量、销售状态、折扣率基准价可通过[修改各商品数量/价格/在售与否/折扣率基准价]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 商品创建完成时会显示注册商品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 |
仅可修改Marketplace商品的配送和退货信息。 |
|||||||||||||||||||||||||
| deliveryMethod | O | String |
配送方式
|
|||||||||||||||||||||||
| deliveryCompanyCode | O | String |
物流公司代码 |
|||||||||||||||||||||||
| deliveryChargeType | O | String |
配送费类型
设置基本运费[deliveryCharge]及退货运费金额(单程) 设置基本运费及退货运费金额(单程) 我们已单独列出了符合运费到付条件的品类，并通过酷澎卖家客服中心分享，以指导卖家。 ※ 使用[CONDITIONAL_FREE]时，您可单独设置想要的指定条件包邮值。 |
|||||||||||||||||||||||
| deliveryCharge | O | Number |
基本运费 若为付费配送或指定条件包邮，请输入单程运费值。 |
|||||||||||||||||||||||
| freeShipOverAmount | O | Number |
免运费门槛 ※ 若为免费配送，请输入0 |
|||||||||||||||||||||||
| deliveryChargeOnReturn | O | Number |
初始退货运费 若为免费配送，则由顾客支付退货运费 |
|||||||||||||||||||||||
| remoteAreaDeliverable | O | String |
偏远地区配送与否
|
|||||||||||||||||||||||
| unionDeliveryType | O | String |
捆绑配送与否
※ 捆绑配送条件 必须输入发货地信息（只有发货地信息相同的商品才能捆绑配送） 不可设置“不可运费到付” |
|||||||||||||||||||||||
| returnCenterCode | O | String |
退货中心代码 创建退货地后，输入显示的退货中心代码 ※ 自动退货链接服务（Goodsflow）仅适用于签约物流公司，且必须输入退货中心代码。 |
|||||||||||||||||||||||
| returnChargeName | O | String |
退货地名称 在酷澎Wing中查看或通过“退货地查询API”注册退货地。 “查询退货地时，输入shippingPlaceName的显示值” |
|||||||||||||||||||||||
| companyContactNumber | O | String |
退货地联系方式 在酷澎Wing中查看或通过“退货地查询API”注册退货地。 |
|||||||||||||||||||||||
| returnZipCode | O | String |
退货地邮政编码 在酷澎Wing中查看或通过“退货地查询API”注册退货地。 |
|||||||||||||||||||||||
| returnAddress | O | String |
退货地址 在酷澎Wing中查看或通过“退货地查询API”注册退货地。 |
|||||||||||||||||||||||
| returnAddressDetail | O | String |
退货地详细地址 在酷澎Wing中查看或通过“退货地查询API”注册退货地。 |
|||||||||||||||||||||||
| returnCharge | O | Number |
退货运费 回收退货商品时的单程运费 *所输入的数值须为初始退货运费的100%～150%。 |
|||||||||||||||||||||||
| outboundShippingPlaceCode | O | Number |
发货地代码 选择捆绑配送时必填。可通过“发货地查询API”进行查询 选择海外代购（AGENT_BUY）时，只能输入海外地址。 |
|||||||||||||||||||||||
| vendorUserId | O | String |
真实用户ID(酷澎WING ID) 属于卖家（Vendor）的用户ID |
|||||||||||||||||||||||
| requested | O | Boolean |
是否自动申请批准
注册商品时，选择是否自动申请批准
● false : 只保存已填写的内容。 （如果您想要销售商品，请通过“商品批准申请API”或WING进行申请） ● true : 保存并自动申请批准销售 |
|||||||||||||||||||||||
| items | O | List |
卖家商品属性列表
|
|||||||||||||||||||||||
| itemName | O | String |
卖家商品属性名 输入各属性名，并保证每个商品不重复 此属性名不显示在网站上，可能会随购买属性而发生变化 最大长度：150个字符 |
|||||||||||||||||||||||
| maximumBuyForPerson | O | Number |
人均最多可购买数量 每人最多可购买的数量。 如果没有限制，请输入“0” （例如：如果输入的人均最多可购买数量为 100，最长购买期限为 3。那么这意味着，一个人在3天内最多可购买 100 件） |
|||||||||||||||||||||||
| maximumBuyForPersonPeriod | O | Number |
最长购买期限 某个时间段内每人可以购买的最大数量 。 如果没有限制，请输入“1” （例如：如果人均最多可购买数量为 100，最长购买期限为 3。那么这意味着，一个人在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