POST
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products2609170000商品注册 (Rocket Growth 与 Rocket Growth/Marketplace 同步运营产品)
# 01
简介
商品注册 (Rocket Growth 与 Rocket Growth/Marketplace 同步运营产品)
# 02
详细内容
API支持的买家用户地区：韩国
该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产品，请参考以下文档：
路径
POST/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
示例端点
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsURL API Name
CREATE_PRODUCT
# 03
请求体参数
请求参数
请求体参数
| Name | Type | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| displayCategoryCode* | number | |||||||||||||||||||||||||
| 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 | 品牌 输入品牌的韩文/英文标准名称 无需输入空格和特殊字符 | ||||||||||||||||||||||||
| brandId | string | 与商品关联的品牌 ID。存在品牌信息时返回。
| ||||||||||||||||||||||||
| generalProductName | string | 商品名
| ||||||||||||||||||||||||
| productGroup | string | 商品群 即商品类型； 输入商品群时，可参考显示品类的最下位名称。 与商品名[generalProductName]重复时，无需输入 | ||||||||||||||||||||||||
| marketplaceShippingAndReturnInfo | object | 创建Marketplace商品时需要提供配送和退货信息。对于韩国本地火箭仓而言，酷澎负责配送和接收退货，因此仅在创建韩国本地火箭仓列表时这些信息可以为空。
| ||||||||||||||||||||||||
| deliveryMethod* marketplaceShippingAndReturnInfo.deliveryMethod | string | 配送方式
| ||||||||||||||||||||||||
| deliveryCompanyCode* marketplaceShippingAndReturnInfo.deliveryCompanyCode | string | 物流公司代码 物流公司代码链接 | ||||||||||||||||||||||||
| deliveryChargeType* marketplaceShippingAndReturnInfo.deliveryChargeType | string | 配送费类型
设置初始退货运费(单程)[deliveryChargeOnReturn]及退货运费金额(单程)[returnCharge] ● 设置付费配送： 设置基本运费[deliveryCharge]及退货运费金额(单程) ● 设置指定条件包邮： 设置基本运费及退货运费金额(单程) ● 设置运费到付： 我们已单独列出了符合运费到付条件的品类，并通过酷澎卖家客服中心分享，以指导卖家。 ※ 使用[CONDITIONAL_FREE]时，您可单独设置想要的指定条件包邮值。
| ||||||||||||||||||||||||
| deliveryCharge* marketplaceShippingAndReturnInfo.deliveryCharge | number | 基本运费 若为付费配送或指定条件包邮，请输入单程运费金额。 | ||||||||||||||||||||||||
| freeShipOverAmount* marketplaceShippingAndReturnInfo.freeShipOverAmount | number | 免运费门槛 ● 示例: 如果您想将免运费的门槛金额设置为10,000韩元或以上，请先将[deliveryChargeType]设置为'CONDITIONAL_FREE'，然后在[freeShipOverAmount]中输入10000。 ※输入单位须为100韩元或以上 (以100为增量) ※ 若为免费配送，请输入0 | ||||||||||||||||||||||||
| deliveryChargeOnReturn* marketplaceShippingAndReturnInfo.deliveryChargeOnReturn | number | 初始退货运费 若为免费配送，则由顾客支付退货运费 | ||||||||||||||||||||||||
| remoteAreaDeliverable* marketplaceShippingAndReturnInfo.remoteAreaDeliverable | string | 偏远地区配送与否
| ||||||||||||||||||||||||
| unionDeliveryType* marketplaceShippingAndReturnInfo.unionDeliveryType | string | 捆绑配送与否
必须输入发货地信息（只有发货地信息相同的商品才能捆绑配送） 不可设置“不可运费到付”
| ||||||||||||||||||||||||
| returnCenterCode* marketplaceShippingAndReturnInfo.returnCenterCode | string | 退货中心代码 创建退货地后，输入显示的退货中心代码 ● 可通过Wing或“退货地创建 API”来创建退货地 ● 无法创建退货地时，可输入“NO_RETURN_CENTERCODE”，手动添加退货地信息 ※ 自动退货链接服务（Goodsflow）仅适用于签约物流公司，且必须输入退货中心代码。 ※ 若为海外配送商品，请务必输入韩国退货地址和签约物流公司代码，以创建退货中心代码。*海外配送商品退货地指南(点击) | ||||||||||||||||||||||||
| 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 | 真实用户ID(酷澎WING ID) 属于卖家（Vendor）的用户ID | ||||||||||||||||||||||||
| requested* | boolean | 是否自动申请批准 注册商品时，选择是否自动申请批准
| ||||||||||||||||||||||||
| items* | object[] | 卖家商品属性列表 最多可注册200个属性 | ||||||||||||||||||||||||
| itemName* items[].itemName | string | 卖家商品属性名 输入各属性名，并保证每个商品不重复 此属性名不显示在网站上，可能会随购买属性而发生变化 最大长度：150个字符 | ||||||||||||||||||||||||
| maximumBuyForPerson* items[].maximumBuyForPerson | number | 人均最多可购买数量 每人最多可购买的数量。 如果没有限制，请输入“0” （例如：如果输入的人均最多可购买数量为 100，最长购买期限为 3。那么这意味着，一个人在3天内最多可购买 100 件） | ||||||||||||||||||||||||
| maximumBuyForPersonPeriod* items[].maximumBuyForPersonPeriod | number | 最长购买期限 设置某个时间段内每人可以购买的最大数量 。 如果没有限制，请输入“1” （例如：如果输入的人均最多可购买数量为 100，最长购买期限为 3。那么这意味着，一个人在3天内最多可购买 100 件） | ||||||||||||||||||||||||
| outboundShippingTimeDay* items[].outboundShippingTimeDay | number | 标准发货日（天） 预计交货日在下单日（D-Day）之后，请以“天”为单位输入。 （例如：次日（D+1）发货，请输入“1”） | ||||||||||||||||||||||||
| unitCount* items[].unitCount | number | 单位数量 输入商品中包含的单位数量。计算方式为（售价 ÷ 单位数量），显示方式为（单个价格 #，000 韩元）。 对于不需要单价的商品，请输入“0”。 | ||||||||||||||||||||||||
| adultOnly* items[].adultOnly | string | 19岁及以上
| ||||||||||||||||||||||||
| taxType* items[].taxType | string | 是否需纳税
| ||||||||||||||||||||||||
| parallelImported* items[].parallelImported | string | 是否为平行进口
| ||||||||||||||||||||||||
| overseasPurchased* items[].overseasPurchased | string | 是否为海外代购
| ||||||||||||||||||||||||
| pccNeeded* items[].pccNeeded | boolean | 是否需要PCC(个人通关代码) 海外代购商品需要PCC。
| ||||||||||||||||||||||||
| extraProperties items[].extraProperties | object | 卖家商品属性的附加信息 Key : 以值的形态存在。可根据需要多次重复输入。 | ||||||||||||||||||||||||
| Key items[].extraProperties.Key | string | 值
| ||||||||||||||||||||||||
| certifications items[].certifications | object[] | 商品认证信息
| ||||||||||||||||||||||||
| certificationType items[].certifications[].certificationType | string | 认证信息类型 可通过“品类元数据查询API”获取认证信息类型 非认证对象品类：NOT_REQUIRED | ||||||||||||||||||||||||
| certificationCode items[].certifications[].certificationCode | string | 商品认证信息编号 该编号由认证机构颁发 | ||||||||||||||||||||||||
| certificationAttachments items[].certifications[].certificationAttachments | object[] | 认证信息附件 认证机构提供的移动设备卖方许可证证书图像； Map 的 key 固定为以下两个，只需要其中一个： 1）vendorPath：如果图片不是源于Coupang CDN Server 2）cdnPath：如果图片已经上传至Coupang CDN Server 注意: 用于注册手机电子产品类别（displayCategoryCode = 62600, 家电/数码>手机/平板电脑/配件>手机/平板电脑>手机>裸机), 需要上传以下两张图片：
| ||||||||||||||||||||||||
| searchTags items[].searchTags | object[] | 搜索词 可根据需要重复输入。["搜索词1"，"搜索词2"] | ||||||||||||||||||||||||
| images* items[].images | object[] | 图片列表 可根据需要重复输入 | ||||||||||||||||||||||||
| imageOrder* items[].images[].imageOrder | number | 图片标示顺序 0,1,2... | ||||||||||||||||||||||||
| imageType* items[].images[].imageType | string | 图片类型 主图类型 可将3MB或以下的正方形图片以 JPG /PNG格式上传（最小 500 x 500 px，最大 5000 x 5000 px）
USED_PRODUCT : 曾用图片（最多可上传4个） | ||||||||||||||||||||||||
| cdnPath* items[].images[].cdnPath | string | 酷澎CDN路径 如果上传到酷澎CDN，请手动输入，且须在vendorPath和cdnPath中至少任选其一 最大长度：150个字符 | ||||||||||||||||||||||||
| vendorPath* items[].images[].vendorPath | string | 卖家图片路径 卖家使用的图像路径。 若路径以 http://为开头，则会被自动下载并添加至酷澎CDN。且须在vendorPath和cdnPath中至少任选其一 最大长度：200个字符 | ||||||||||||||||||||||||
| notices items[].notices | object[] | 商品通知信息列表 可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择所需的通知信息项 | ||||||||||||||||||||||||
| noticeCategoryName items[].notices[].noticeCategoryName | string | 商品通知信息品类名 为各品类输入一个可用的商品通知信息品类 可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择所需的通知信息项。 | ||||||||||||||||||||||||
| noticeCategoryDetailName items[].notices[].noticeCategoryDetailName | string | 商品通知信息品类详细名
| ||||||||||||||||||||||||
| content items[].notices[].content | string | 内容
| ||||||||||||||||||||||||
| attributes* items[].attributes | object[] | 属性列表(属性) 输入按品类确定的属性列表 可重复输入想要注册的购买属性数量 若购买属性（attribute exposed）的所有值都重复，则无法注册。 必须注册1个以上，可将不想输入的属性从attributes 列表中删除或将attributeValueName输入为 ""后发送。 | ||||||||||||||||||||||||
| attributeTypeName* items[].attributes[].attributeTypeName | string | 属性类型名 可通过“品类元数据查询API”或整体品类列表的Excel文件，查看并选择与品类合适的属性类型名 最大长度：25个字符 | ||||||||||||||||||||||||
| attributeValueName* items[].attributes[].attributeValueName | string | 属性值 输入单位时，请一并输入属性类型名[attributeTypeName]的值 (例如 :"200ml") 最大长度：30个字符 | ||||||||||||||||||||||||
| contents* items[].contents | object[] | 内容列表 可根据需要重复输入 | ||||||||||||||||||||||||
| contentsType* items[].contents[].contentsType | string | 内容类型
| ||||||||||||||||||||||||
| contentDetails* items[].contents[].contentDetails | object[] | 详细内容列表
| ||||||||||||||||||||||||
| content* items[].contents[].contentDetails[].content | string | 内容
| ||||||||||||||||||||||||
| detailType* items[].contents[].contentDetails[].detailType | string | 详细类型
| ||||||||||||||||||||||||
| offerCondition items[].offerCondition | string | 商品状态 商品创建后，无法修改offerCondition。 可根据显示品类代码选择以下数值。未选择时，则将其视为NEW。
| ||||||||||||||||||||||||
| offerDescription items[].offerDescription | string | 曾用商品的详细说明 对曾用商品状态的说明，700个字符以内 仅在offerCondition输入为“曾用”时可用 | ||||||||||||||||||||||||
| rocketGrowthItemData* items[].rocketGrowthItemData | object | 如果申请创建韩国本地火箭仓商品或同时创建国本地火箭仓商品和Marketplace商品，则必须要有该对象的参数。如果仅申请创建Marketplace商品，这些参数应为空。
| ||||||||||||||||||||||||
| barcode items[].rocketGrowthItemData.barcode | string | 条形码 贴在商品上的有效标准商品编号 若满足以下条件，则为有效条形码：
| ||||||||||||||||||||||||
| emptyBarcodeReason items[].rocketGrowthItemData.emptyBarcodeReason | string | 没有条形码的原因 最大长度：100个字符 如果您想生成酷澎生成的条形码，原因请选择“AUTO_GENERATED”。 | ||||||||||||||||||||||||
| emptyBarcode items[].rocketGrowthItemData.emptyBarcode | boolean | 如果通过创建商品API来提供SKU信息，则条形码应为必填信息。
| ||||||||||||||||||||||||
| externalVendorSku items[].rocketGrowthItemData.externalVendorSku | string | |||||||||||||||||||||||||
| modelNo items[].rocketGrowthItemData.modelNo | string | 모델 번호null값으로 제공 가능
| ||||||||||||||||||||||||
| priceData* items[].rocketGrowthItemData.priceData | object | |||||||||||||||||||||||||
| originalPrice* items[].rocketGrowthItemData.priceData.originalPrice | number | 折扣率基准价（定价） 此为折扣前的价格，以显示折扣率（%）。如果输入的价格与销售价格相同，则显示为“酷澎价”。审批完成后可通过[修改各属性折扣率基准价]API修改。 | ||||||||||||||||||||||||
| salePrice* items[].rocketGrowthItemData.priceData.salePrice | number | 售价 输入售价。 “最初”注册商品时，只能在申请商品审批前输入售价。审批通过后，可通过[修改各属性价格]API修改。 | ||||||||||||||||||||||||
| skuInfo items[].rocketGrowthItemData.skuInfo | object | 申请创建商品时，此为可选项。此类信息可在创建商品或在创建入库时提供（目前此服务在Wing上可用）。如果选择在创建商品时提供SKU信息，则此对象下的所有参数都是必填项，只填写部分信息时会出现错误。 如果决定提供skuInfo，则“additionalInformationForRocketGrowth”中的“rfmInboundName”项是必填信息。如果skuInfo有值但没有“rfmInboundName”，会出现错误。 | ||||||||||||||||||||||||
| 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 | 韩国本地火箭仓的quantityPerBox（每箱数量）应始终为1
| ||||||||||||||||||||||||
| distributionPeriod items[].rocketGrowthItemData.skuInfo.distributionPeriod | number | 消费期限指是商品需要在此期限内消费。根据品类元数据查询API，如果是“isExpirationDateRequiredForRocketGrowth = true”的品类，则该信息为必填项目。
| ||||||||||||||||||||||||
| expiredAtManaged items[].rocketGrowthItemData.skuInfo.expiredAtManaged | boolean | 如果消费期限 > 0，则为True。 如果消费期限 = 0，则为False。 | ||||||||||||||||||||||||
| marketplaceItemData* items[].marketplaceItemData | object | 如果申请创建韩国本地火箭仓商品或同时创建国本地火箭仓商品和Marketplace商品，则必须要有该对象的参数。如果仅申请创建Marketplace商品，这些参数应为空。
| ||||||||||||||||||||||||
| externalVendorSku items[].marketplaceItemData.externalVendorSku | string | 可任意设置卖家的固有商品编号值，该数值将包含在PO查询API响应中。
| ||||||||||||||||||||||||
items[].marketplaceItemData.externalVendorSku. | object | |||||||||||||||||||||||||
| Number items[].marketplaceItemData.externalVendorSku..Number | object | 판매가능수량판매가능한 재고수량을 입력. '최초' 업체상품 등록시 판매수량은 상품 승인 요청 전에만 가능하며, 승인완료 이후 재고 수정은 [옵션별 수량 변경] API를 통해 변경가능최대값 : 99999 | ||||||||||||||||||||||||
| modelNo items[].marketplaceItemData.modelNo | string | 모델번호
| ||||||||||||||||||||||||
| emptyBarcode items[].marketplaceItemData.emptyBarcode | boolean | 无条形码 若无条形码，则为True | ||||||||||||||||||||||||
| barcode items[].marketplaceItemData.barcode | string | 条形码 贴在商品上的有效标准商品编号 | ||||||||||||||||||||||||
| emptyBarcodeReason items[].marketplaceItemData.emptyBarcodeReason | string | 没有条形码的原因 最大长度：100个字符 | ||||||||||||||||||||||||
| priceData* items[].marketplaceItemData.priceData | object | |||||||||||||||||||||||||
| originalPrice* items[].marketplaceItemData.priceData.originalPrice | number | 折扣率基准价（定价） 此为折扣前的价格，以显示折扣率（%）。如果输入的价格与销售价格相同，则显示为“酷澎价”。审批完成后可通过[修改各属性折扣率基准价]API修改。 | ||||||||||||||||||||||||
| salePrice* items[].marketplaceItemData.priceData.salePrice | number | 售价 输入售价。 “最初”注册商品时，只能在申请商品审批前输入售价。审批通过后，可通过[修改各属性价格]API修改。 | ||||||||||||||||||||||||
| requiredDocuments | object[] | 如果所需文件为必填项，则须输入。 文档须小于5MB（PDF、HWP、DOC、DOCX、TXT、PNG、JPG、JPEG） | ||||||||||||||||||||||||
| templateName requiredDocuments[].templateName | string | 所需文件的模版名 可通过“品类元数据查询API”确认 | ||||||||||||||||||||||||
| 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 | 此字段显示韩国本地火箭仓的物流信息名称，是入库信息的一部分。 若决定提供“skuInfo”，则为必填信息。如果skuInfo有值但没有“rfmInboundName”，会出现错误。 | ||||||||||||||||||||||||
| legalAgreement* additionalInformationForRocketGrowth.legalAgreement | string | 此字段显示处理韩国本地火箭仓商品的韩国本地火箭仓法律协议。除”AGREE”以外的任何值都会导致错误。创建任何韩国本地火箭仓商品时，都需要同意相应的政策信息。请参阅以下政策信息。 关于如何获得同意的Wing示例： |
# 04
响应体
响应消息
| Name | Type | Description |
|---|---|---|
| code | string | result code SUCCES/ERROR |
| message | string | message
|
| data | object | registered product ID =sellerProductId |
| 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 | 代码 | 消息 |
|---|---|---|
| -- | ||