转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 26 下一个 »

描述

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

路径

HTTP VerbURL
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
Authorization:WallTech etotest8xkIIphLnbkjRACNj4P:pc9H97D-_b2_TSCVvNj81A
X-WallTech-Date:Tue, 02 Aug 2022 06:43:37 GMT

字段

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

sku


30

M

SKU编码

barCodeNumber
50

条形码编号

skuNameCn


255

M

品名(中文)

skuNameEn


255

M

品名(英文)

originCountry


2

O

原产国二字码:如CN;US

hsCode
20

M

海关编码

countryInformationItems

list

O

进口清关信息


countryCode2
M目的国家/地区

hsCode200
M海关编码

destinationCountryBrand1
O

品牌属性:0:自有品牌;1:品牌授权 ;2:无品牌


remark255

O

备注

grossWeight


(8,3)

M

预估商品重量
estimateWeightUnit
2
M

预估商品重量单位(新增)

KG;LB

productLength

estimateLength


(5,1)

M

预估商品长

productWidth

estimateWidth


(5,1)

M

预估商品宽

productHeight

estimateHeight


(5,1)

M

预估商品高
estimateDimensionUnit
2

预估商品尺寸单位(新增)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

供应商(新增)

model


128

O

型号

productMaterial

material


50

M

材质

productUsage

usage


50

M

用途

combinationType
1
O

组合类型(新增)

0:item

1:kit

2:box

tallyRule


1

O

理货规则 

1:单件

2:单箱

batterySize

battery


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

salesUrl


250

O

销售链接

picture


O图片 格式base64(新增)
warehouseCodeList


O仓库代码 注意可以是多个海外仓(新增)

skuRemark

remark


255

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": [
            {
                "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"
        ]
    }
]





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",
                "message": "SKU:testsku32,Repeated"
            }
        ],
        "message": "paramter error",
        "messageId": "",
        "success": false,
        "warnList": ""
    },
    {
        "code": "0005",
        "data": "testsku33",
        "errors": [
            {
                "code": "100025",
                "message": "SKU:testsku33,Repeated"
            }
        ],
        "message": "paramter error",
        "messageId": "",
        "success": false,
        "warnList": ""
    }
]



  • 无标签