商品注册 (Rocket Growth 与 Rocket Growth/Marketplace 同步运营产品)

该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 添加它。

创建商品时，发货地/退货地、品类、通知信息、属性信息等需要符合酷澎的标准。

请下载下方商品注册指南，获取更多详细信息。

[下载] 酷澎 OPENAPI 商品注册指南

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

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年

displayProductName

String

显示商品名

实际在酷澎销售页面上显示的商品名

建议输入与[brand]+[generalProductName]相同的商品名，未输入商品名也可注册商品。

未输入时，可能会显示[brand]+

[generalProductName]或[sellerProductName]。

最大长度：100个字符

brand

String

品牌

输入品牌的韩文/英文标准名称

无需输入空格和特殊字符

generalProductName

String

商品名

不包括购买属性[Attribute exposed]信息(尺寸、颜色等)。可另行添加型号名

productGroup

String

商品群

即商品类型；输入商品群时，可参考显示品类的最下位名称。

与商品名[generalProductName]重复时，无需输入

marketplaceShippingAndReturnInfo

创建Marketplace商品时需要提供配送和退货信息。对于韩国本地火箭仓而言，酷澎负责配送和接收退货，因此仅在创建韩国本地火箭仓列表时这些信息可以为空。

deliveryMethod

String

配送方式

Parameter Name	Status状态
SEQUENCIAL	一般配送  (依次配送)
COLD_FRESH	冷冻生鲜
MAKE_ORDER	定制
AGENT_BUY	代购
VENDOR_DIRECT	上门安装或卖家直接配送

对于生鲜食品，配送类型必须选择冷冻生鲜，而不是一般配送 。

deliveryCompanyCode

String

物流公司代码
物流公司代码链接

deliveryChargeType

String

配送费类型

Parameter Name	状态
FREE	免费配送
NOT_FREE	付费配送
CHARGE_RECEIVED	运费到付
CONDITIONAL_FREE	指定条件包邮

● 设置免费配送：
设置初始退货运费(单程)[deliveryChargeOnReturn]及退货运费金额(单程)[returnCharge]  
● 设置付费配送： 

设置基本运费[deliveryCharge]及退货运费金额(单程)  
● 设置指定条件包邮：  

设置基本运费及退货运费金额(单程)  
● 设置运费到付：  

我们已单独列出了符合运费到付条件的品类，并通过酷澎卖家客服中心分享，以指导卖家。

※ 使用[CONDITIONAL_FREE]时，您可单独设置想要的指定条件包邮值。

deliveryCharge

Number

基本运费 

若为付费配送或指定条件包邮，请输入单程运费金额。 

freeShipOverAmount

Number

免运费门槛
● 示例:  如果您想将免运费的门槛金额设置为10,000韩元或以上，请先将[deliveryChargeType]设置为'CONDITIONAL_FREE'，然后在[freeShipOverAmount]中输入10000。 
※输入单位须为100韩元或以上 (以100为增量)   

※ 若为免费配送，请输入0 

deliveryChargeOnReturn

Number

初始退货运费 

若为免费配送，则由顾客支付退货运费 

remoteAreaDeliverable

String

偏远地区配送与否

Parameter Name	Status状态
Y	偏远地区可配送
N	偏远地区不配送

unionDeliveryType

String

捆绑配送与否

Parameter Name	Status状态
UNION_DELIVERY	可捆绑配送
NOT_UNION_DELIVERY	不可捆绑配送

※ 捆绑配送条件 ： 

必须输入发货地信息（只有发货地信息相同的商品才能捆绑配送） 

不可设置“不可运费到付” 

returnCenterCode

String

退货中心代码

创建退货地后，输入显示的退货中心代码 
● 可通过Wing或“退货地创建 API”来创建退货地 
● 无法创建退货地时，可输入“NO_RETURN_CENTERCODE”，手动添加退货地信息 

※ 自动退货链接服务（Goodsflow）仅适用于签约物流公司，且必须输入退货中心代码。  
※ 若为海外配送商品，请务必输入韩国退货地址和签约物流公司代码，以创建退货中心代码。*海外配送商品退货地指南(点击) 

returnChargeName

String

退货地名称

在酷澎Wing中查看或通过“退货地查询API”注册退货地。 

“查询退货地时，输入shippingPlaceName的显示值” 

companyContactNumber

String

退货地联系方式 

在酷澎Wing中查看或通过“退货地查询API”注册退货地。

returnZipCode

String

退货地邮政编码  

在酷澎Wing中查看或通过“退货地查询API”注册退货地。

returnAddress

String

退货地址 

在酷澎Wing中查看或通过“退货地查询API”注册退货地。

returnAddressDetail

String

退货地详细地址 

在酷澎Wing中查看或通过“退货地查询API”注册退货地。

returnCharge

Number

退货运费 

回收退货商品时的单程运费 

*所输入的数值须为初始退货运费的100%～150%。 

outboundShippingPlaceCode

Number

发货地代码 

选择捆绑配送时必填。可通过“发货地查询API”进行查询 

选择海外代购（AGENT_BUY）时，只能输入海外地址。

vendorUserId

String

真实用户ID(酷澎WING ID)

属于卖家（Vendor）的用户ID

requested

Boolean

是否自动申请批准

注册商品时，选择是否自动申请批准

false : 只保存已填写的内容，审批未通过（如果您想要销售商品，请通过“商品批准申请API”或WING进行申请）
true : 保存并自动申请批准销售

items

List

卖家商品属性列表

最多可注册200个属性

itemName

String

卖家商品属性名

输入各属性名，并保证每个商品不重复

此属性名不显示在网站上，可能会随购买属性而发生变化

最大长度：150个字符

maximumBuyForPerson

Number

人均最多可购买数量

每人最多可购买的数量。

如果没有限制，请输入“0”

（例如：如果输入的人均最多可购买数量为 100，最长购买期限为 3。那么这意味着，一个人在3天内最多可购买 100 件）

maximumBuyForPersonPeriod

Number

最长购买期限

设置某个时间段内每人可以购买的最大数量。

如果没有限制，请输入“1”

（例如：如果输入的人均最多可购买数量为 100，最长购买期限为 3。那么这意味着，一个人在3天内最多可购买 100 件）

outboundShippingTimeDay

Number

标准发货日（天）

预计交货日在下单日（D-Day）之后，请以“天”为单位输入。

（例如：次日（D+1）发货，请输入“1”）

unitCount

Number

单位数量

输入商品中包含的单位数量。计算方式为（售价 ÷ 单位数量），显示方式为（单个价格 #，000 韩元）。对于不需要单价的商品，请输入“0”。

adultOnly

String

19岁及以上

参数名

状态

ADULT_ONLY

19岁及以上可购买

EVERYONE

无购买年龄限制(默认值)

taxType

String

是否需纳税

参数名	状态
TAX	需纳税(默认值)
FREE	无需缴税

parallelImported

String

是否为平行进口

参数名	状态
PARALLEL_IMPORTED	平行进口
NOT_PARALLEL_IMPORTED	平行进口(默认值)

※ 创建平行进口商品时，应注册进口申报单URL – 注册指南(点击)

overseasPurchased

String

是否为海外代购

Parameter Name

状态

OVERSEAS_PURCHASED

代购

NOT_OVERSEAS_PURCHASED

非代购(默认值)

※ 创建代购商品时，应注

pccNeeded

Boolean

是否需要PCC(个人通关代码)

海外代购商品需要PCC。

如果是海外代购（AGENT_BUY），产品PCC必须填写为true。

- 默认值: 不需要 (false)

true	顾客输入PCC后即可购买(PCC包含在订单中)
false	顾客可购买，无需输入PCC

extraProperties

卖家商品属性的附加信息

Key : 以值的形态存在。可根据需要多次重复输入。

Key

String

值

certifications

List

商品认证信息

certificationType

String

认证信息类型

可通过“品类元数据查询API”获取认证信息类型

非认证对象品类：NOT_REQUIRED

certificationCode

String

商品认证信息编号

该编号由认证机构颁发

certificationAttachments

List<Map<String,String>>

认证信息附件

认证机构提供的移动设备卖方许可证证书图像；

Map 的 key 固定为以下两个，只需要其中一个：
1）vendorPath：如果图片不是源于Coupang CDN Server
2）cdnPath：如果图片已经上传至Coupang CDN Server

注意: 用于注册手机电子产品类别（displayCategoryCode = 62600, 家电/数码>手机/平板电脑/配件>手机/平板电脑>手机>裸机),
需要上传以下两张图片：
1. 移动通信事先同意或认证机构证明

2. 零售商预先批准的认证标志或移动运营商的认证标志

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

List

搜索词

可根据需要重复输入。["搜索词1"，"搜索词2"]

最多可输入20个搜索词，每个搜索词不得超过20个字符，不得输入 !@#$%^&*-+;:'. 外的其它特殊字符

images

List

图片列表

可根据需要重复输入

imageOrder

Number

图片标示顺序

0,1,2...

imageType

String

图片类型

主图类型

可将3MB或以下的正方形图片以 JPG /PNG格式上传（最小 500 x 500 px，最大 5000 x 5000 px）

必选

REPRESENTATION : 正方形主图

可选

DETAIL : 其它图片（最多可上传9个）

USED_PRODUCT : 曾用图片（最多可上传4个）

cdnPath

String

酷澎CDN路径

如果上传到酷澎CDN，请手动输入，且须在vendorPath和cdnPath中至少任选其一

最大长度：150个字符

vendorPath

String

卖家图片路径

卖家使用的图像路径。若路径以 http://为开头，则会被自动下载并添加至酷澎CDN。且须在vendorPath和cdnPath中至少任选其一

最大长度：200个字符

notices

List

商品通知信息列表

可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择所需的通知信息项

noticeCategoryName

String

商品通知信息品类名

为各品类输入一个可用的商品通知信息品类

可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择所需的通知信息项。

noticeCategoryDetailName

String

商品通知信息品类详细名

content

String

内容

attributes

List

属性列表(属性)

输入按品类确定的属性列表

可重复输入想要注册的购买属性数量

若购买属性（attribute exposed）的所有值都重复，则无法注册。

必须注册1个以上，可将不想输入的属性从attributes 列表中删除或将attributeValueName输入为 ""后发送。

attributeTypeName

String

属性类型名

可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择与品类合适的属性类型名

最大长度：25个字符

attributeValueName

String

属性值

输入单位时，请一并输入属性类型名[attributeTypeName]的值

(例如 :"200ml")

最大长度：30个字符

contents

List

内容列表

可根据需要重复输入

contentsType

String

内容类型

参数名称	含义
IMAGE	图片
IMAGE_NO_SPACE	图片 (无空白)
TEXT	文本
IMAGE_TEXT	图片-文本
TEXT_IMAGE	文本-图片
IMAGE_IMAGE	图片-图片
TEXT_TEXT	文本-文本
TITLE	标题
HTML	HTML

contentDetails

List

详细内容列表

content

String

内容

detailType

String

详细类型

类型	含义
IMAGE	图片
TEXT	文本

offerCondition

String

商品状态

商品创建后，无法修改offerCondition。

可根据显示品类代码选择以下数值。未选择时，则将其视为NEW。

参数名称	含义
NEW	新商品
REFURBISHED	翻新
USED_BEST	二手 (优秀)
USED_GOOD	二手 (良好)
USED_NORMAL	二手（一般）

offerDescription

String

曾用商品的详细说明

对曾用商品状态的说明，700个字符以内

仅在offerCondition输入为“曾用”时可用

rocketGrowthItemData

如果申请创建韩国本地火箭仓商品或同时创建国本地火箭仓商品和Marketplace商品，则必须要有该对象的参数。如果仅申请创建Marketplace商品，这些参数应为空。

barcode

String

条形码 

贴在商品上的有效标准商品编号 

若满足以下条件，则为有效条形码：

不含小写字母

条形码长度不超过19位（可为8、12、13、14、18位）

无双重空格

除了连字符外，没有特殊字符

字符前后没有空格

emptyBarcodeReason

String

没有条形码的原因

最大长度：100个字符 

如果您想生成酷澎生成的条形码，原因请选择“AUTO_GENERATED”。

emptyBarcode

Boolean

如果通过创建商品API来提供SKU信息，则条形码应为必填信息。

Parameter Name	描述
TRUE	不提供SKU信息
FALSE or null	无条形码信息。请在“emptyBarcodeReason”项中选择“AUTO_GENERATED”，以生成酷澎条形码。

externalVendorSku

String

modelNo

String

모델 번호

null값으로 제공 가능

priceData

originalPrice

Number

折扣率基准价（定价） 

此为折扣前的价格，以显示折扣率（%）。如果输入的价格与销售价格相同，则显示为“酷澎价”。审批完成后可通过[修改各属性折扣率基准价]API修改。 

salePrice

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

externalVendorSku

String

卖家商品编号 (卖家SKU编号） 

可任意设置卖家的固有商品编号值，该数值将包含在PO查询API响应中。 

Number

판매가능수량

판매가능한 재고수량을 입력.
'최초' 업체상품 등록시 판매수량은 상품 승인 요청 전에만 가능하며, 승인완료 이후 재고 수정은 [옵션별 수량 변경] API를 통해 변경가능

최대값 : 99999

modelNo

String

모델번호

emptyBarcode

Boolean

无条形码 

若无条形码，则为True 

barcode

String

条形码 

贴在商品上的有效标准商品编号 

emptyBarcodeReason

String

没有条形码的原因

最大长度：100个字符 

priceData

originalPrice

Number

折扣率基准价（定价）
此为折扣前的价格，以显示折扣率（%）。如果输入的价格与销售价格相同，则显示为“酷澎价”。审批完成后可通过[修改各属性折扣率基准价]API修改。

salePrice

Number

售价 

输入售价。 

“最初”注册商品时，只能在申请商品审批前输入售价。审批通过后，可通过[修改各属性价格]API修改。 

requiredDocuments

List

如果所需文件为必填项，则须输入。

文档须小于5MB（PDF、HWP、DOC、DOCX、TXT、PNG、JPG、JPEG） 

templateName

String

所需文件的模版名 

可通过“品类元数据查询API”确认 

documentPath

String

所需文件的酷澎CDN路径 

须在documentPath和vendorDocumentPath中任选其一  

最大长度：150个字符 

vendorDocumentPath

OPENAPI 관련 안내

此组别内的文章

Path

Example Endpoint

Request Parameters

Body Parameter