该API用于注册在酷澎上销售的商品。
Rocket Growth产品创建时要成功调用API，首先点击WING平台 > 卖家信息菜单 > 附加信息菜单 > 同意，点击“同意Rocket Growth产品创建API使用和检验标准” OPEN API Key Issuance”区域，处理后即可使用。
如果您使用现有的Marketplace产品创建API，您可以使用相同的Endpoint创建Rocket Growth的Rocket Growth产品或Rocket Growth与Marketplace同步操作的产品，但必须使用本文档中新的Schema。现有产品创建API中添加/更改的参数可以参考绿色文字。如果您将 Rocket Growth 产品添加到现有市场产品中，则可以使用产品修改 API 添加它。
创建商品时，发货地/退货地、品类、通知信息、属性信息等需要符合酷澎的标准。
请下载下方商品注册指南，获取更多详细信息。
CGF/CGF Lite 的商品发布，请参考如下链接CGF/CGF Lite商品发布
创建Rocket Growth产品，请参考以下文档：
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 |
显示商品名 实际在酷澎销售页面上显示的商品名 建议输入与[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 |
是否自动申请批准 注册商品时，选择是否自动申请批准
|
|||||||||||||||||||||||
|
items |
O |
List |
卖家商品属性列表 最多可注册200个属性 |
|||||||||||||||||||||||
|
|
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 |
单位数量 输入商品中包含的单位数量。计算方式为（售价 ÷ 单位数量），显示方式为（单个价格 #，000 韩元）。 对于不需要单价的商品，请输入“0”。 |
||||||||||||||||||||||
|
|
adultOnly |
O |
String |
19岁及以上
|
||||||||||||||||||||||
|
|
taxType |
O |
String |
是否需纳税
|
||||||||||||||||||||||
|
|
parallelImported |
O |
String |
是否为平行进口
※ 创建平行进口商品时，应注册进口申报单URL – 注册指南(点击) |
||||||||||||||||||||||
|
|
overseasPurchased |
O |
String |
是否为海外代购
※ 创建代购商品时，应注 |
||||||||||||||||||||||
|
|
pccNeeded |
O |
Boolean |
是否需要PCC(个人通关代码) 海外代购商品需要PCC。 如果是海外代购（AGENT_BUY），产品PCC必须填写为true。 - 默认值: 不需要 (false)
|
||||||||||||||||||||||
|
|
extraProperties |
|
|
卖家商品属性的附加信息 Key : 以值的形态存在。可根据需要多次重复输入。 |
||||||||||||||||||||||
|
|
|
Key |
|
String |
值
|
|||||||||||||||||||||
|
|
certifications |
|
List |
商品认证信息
|
||||||||||||||||||||||
|
|
|
certificationType |
|
String |
认证信息类型 可通过“品类元数据查询API”获取认证信息类型 非认证对象品类：NOT_REQUIRED |
|||||||||||||||||||||
|
|
|
certificationCode |
|
String |
商品认证信息编号 该编号由认证机构颁发 |
|||||||||||||||||||||
|
|
|
certificationAttachments |
|
List<Map<String,String>> |
认证信息附件 认证机构提供的移动设备卖方许可证证书图像； Map 的 key 固定为以下两个，只需要其中一个：
注意: 用于注册手机电子产品类别（displayCategoryCode = 62600, 家电/数码>手机/平板电脑/配件>手机/平板电脑>手机>裸机), 2. 零售商预先批准的认证标志或移动运营商的认证标志 Example:
|
|||||||||||||||||||||
|
|
searchTags |
|
List |
搜索词 可根据需要重复输入。["搜索词1"，"搜索词2"] 最多可输入20个搜索词，每个搜索词不得超过20个字符，不得输入 !@#$%^&*-+;:'. 外的其它特殊字符 |
||||||||||||||||||||||
|
|
images |
O |
List |
图片列表 可根据需要重复输入 |
||||||||||||||||||||||
|
|
|
imageOrder |
O |
Number |
图片标示顺序 0,1,2... |
|||||||||||||||||||||
|
|
|
imageType |
O |
String |
图片类型 主图类型 可将3MB或以下的正方形图片以 JPG /PNG格式上传（最小 500 x 500 px，最大 5000 x 5000 px）
REPRESENTATION : 正方形主图
DETAIL : 其它图片（最多可上传9个） USED_PRODUCT : 曾用图片（最多可上传4个） |
|||||||||||||||||||||
|
|
|
cdnPath |
O |
String |
酷澎CDN路径 如果上传到酷澎CDN，请手动输入，且须在vendorPath和cdnPath中至少任选其一 最大长度：150个字符 |
|||||||||||||||||||||
|
|
|
vendorPath |
O |
String |
卖家图片路径 卖家使用的图像路径。 若路径以 http://为开头，则会被自动下载并添加至酷澎CDN。且须在vendorPath和cdnPath中至少任选其一 最大长度：200个字符 |
|||||||||||||||||||||
|
|
notices |
|
List |
商品通知信息列表 可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择所需的通知信息项 |
||||||||||||||||||||||
|
|
|
noticeCategoryName |
|
String |
商品通知信息品类名 为各品类输入一个可用的商品通知信息品类 可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择所需的通知信息项。 |
|||||||||||||||||||||
|
|
|
noticeCategoryDetailName |
|
String |
商品通知信息品类详细名 |
|||||||||||||||||||||
|
|
|
content |
|
String |
内容 |
|||||||||||||||||||||
|
|
attributes |
O |
List |
属性列表(属性) 输入按品类确定的属性列表 可重复输入想要注册的购买属性数量 若购买属性（attribute exposed）的所有值都重复，则无法注册。 必须注册1个以上，可将不想输入的属性从attributes 列表中删除或将attributeValueName输入为 ""后发送。 |
||||||||||||||||||||||
|
|
|
attributeTypeName |
O |
String |
属性类型名 可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择与品类合适的属性类型名 最大长度：25个字符 |
|||||||||||||||||||||
|
|
|
attributeValueName |
O |
String |
属性值 输入单位时，请一并输入属性类型名[attributeTypeName]的值 (例如 :"200ml") 最大长度：30个字符 |
|||||||||||||||||||||
|
|
contents |
O |
List |
内容列表 可根据需要重复输入 |
||||||||||||||||||||||
|
|
|
contentsType |
O |
String |
内容类型
|
|||||||||||||||||||||
|
|
|
contentDetails |
O |
List |
详细内容列表 |
|||||||||||||||||||||
|
|
|
|
content |
O |
String |
内容 |
||||||||||||||||||||
|
|
|
|
detailType |
O |
String |
详细类型
|
||||||||||||||||||||
|
|
offerCondition |
|
String |
商品状态 商品创建后，无法修改offerCondition。 可根据显示品类代码选择以下数值。未选择时，则将其视为NEW。
|
||||||||||||||||||||||
|
|
offerDescription |
|
String |
曾用商品的详细说明 对曾用商品状态的说明，700个字符以内 仅在offerCondition输入为“曾用”时可用 |
||||||||||||||||||||||
|
|
rocketGrowthItemData |
O |
|
如果申请创建韩国本地火箭仓商品或同时创建国本地火箭仓商品和Marketplace商品，则必须要有该对象的参数。如果仅申请创建Marketplace商品，这些参数应为空。 |
||||||||||||||||||||||
|
|
|
barcode |
|
String |
条形码 贴在商品上的有效标准商品编号 若满足以下条件，则为有效条形码：
|
|||||||||||||||||||||
|
|
|
emptyBarcodeReason |
|
String |
没有条形码的原因 最大长度：100个字符 如果您想生成酷澎生成的条形码，原因请选择“AUTO_GENERATED”。 |
|||||||||||||||||||||
|
|
|
emptyBarcode |
|
Boolean |
如果通过创建商品API来提供SKU信息，则条形码应为必填信息。
|
|||||||||||||||||||||
|
|
|
externalVendorSku |
|
String |
|
|||||||||||||||||||||
|
|
|
modelNo |
|
String |
모델 번호 null값으로 제공 가능 |
|||||||||||||||||||||
|
|
|
priceData |
O |
|
|
|||||||||||||||||||||
|
|
|
|
originalPrice |
O |
Number |
折扣率基准价（定价） 此为折扣前的价格，以显示折扣率（%）。如果输入的价格与销售价格相同，则显示为“酷澎价”。审批完成后可通过[修改各属性折扣率基准价]API修改。 |
||||||||||||||||||||
|
|
|
|
salePrice |
O |
Number |
售价 输入售价。 “最初”注册商品时，只能在申请商品审批前输入售价。审批通过后，可通过[修改各属性价格]API修改。 |
||||||||||||||||||||
|
|
|
skuInfo |
|
|
申请创建商品时，此为可选项。此类信息可在创建商品或在创建入库时提供（目前此服务在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 |
韩国本地火箭仓的quantityPerBox（每箱数量）应始终为1 |
||||||||||||||||||||
|
|
|
|
distributionPeriod |
|
Number |
消费期限指是商品需要在此期限内消费。根据品类元数据查询API，如果是“isExpirationDateRequiredForRocketGrowth = true”的品类，则该信息为必填项目。 |
||||||||||||||||||||
|
|
|
|
expiredAtManaged |
|
Boolean |
如果消费期限 > 0，则为True。 如果消费期限 = 0，则为False。 |
||||||||||||||||||||
|
|
marketplaceItemData |
O |
|
如果申请创建韩国本地火箭仓商品或同时创建国本地火箭仓商品和Marketplace商品，则必须要有该对象的参数。如果仅申请创建Marketplace商品，这些参数应为空。 |
||||||||||||||||||||||
|
|
|
externalVendorSku |
|
String |
卖家商品编号 (卖家SKU编号）
可任意设置卖家的固有商品编号值，该数值将包含在PO查询API响应中。 |
|||||||||||||||||||||
|
|
|
|
|
Number |
판매가능수량 판매가능한 재고수량을 입력. 최대값 : 99999 |
|||||||||||||||||||||
|
|
|
modelNo |
|
String |
모델번호 |
|||||||||||||||||||||
|
|
|
emptyBarcode |
|
Boolean |
无条形码 若无条形码，则为True |
|||||||||||||||||||||
|
|
|
barcode |
|
String |
条形码 贴在商品上的有效标准商品编号 |
|||||||||||||||||||||
|
|
|
emptyBarcodeReason |
|
String |
没有条形码的原因 最大长度：100个字符 |
|||||||||||||||||||||
|
|
|
priceData |
O |
|
|
|||||||||||||||||||||
|
originalPrice |
O |
Number |
折扣率基准价（定价） |
|||||||||||||||||||||||
|
|
|
|
salePrice |
O |
Number |
售价 输入售价。 “最初”注册商品时，只能在申请商品审批前输入售价。审批通过后，可通过[修改各属性价格]API修改。 |
||||||||||||||||||||
|
requiredDocuments |
|
List |
如果所需文件为必填项，则须输入。 文档须小于5MB（PDF、HWP、DOC、DOCX、TXT、PNG、JPG、JPEG）
|
|||||||||||||||||||||||
|
|
templateName |
|
String |
所需文件的模版名 可通过“品类元数据查询API”确认 |
||||||||||||||||||||||
|
|
documentPath |
|
String |
所需文件的酷澎CDN路径 须在documentPath和vendorDocumentPath中任选其一 最大长度：150个字符 |
||||||||||||||||||||||
|
|
vendorDocumentPath |
|
String |
所需文件的卖家路径 若路径以http://开头，则会被自动下载并添加至酷澎CDN。须在documentPath和vendorDocumentPath中任选其一 最大长度：150个字符 |
||||||||||||||||||||||
|
extraInfoMessage |
|
String |
定制信息 顾客将配送方式选择为“定制”时，显示给顾客的信息 |
|||||||||||||||||||||||
|
manufacture |
|
String |
制造商 无法输入准确的制造商信息时，可输入与 [brand] 相同的内容 |
|||||||||||||||||||||||
|
additionalInformationForRocketGrowth |
O |
|
|
|||||||||||||||||||||||
|
|
|
|
String |
此字段显示韩国本地火箭仓的物流信息名称，是入库信息的一部分。
若决定提供“skuInfo”，则为必填信息。如果skuInfo有值但没有“rfmInboundName”，会出现错误。 |
||||||||||||||||||||||
|
|
legalAgreement |
O |
String |
此字段显示处理韩国本地火箭仓商品的韩国本地火箭仓法律协议。除”AGREE”以外的任何值都会导致错误。创建任何韩国本地火箭仓商品时，都需要同意相应的政策信息。请参阅以下政策信息。 关于如何获得同意的Wing示例： |
||||||||||||||||||||||
同意Rocket Growth检查标准
-
1. 以下商品不能作为韩国本地火箭仓处理，也不能入库至CFS（酷澎物流服务）仓库中。生鲜/冷藏/冷冻食品群，食品 个别法律规定了须特殊处理/仓储/陈列标准的商品群，包括以下情况 a. 根据产业安全健康法，包含有提供、公布MSDS（材料安全数据表）义务和培训义务的“目标化学物质”的商品。 b. 化学物质管理法规定的有害化学物质（有毒物质、许可物质、限制物质、禁止物质、事故预防物质以及其它有害或危险的化学品或疑似有害或危险的化学品）c. 危险物安全管理法规定的易燃和可燃化学成分含量高的商品，包括扩香器、空气清新剂、洗手液、除臭剂、清洁剂、机油、油性涂料、燃油添加剂、液体清洁剂、杀虫剂、液体香烟等 d. 高压气体安全管理法规定的商品 1. 常温下压力（指表压，下同）大于1兆帕的压缩气体（如CO2、N2、二氧化碳、氮气、压缩气体、氦气等），且实际压力是1兆帕以上，或在温度35摄氏度时压力为1兆帕以上的压缩气体（不包含乙炔），以及压力为0.2兆帕以上的液化气体（如LPG、液化天然气、DME等）商品 2. 温度15摄氏度时压力超过0帕斯卡的乙炔气体 3. 常温下压力为0.2兆帕以上的液化气体，且实际压力为0.2兆帕以上，或压力达到0.2兆帕时的温度为35摄氏度以下的液化气体。 4. 温度35摄氏度时压力超过0帕斯卡的液化气体中，液化氰化氢、液化溴化甲烷及液化环氧乙烷气体 e. 根据枪械及炸药法，属于枪、剑、火药、喷枪、电击枪、弩等的商品 f. 根据医疗器械流通质量管理标准，需要保持一定温度（如冷藏、冷冻储存）的医疗器械 以单独销售的1件单位商品（含包装）为标准，宽+长+高之和超过250cm或重量超过30kg 需要上门安装交付的商品 其它不符合相关法律规定的商品（如违反食品等广告相关法律以及保质期/食用日期标识规定）
-
2. 即使商品可以入库CFS（酷澎物流服务），如果不符合以下检查标准，也可能会被退回。如果每个选项的产品外观因颜色、容量、长度等差异而不同，则必须为每个选项上传商品主图。在CFS（酷澎物流服务）的检查阶段，会将实际入库的产品与卖家在Wing上注册的商品信息进行比对。此时实物上须能确认出商品名称、选项名称和商品主图。可能因温度原因导致融化或变形的商品，如巧克力、糖果、果冻、蜡烛等，无法在夏季（7月~9月）入库。此类商品入库时，可能会被退回或退仓，并在不可避免的情况下，被CFS（酷澎物流服务）作废弃处理。此时，退回、退仓、废弃所产生的费用可能由卖家承担。可能因温度原因导致融化或变形，或对温度敏感，易变质的商品（坚果、茶、可可加工产品、巧克力、果冻、布丁等部分糖果、蜡烛、谷物等）无法入库。卖家有责任在申请入库前检查商品是否为对温度敏感的类型，对温度敏感的商品无法入库。因温度敏感导致的商品损坏，Coupang将不予赔偿，且此类商品如发生损坏等不可避免的情况时，可能会被退回或退仓，由此产生的费用由卖家承担。此外，您还必须遵守CFS（酷澎物流服务）单独分发的入库手册。
-
3. 您必须将商品归入正确的品类，并准确注册该商品的所有相关信息。Coupang提供的品类仅供卖家参考。卖家必须按照法律规定将商品归入正确的品类，并确认其是否为可以在韩国本地火箭仓上销售的商品再进行注册。
-
4. 因注册/仓储/销售不符合上述标准的商品而产生的所有损害和责任（包括但不限于退回/退仓费用、对CFS（酷澎物流服务）及其关联公司的损害，以及行政处分和刑事处罚等所有法律责任）由卖家本人承担。
Request Example
Rocket Growth 独家产品
{
"vendorId": "A00012345",
"vendorUserId": "vendor1234",
"displayCategoryCode": 69515,
"brand": "brandname",
"manufacture": "sadf",
"sellerProductName": "test openapi rg only",
"displayProductName": "test openapi rg only",
"generalProductName": "test openapi rg only",
"saleStartedAt": "2024-04-24T13:15:10",
"saleEndedAt": "2099-12-30T07:00:00",
"items":
[
{
"images":
[
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"vendorPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"
}
],
"offerDescription": "",
"contents":
[
{
"contentsType": "HTML",
"contentDetails":
[
{
"content": "<p>asdf</p>",
"detailType": "TEXT"
}
]
}
],
"itemName": "s",
"attributes":
[
{
"attributeTypeName": "패션의류/잡화 사이즈",
"attributeValueName": "s"
}
],
"notices":
[
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "first"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증사항",
"content": "second"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "third"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "fourth"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "fifth"
}
],
"maximumBuyForPerson": 0,
"maximumBuyForPersonPeriod": 1,
"certifications":
[
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"taxType": "TAX",
"adultOnly": "EVERYONE",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"pccNeeded": false,
"outboundShippingTimeDay": "1",
"searchTags":
[
"tag1",
"tag2"
],
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"offerCondition": "NEW",
"unitCount": 1,
"rocketGrowthItemData": {
"barcode": "DEFG123456781",
"externalVendorSku": "DUMMY_EXT_SKU"
"modelNo": "DUMMY_MODEL_NO"
"skuInfo":
{
"fragile": false,
"weight": 1042,
"netWeight": 937,
"leadTime": null,
"width": 341,
"length": 365,
"height": 141,
"quantityPerBox": 1,
"distributionPeriod": 400,
"expiredAtManaged": true
},
"priceData": {
"salePrice": 900000000,
"originalPrice": 0
}
}
},
{
"images":
[
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"vendorPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"
}
],
"offerDescription": "",
"contents":
[
{
"contentsType": "HTML",
"contentDetails":
[
{
"content": "<p>asdf</p>",
"detailType": "TEXT"
}
]
}
],
"itemName": "m",
"attributes":
[
{
"attributeTypeName": "패션의류/잡화 사이즈",
"attributeValueName": "m"
}
],
"notices":
[
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "first"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증사항",
"content": "second"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "third"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "fourth"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "fifth"
}
],
"maximumBuyForPerson": 0,
"maximumBuyForPersonPeriod": 1,
"certifications":
[
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"taxType": "TAX",
"adultOnly": "EVERYONE",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"pccNeeded": false,
"outboundShippingTimeDay": "1",
"searchTags":
[
"tag1",
"tag2"
],
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"offerCondition": "NEW",
"unitCount": 1,
"rocketGrowthItemData": {
"barcode": "ABCD234567881",
"externalVendorSku": "DUMMY_EXT_SKU_1"
"modelNo": "DUMMY_MODEL_NO_1"
"skuInfo":
{
"fragile": false,
"weight": 1042,
"netWeight": 937,
"leadTime": null,
"width": 341,
"length": 365,
"height": 141,
"quantityPerBox": 1,
"distributionPeriod": 400,
"expiredAtManaged": true
},
"priceData": {
"salePrice": 900000000,
"originalPrice": 0
}
}
}
],
"requiredDocuments":
[
{
"templateName": "기타인증서류",
"documentPath": "vendor_inventory/documents/2024/04/25/5/6/8116774a-896c-4482-a6a3-6f6c4329eccb.png",
"vendorDocumentPath": "images.png"
}
],
"rocketGrowthAdditionalInformation":
{
"rfmInboundName": "test product",
"legalAgreement": "AGREE"
},
"requested": true
}
Rocket Growth/Marketplace 同步操作产品
{
"vendorId": "A00012345",
"vendorUserId": "vendor1234",
"displayCategoryCode": 69515,
"brand": "brandname",
"manufacture": "sadf",
"sellerProductName": "test openapi hybrid product",
"displayProductName": "test openapi hybrid product",
"generalProductName": "test openapi hybrid product",
"saleStartedAt": "2024-04-24T13:15:10",
"saleEndedAt": "2099-12-30T07:00:00",
"items":
[
{
"images":
[
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"vendorPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"
}
],
"offerDescription": "",
"contents":
[
{
"contentsType": "HTML",
"contentDetails":
[
{
"content": "<p>asdf</p>",
"detailType": "TEXT"
}
]
}
],
"itemName": "s",
"attributes":
[
{
"attributeTypeName": "패션의류/잡화 사이즈",
"attributeValueName": "s"
}
],
"notices":
[
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "first"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증사항",
"content": "second"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "third"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "fourth"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "fifth"
}
],
"maximumBuyForPerson": 0,
"maximumBuyForPersonPeriod": 1,
"certifications":
[
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"taxType": "TAX",
"adultOnly": "EVERYONE",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"pccNeeded": false,
"outboundShippingTimeDay": "1",
"searchTags":
[
"tag1",
"tag2"
],
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"offerCondition": "NEW",
"unitCount": 1,
"rocketGrowthItemData": {
"barcode": "DEF012345678",
"externalVendorSku": "DUMMY_EXT_SKU_1"
"modelNo": "DUMMY_MODEL_NO_1",
"skuInfo":
{
"fragile": false,
"weight": 1042,
"netWeight": 937,
"leadTime": null,
"width": 341,
"length": 365,
"height": 141,
"quantityPerBox": 1,
"distributionPeriod": 400,
"expiredAtManaged": true
},
"priceData": {
"salePrice": 900000000,
"originalPrice": 0
}
},
"marketplaceItemData": {
"externalVendorSku": "DUMMY_EXT_SKU_2"
"modelNo": "DUMMY_MODEL_NO_2",
"maximumBuyCount": "10,
"priceData": {
"salePrice": 900000000,
"originalPrice": 0
}
}
},
{
"images":
[
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"vendorPath": "vendor_inventory/3f2d/3761ff43e340428f448570409a373b21976fe051a954b3f4bbc18ef69e96.jpeg"
}
],
"offerDescription": "",
"contents":
[
{
"contentsType": "HTML",
"contentDetails":
[
{
"content": "<p>asdf</p>",
"detailType": "TEXT"
}
]
}
],
"itemName": "m",
"attributes":
[
{
"attributeTypeName": "패션의류/잡화 사이즈",
"attributeValueName": "m"
}
],
"notices":
[
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "first"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증사항",
"content": "second"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "third"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "fourth"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "fifth"
}
],
"maximumBuyForPerson": 0,
"maximumBuyForPersonPeriod": 1,
"certifications":
[
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"taxType": "TAX",
"adultOnly": "EVERYONE",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"pccNeeded": false,
"outboundShippingTimeDay": "1",
"searchTags":
[
"tag1",
"tag2"
],
"overseasPurchased": "NOT_OVERSEAS_PURCHASED",
"offerCondition": "NEW",
"unitCount": 1,
"rocketGrowthItemData": {
"barcode": "ABC123456788",
"externalVendorSku": "DUMMY_EXT_SKU_3"
"modelNo": "DUMMY_MODEL_NO_3",
"skuInfo":
{
"fragile": false,
"weight": 1042,
"netWeight": 937,
"leadTime": null,
"width": 341,
"length": 365,
"height": 141,
"quantityPerBox": 1,
"distributionPeriod": 400,
"expiredAtManaged": true
},
"priceData": {
"salePrice": 900000000,
"originalPrice": 0
}
},
"marketplaceItemData": {
"externalVendorSku": "DUMMY_EXT_SKU_4"
"modelNo": "DUMMY_MODEL_NO_4",
"maximumBuyCount": "10,
"priceData": {
"salePrice": 900000000,
"originalPrice": 0
}
}
}
],
"requiredDocuments":
[
{
"templateName": "기타인증서류",
"documentPath": "vendor_inventory/documents/2024/04/25/5/6/8116774a-896c-4482-a6a3-6f6c4329eccb.png",
"vendorDocumentPath": "images.png"
}
],
"rocketGrowthAdditionalInformation":
{
"rfmInboundName": "test product",
"legalAgreement": "AGREE"
},
"marketplaceShippingAndReturnInfo": {
"deliveryMethod": "SEQUENCIAL",
"deliveryCompanyCode": "HYUNDAI",
"deliveryChargeType": "FREE",
"deliveryCharge": 0,
"freeShipOverAmount": 0,
"remoteAreaDeliverable": "Y",
"unionDeliveryType": "UNION_DELIVERY",
"outboundShippingPlaceCode": 63714,
"extraInfoMessage": "",
"returnCenterCode": "NO_RETURN_CENTERCODE",
"returnChargeName": "지모스(쿠팡)",
"companyContactNumber": "031-297-9758",
"returnZipCode": "18335",
"returnAddress": "경기도 화성시 봉담읍 복만터길72번길 48",
"returnAddressDetail": "나동 202호",
"returnCharge": 3000,
"deliveryChargeOnReturn": 3000
},
"requested": true
}
Response Message
|
名称 |
类型 |
描述 |
|
code |
String |
result code SUCCES/ERROR |
|
message |
String |
message |
|
data |
Long |
registered product ID =sellerProductId |
Response Example
{
"code": "200",
"message": "",
"data": {
"code": "SUCCESS",
"message": "",
"data": 427011919
}
}
Error Spec (생성/수정 동일)
| Http Status Code ( error type ) | Error message | Resolution |
| 400 |
注册商品名中不允许有特殊字符。
显示商品名中不允许有特殊字符。 |
displayProductName和sellerProductName
仅允许使用英文、韩文、数字、空格及以下特殊字符： !@#$%^&*()_+=-][{}';:\"/.,<>?~㈜®|°。× |
| 400 |
条形码已存在。 |
不能将条形码重复用于不同商品。 请填写其它条形码或使用自动生成酷澎条形码。 |
| 400 |
创建入库后，无法更改物流（SKU）信息。 |
入库后，无法修改sku信息。如果需要，请联系支持团队。 |
| 400 |
缺少物流信息，请输入已注册的SKU信息或您希望更改的SKU信息，然后再次申请修改。 |
SKU信息字段中缺少的值。请填写。同时请注意，SKU信息无法删除。 |
| 400 |
请勾选并同意韩国本地火箭仓检验标准的条款。如果不同意，则无法注册韩国本地火箭仓商品。 |
RocketGrowthAdditionalInformation.legalAgreement是必填字段。 |
| 400 |
无法删除正在销售中的商品。 |
缺少部分id（vendorItemId、sellerProductItmeId）。请检查该数值。 |
※ 注意事项
确认过商品创建成功的消息后，酷澎建议您通过【商品列表区间查询API】或WING 查看商品状态是否为“已批准”。
- 如果状态为“未通过审批”，请确认拒绝原因，修改后重新申请审批。
- 可通过WING中的状态修改记录或[商品状态修改记录查询API]查看“未通过审批”的原因。
*商品创建及API修改的调用不得超过每秒十次。
URL API Name
CREATE_PRODUCT