coupang
POST/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsv1

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

# 01

简介

API 支持的买家用户地区:韩国 该API用于注册在酷澎上销售的商品 。 Rocket Growth产品创建时要成功调用API,首先点击WING平台 > 卖家信息菜单 > 附加信息菜单 > 同意,点击“同意Rocket Growth产品创建API使用和检验标准” OPEN API Key Issuance”区域,处理后即可使用。

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

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

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

[下载] 酷澎 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 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

品牌

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

无需输入空格和特殊字符

brandId   String 与商品关联的品牌 ID。存在品牌信息时返回。
generalProductName   String

商品名

 

productGroup   String

商品群

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

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

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

配送方式

Parameter Name Status状态
SEQUENCIAL

一般配送 

(依次配送) 

COLD_FRESH 冷冻生鲜 
MAKE_ORDER 定制
AGENT_BUY 代购
VENDOR_DIRECT 上门安装或卖家直接配送

 

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

  deliveryCompanyCode O String 物流公司代码 
物流公司代码链接
  deliveryChargeType O String

配送费类型

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

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

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

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

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

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

  deliveryCharge O Number

基本运费 

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

  freeShipOverAmount O Number

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

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

  deliveryChargeOnReturn O Number

初始退货运费 

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

  remoteAreaDeliverable O String

偏远地区配送与否

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

 

  unionDeliveryType O String

捆绑配送与否

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

 

※ 捆绑配送条件 : 

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

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

 

  returnCenterCode O String

退货中心代码

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

※ 自动退货链接服务(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

卖家商品属性列表

最多可注册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岁及以上

参数名

 

状态
ADULT_ONLY 19岁及以上可购买
EVERYONE 无购买年龄限制(默认值)

 

  taxType O  String

是否需纳税

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

是否为平行进口

PARALLEL_IMPORTED 平行进口
NOT_PARALLEL_IMPORTED 平行进口(默认值)

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

  overseasPurchased O  String

是否为海外代购

Parameter Name
OVERSEAS_PURCHASED

 

代购

NOT_OVERSEAS_PURCHASED

 

非代购(默认值)

※ 创建代购商品时,应注

  pccNeeded O  Boolean

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

海外代购商品需要PCC。

 

- 默认值: 不需要 (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"] 

 

  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

内容类型

参数名称 含义
IMAGE 图片
IMAGE_NO_SPACE 图片 (无空白)
TEXT 文本
IMAGE_TEXT 图片-文本
TEXT_IMAGE 文本-图片
IMAGE_IMAGE 图片-图片
TEXT_TEXT 文本-文本
TITLE 标题
HTML HTML
    contentDetails O  List 详细内容列表
      content O  String 内容
      detailType O  String

详细类型

类型 含义
IMAGE 图片
TEXT 文本
  offerCondition   String

商品状态 

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

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

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

曾用商品的详细说明

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

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

  rocketGrowthItemData O   如果申请创建韩国本地火箭仓商品或同时创建国本地火箭仓商品和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 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 可任意设置卖家的固有商品编号值,该数值将包含在PO查询API响应中。 
        Number 판매가능수량판매가능한 재고수량을 입력.  
'최초' 업체상품 등록시 판매수량은 상품 승인 요청 전에만 가능하며, 승인완료 이후 재고 수정은 [옵션별 수량 변경] API를 통해 변경가능최대값 : 99999
    modelNo   String  모델번호
    emptyBarcode   Boolean

无条形码 

若无条形码,则为True 

    barcode   String

条形码 

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

    emptyBarcodeReason   String

没有条形码的原因

最大长度:100个字符 

    priceData O  
      originalPrice O Number 折扣率基准价(定价) 
此为折扣前的价格,以显示折扣率(%)。如果输入的价格与销售价格相同,则显示为“酷澎价”。审批完成后可通过[修改各属性折扣率基准价]API修改。
      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    
 
rfmInboundName  
  
 
  String

此字段显示韩国本地火箭仓的物流信息名称,是入库信息的一部分。

 

若决定提供“skuInfo”,则为必填信息。如果skuInfo有值但没有“rfmInboundName”,会出现错误。

  legalAgreement O String

此字段显示处理韩国本地火箭仓商品的韩国本地火箭仓法律协议。除”AGREE”以外的任何值都会导致错误。创建任何韩国本地火箭仓商品时,都需要同意相应的政策信息。请参阅以下政策信息。

关于如何获得同意的Wing示例:

 

同意Rocket Growth检查标准

  1. 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. 2. 即使商品可以入库CFS(酷澎物流服务),如果不符合以下检查标准,也可能会被退回。如果每个选项的产品外观因颜色、容量、长度等差异而不同,则必须为每个选项上传商品主图。在CFS(酷澎物流服务)的检查阶段,会将实际入库的产品与卖家在Wing上注册的商品信息进行比对。此时实物上须能确认出商品名称、选项名称和商品主图。可能因温度原因导致融化或变形的商品,如巧克力、糖果、果冻、蜡烛等,无法在夏季(7月~9月)入库。此类商品入库时,可能会被退回或退仓,并在不可避免的情况下,被CFS(酷澎物流服务)作废弃处理。此时,退回、退仓、废弃所产生的费用可能由卖家承担。可能因温度原因导致融化或变形,或对温度敏感,易变质的商品(坚果、茶、可可加工产品、巧克力、果冻、布丁等部分糖果、蜡烛、谷物等)无法入库。卖家有责任在申请入库前检查商品是否为对温度敏感的类型,对温度敏感的商品无法入库。因温度敏感导致的商品损坏,Coupang将不予赔偿,且此类商品如发生损坏等不可避免的情况时,可能会被退回或退仓,由此产生的费用由卖家承担。此外,您还必须遵守CFS(酷澎物流服务)单独分发的入库手册。
  3. 3. 您必须将商品归入正确的品类,并准确注册该商品的所有相关信息。Coupang提供的品类仅供卖家参考。卖家必须按照法律规定将商品归入正确的品类,并确认其是否为可以在韩国本地火箭仓上销售的商品再进行注册。
  4. 4. 因注册/仓储/销售不符合上述标准的商品而产生的所有损害和责任(包括但不限于退回/退仓费用、对CFS(酷澎物流服务)及其关联公司的损害,以及行政处分和刑事处罚等所有法律责任)由卖家本人承担。

 

Request Example

Rocket Growth 独家产品

{

    "vendorId": "A00012345",

    "vendorUserId": "vendor1234",

    "displayCategoryCode": 69515,

    "brand": "brandname",
     "brandId": "KR-00005",

    "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 查看商品状态是否为“已批准”。 
  • 如果状态为“未通过审批”,请确认拒绝原因,修改后重新申请审批 

             *商品创建及API修改的调用不得超过每秒十次。 

 

URL API Name

CREATE_PRODUCT