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

CGF/CGF lite 商品发布

# 01

简介

API 支持的买家用户地区:韩国。 不可用于台湾店铺。 此API用于 CGF/CGF lite 商品信息的发布。

# 02

详细内容

API支持的买家用户地区:韩国。不可用于台湾店铺。
此API用于 CGF/CGF lite 商品信息的发布。

 

目前CGF/CGF lite服务目前仅向中国大陆地区卖家及服务商开放,本文档主要用于帮助卖家及服务商接入 API,实现高效率的 CGF/CGF lite 商品发布

 

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

商品品类代码
目前 CGF/CGF lite 仅支持特定 的 Category,请联系您的客户 经理咨询或邮件发送至

openapisupport@coupang.com
来函请务必提供 vendorID 及客 户名称。

sellerProductName O String

注册商品名称,订单中使用的产品 名称

最小长度:15字符

最大长度:100 个字符

vendorId O String

企业代码(商家编号) 企业代码是在 Coupang 唯一卖家 编号标识. 可以在 Wing 上登录后 查看

saleStartedAt O String

开始销售时间
格式 "yyyy-MM-dd'T'HH:mm:ss"

saleEndedAt O String

结束销售时间
格式 "yyyy-MM-dd'T'HH:mm:ss"

displayProductName O String

显示商品名
实际 Coupang 销售页面上显示的 产品名称。
建议输入与 [brand]+[generalProductName]相 同 

最小长度:15字符

最大长度:100 个字符

brand   String

商标名
与 globalInfo 的 brandName 参数 区别是为,此字段是韩文或者英 文的

generalProductName   String

产品名称
购买选项 [属性公开] 不包含信息 (尺寸、颜色等)的产品名称。 可添加型号名称

productGroup   String

产品组

它是一个表示产品类型的名称, 可以参考产品类别的最后一级名 称来输入。
如果产品名称 [generalProductName]重复,则不 需要输入

returnCenterCode O String

退货中心代码 创建返回目的地后,输入提取的 返回目的地中心代码
※ 海外配送商品,请输入韩国国 内退货地址和签约快递代码,创 建退货目的地中心代码。如果不 输入约定的快递代码,客户将不 予取件退款。 海外派送产品的退 货目的地必须是韩国国内地址, 请注意,快递服务合同代码只能 注册到[乐天,罗森,邮局,韩 进,CJ,一阳],可以输入返回目 的地的返回目的地快递代码。 如 果您未注册韩国国内退货目的地 和快递公司合同代码,则无需取 件并申请退款。此时,如果客户 取消退款金额低于 KRW 100,000,Coupang 将不会收取产 品,但会退款并通知客户产品处 理。

*生效日期:2020 年 3 月 31 日起 取货无需退款:如果订单退款金 额超过 KRW 100,000,Coupang 将与卖家联系商讨是否取货指 南。 无需取件如果您希望自动取 件而不是退款,请正确注册韩国国内退货目的地和快递公司合同代码

 
returnChargeName O String
返回费用名称
companyContactNumber O String
公司联系电话
returnZipCode O String
退货邮政编码
returnAddress O String
退货地址
returnAddressDetail O String
退货地址详情
vendorUserId O String
商家用户ID
requested O Boolean

是否请求自动审批 注册产品时, 选择是否自动进行销售审批请求

● false :只保存销售请求前的内 容和状态(如果要销售,需要通 过产品审批请求进行销售请求 API 或 wing)

● true : 保存并自动请求销售授权

items O List
商品子变体信息
 
  itemName String

货品名 最大长度 150 字符

  originalPrice Number

原始价格

  salePrice Number

销售价格

最大可以输入 800,000KRW ,

最小限制要求为 2500KRW,

否则校验不会通过 

  maximumBuyCount Number

可售数量,库存 最大:99999

  maximumBuyForPerson Number

每人最大购买数量 如果没有限制,输入'0'
对于 CE category,这个字段必 填,而且只能填 1

  maximumBuyForPersonPeriod Number
最大采购数量期间 设置每个人可以购买产品的频率。

如果没有限制,输入'1'

  outboundShippingTimeDay Number

出库时间
对于 CGF lite,这个字段是必填 项,代表卖家预计发货到 Coupang 的中国仓库(深圳)的 时间,这个最大值是 5

  unitCount Number

单位数量 如果您输入产品中包含的数量, 则计算方式为(销售价格 ÷ 单位 数量)并显示为(价格 #,每单 位 000 韩元)。 对于不需要单价的产品,输入 “0”。

  adultOnly String
是否承认用品
Parameter Name Status
ADULT_ONLY

注册为成人产品

EVERYONE
注册为普通非成人产品
  taxType String

税种

强制填入"TAX"

 
  parallelImported String

平行进口

GF 或者 CGF lite 卖家必须填入 NOT_PARALLEL_IMPORTED

  overseasPurchased String

海外代购
作为 CGF 或者 CGF lite 卖家必须 填入 OVERSEAS_PURCHASED

  pccNeeded Boolean
 

是否需要 pcc code
对于 CGF 和 CGF lite 的卖家,不 需要输入该字段,这个字段默认 为 true

 
  externalVendorSku   String

商户产品代码(Vendor Product Code) 公司唯一商品代码值可任意设 置,输入值包含在订单查询 API 响应中。

  barcode   String

商标
对于 CGF 卖家,这个字段是必填 项
对于 CGF lite 卖家, 这个字段是选 填项

  emptyBarcode   Boolean
是否没有条形码
  emptyBarcodeReason   String
有条形码的原因
  modelNo   String

商品的型号编号,针对最 新 CGF/CGF lite 商品上架要 求,已将该字段更新为选填字段

  extraProperties    

额外属性

    Key   String
  certifications   List

产品认证信息

    certificationType   String

认证类型 Registerable Type 可以

通过分类元信息查询接口获取。 对于不受身份验证的类别:

NOT_REQUIRED, REQUIRED

    certificationCode   String

认证代码 由认证机构颁发的代码

  searchTags   List

搜索词

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

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

  images List

图片列表

注意不要上传中文的产 品宣传图片

    imageOrder Number

图像显示顺序 0,1,2...

    imageType String

图像类型 代表性图像类型 3MB 或以下的方形图像可以注册为 JPG 或 PNG(最小 500 x 500 像 素,最大 5000 x 5000 像素)

● 必需的

REPRESENTATION:方形的代表性图 像
● 可选

DETAIL:其他图像(最多可 以注册 9 个) )

USED _PRODUCT:使用状态图像(最 多可注册 4 个)

    cdnPath String

Coupang CDN 路径 如果上传到 Coupang CDN,手动输入, vendorPath 和 cdnPath 中的至少一 个 需要

最大长度:150 个字符

    vendorPath String

供应商图片路径 供应商图片路 径,如果路径以 http://开头,会 自动下载并添加到 Coupang CDN 中,vendorPath 和 cdnPath 中至少 有一个需要

最大长度:150 个字符

  notices   List

产品公告信息列表 通过品类元信 息查询 API 或整个品类列表 Excel 文件,可以查看和选择需要 的通知信息项

    noticeCategoryName   String

产品公告类别名称 输入每个类别 可以输入的产品公告信息类别之 一,通过类别元信息查询 API 或整个类别信息 Excel 文件检查并 选择所需的公告信息项。

    noticeCategoryDetailName   String

产品公告分类详情

    content   String

内容

  attributes List

属性

注意属性和属性值不要填入中文

    attributeTypeName String

属性类型名称

    attributeValueName String

属性值名称

 
    exposed   String

 

该字段将属性与搜索过滤器分开 如果您注册为"EXPOSED",则将

其注册为一个属性; 如果在相应项目中写入"NONE" 值,则注册为过滤器 搜索过滤器 只能使用与要注册的类别匹配的 过滤器名称。

 

  contents List

内容列表 注意不要上传中文的产 品说明

    contentsType String

内容类型 这个字段和普通商品的 Open API 注册是一致的

Parameter Name Status
IMAGE image
IMAGE_NO_SPACE image(no space)
TEXT text
IMAGE_TEXT image-text
TEXT_IMAGE text-image
IMAGE_IMAGE image-image
TEXT_TEXT text-text
TITLE title
HTML HTML
    contentDetails List

详细内容列表

这个字段和普通商 品的 Open API 注册是一致的

      content String

内容

这个字段和普通商品的 Open API 注册是一致的

      detailType String

详细类型

这个字段和普通商品的 Open API 注册是一致的

Parameter Name Status
IMAGE image
TEXT text
  offerCondition   String

产品状态

这个字段填入商品状态

对于CGF/CGF lite商品目前仅能选“NEW”.

参数名称 含义
NEW

新商品 

REFURBISHED

翻新 

USED_BEST

二手 (优秀) 

USED_GOOD

二手 (良好) 

USED_NORMAL

二手 (一般) 

  offerDescription   String

产品状态描述

 

skuInfo

   

 

 

 

fragile

Boolean

是否是易碎品 true 或者 false

 

 

height

 

 

Number

该字段更改为选填

高度,默认单位是 mm, 如需输入,则输入限制不得超过1000mm, 高度+宽度+长度总长 度不得超过 1600mm

 

 

length

 

Number

该字段更改为选填。 长度 默认单位是 mm,如需输 入,则输入限制不得超过 1000mm, 高度+宽度+长度总长 度不得超过 1600mm

 

 

width

 

Number

该字段更改为选填
宽度 默认单位是 mm,如需输 入,则输入限制不得超过 1000mm, 高度+宽度+长度总长 度不得超过 160CM

 

 

weight

 

 

Number

该字段更改为选填
重量 默认单位是 g, 如需输入, 则输入不超过 22,000g, 而且必 须 weight>newWeight

 

 

quantityPerBox

 

Number

每箱个数

 

 

netWeight

 

 

Number

该字段更改为选填
净重 默认单位是 g, 如需输入,则 不超过 22,000g, 而且必须 weight>newWeight

 

 

hazardous

 

Boolean

是否易碎 不管卖家输入什么,后 端逻辑直接传递 false 值给 jikgu 系统

 

 

heatSensitive

 

Boolean

是否热敏 不管卖家输入什么,后 端逻辑直接传递 false 值给 jikgu 系统

 

globalInfo

 

 

 

 

 

 

brandName

 

 

String

选填

中文商标名 这个字段与 brand 的 区别是,这个字段需要输入的是 中文或者英文

 

 

brandType

 

String

选填

商标类型 如果无商标,可以输入 "NO_BRAND" 如果有商标,可以

输入以下三种类型

DOMESTIC_INDEPENDENT_BR AND ——中国境内自主品牌

OVERSEAS_BRAND——海外品

牌,代工生产的

OTHERS_OVERSEAS_BRAND— —海外品牌,非代工生产的

 

 

manufacturedCountry

 

String

制造国家

请参照 Coupang 的国家

列表, 如 "China"

 

 

plugItem

 

对于 C.E category(电子类)

是必填

Boolean

是否使用插头 只有 C.E category

需要设置这个值为 true 或者 false

 

 

plugType

 

plugItem为 true 时必填

String

插头型号 可以输入诸如 110v, 220v...

 

 

battery

Boolean

产品是电池或者产品里包含电池 填入 true 或者 false

 

 

batteryUtilized

battery 为 true 时 必填

String

使用电池的类型 BATTERY_PRODUCT--该商品为 电池 BATTERY_INSTALLED--该 商品内含电池 BATTERY_INCLUDED--该商品 需电池供电,电池在商品包装中 BATTERY_USED--需要电池供 电,但商品包装内不含电池。

 

 

lithiumBatteryType

batteryUtilized 为 BATTERY_INST ALLED 或 BATTERY_INCL UDED 时必填

String

锂电池类型 ELM——锂金属 ELI——锂离子 OTHERS——其 他电池

 

 

batteryWeightType

batteryUtilized 为 BATTERY_INST ALLED 时必填

String

电池重量 OVER_5000--大于

5000g UNDER_5000--小于等于 5000g

 

 

batteryQuantityType

batteryUtilized 为 BATTERY_INCL UDED 时必填

String

池数量 OVER_TWO--大于 2 个 UNDER_TWO--小于等于2个

 

 

batteryComposition

batteryUtilized 为 BATTERY_INST ALLED 或 BATTERY_INCL UDED 时必填

String

电池类型 BATTERY--蓄电池 CELL--干电池

 

 

batteryWattType

lithiumBatteryTyp e 为 ELI 时必填

String

电池功率类型(瓦特) batteryComposition 为 CELL 时: OVER_20WH--大于 20wh UNDER_20WH--小于等于 20wh batteryComposition 为 BATTERY 时: OVER_100WH-- 大于 100wh UNDER_100WH--小 于等于 100wh

 

 

lithiumWeightType

lithiumBatteryTyp e 为 ELM 时必填

String

锂的重量
batteryComposition 为 CELL 时: OVER_ONE--大于 1g UNDER_ONE--小于等于 1g ; batteryComposition 为 BATTERY 时: OVER_TWO--大

于 2g UNDER_TWO--小于等于 2g

 

 

productRegulationInfo

Y

Boolean

是否为危险品 如果包含以下 5 种 中任何一种,这个字段为 true

 

 

material

 

 

 

 

 

 

ACETONE_AEROSOLS_WEAPONS

Y

Boolean

是否包含丙酮/气雾剂/酒精饮料/ 武器(玩具或真实的或类似武器 的)
这个字段为 true, 则不可 listing

 

 

 

PERFUMES_OVER_60 ML

Y

Boolean

是否超过 60ML 的香水 这个字段 为 true, 则不可 listing

 

 

 

INCLUDE_SYMBOL_FLAMMABLE

Y

Boolean

是否包含易燃符号 这个字段为 true, 则不可 listing

 

 

 

INCLUDE_WORD_FLAMMABLE

Y

Boolean

是否包含易燃字样 这个字段为 true, 则不可 listing

 

 

 

MAGNETS_INCLUDED

Y

Boolean

是否包含磁体 仅这个字段为 true, 则可以 listing

 

 

 

invoiceName

 

 

String

发票商品名 只允许输入中文

该字段为选填 这个字段是为了中国海关清关 用,请用中文输入发票上需要记 载的商品名

 

 

productNameEng

 

String

产品英文名称

该字段为选填

 

 

localProductName

 

String

中文商品名 允许输入中文/英文, 这个字段是为了中国海关清关用

requiredDocuments   List
 
  templateName

battery 为 true 时 必填

String
如果注册的产品包含电池,针对 通关的产品需要上传相关电池的 测试报告
  documentPath

battery 为 true 时,documentPa th
或 vendorDocume ntPath 两个字段 二选一必填

String

需文件 Coupang CDN 路径

需要 documentPath 或 vendorDocumentPath 最大长度:150 个字符

  vendorDocumentPath

battery 为 true 时,documentPa th
或 vendorDocume ntPath 两个字段 二选一必填

String

所需文件供应商路径 必填文件路 径,
如果路径以 http://开头,会自动 下载并添加到 Coupang CDN。 需要 documentPath 或 vendorDocumentPath 最大长度: 150 个字符

 

issueDate

battery 为 true 时 必填

String

包含电池时必填

格式为 “2021-10-28”,如果注册的产 品包含电池,针对通关的产品需 要上传相关的测试报告,同时需 要填入报告的检测生效时间

extraInfoMessage   String

自定义订单消息 输入消息以在选 择“自定义”作为传递方法时通知 客户

manufacture   String

制造商 如果不能输入确切的制造 商,可以像[品牌]一样输入。

registrationType

Y String

注册类型
对于 CGF 的商品,这个字段请注 册为"FUJI";
对于 CGF lite 的产品,这个字段 请注册为“FUJI_CROSSDOCK"

metaData

   

 

 

 

RETURN_SHIPPING_OPTION

 

 

Y

String

回收退货类型
如果选择通过 Coupang 回收退 货,该字段填入“COUPANG" ; 如果选择通过卖家自己回收退 货,该字段填入“SELF"

Request Example

1)CGF 商品发布请求示例
{
"sellerProductName": "Fuji product test",
"displayCategoryCode": 78717,
"vendorId": "C00481733",
"saleStartedAt": "2021-07-07T17:10:54",
"saleEndedAt": "2099-12-30T23:00:00",
"displayProductName": "Fuji product test",
"brand": "",
"vendorUserId": "lily_fuji_xdock",
"requested": true,
"items": [
{
"offerCondition": "NEW",
"offerDescription": "",
"itemName": "test 1",
"originalPrice": 0,
"salePrice": 100000,
"maximumBuyCount": 0,
"maximumBuyForPerson": 0,
"maximumBuyForPersonPeriod": 1,
"unitCount": 1,
"adultOnly": "EVERYONE",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"overseasPurchased": "OVERSEAS_PURCHASED",
"externalVendorSku": "",
"pccNeeded": true,
"emptyBarcode": true,
"emptyBarcodeReason": "",
"barcode": "",
"modelNo": "a",
"images": [
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"cdnPath": "vendor_inventory/6609/02369b7454a73425177c385b5c60767cad41c4cf48fe19a7d3e9b0016b7b.png",
"vendorPath": "02369b7454a73425177c385b5c60767cad41c4cf48fe19a7d3e9b0016b7b.png" }
],
"notices": [
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증/허가 사항",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "a"
}
],
"attributes": [
{
"attributeTypeName": "색상",
"attributeValueName": "1",
"exposed": "EXPOSED"
}
],
"contents": [
{
"contentsType": "IMAGE_NO_SPACE",
"contentDetails": [
{
"content": "vendor_inventory/892f/1015ca029a4f6d5f73b6f3632cdb3c1a132a1e8a8e4b1c1ab2f7cfab6698.jpg",
"detailType": "IMAGE"
}
]
}
],
"certifications": [
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"extraProperties": null,
"searchTags": [],
"skuInfo": {
"fragile": false,
"height": 100,
"length": 20000,
"width": 20000,
"weight": 23000,
"quantityPerBox": 1,
"netWeight": 24000
},
"skuId": null,
"globalInfo": {
"brandName": "",
"brandType": "NO_BRAND",
"productUrl": null,
"manufacturedCountry": "China",
"plugItem": false,
"plugType": null,
"battery": false,
"batteryUtilized": "",
"lithiumBatteryType": "",
"batteryWeightType": "",
"batteryQuantityType": "",
"batteryComposition": "",
"batteryWattType": "",
"lithiumWeightType": "",
"batteryType": "",
"productRegulationInfo": false,
"material": {},
"invoiceName": "测试",
"localProductName": "Fuji product 测试",
"productNameEng": "Fuji product test"
}
}
],
"requiredDocuments": [],
"extraInfoMessage": "",
"manufacture": "g",
"registrationType": "FUJI",
"metaData": {
"RETURN_SHIPPING_OPTION": "COUPANG"
}
}
 
2)CGF lite 商品发布请求示例
{
"sellerProductName": "Fuji product test",
"displayCategoryCode": 78717,
"vendorId": "C00481733",
"saleStartedAt": "2021-07-07T17:10:54",
"saleEndedAt": "2099-12-30T23:00:00",
"displayProductName": "Fuji product test",
"brand": "",
"vendorUserId": "lily_fuji_xdock",
"requested": true,
"items": [
{
"offerCondition": "NEW",
"offerDescription": "",
"itemName": "test 1",
"originalPrice": 0,
"salePrice": 100000,
"maximumBuyCount": 0,
"maximumBuyForPerson":0,
"maximumBuyForPersonPeriod":1,
"unitCount": 1,
"adultOnly": "EVERYONE",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"overseasPurchased": "OVERSEAS_PURCHASED",
"externalVendorSku": "",
"pccNeeded": true,
"emptyBarcode": true,
"emptyBarcodeReason": "",
"barcode": "",
"modelNo": "a",
"images": [
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"cdnPath": "vendor_inventory/6609/02369b7454a73425177c385b5c60767cad41c4cf48fe19a7d3e9b0016b7b.png",
"vendorPath": "02369b7454a73425177c385b5c60767cad41c4cf48fe19a7d3e9b0016b7b.png"
}
],
"notices": [
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증/허가 사항",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "a"
}
],
"attributes": [
{
"attributeTypeName": "색상",
"attributeValueName": "1",
"exposed": "EXPOSED"
}
],
"contents": [
{
"contentsType": "IMAGE_NO_SPACE",
"contentDetails": [
{
"content": "vendor_inventory/892f/1015ca029a4f6d5f73b6f3632cdb3c1a132a1e8a8e4b1c1ab2f7cfab6698.jpg",
"detailType": "IMAGE"
}
]
}
],
"certifications": [
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"extraProperties": null,
"searchTags": [],
"skuInfo": {
"fragile": false,
"height": 100,
"length": 20000,
"width": 20000,
"weight": 23000,
"quantityPerBox": 1,
"netWeight": 24000
},
"skuId": null,
"globalInfo": {
"brandName": "",
"brandType": "NO_BRAND",
"productUrl": null,
"manufacturedCountry": "China",
"plugItem": false,
"plugType": null,
"battery": false,
"batteryUtilized": "",
"lithiumBatteryType": "",
"batteryWeightType": "",
"batteryQuantityType": "",
"batteryComposition": "",
"batteryWattType": "",
"lithiumWeightType": "",
"batteryType": "",
"productRegulationInfo": false,
"material": {
},
"invoiceName": "测试",
"localProductName": "Fuji product 测试",
"productNameEng": "Fuji product test"
}
}

],
"requiredDocuments": [
],
"extraInfoMessage": "",
"manufacture": "g",
"registrationType": "FUJI",
"metaData": {
"RETURN_SHIPPING_OPTION": "COUPANG"
}
}
3)CE电子类商品请求示例
{
"sellerProductName": "X-dock CE product test",
"displayCategoryCode": 63433,
"vendorId": "C00481733",
"saleStartedAt": "2021-07-07T17:10:54",
"saleEndedAt": "2099-12-30T23:00:00",
"displayProductName": "X-dock CE product test",
"brand": "",
"vendorUserId": "lily_fuji_xdock",
"returnCenterCode": "1000903464",
"returnChargeName": "kkl",
"companyContactNumber": "02-1234-678",
"returnZipCode": "05510",
"returnAddress": "Seth Test Address",
"returnAddressDetail": "jkjjk",
"requested": true,
"items": [
{
"offerCondition": "NEW",
"offerDescription": "",
"itemName": "test 1",
"originalPrice": 0,
"salePrice": 100000,
"maximumBuyCount": 0,
"maximumBuyForPerson":1,
"maximumBuyForPersonPeriod":1,
"outboundShippingTimeDay":2,
"unitCount": 1,
"adultOnly": "EVERYONE",
"taxType": "TAX",
"parallelImported": "NOT_PARALLEL_IMPORTED",
"overseasPurchased": "OVERSEAS_PURCHASED",
"externalVendorSku": "",
"pccNeeded": true,
"emptyBarcode": true,
"emptyBarcodeReason": "",
"barcode": "",
"saleAgentCommission": 0.0,
"modelNo": "a",
"images": [
{
"imageOrder": 0,
"imageType": "REPRESENTATION",
"cdnPath": "vendor_inventory/6609/02369b7454a73425177c385b5c60767cad41c4cf48fe19a7d3e9b0016b7b.png",
"vendorPath": "02369b7454a73425177c385b5c60767cad41c4cf48fe19a7d3e9b0016b7b.png"
}
],
"notices": [
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "품명 및 모델명",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "인증/허가 사항",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조국(원산지)",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "제조자(수입자)",
"content": "a"
},
{
"noticeCategoryName": "기타 재화",
"noticeCategoryDetailName": "소비자상담 관련 전화번호",
"content": "a"
}
],
"attributes": [
{
"attributeTypeName": "색상",
"attributeValueName": "1",
"exposed": "EXPOSED"
}
],
"contents": [
{
"contentsType": "IMAGE_NO_SPACE",
"contentDetails": [
{
"content": "vendor_inventory/892f/1015ca029a4f6d5f73b6f3632cdb3c1a132a1e8a8e4b1c1ab2f7cfab6698.jpg",
"detailType": "IMAGE"
}
]
}
],
"certifications": [
{
"certificationType": "NOT_REQUIRED",
"certificationCode": ""
}
],
"extraProperties": null,
"searchTags": [],
"skuInfo": {
"fragile": false,
"height": 100,
"length": 20000,
"width": 20000,
"weight": 23000,
"quantityPerBox": 1,
"netWeight": 24000
},
"skuId": null,
"globalInfo": {
"brandName": "",
"brandType": "NO_BRAND",
"productUrl": null,
"manufacturedCountry": "China",
"plugItem": true,
"plugType": "220v",
"battery": true,
"batteryUtilized": "BATTERY_INCLUDED",
"lithiumBatteryType": "ELM",
"batteryWeightType": "",
"batteryQuantityType": "UNDER_TWO",
"batteryComposition": "BATTERY",
"batteryWattType": "",
"lithiumWeightType": "UNDER_TWO",
"batteryType": "UN3091",
"productRegulationInfo": true,
"material": {
"ACETONE_AEROSOLS_WEAPONS": false,
"PERFUMES_OVER_60ML": false,
"INCLUDE_SYMBOL_FLAMMABLE": false,
"INCLUDE_WORD_FLAMMABLE": false,
"MAGNETS_INCLUDED": true
},
"invoiceName": "测试",
"localProductName": "XDOCK CE product 测试",
"productNameEng": "XDOCK CE product test"
}
}

],
"requiredDocuments": [
{
"templateName": "UN 38.3 Test Report",
"documentPath": "vendor_inventory/documents/2021/06/25/16/0/a66cd69e-3f5e-4839-b0d9-b7e5ffea2db0.png",
"vendorDocumentPath": "a66cd69e-3f5e-4839-b0d9-b7e5ffea2db0.png"
},
{
"templateName": "MSDS Test Report",
"documentPath": "vendor_inventory/documents/2021/06/25/16/3/95a1bfd6-cd17-4ba8-ae39-9730bcff9517.jpg",
"vendorDocumentPath": "95a1bfd6-cd17-4ba8-ae39-9730bcff9517.jpg"
}
],
"extraInfoMessage": "",
"manufacture": "g",
"registrationType": "FUJI_CROSSDOCK",
"metaData": {
"RETURN_SHIPPING_OPTION": "SELF"
}
}

 

Response Message

名称 

类型

描述

code 

String 

结果code

SUCCES/ERROR 

message 

String 

响应信息 

data 

Long 

注册产品id

=sellerProductId 

 

Response Example

{
  "code": "200",
  "message": "",
  "data": {
    "code": "SUCCESS",
    "message": "",
    "data": 427011919
  }
}

Error Spec

HTTP 状态代码 (错误类型) 

错误信息 

解决方案 

400 (确认请求参数) 

品类的必需属性不存在。 

这是属性(attributes)值中必需MANDATORY) 

输入的项目被遗漏时发生的错误,需要通过“品类元数据查询API”确认并输入所需的属性值 

400 (确认请求参数) 

输入值错误。line: 123 

确认请求的 JSON 文本相应line中输入的参数、值和数组格式是否正确。 

400 (确认请求参数) 

 

请输入正确的退货中心代码。 

通过“发货地&退货地查询API”确认您输入的发货地和退货地代码是否正确 

400 (确认请求参数) 

java.lang.NullPointerException 

需要确认请求的 JSON 文本中是否存在拼写错误。. 

400 (确认请求参数) 

输入的商品必需通知信息[例如:制造商和制造经销商]与品类[例如:化妆品]中提供的信息不同 

这是输入的通知信息有问题时出现的错误。请查询品类元数据信息,确认其是否与输入的通知信息(“notices”:[])完全一致。 

400 (确认请求参数) 

配送费类型为满19800免费配送时 

如果设置了 freeShipOverAmount:19800, 

400 (确认请求参数) 

指定条件包邮价格为19800韩元,初始运费为0韩元。 

则需要确认初始运费 (deliveryChargeOnReturn) 值是否输入为“0”。 

400 (确认请求参数) 

请确认[物流公司代码]。 

如果设置了偏远地区配送(remoteAreaDeliverable:“Y”),则只能输入在发货地注册的物流公司。 

400 (确认请求参数) 

UNAUTHORIZATION 

这是因认证信息不正确而出现的错误。请确认认证是否正确