API
注册/编辑商品(registerProduct)
更新时间: 2019-10-16 19:59:39 访问次数:5143
接口说明

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

接口名称

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,有需要可申请加大。
请求入参
<-->
名称 类型 必填 说明 示例
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":"AC162C6DDE78A023DA47AFB8BCE913E4",
    "data":{
        "productList":
        [
            {
                "productCode":"20190530-9",
                "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":          [
                        {
               "skuCodeThird": "test20190530-9",
               "description": "null"
                         }

                                           ]

            },
              {
                "productCode":"KB012348",
                "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":          [
                        {
               "skuCodeThird": "KB0123458-test",
               "description": "null"
                         }

                                           ]

            }
 
        ]
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"A68F8C5DB87722F1178D2801437E55F5",
    "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": "20190530-9"},
      {"productCode": "KB012348"}
   ]
}