描述

添加新的商品，最多支持单条同时发送30个商品

Send up to 30 items at a time

路径

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

商品英文名

海关编码

model

countryInformationItems

127

list

O

商品型号

进口清关信息

productMaterial

countryCode

50

2

M

商品材质

目的国家/地区

productUsage

hsCode

50

200

M

商品用途

brand

50

海关编码
destinationCountryBrand	1	O	品牌属性：0：自有品牌；1：品牌授权；2：无品牌
remark	255	O

品牌

备注

grossWeight

（8,3）

（8，3）

M

重量

预估商品重量

invoiceValue

estimateWeightUnit

（10,2）

2

M

价格

预估商品重量单位：KG；LB

currency

productLength

3

（5，1）

M

币种

预估商品长

hsCode

productWidth

20

（5，1）

M

原始国HSCODE

预估商品宽

url

productHeight

4000

（5，1）

O

M

商品链接

预估商品高

skuRemark

estimateDimensionUnit

255

2

O

M

商品信息备注

预估商品尺寸单位：CM；IN

productLength

invoiceValue

（5,1）

（10，2）

M

长度

申报价值

productWidth

actualValue

（5,1）

（10，2）

M

O

宽度

实际价值

productHeight

currency

（5,1）

3

M

高度

币种三字码，如CNY；EUR

batterySize

shippingBagPacked

--

1

M

电池配置 0:无电池,1:外置电池,2:内置电池,3:纯电池

otherAttributes

--

M

其他属性 0:液体,1:粉末,2:胶状物,3:液体 & 粉末,4:液体 & 胶状物,5:粉末 & 胶状物,6:液体 & 粉末 & 胶状物,7:以上都不包含

shippingBagPacked

--

M

是否自带物流包装 0 否 1是

packagingAttributes

300

O

物流包装属性

originCountry

2

O

原产国请填写国家二字码

countryInformationItems

--

M

国家属性

countryCode

2

M

国家二字码

hsCode

20

M

目的国HSCODE；（在countryInformationItems中，区别于原始国hscode）

destinationCountryBrand

--

M

目的国品牌：0：自有品牌

1：品牌授权 2：无品牌

remark

255

M

备注

tallyRule

--

O

理货规则：1：单件 2：单箱

barcode

-

返回值

系统商品编号

code

-

返回编码

errors

-

报错

message

-

返回信息

messageId

-

返回信息编码

success

-

成功响应

warnList

-

废弃字段

自带物流包装：0：否；1：是
packagingAttributes	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
tallyRule	1		O	理货规则：1：单件；2：单箱
batterySize	1		M	电池配置：0:无电池；1:外置电池；2:内置电池；3:纯电池
otherAttributes	1		M	其他属性 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 stove03testsku32",
        "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"
        ]
    },
    {
        "code": "0sku": "testsku33",
        "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",
        "datacountryInformationItems": [
            {
                "countryCode": "us",
                "barcodehsCode": "UBI1228322111400008S111",
                "skudestinationCountryBrand": "gas stove12"2",
                "remark": "testremark"
            }
        ],
        "errorstallyRule": "",
        "barCodeNumber": "testbarcodenumber996",
        "supplier": "testsupplier",
        "refrigerated": false,
        "hazardous": "DG",
        "UnHazardCode": "testunhazardcode",
        "message": ""prop65": false,
        "food": true,
        "picture": null,
        "messageIdactualValue": 1.61,
        "hasSerialNumber": false,
        "successisLotControlled": true,
        "estimateWeightUnit": "KG",
        "estimateDimensionUnit": "CM",
        "warnList": """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": "0005",
        "data": "testsku32",
        "errors": [
            {
                "code": "100025": "gas stove03,
                "message": "SKU:testsku32,Repeated"
            }
        ],
        "message": "paramter error",
        "messageId": "",
        "success": false,
        "warnList": ""
    },
    {
        "code": "0005",
        "data": "testsku33",
        "errors": [
            {
                "code": "100025",
                "message": "SKU:gas stove03testsku33,Repeated"
            }
        ],
        "message": "paramter error",
        "messageId": "",
        "success": false,
        "warnList": ""
    }
]

...

页面树结构

版本比较

旧版本 6

新版本当前版本

标识

描述

路径

请求头样例

字段

请求样例

返回样例

返回样例

页面树结构

页面历史

版本比较

旧版本 6

新版本 当前版本

标识

描述

路径

请求头样例

字段

请求样例

返回样例

返回样例

新版本当前版本