Skip to main content

updateProduct：批量更新商品档案

入参 

参数名称

是否必须

类型

参数说明

sKey

Y

String

密钥

body

Y

Object

具体入参

channel

N

 

针对联营版可用，指定联营商ID(联营商ID可通过接口getCollaboratorList查询获取)，指定此参数后将更新对应联营商账号下对应商品

body：以下字段非必填项  存在且不为空则更新

参数名称

是否必须

参数类型

参数说明

guid

Y

String

值为客户ERP系统中唯一值，用做关系对应

name

N

String

商品名称

siteID

N

String

erp商品分类guid

brandID

N

String

erp商品品牌guid

goods_allocation

N

String

货位号

model

N

String

型号

coding

N

String

商品编码只允许字母或数字开头,其后可与中文、数字、字母-_./\*+()# |{},、，’‘✖:：（）。￥!$・【】\'φ?？组合，长度1-40位

barcode

N

String

小单位条码

conversion_barcode

N

String

大单位条码

price1

N

Float

订货价

price2

N

Float

市场价 若未传递默认0.00

price3

N

Float

进货价 若未传递默认0.00

units

N

String

小单位

bigunits

N

String

大单位

conversionnumber

N

Float

大单位和小单位的换算关系

package

N

Float

最低定量

minorder

N

String

起订单位，base_units，container_units，middle_units，默认base_units

stockGuid

N

String

仓库ID 商品默认仓库外码，开启多仓库时有效，且需要先同步仓库信息

goodsWeight

N

Float

小单位重量 单位 kg

userdefined

N

Object

商品自定义字段 值与“系统初始化”中顺序一致。field_1，field_2…，参见[userdefined子元素]

goods_imgs

N

Object

商品图集，第一张图为商品首图。

delete_imgs

N

Object

需要删除的图片。

content

N

String

详细描述 若有图片，需图片应该是可互联网访问的或经过base64加密的

orderNum

N

Int

排序权重 系统排序值，默认500，最小0。排序优先级：系统排序值-->商品录入系统时间

librarydown

N

String

库存下限 默认0

libraryup

N

String

库存上限 默认0

librarysafe

N

String

安全库存 默认0

count

N

String

热度 默认0

keywords

N

String

关键字 格式：多个关键字用空格分离，比如：三星 苹果 索尼

multi

N

Object

商品多规格档案 默认不填写，若该字段有数据，则至少有一个规格。系统中支持两个规格，参见[multi子元素]

subtitle

N

String

商品营销子标题

middle_unit_whole_price

N

Float

中单位订货价

big_unit_whole_price

N

Float

大单位订货价

middle_units

N

String

中单位

middle_barcode

N

String

中单位条码

base2middle_unit_rate

N

Float

小单位转中单位换算关系

commendid

N

String

商品类型标签，new：新品；recommend：推荐；hot：热销；gift：赠品；如果要指定多个标签，用英文逗号隔开，例如：new,recommend,hot,gift，传空则会删除标签

userdefined参数  最多支持6个自定义字段

参数名称

是否必须

类型

描述

field_1

N

String

自定义字段

field_2

N

String

自定义字段

field_3

N

String

自定义字段

field_4

N

String

自定义字段

field_5

N

String

自定义字段

field_6

N

String

自定义字段

multi子元素

参数名称

是否必须

类型

描述

multiFirst

N

String

子规格GUID，ERP唯一编号。若启用了多规格，则该字段必填

multiSecond

N

String

子规格GUID，ERP唯一编号。存在则填写

barcode

N

String

子规格商品条形码（小单位）

whole

N

Float

规格小单位订货价

selling

N

Float

市场价

purchase

N

Float

进货价

optionsGoodsNum

N

String

规格商品编码，如果传了就以这个值为规格商品编码，否则以默认规则生成

middle_unit_whole_price

N

Float

规格中单位订货价

big_unit_whole_price

N

Float

规格大单位订货价

options_middle_barcode

N

String

规格中单位条形码

options_big_barcode

N

String

规格大单位条形码

goods_imgs子元素

参数名称

是否必须

参数类型

参数说明

resource_id

N

Int

资源Id,传入resource_id将更新对应的图片信息，没有传入resource_id的记录为新增图片。

file_name

Y

String

图片完整路径，如：https://img.dhb168.com/1/2/3/4.png

order_num

N

Int

图片排序值，如：1.

delete_imgs子元素

参数名称

是否必须

参数类型

参数说明

resource_id

N

Int

需要删除的资源Id
入参示例:
{
    "f":"updateProduct",
    "v":{
        "sKey":"2328a84d56fcfa89b1fdb688fc435c45",
        "body":[
            {
                "guid":"2020050701",
                "name":"测试商品1",
                "coding":"2020050701",
                "price1":11.11,
                "units":"只",
                "conversionnumber":12,
                "stockGuid":"beijing",
                "siteID":6,
                "brandID":"00001",
                "goods_allocation":"xxmm",
                "model":"1*12",
                "barcode":"aaaaaa",
                "conversion_barcode":"bbbbbb",
                "price2":12.05,
                "price3":10.08,
                "bigunits":"箱",
                "package":1,
                "minorder":"base_units",
                "goodsWeight":0.65,
                "content":"商品详细描述信息………………",
                "orderNum":1,
                "librarydown":0,
                "libraryup":0,
                "librarysafe":0,
                "count":0,
                "keywords":"测试",
                "subtitle":"测试",
                "middle_unit_whole_price":60,
                "big_unit_whole_price":100,
                "middle_units":"打",
                "middle_barcode":"ccccccc",
                "base2middle_unit_rate":6,
                "userdefined":{
                    "field_1":"自定义字段1",
                    "field_2":"自定义字段2",
                    "field_3":"自定义字段3",
                    "field_4":"自定义字段4",
                    "field_5":"自定义字段5",
                    "field_6":"自定义字段6"
                },
                "multi":[
                    {
                        "multiFirst":"0002",
                        "multiSecond":"1002",
                        "barcode":"base_00021002",
                        "whole":11.11,
                        "selling":12.12,
                        "purchase":10.1,
                        "optionsGoodsNum":"00021002",
                        "middle_unit_whole_price":61.61,
                        "big_unit_whole_price":101.1,
                        "options_middle_barcode":"middle_00021002",
                        "options_big_barcode":"big_00021002"
                    },
                    {
                        "multiFirst":"0002",
                        "multiSecond":"1003",
                        "barcode":"base_00021003",
                        "whole":11.12,
                        "selling":12.13,
                        "purchase":10.2,
                        "optionsGoodsNum":"00021003",
                        "middle_unit_whole_price":61.62,
                        "big_unit_whole_price":101.2,
                        "options_middle_barcode":"middle_00021003",
                        "options_big_barcode":"big_00021003"
                    },
                    {
                        "multiFirst":"0003",
                        "multiSecond":"1003",
                        "barcode":"base_00031003",
                        "whole":11.13,
                        "selling":12.14,
                        "purchase":10.3,
                        "optionsGoodsNum":"00031003",
                        "middle_unit_whole_price":61.63,
                        "big_unit_whole_price":101.3,
                        "options_middle_barcode":"middle_00031003",
                        "options_big_barcode":"big_00031003"
                    }
                ]
            }
        ]
    }
}
返参

参数名称

类型

描述、 返回字段

rStatus

INT

100：正常，其他：异常

message

String

信息描述

rData

Object

具体信息
返参示例:
{
    "rStatus": 100,
    "message": "success",
    "rData": []
}

Back to top