POST
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products2609170000CGF/CGF lite 商品发布
# 01
简介
CGF/CGF lite 商品发布
# 02
详细内容
API支持的买家用户地区:韩国。不可用于台湾店铺。
此API用于 CGF/CGF lite 商品信息的发布。
目前CGF/CGF lite服务目前仅向中国大陆地区卖家及服务商开放,本文档主要用于帮助卖家及服务商接入 API,实现高效率的 CGF/CGF lite 商品发布
路径
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-products# 03
请求体参数
请求参数
请求体参数
| Name | Type | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| displayCategoryCode* | integer | 商品品类代码 目前 CGF/CGF lite 仅支持特定 的 Category,请联系您的客户 经理咨询或邮件发送至 openapisupport@coupang.com 来函请务必提供 vendorID 及客 户名称。 | ||||||||||||||||||||
| sellerProductName* | string | 注册商品名称,订单中使用的产品 名称 最小长度:15字符 最大长度:100 个字符 | ||||||||||||||||||||
| vendorId* | string | 企业代码(商家编号) 企业代码是在 Coupang 唯一卖家 编号标识. 可以在 Wing 上登录后 查看
| ||||||||||||||||||||
| saleStartedAt* | string | 开始销售时间 格式 "yyyy-MM-dd'T'HH:mm:ss" | ||||||||||||||||||||
| saleEndedAt* | string | 结束销售时间 格式 "yyyy-MM-dd'T'HH:mm:ss" | ||||||||||||||||||||
| displayProductName* | string | 显示商品名 实际 Coupang 销售页面上显示的 产品名称。 建议输入与 [brand]+[generalProductName]相 同 最小长度:15字符 最大长度:100 个字符 | ||||||||||||||||||||
| brand | string | 商标名 与 globalInfo 的 brandName 参数 区别是为,此字段是韩文或者英 文的 | ||||||||||||||||||||
| generalProductName | string | 产品名称 购买选项 [属性公开] 不包含信息 (尺寸、颜色等)的产品名称。 可添加型号名称 | ||||||||||||||||||||
| productGroup | string | 产品组 它是一个表示产品类型的名称, 可以参考产品类别的最后一级名 称来输入。 如果产品名称 [generalProductName]重复,则不 需要输入 | ||||||||||||||||||||
| returnCenterCode* | string | 退货中心代码 创建返回目的地后,输入提取的 返回目的地中心代码 ※ 海外配送商品,请输入韩国国 内退货地址和签约快递代码,创 建退货目的地中心代码。如果不 输入约定的快递代码,客户将不 予取件退款。 海外派送产品的退 货目的地必须是韩国国内地址, 请注意,快递服务合同代码只能 注册到[乐天,罗森,邮局,韩 进,CJ,一阳],可以输入返回目 的地的返回目的地快递代码。 如 果您未注册韩国国内退货目的地 和快递公司合同代码,则无需取 件并申请退款。此时,如果客户 取消退款金额低于 KRW 100,000,Coupang 将不会收取产 品,但会退款并通知客户产品处 理。 *生效日期:2020 年 3 月 31 日起 取货无需退款:如果订单退款金 额超过 KRW 100,000,Coupang 将与卖家联系商讨是否取货指 南。 无需取件如果您希望自动取 件而不是退款,请正确注册韩国国内退货目的地和快递公司合同代码 | ||||||||||||||||||||
| returnChargeName* | string | 返回费用名称
| ||||||||||||||||||||
| companyContactNumber* | string | 公司联系电话
| ||||||||||||||||||||
| returnZipCode* | string | 退货邮政编码
| ||||||||||||||||||||
| returnAddress* | string | 退货地址
| ||||||||||||||||||||
| returnAddressDetail* | string | 退货地址详情
| ||||||||||||||||||||
| vendorUserId* | string | 商家用户ID
| ||||||||||||||||||||
| requested* | boolean | 是否请求自动审批 注册产品时, 选择是否自动进行销售审批请求 ● false :只保存销售请求前的内 容和状态(如果要销售,需要通 过产品审批请求进行销售请求 API 或 wing) ● true : 保存并自动请求销售授权 | ||||||||||||||||||||
| items* | object[] | 商品子变体信息
| ||||||||||||||||||||
| itemName* items[].itemName | string | 货品名 最大长度 150 字符
| ||||||||||||||||||||
| originalPrice* items[].originalPrice | integer | 原始价格
| ||||||||||||||||||||
| salePrice* items[].salePrice | integer | 销售价格 最大可以输入 800,000KRW , 最小限制要求为 2500KRW, 否则校验不会通过 | ||||||||||||||||||||
| maximumBuyCount* items[].maximumBuyCount | integer | 可售数量,库存 最大:99999
| ||||||||||||||||||||
| maximumBuyForPerson* items[].maximumBuyForPerson | integer | 每人最大购买数量 如果没有限制,输入'0' 对于 CE category,这个字段必 填,而且只能填 1 | ||||||||||||||||||||
| maximumBuyForPersonPeriod* items[].maximumBuyForPersonPeriod | integer | 最大采购数量期间 设置每个人可以购买产品的频率。 如果没有限制,输入'1' | ||||||||||||||||||||
| outboundShippingTimeDay* items[].outboundShippingTimeDay | integer | 出库时间 对于 CGF lite,这个字段是必填 项,代表卖家预计发货到 Coupang 的中国仓库(深圳)的 时间,这个最大值是 5 | ||||||||||||||||||||
| unitCount* items[].unitCount | integer | 单位数量 如果您输入产品中包含的数量, 则计算方式为(销售价格 ÷ 单位 数量)并显示为(价格 #,每单 位 000 韩元)。 对于不需要单价的产品,输入 “0”。
| ||||||||||||||||||||
| adultOnly* items[].adultOnly | string | 是否承认用品
| ||||||||||||||||||||
| taxType* items[].taxType | string | 税种 强制填入"TAX" | ||||||||||||||||||||
| parallelImported* items[].parallelImported | string | 平行进口 GF 或者 CGF lite 卖家必须填入 NOT_PARALLEL_IMPORTED | ||||||||||||||||||||
| overseasPurchased* items[].overseasPurchased | string | 海外代购 作为 CGF 或者 CGF lite 卖家必须 填入 OVERSEAS_PURCHASED | ||||||||||||||||||||
| pccNeeded* items[].pccNeeded | boolean | 是否需要 pcc code 对于 CGF 和 CGF lite 的卖家,不 需要输入该字段,这个字段默认 为 true | ||||||||||||||||||||
| externalVendorSku items[].externalVendorSku | string | 商户产品代码(Vendor Product Code) 公司唯一商品代码值可任意设 置,输入值包含在订单查询 API 响应中。
| ||||||||||||||||||||
| barcode items[].barcode | string | 商标 对于 CGF 卖家,这个字段是必填 项 对于 CGF lite 卖家, 这个字段是选 填项 | ||||||||||||||||||||
| emptyBarcode items[].emptyBarcode | boolean | 是否没有条形码
| ||||||||||||||||||||
| emptyBarcodeReason items[].emptyBarcodeReason | string | 有条形码的原因
| ||||||||||||||||||||
| modelNo items[].modelNo | string | 商品的型号编号,针对最 新 CGF/CGF lite 商品上架要 求,已将该字段更新为选填字段
| ||||||||||||||||||||
| extraProperties items[].extraProperties | object | 额外属性
| ||||||||||||||||||||
| Key items[].extraProperties.Key | string | 值
| ||||||||||||||||||||
| certifications items[].certifications | object[] | 产品认证信息
| ||||||||||||||||||||
| certificationType items[].certifications[].certificationType | string | 认证类型 Registerable Type 可以 通过分类元信息查询接口获取。 对于不受身份验证的类别: NOT_REQUIRED, REQUIRED | ||||||||||||||||||||
| certificationCode items[].certifications[].certificationCode | string | 认证代码 由认证机构颁发的代码
| ||||||||||||||||||||
| searchTags items[].searchTags | object[] | 搜索词 可根据需要重复输入。["搜索词1","搜索词2"] 最多可输入20个搜索词,每个搜索词不得超过20个字符,不得输入 !@#$%^&*-+;:'. 外的其它特殊字符 | ||||||||||||||||||||
| images* items[].images | object[] | 图片列表 注意不要上传中文的产 品宣传图片 | ||||||||||||||||||||
| imageOrder* items[].images[].imageOrder | integer | 图像显示顺序 0,1,2...
| ||||||||||||||||||||
| imageType* items[].images[].imageType | string | 图像类型 代表性图像类型 3MB 或以下的方形图像可以注册为 JPG 或 PNG(最小 500 x 500 像 素,最大 5000 x 5000 像素) ● 必需的 REPRESENTATION:方形的代表性图 像 ● 可选 DETAIL:其他图像(最多可 以注册 9 个) ) USED _PRODUCT:使用状态图像(最 多可注册 4 个) | ||||||||||||||||||||
| cdnPath* items[].images[].cdnPath | string | Coupang CDN 路径 如果上传到 Coupang CDN,手动输入, vendorPath 和 cdnPath 中的至少一 个 需要 最大长度:150 个字符 | ||||||||||||||||||||
| vendorPath* items[].images[].vendorPath | string | 供应商图片路径 供应商图片路 径,如果路径以 http://开头,会 自动下载并添加到 Coupang CDN 中,vendorPath 和 cdnPath 中至少 有一个需要 最大长度:150 个字符 | ||||||||||||||||||||
| 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[] | 属性 注意属性和属性值不要填入中文 | ||||||||||||||||||||
| attributeTypeName* items[].attributes[].attributeTypeName | string | 属性类型名称
| ||||||||||||||||||||
| attributeValueName* items[].attributes[].attributeValueName | string | 属性值名称
| ||||||||||||||||||||
| exposed items[].attributes[].exposed | string | 该字段将属性与搜索过滤器分开 如果您注册为"EXPOSED",则将 其注册为一个属性; 如果在相应项目中写入"NONE" 值,则注册为过滤器 搜索过滤器 只能使用与要注册的类别匹配的 过滤器名称。 | ||||||||||||||||||||
| contents* items[].contents | object[] | 内容列表 注意不要上传中文的产 品说明
| ||||||||||||||||||||
| contentsType* items[].contents[].contentsType | string | 内容类型 这个字段和普通商品的 Open API 注册是一致的
| ||||||||||||||||||||
| contentDetails* items[].contents[].contentDetails | object[] | 详细内容列表 这个字段和普通商 品的 Open API 注册是一致的 | ||||||||||||||||||||
| content* items[].contents[].contentDetails[].content | string | 内容 这个字段和普通商品的 Open API 注册是一致的 | ||||||||||||||||||||
| detailType* items[].contents[].contentDetails[].detailType | string | 详细类型 这个字段和普通商品的 Open API 注册是一致的
| ||||||||||||||||||||
| offerCondition items[].offerCondition | string | 产品状态 这个字段填入商品状态 对于CGF/CGF lite商品目前仅能选“NEW”.
| ||||||||||||||||||||
| offerDescription items[].offerDescription | string | 产品状态描述
| ||||||||||||||||||||
| skuInfo items[].skuInfo | object | |||||||||||||||||||||
| fragile* items[].skuInfo.fragile | boolean | 是否是易碎品 true 或者 false
| ||||||||||||||||||||
| height items[].skuInfo.height | integer | 该字段更改为选填 高度,默认单位是 mm, 如需输入,则输入限制不得超过1000mm, 高度+宽度+长度总长 度不得超过 1600mm | ||||||||||||||||||||
| length items[].skuInfo.length | integer | 该字段更改为选填。 长度 默认单位是 mm,如需输 入,则输入限制不得超过 1000mm, 高度+宽度+长度总长 度不得超过 1600mm
| ||||||||||||||||||||
| width items[].skuInfo.width | integer | 该字段更改为选填 宽度 默认单位是 mm,如需输 入,则输入限制不得超过 1000mm, 高度+宽度+长度总长 度不得超过 160CM | ||||||||||||||||||||
| weight items[].skuInfo.weight | integer | 该字段更改为选填 重量 默认单位是 g, 如需输入, 则输入不超过 22,000g, 而且必 须 weight>newWeight | ||||||||||||||||||||
| quantityPerBox* items[].skuInfo.quantityPerBox | integer | 每箱个数
| ||||||||||||||||||||
| netWeight items[].skuInfo.netWeight | integer | 该字段更改为选填 净重 默认单位是 g, 如需输入,则 不超过 22,000g, 而且必须 weight>newWeight | ||||||||||||||||||||
| hazardous items[].skuInfo.hazardous | boolean | 是否易碎 不管卖家输入什么,后 端逻辑直接传递 false 值给 jikgu 系统
| ||||||||||||||||||||
| heatSensitive items[].skuInfo.heatSensitive | boolean | 是否热敏 不管卖家输入什么,后 端逻辑直接传递 false 值给 jikgu 系统
| ||||||||||||||||||||
| globalInfo items[].globalInfo | object | |||||||||||||||||||||
| brandName items[].globalInfo.brandName | string | 选填 中文商标名 这个字段与 brand 的 区别是,这个字段需要输入的是 中文或者英文 | ||||||||||||||||||||
| brandType items[].globalInfo.brandType | string | 选填 商标类型 如果无商标,可以输入 "NO_BRAND" 如果有商标,可以 输入以下三种类型 DOMESTIC_INDEPENDENT_BR AND ——中国境内自主品牌 OVERSEAS_BRAND——海外品 牌,代工生产的 OTHERS_OVERSEAS_BRAND— —海外品牌,非代工生产的 | ||||||||||||||||||||
| manufacturedCountry* items[].globalInfo.manufacturedCountry | string | 制造国家 请参照 Coupang 的国家 列表, 如 "China" | ||||||||||||||||||||
| plugItem items[].globalInfo.plugItem | boolean | 是否使用插头 只有 C.E category 需要设置这个值为 true 或者 false | ||||||||||||||||||||
| plugType items[].globalInfo.plugType | string | 插头型号 可以输入诸如 110v, 220v...
| ||||||||||||||||||||
| battery* items[].globalInfo.battery | boolean | 产品是电池或者产品里包含电池 填入 true 或者 false
| ||||||||||||||||||||
| batteryUtilized items[].globalInfo.batteryUtilized | string | 使用电池的类型 BATTERY_PRODUCT--该商品为 电池 BATTERY_INSTALLED--该 商品内含电池 BATTERY_INCLUDED--该商品 需电池供电,电池在商品包装中 BATTERY_USED--需要电池供 电,但商品包装内不含电池。
| ||||||||||||||||||||
| lithiumBatteryType items[].globalInfo.lithiumBatteryType | string | 锂电池类型 ELM——锂金属 ELI——锂离子 OTHERS——其 他电池
| ||||||||||||||||||||
| batteryWeightType items[].globalInfo.batteryWeightType | string | 电池重量 OVER_5000--大于 5000g UNDER_5000--小于等于 5000g | ||||||||||||||||||||
| batteryQuantityType items[].globalInfo.batteryQuantityType | string | 池数量 OVER_TWO--大于 2 个 UNDER_TWO--小于等于2个
| ||||||||||||||||||||
| batteryComposition items[].globalInfo.batteryComposition | string | 电池类型 BATTERY--蓄电池 CELL--干电池
| ||||||||||||||||||||
| batteryWattType items[].globalInfo.batteryWattType | string | 电池功率类型(瓦特) batteryComposition 为 CELL 时: OVER_20WH--大于 20wh UNDER_20WH--小于等于 20wh batteryComposition 为 BATTERY 时: OVER_100WH-- 大于 100wh UNDER_100WH--小 于等于 100wh
| ||||||||||||||||||||
| lithiumWeightType items[].globalInfo.lithiumWeightType | string | 锂的重量 batteryComposition 为 CELL 时: OVER_ONE--大于 1g UNDER_ONE--小于等于 1g ; batteryComposition 为 BATTERY 时: OVER_TWO--大 于 2g UNDER_TWO--小于等于 2g | ||||||||||||||||||||
| productRegulationInfo items[].globalInfo.productRegulationInfo | boolean | 是否为危险品 如果包含以下 5 种 中任何一种,这个字段为 true
| ||||||||||||||||||||
| material items[].globalInfo.material | object | |||||||||||||||||||||
| ACETONE_AEROSOLS_WEAPONS items[].globalInfo.material.ACETONE_AEROSOLS_WEAPONS | boolean | 是否包含丙酮/气雾剂/酒精饮料/ 武器(玩具或真实的或类似武器 的) 这个字段为 true, 则不可 listing | ||||||||||||||||||||
| PERFUMES_OVER_60 ML items[].globalInfo.material.PERFUMES_OVER_60 ML | boolean | 是否超过 60ML 的香水 这个字段 为 true, 则不可 listing
| ||||||||||||||||||||
| INCLUDE_SYMBOL_FLAMMABLE items[].globalInfo.material.INCLUDE_SYMBOL_FLAMMABLE | boolean | 是否包含易燃符号 这个字段为 true, 则不可 listing
| ||||||||||||||||||||
| INCLUDE_WORD_FLAMMABLE items[].globalInfo.material.INCLUDE_WORD_FLAMMABLE | boolean | 是否包含易燃字样 这个字段为 true, 则不可 listing
| ||||||||||||||||||||
| MAGNETS_INCLUDED items[].globalInfo.material.MAGNETS_INCLUDED | boolean | 是否包含磁体 仅这个字段为 true, 则可以 listing
| ||||||||||||||||||||
| invoiceName items[].globalInfo.invoiceName | string | 发票商品名 只允许输入中文 该字段为选填 这个字段是为了中国海关清关 用,请用中文输入发票上需要记 载的商品名 | ||||||||||||||||||||
| productNameEng items[].globalInfo.productNameEng | string | 产品英文名称 该字段为选填 | ||||||||||||||||||||
| localProductName items[].globalInfo.localProductName | string | 中文商品名 允许输入中文/英文, 这个字段是为了中国海关清关用
| ||||||||||||||||||||
| requiredDocuments | object[] | |||||||||||||||||||||
| templateName requiredDocuments[].templateName | string | 如果注册的产品包含电池,针对 通关的产品需要上传相关电池的 测试报告
| ||||||||||||||||||||
| documentPath requiredDocuments[].documentPath | string | 需文件 Coupang CDN 路径 需要 documentPath 或 vendorDocumentPath 最大长度:150 个字符 | ||||||||||||||||||||
| vendorDocumentPath requiredDocuments[].vendorDocumentPath | string | 所需文件供应商路径 必填文件路 径, 如果路径以 http://开头,会自动 下载并添加到 Coupang CDN。 需要 documentPath 或 vendorDocumentPath 最大长度: 150 个字符 | ||||||||||||||||||||
| issueDate requiredDocuments[].issueDate | string | 包含电池时必填 格式为 “2021-10-28”,如果注册的产 品包含电池,针对通关的产品需 要上传相关的测试报告,同时需 要填入报告的检测生效时间 | ||||||||||||||||||||
| extraInfoMessage | string | 自定义订单消息 输入消息以在选 择“自定义”作为传递方法时通知 客户
| ||||||||||||||||||||
| manufacture | string | 制造商 如果不能输入确切的制造 商,可以像[品牌]一样输入。
| ||||||||||||||||||||
| registrationType | string | 注册类型 对于 CGF 的商品,这个字段请注 册为"FUJI"; 对于 CGF lite 的产品,这个字段 请注册为“FUJI_CROSSDOCK" | ||||||||||||||||||||
| metaData | object | |||||||||||||||||||||
| RETURN_SHIPPING_OPTION metaData.RETURN_SHIPPING_OPTION | string | 回收退货类型 如果选择通过 Coupang 回收退 货,该字段填入“COUPANG" ; 如果选择通过卖家自己回收退 货,该字段填入“SELF" |
请求示例application/json
{
"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,
"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"
}
}# 04
响应体
响应消息
| Name | Type | Description |
|---|---|---|
| code | string | 结果code SUCCES/ERROR |
| message | string | 响应信息
|
| data | object | 注册产品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 | 代码 | 消息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
错误说明
| HTTP | 类型 | 错误消息 | 解决方案 |
|---|---|---|---|
| 400 | 400 (确认请求参数) | 品类的必需属性不存在。 | 这是属性(attributes)值中必需(MANDATORY) 输入的项目被遗漏时发生的错误,需要通过“品类元数据查询API”确认并输入所需的属性值。 |
| 400 | 400 (确认请求参数) | 输入值错误。line: 123 | 确认请求的 JSON 文本相应line中输入的参数、值和数组格式是否正确。 |
| 400 | 400 (确认请求参数) | 请输入正确的退货中心代码。 | 通过“发货地&退货地查询API”确认您输入的发货地和退货地代码是否正确。 |
| 400 | 400 (确认请求参数) | java.lang.NullPointerException | 需要确认请求的 JSON 文本中是否存在拼写错误。. |
| 400 | 400 (确认请求参数) | 输入的商品必需通知信息[例如:制造商和制造经销商]与品类[例如:化妆品]中提供的信息不同。 | 这是输入的通知信息有问题时出现的错误。请查询品类元数据信息,确认其是否与输入的通知信息(“notices”:[])完全一致。 |
| 400 | 400 (确认请求参数) | 配送费类型为满19800免费配送时, | 如果设置了 freeShipOverAmount:19800, |
| 400 | 400 (确认请求参数) | 指定条件包邮价格为19800韩元,初始运费为0韩元。 | 则需要确认初始运费 (deliveryChargeOnReturn) 值是否输入为“0”。 |
| 400 | 400 (确认请求参数) | 请确认[物流公司代码]。 | 如果设置了偏远地区配送(remoteAreaDeliverable:“Y”),则只能输入在发货地注册的物流公司。 |
| 400 | 400 (确认请求参数) | UNAUTHORIZATION | 这是因认证信息不正确而出现的错误。请确认认证是否正确。 |