Description

Add a new item.

Send up to 30 items at a time

...

描述

添加新的商品，最多支持单条同时发送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=

Fileds

...

字段

字段名		字段长度	数据类型	必填性	描述
sku

Varchar

30

M

商品编码

SKU编码
barCodeNumber	50	O	条形码编号
skuNameCn

Varchar

255

M

商品中文名

品名（中文）

skuNameEn

Varchar

255

M

商品英文名

model

Varchar

127

O

商品型号

productMaterial

Varchar

50

M

商品材质

productUsage

Varchar

50

M

商品用途

brand

Varchar

50

O

品牌

grossWeight

Decimal

（8,3）

M

重量

invoiceValue

Decimal

（10,2）

M

价格

currency

Varchar

3

M

币种

hsCode

Varchar

20

M

原始国HSCODE

url

Varchar

4000

O

商品链接

skuRemark

Varchar

255

O

商品信息备注

productLength

Decimal

（5,1）

M

长度

productWidth

Decimal

（5,1）

M

宽度

productHeight

Decimal

（5,1）

M

高度

batterySize

--

M

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

otherAttributes

--

M

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

shippingBagPacked

--

M

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

packagingAttributes

Varchar

300

O

物流包装属性

originCountry

Varchar

2

O

原产国请填写国家二字码

countryInformationItems

--

M

国家属性

countryCode

Varchar

2

M

国家二字码

hsCode

Varchar

20

M

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

destinationCountryBrand

--

M

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

1：品牌授权 2：无品牌

remark

Varchar

255

M

备注

tallyRule

--

O

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

barcode

-

返回值

系统商品编号

code

-

返回编码

errors

-

报错

message

-

返回信息

messageId

-

返回信息编码

success

-

成功响应

warnList

-

废弃字段

Request Sample

代码块

[
{
"sku": "gas stove03",
"skuNameCn": "燃气灶",
"skuNameEn":"gas stove",
"model": "sso01",
"productMaterial": "耐高温材质",
"productUsage": "厨房烧燃气做饭",
"brand": "老板",
"grossWeight": "15",
"invoiceValue":"999",
"currency": "CNY",
"hsCode": "121212",
"url": "",
"skuRemark": "",
"productLength":"100",
"productWidth":"50",
"productHeight":"40",
"batterySize":"0", 
"otherAttributes":"7",
"shippingBagPacked":"1",
"packagingAttributes": "DFAGFDSFTRE",
"originCountry": "",
"countryInformationItems": [
{
"countryCode": "US",
"hsCode": "23512423",
"destinationCountryBrand":"2",
"remark": ""
}
],
"tallyRule":"1"
}
]

Response

...

品名（英文）
originCountry		2		C（根据集成商配置决定，是否必填请先咨询自己的集成商）	原产国二字码：如CN;US
hsCode		20		M	海关编码
countryInformationItems	list			O	进口清关信息
	countryCode	2		M	目的国家/地区
	hsCode	200		M	海关编码
	destinationCountryBrand	1		O	品牌属性：0：自有品牌；1：品牌授权；2：无品牌
	remark	255		O	备注
grossWeight		（8，3）		M	预估商品重量
estimateWeightUnit		2		M	预估商品重量单位：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		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": "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": "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": [
            {
                "barcodecountryCode": "us",
                "hsCode": "UBI1228322111400008S111",
                "skudestinationCountryBrand": "2",
            "gas stove12    "remark": "testremark"
            }
        ],
        "tallyRule": "",
        "barCodeNumber": "testbarcodenumber996",
        "supplier": "testsupplier",
        "errors": ""refrigerated": false,
        "hazardous": "DG",
        "UnHazardCode": "testunhazardcode",
        "prop65": false,
        "messagefood": true,
        "picture": null,
        "messageIdactualValue": 1.61,
        "hasSerialNumber": false,
        "successisLotControlled": true,
        "warnList": "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": "0005",
        "data": "testsku32",
       "gas stove03 "errors": [
            {
                "code": "100025",
                "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": ""
    }
]

...

页面树结构

版本比较

旧版本 2

新版本当前版本

标识

Description

描述

路径

请求头样例

Fileds

字段

Request Sample

Response

请求样例

返回样例

页面树结构

页面历史

版本比较

旧版本 2

新版本 当前版本

标识

Description

描述

路径

请求头样例

Fileds

字段

Request Sample

Response

请求样例

返回样例

新版本当前版本