目前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 |
商品品类代码 openapisupport@coupang.com |
||||||||||||||||||||||||
sellerProductName | O | String |
注册商品名称,订单中使用的产品 名称 最小长度:15字符 最大长度:100 个字符 |
||||||||||||||||||||||||
vendorId | O | String |
企业代码(商家编号) 企业代码是在 Coupang 唯一卖家 编号标识. 可以在 Wing 上登录后 查看 |
||||||||||||||||||||||||
saleStartedAt | O | String |
开始销售时间 |
||||||||||||||||||||||||
saleEndedAt | O | String |
结束销售时间 |
||||||||||||||||||||||||
displayProductName | O | String |
显示商品名 最小长度:15字符 最大长度:100 个字符 |
||||||||||||||||||||||||
brand | String |
商标名 |
|||||||||||||||||||||||||
generalProductName | String |
产品名称 |
|||||||||||||||||||||||||
productGroup | String |
产品组 它是一个表示产品类型的名称, 可以参考产品类别的最后一级名 称来输入。 |
|||||||||||||||||||||||||
returnCenterCode | O | String |
退货中心代码 创建返回目的地后,输入提取的 返回目的地中心代码 *生效日期: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 | O | String |
货品名 最大长度 150 字符 |
||||||||||||||||||||||||
originalPrice | O | Number |
原始价格 |
||||||||||||||||||||||||
salePrice | O | Number |
销售价格 最大可以输入 800,000KRW , 最小限制要求为 2500KRW, 否则校验不会通过 |
||||||||||||||||||||||||
maximumBuyCount | O | Number |
可售数量,库存 最大:99999 |
||||||||||||||||||||||||
maximumBuyForPerson | O | Number |
每人最大购买数量 如果没有限制,输入'0' |
||||||||||||||||||||||||
maximumBuyForPersonPeriod | O | Number |
最大采购数量期间 设置每个人可以购买产品的频率。
如果没有限制,输入'1' |
||||||||||||||||||||||||
outboundShippingTimeDay | O | Number |
出库时间 |
||||||||||||||||||||||||
unitCount | O | Number |
单位数量 如果您输入产品中包含的数量, 则计算方式为(销售价格 ÷ 单位 数量)并显示为(价格 #,每单 位 000 韩元)。 对于不需要单价的产品,输入 “0”。 |
||||||||||||||||||||||||
adultOnly | O | String |
是否承认用品
|
||||||||||||||||||||||||
taxType | O | String |
税种 强制填入"TAX" |
||||||||||||||||||||||||
parallelImported | O | String |
平行进口 GF 或者 CGF lite 卖家必须填入 NOT_PARALLEL_IMPORTED |
||||||||||||||||||||||||
overseasPurchased | O | String |
海外代购 |
||||||||||||||||||||||||
pccNeeded | O | Boolean |
是否需要 pcc code |
||||||||||||||||||||||||
externalVendorSku | String |
商户产品代码(Vendor Product Code) 公司唯一商品代码值可任意设 置,输入值包含在订单查询 API 响应中。 |
|||||||||||||||||||||||||
barcode | String |
商标 |
|||||||||||||||||||||||||
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 | O | List |
图片列表 注意不要上传中文的产 品宣传图片 |
||||||||||||||||||||||||
imageOrder | O | Number |
图像显示顺序 0,1,2... |
||||||||||||||||||||||||
imageType | O | String |
图像类型 代表性图像类型 3MB 或以下的方形图像可以注册为 JPG 或 PNG(最小 500 x 500 像 素,最大 5000 x 5000 像素) ● 必需的 REPRESENTATION:方形的代表性图 像 DETAIL:其他图像(最多可 以注册 9 个) ) USED _PRODUCT:使用状态图像(最 多可注册 4 个) |
||||||||||||||||||||||||
cdnPath | O | String |
Coupang CDN 路径 如果上传到 Coupang CDN,手动输入, vendorPath 和 cdnPath 中的至少一 个 需要 最大长度:150 个字符 |
||||||||||||||||||||||||
vendorPath | O | String |
供应商图片路径 供应商图片路 径,如果路径以 http://开头,会 自动下载并添加到 Coupang CDN 中,vendorPath 和 cdnPath 中至少 有一个需要 最大长度:150 个字符 |
||||||||||||||||||||||||
notices | List |
产品公告信息列表 通过品类元信 息查询 API 或整个品类列表 Excel 文件,可以查看和选择需要 的通知信息项 |
|||||||||||||||||||||||||
noticeCategoryName | String |
产品公告类别名称 输入每个类别 可以输入的产品公告信息类别之 一,通过类别元信息查询 API 或整个类别信息 Excel 文件检查并 选择所需的公告信息项。 |
|||||||||||||||||||||||||
noticeCategoryDetailName | String |
产品公告分类详情 |
|||||||||||||||||||||||||
content | String |
内容 |
|||||||||||||||||||||||||
attributes | O | List |
属性 注意属性和属性值不要填入中文 |
||||||||||||||||||||||||
attributeTypeName | O | String |
属性类型名称 |
||||||||||||||||||||||||
attributeValueName | O | String |
属性值名称 |
||||||||||||||||||||||||
exposed | String |
该字段将属性与搜索过滤器分开 如果您注册为"EXPOSED",则将 其注册为一个属性; 如果在相应项目中写入"NONE" 值,则注册为过滤器 搜索过滤器 只能使用与要注册的类别匹配的 过滤器名称。
|
|||||||||||||||||||||||||
contents | O | List |
内容列表 注意不要上传中文的产 品说明 |
||||||||||||||||||||||||
contentsType | O | String |
内容类型 这个字段和普通商品的 Open API 注册是一致的
|
||||||||||||||||||||||||
contentDetails | O | List |
详细内容列表 这个字段和普通商 品的 Open API 注册是一致的 |
||||||||||||||||||||||||
content | O | String |
内容 这个字段和普通商品的 Open API 注册是一致的 |
||||||||||||||||||||||||
detailType | O | String |
详细类型 这个字段和普通商品的 Open API 注册是一致的
|
||||||||||||||||||||||||
offerCondition | String |
产品状态 这个字段填入商品状态 对于CGF/CGF lite商品目前仅能选“NEW”.
|
|||||||||||||||||||||||||
offerDescription | String |
产品状态描述 |
|||||||||||||||||||||||||
skuInfo |
|
||||||||||||||||||||||||||
|
fragile |
O | Boolean |
是否是易碎品 true 或者 false |
|||||||||||||||||||||||
|
height
|
Number |
该字段更改为选填 高度,默认单位是 mm, 如需输入,则输入限制不得超过1000mm, 高度+宽度+长度总长 度不得超过 1600mm |
||||||||||||||||||||||||
|
length |
Number |
该字段更改为选填。 长度 默认单位是 mm,如需输 入,则输入限制不得超过 1000mm, 高度+宽度+长度总长 度不得超过 1600mm |
||||||||||||||||||||||||
|
width |
Number |
该字段更改为选填 |
||||||||||||||||||||||||
|
weight
|
Number |
该字段更改为选填 |
||||||||||||||||||||||||
|
quantityPerBox
|
O |
Number |
每箱个数 |
|||||||||||||||||||||||
|
netWeight
|
Number |
该字段更改为选填 |
||||||||||||||||||||||||
|
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
|
O |
String |
制造国家 请参照 Coupang 的国家 列表, 如 "China" |
|||||||||||||||||||||||
|
plugItem
|
对于 C.E category(电子类) 是必填 |
Boolean |
是否使用插头 只有 C.E category 需要设置这个值为 true 或者 false |
|||||||||||||||||||||||
|
plugType
|
plugItem为 true 时必填 |
String |
插头型号 可以输入诸如 110v, 220v... |
|||||||||||||||||||||||
|
battery |
O |
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 |
锂的重量 于 2g UNDER_TWO--小于等于 2g |
|||||||||||||||||||||||
|
productRegulationInfo |
Y |
Boolean |
是否为危险品 如果包含以下 5 种 中任何一种,这个字段为 true |
|||||||||||||||||||||||
|
material |
|
|
|
|||||||||||||||||||||||
|
|
ACETONE_AEROSOLS_WEAPONS |
Y |
Boolean |
是否包含丙酮/气雾剂/酒精饮料/ 武器(玩具或真实的或类似武器 的) |
||||||||||||||||||||||
|
|
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 |
String |
需文件 Coupang CDN 路径 需要 documentPath 或 vendorDocumentPath 最大长度:150 个字符 |
||||||||||||||||||||||||
vendorDocumentPath |
battery 为 true 时,documentPa th |
String |
所需文件供应商路径 必填文件路 径, |
||||||||||||||||||||||||
issueDate |
battery 为 true 时 必填 |
String |
包含电池时必填 格式为 “2021-10-28”,如果注册的产 品包含电池,针对通关的产品需 要上传相关的测试报告,同时需 要填入报告的检测生效时间 |
||||||||||||||||||||||||
extraInfoMessage | String |
自定义订单消息 输入消息以在选 择“自定义”作为传递方法时通知 客户 |
|||||||||||||||||||||||||
manufacture | String |
制造商 如果不能输入确切的制造 商,可以像[品牌]一样输入。 |
|||||||||||||||||||||||||
registrationType |
Y | String |
注册类型 |
||||||||||||||||||||||||
metaData |
|
||||||||||||||||||||||||||
|
RETURN_SHIPPING_OPTION
|
Y |
String |
回收退货类型 |
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 |
这是因认证信息不正确而出现的错误。请确认认证是否正确。 |