API
注册/编辑商品(registerProduct)
更新时间: 2020-06-23 12:05:38 访问次数:6997
接口说明

本接口用于提供给第三方平台或是卖家自有系统集成产品注册功能。

接口名称

registerProduct

使用场景

卖家可以通过该接口实现新产品注册功能,保存至产品列表。

备注

1.sku+规格唯一标识一个商品,会唯一生成M码,sku对应参数:productCode;规格对应参数:specification
2.建议规格(specification)为空,即"specification":""
3.当sku(productCode)和规格(specification)相同时,即为编辑商品信息
4.更新时,如果进/出口国家和进/出口申报价值与创建时不同,则视为在进/出口国家注册。

*编辑商品时候,新入参全覆盖原SKU旧数据,请谨慎操作。

请求说明
正式URL http://openapi.winit.com.cn/openapi/service
测试URL http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
<-->
名称 类型 必填 说明 示例
isSiManager Boolean N
注册的商品是否为商品化管理
Y: 商品化管理
N:单品化管理
1、未开启混合管理的客户可不填写(如需开启请咨询商务或者在线客服)
2、不填写默认按照客户级的管理方式给商品赋值(单品化或商品化)。
3、注意:参数值需要大写。 客户注册商品时命名的商品编码,提交后不可修改
Y
productCode String(120) Y 客户注册商品时命名的商品编码,提交后不可修改
specification String(120) N 商品规格,不建议使用
chineseName String(255) Y 中文名称
englishName String(255) Y 英文名称
categoryOne String(22) N 商品类别1,目前已经暂停使用,可不传,直接删掉入参
categoryTwo String(22) N 商品类别2,目前已经暂停使用,可不传,直接删掉入参
categoryThree String(22) N 商品类别3,目前已经暂停使用,可不传,直接删掉入参
registeredWeight Numeric(10,2) Y 注册重量(克/g)
fixedVolumeWeight String(1) Y 重量体积是否固定,Y|N(目前不可更改,默认为Y) Y
registeredLength Numeric(10,2) Y 注册长度(cm)
registeredWidth Numeric(10,2) Y 注册宽度(cm)
registeredHeight Numeric(10,2) Y 注册高度(cm)
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
battery String(1) Y 是否有电池,Y|N必选其一,默认为N Y
stockOutRate String() N 缺货率,达成缺货率控制的百分比 10
leadTime String() N 交货周期,从订购到供应商交货所间隔的时间 10
replenishmentLeadTime String() N 补货周期,卖家决定需要补货的周期 20
itemThirdVos 第三方编码信息数据列表
skuCodeThird String(50) N 第三方商品编码,提交后不能更改 KB0123458-test
description String() N 第三方商品编码的说明,提交后不能修改 null
请求示例
{
{
    "action": "registerProduct",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "D82B6DA0E96C6FBFE4D16AE89EC93BBC",
    "data": {
        "productList": [
            {
                "isSiManager": "Y",
                "productCode": "20200623002",
                "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",
                "stockOutRate": "10",
                "leadTime": "10",
                "replenishmentLeadTime": "20",
                "battery": "Y",
                "itemThirdVos": [
                    {
                        "description": "null"
                    }
                ]
            },
            {
                "productCode": "202006230111",
                "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": "3DDC85784254E030D90BF6E5C84780B2",
    "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": "20200623002"
        },
        {
            "productCode": "202006230111"
        }
    ]
}