API
注册/编辑商品
更新时间: 2021-12-02 20:47:09 访问次数:12044
接口说明

本接口用于实现注册商品功能。

接口名称

registerProduct

使用场景

客户新商品注册。

请求说明
正式URL https://openapi.winit.com.cn/openapi/service
测试URL https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
<-->
名称 类型 必填 说明 示例
productCode String(120) Y 商品编码
提交后不可变更。
SKU001
specification String(120) N 商品规格,使用需联系客服开启权限。
chineseName String(255) Y 中文名称
englishName String(255) Y 英文名称
registeredWeight Numeric(10,2) Y 注册重量(克/g)
fixedVolumeWeight String(1) Y 重量体积是否固定,请传固定值Y Y
registeredLength Numeric(10,2) Y 注册商品长度(cm) 99
registeredWidth Numeric(10,2) Y 注册商品宽度(cm) 99
registeredHeight Numeric(10,2) Y 注册商品高度(cm) 99
branded String(1) Y 是否有品牌,Y|N Y
brandedName String(127) O 品牌名称当branded为Y时必填 HHG
model String(127) O 型号
当brandedname为Y时为必填
HG
displayPageUrl String(1000) Y 商品链接 www.demo_icon.com
remark String(255) N 备注 e
exportCountry String(22) Y 出口国家,国家2字码 CN
inporCountry String(22) Y 进口国家,国家2字码 AU
inportDeclaredvalue Numeric(10,2) Y 进口申报价(USD) 33
exportDeclaredvalue Numeric(10,2) Y 出口申报价(USD) 34
exportValueForImport Numeric(10,2) Y 进口国出口申报价(USD)
默认为0
34
battery String(1) Y 是否有电池,Y|N Y
batteryTypeId int N 电池种类
1 :锂离子电池
2 :锂金属电池
3 :非锂电池
1
batteryPackId int N 电池包装
4 :纯电
5 :内置
6 :外置
4
batteryPower int 电池功率 100
isSiManager Boolean N 商品管理方式
Y:单品化管理
N:商品化管理
不传默认按照客户级管理方式赋值。
Y
packaging String(120) N 商品入库时的包装。
LOGISTICS:物流包装
SALES:销售包装
NUDE_CARGO:裸货
不填写默认“LOGISTICS”
LOGISTICS
outPackagingType String(20) 出库包装类别
不加包装: NO
WINIT标准包装:PACKAGING_WINIT
客制物流包装:CUSTOM_LOGISTICS
客制销售包装:CUSTOM_SALE
LOGISTICS
packagingMethod String(120) N 商品出库时需要加的包装。
COURIER_SATCHEL:快递袋
PADDED_ENVELOPE:气泡袋
CARTON_BOX:纸箱
NO:不加包装
不填写默认“NO”
CARTON_BOX
outPackagingSku String(60) N 指定包材SKU outPackagingSku
packagingMethodMulti string(30) 复合订单出库包材类型
塑料袋:COURIER_SATCHEL,
气泡袋:PADDED_ENVELOPE,
纸箱:CARTON_BOX,
不加包装:NO
COURIER_SATCHEL
outPackagingTypeMulti string(50) 复合订单出库包装类别
不加包装: NO
WINIT标准包装:PACKAGING_WINIT
客制物流包装:CUSTOM_LOGISTICS
客制销售包装:CUSTOM_SALE
NO
outPackagingSkuMulti string(30) 复合订单出库指定包材sku Sku001
isBatchManager String(1) N 是否批次管理,Y/N
使用需开启权限
Sku001
batchAttributeType String(50) N 批次属性类型 N
isPackingMaterial String(1) N 是否包材, Y/N ,空默认N
使用需开启权限
N
itemShape String() Y 商品形状
STRIP 规则长条形
SQUARE 规则方形
ROUND 规则圆形
IRREGULAR 不规则形状
CARTON
itemPackagingMaterial String() Y 商品包装材质(入库时)
CARTON 通用纸箱
COURIER 快递袋
BUBBLE 气泡袋
WOVEN 编织袋
METAL 金属容器
CORTICAL 皮质
FOAM 泡沫箱
ELSE 其他
CARTON
carryLabelVos 携带标签
labelCode String() N 标签编码
CE_LABEL CE标
FIRE_SAFETY_LABEL UM标签(防火标)
DANGEROUS_LABEL 9类危险品标
FRAGILE_LABEL 易碎品标
FRONT_UP_LABEL 正面朝上标
labelValue String() N 标签值
Y 含有该标签
N 不含有该标签
itemThirdVos 第三方商品编码信息数据列表
skuCodeThird String(50) N 第三方商品编码 KB0123458-test
description String() N 第三方商品编码的说明 null
请求示例
{
    "action": "registerProduct",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "19E393A6B2694E249F2D8C4648C9D1AC",
    "data": {
        "productList": [
            {
                "packaging": "LOGISTICS",
                "packagingMethod": "CARTON_BOX",
                "isSiManager": "Y",
                "productCode": "1234567test2",
                "chineseName": "PowerBuyerDEF456",
                "englishName": "34BayItemI34245",
                "categoryOne": "1001",
                "categoryTwo": "1SDDW",
                "categoryThree": "2",
                "registeredWeight": "2",
                "fixedVolumeWeight": "Y",
                "registeredLength": "4",
                "registeredWidth": "4",
                "registeredHeight": "4",
                "branded": "Y",
                "brandedName": "HHG",
                "model": "HG",
                "displayPageUrl": "www.demo_icon.com",
                "remark": "e",
                "itemShape": "",
                "itemPackagingMaterial": "CARTON",
                "carryLabelVos": [
                    {
                        "labelCode": "CE_LABEL",
                        "labelValue": "Y"
                    },
                    {
                        "labelCode": "DANGEROUS_LABEL",
                        "labelValue": "N"
                    },
                    {
                        "labelCode": "FRAGILE_LABEL",
                        "labelValue": "N"
                    },
                    {
                        "labelCode": "FRONT_UP_LABEL",
                        "labelValue": "N"
                    }
                ],
                "exportCountry": "CN",
                "inporCountry": "AU",
                "inportDeclaredvalue": "33",
                "exportDeclaredvalue": "34",
                "stockOutRate": "10",
                "leadTime": "10",
                "replenishmentLeadTime": "20",
                "battery": "Y",
                "itemThirdVos": [
                    {
                        "description": "null"
                    }
                ]
            },
            {
                "productCode": "1234567test",
                "packaging": "",
                "packagingMethod": "",
                "isSiManager": "N",
                "chineseName": "PowerBuyerDEF456",
                "englishName": "34BayItemI34245",
                "categoryOne": "1001",
                "registeredWeight": "2",
                "fixedVolumeWeight": "Y",
                "registeredLength": "4",
                "registeredWidth": "4",
                "registeredHeight": "4",
                "branded": "Y",
                "brandedName": "HHG",
                "model": "HG",
                "displayPageUrl": "www.demo_icon.com",
                "remark": "e",
                "exportCountry": "CN",
                "inporCountry": "AU",
                "inportDeclaredvalue": "33",
                "exportDeclaredvalue": "34",
                "stockOutRate": "10",
                "leadTime": "10",
                "replenishmentLeadTime": "20",
                "battery": "N",
                "itemShape": "IRREGULAR ",
                "itemPackagingMaterial": "",
                "carryLabelVos": [
                    {
                        "labelCode": "CE_LABEL",
                        "labelValue": "N"
                    },
                    {
                        "labelCode": "CE_LABEL",
                        "labelValue": "Y"
                    },
                    {
                        "labelCode": "DANGEROUS_LABEL",
                        "labelValue": "N"
                    },
                    {
                        "labelCode": "FRAGILE_LABEL",
                        "labelValue": "N"
                    },
                    {
                        "labelCode": "FRONT_UP_LABEL",
                        "labelValue": "N"
                    }
                ],
                "itemThirdVos": [
                    {
                        "description": "null"
                    }
                ]
            }
        ]
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "CF0569D4E8F09ECA134086A906C29C1E",
    "sign_method": "md5",
    "timestamp": "2015-06-16 00:19:26",
    "version": "1.0"
}

                    

            
返回出参
名称 类型 必填 说明 示例
code String(80)/Number Y 错误代码 0
msg String(255) Y 提示信息
data object Y 返回数据
productCode String(80) Y 商品sku
返回示例
{
    "code": 0,
    "msg": "操作成功",
    "data": [
        {
            "productCode": "1234567test2"
        },
        {
            "productCode": "1234567test"
        }
    ]
}