API
注册/编辑商品
更新时间: 2021-01-29 10:30:12 访问次数:11583
接口说明

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

接口名称

registerProduct

使用场景

客户新商品注册。

请求说明
正式URL https://openapi.winit.com.cn/openapi/service
测试URL https://openapi.sandbox.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
itemThirdVos 第三方商品编码信息数据列表
skuCodeThird String(50) N 第三方商品编码 KB0123458-test
description String() N 第三方商品编码的说明 null
请求示例
{
    "action": "registerProduct",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "EEF25624FDC9DE16B9E1DED621E717F1",
    "data": {
        "productList": [{
                "packaging": "LOGISTICS",
                "packagingMethod": "CARTON_BOX",
                "isSiManager": "Y",
                "productCode": "20201223",
                "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",
                "exportCountry": "CN",
                "inporCountry": "AU",
                "inportDeclaredvalue": "33",
                "exportDeclaredvalue": "34",
                "exportValueForImport": "1000",
                "stockOutRate": "10",
                "leadTime": "10",
                "replenishmentLeadTime": "20",
                "battery": "Y",
                "itemThirdVos": [{
                    "description": "null"
                }]
            },
            {
                "productCode": "20201028001",
                "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",
                "itemThirdVos": [{
                    "description": "null"
                }]
            }
        ]
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "C6650D6674F53DD8BCD06D703CA0D7C9",
    "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": "20201028"
        },
        {
            "productCode": "20201028001"
        }
    ]
}