描述
添加新的商品,最多支持单条同时发送30个商品
路径
| HTTP Verb | URL |
|---|---|
| POST | /api/supplier-service/v1/product/create |
请求头样例
| 代码块 |
|---|
POST /api/supplier-service/v1/product/create HTTP/1.1 Host: http://cfs-qa.etowertech.com/ Content-Type: application/json Accept: application/json User-AgentAuthorization: Mozilla 5.0 Host: http://qa.etowertech.com/WallTech etotest8xkIIphLnbkjRACNj4P:pc9H97D-_b2_TSCVvNj81A X-WallTech-Date: ThuTue, 0602 Aug 20202022 06:3643:2437 GMT Authorization: WallTech testLvs2jdug2qIoRsJyuxs:VaWNgikNP0NGcoxVCeWYid50MYQ= |
字段
| 字段名 | 字段长度 | 数据类型 | 必填性 | 描述 | |
|---|---|---|---|---|---|
sku | 30 | M | SKU编码 | ||
| barCodeNumber | 50 | O |
| 条形码编号 | |||||
skuNameCn | 255 | M | 品名(中文) | ||
skuNameEn | 255 | M | 品名(英文) | ||
originCountry | 2 |
C(根据集成商配置决定,是否必填请先咨询自己的集成商) |
原产国二字码:如CN;US | ||||
| hsCode | 20 | M |
| 海关编码 | |
countryInformationItems | list |
| O | 进口清关信息 |
| countryCode |
| 2 | M | 目的国家/地区 |
| hsCode | 200 | M | 海关编码 |
| destinationCountryBrand | 1 | O |
品牌 属性:
0:自有品牌
1:品牌授权
2:无品牌
品牌属性:0:自有品牌;1:品牌授权 ;2:无品牌 | |||||
| remark | 255 | O | 备注 | ||
grossWeight |
| (8,3) | M | 预估商品重量 | ||
| estimateWeightUnit | 2 | M |
预估商品重量单位(新增)
KG;LB预估商品重量单位:KG;LB |
productLength |
| (5,1) | M | 预估商品长 | ||
productWidth |
| (5,1) | M | 预估商品宽 | ||
productHeight |
| (5,1) | M | 预估商品高 | ||
| estimateDimensionUnit |
| 2 | M | 预估商品尺寸单位:CM;IN | |||
invoiceValue |
| (10,2) | M | 申报价值 | ||
| actualValue | (10,2) | O |
| 实际价值 | |||||
currency | 3 | M | 币种三字码,如CNY;EUR | ||
shippingBagPacked | 1 | M |
自带物流包装:0:否;1:是 |
packagingAttributes |
1:是
| 1 | O | 物流包装属性 | |||
brand | 50 | O | 品牌 | ||
| supplier | 20 | O |
| 供应商 | |||||
model | 128 | O | 型号 | ||
productMaterial |
| 50 | M | 材质 | ||
productUsage |
| 50 | M | 用途 | ||
| combinationType | 1 | O |
组合类型:0:item;1:kit;2:box |
0:item
1:kit
2:box
tallyRule | 1 | O |
理货规则
1:单件
2:单箱理货规则 :1:单件;2:单箱 |
batterySize |
| 1 | M |
电池配置
0:无电池,1:外置电池,2:内置电池,3危险品(新增)
DG:是危险品
不是危险品则传空即可
危险代码
hazardous不为空时必填
Prop65
是;否(新增)
食品
是;否(新增)
冷藏
是;否(新增)
序列号
是;否(新增)
批次管理
是;否(新增)
url
电池配置:0:无电池;1:外置电池;2:内置电池;3:纯电池 | |||||
otherAttributes | 1 | M | 其他属性 |
0:液体,1:粉末,2:胶状物,3:液体 & 粉末,4:液体 & 胶状物,
5:粉末 & 胶状物,6:液体 & 粉末 & 胶状物,7:以上都不包含
0:液体;1:粉末;2:胶状物;3:液体 & 粉末;4:液体&胶状物; 5:粉末 & 胶状物;6:液体&粉末&胶状物;7:以上都不包含 | |||||
| hazardous | 2 | O | 危险品:“DG”表示是危险品;不是危险品则传空即可 | ||
| UnHazardCode | 20 | O | 危险代码:hazardous不为空时必填 | ||
| prop65 | 5 | O | Prop65:是;否 | ||
| food | 5 | O | 食品:是;否 | ||
| refrigerated | 5 | O | 冷藏:是;否 | ||
| hasSerialNumber | 5 | O | 序列号:是;否 | ||
| isLotControlled | 5 | O | 批次管理:是;否 | ||
url | 250 | O | 销售链接 | ||
| picture | O |
| 图片格式:base64 |
| warehouseCodeList | O | 仓库代码 |
| 注意可以是多个海外仓 |
skuRemark |
| 255 | O | 备注 | |||
| businessCode | 100 | String | O | 业务编码 |
请求样例
| 代码块 |
|---|
[ { "sku": "gas stove03",": "testsku32", "skuNameCn": "测试商品", "skuNameEn": "testproduct", "model": "testmodel", "productMaterial": "testproductmaterial", "productUsage": "testproductusage", "brand": "testbrand", "grossWeight": "1", "invoiceValue": "55", "currency": "usd", "hsCode": "111", "url": "testurl", "skuRemark": "testremark", "productLength": "25.1", "productWidth": "35.2", "productHeight": "20.5", "batterySize": "0", "otherAttributes": "5", "shippingBagPacked": "0", "packagingAttributes": "testpackageingattribu", "originCountry": "cn", "countryInformationItems": [ { "countryCode": "us", "hsCode": "111", "destinationCountryBrand": "2", "remark": "testremark" } ], "tallyRule": "", "barCodeNumber": "testbarcodenumber996", "supplier": "testsupplier", "refrigerated": false, "hazardous": "DG", "UnHazardCode": "testunhazardcode", "prop65": false, "food": true, "picture": null, "actualValue": 1.61, "hasSerialNumber": false, "isLotControlled": true, "estimateWeightUnit": "KG", "estimateDimensionUnit": "CM", "combinationType": 2, "warehouseCodeList":[ "Australian Warehouse" ] }, { "sku": "testsku33", "skuNameCn": "燃气灶测试商品", "skuNameEn": "gas stovetestproduct", "model": "sso01testmodel", "productMaterial": "耐高温材质testproductmaterial", "productUsage": "厨房烧燃气做饭testproductusage", "brand": "老板testbrand", "grossWeight": "151", "invoiceValue": "99955", "currency": "CNYusd", "hsCode": "121212111", "url": "testurl", "skuRemark": "testremark", "productLength": "10025.1", "productWidth": "5035.2", "productHeight": "4020.5", "batterySize": "0", "otherAttributes": "75", "shippingBagPacked": "10", "packagingAttributes": "DFAGFDSFTREtestpackageingattribu", "originCountry": "cn", "countryInformationItems": [ { "countryCode": "USus", "hsCode": "23512423111", "destinationCountryBrand": "2", "remark": "testremark" } ], "tallyRule": "", "barCodeNumber": "testbarcodenumber996", "supplier": "testsupplier", "refrigerated": false, "hazardous": "DG", "UnHazardCode": "testunhazardcode", "prop65": false, "food": true, "picture": null, "actualValue": 1.61, "hasSerialNumber": false, "isLotControlled": true, "estimateWeightUnit": "KG", "estimateDimensionUnit": "CM", "combinationType": 2, "warehouseCodeList":[ "Australian Warehouse" ] } ] |
barcode | 返回值 | 系统商品编号 |
code | - | 返回编码 |
errors | - | 报错 |
message | - | 返回信息 |
messageId | - | 返回信息编码 |
success | - | 成功响应 |
warnList | - | 废弃字段 |
返回样例
[
{
"code": "0",
"data": {
"barcode": "UBI1228323030700036S",
"sku": "testsku32"
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
},
{
"code": "0",
"data": {
"barcode": "UBI1228323030700037S",
"sku": "testsku33"
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}
]
| 代码块 |
|---|
[
{
"code": "00005",
"data": "testsku32",
"errors": [
{
"barcodecode": "UBI1228322111400008S100025",
"skumessage": "gas stove12""SKU:testsku32,Repeated"
},
"errors": ""],
"message": "paramter error",
"messageId": "",
"success": truefalse,
"warnList": ""
}
] |
| 代码块 |
[, { "code": "0005", "data": "gas stove03testsku33", "errors": [ { "code": "100025", "message": "SKU:gas stove03testsku33,Repeated" } ], "message": "paramter error", "messageId": "", "success": false, "warnList": "" } ] |
...