Skip to main content

addProduct：批量新增商品档案

入参

参数名称

是否必须

参数类型

参数说明

sKey

Y

String

密钥

body

Y

Object

具体参数

channel

N

Int

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

body

参数名称

是否必须

参数类型

参数说明

guid

Y

String

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

name

Y

String

商品名称 公司下唯一

coding

Y

String

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

price1

Y

Float

订货价

units

Y

String

小单位

conversionnumber

N

Float

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

stockGuid

N

String

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

siteID

N

String

erp商品分类guid

brandID

N

String

erp商品品牌guid

goods_allocation

N

String

货位号

model

N

String

型号

barcode

N

String

小单位条码

conversion_barcode

N

String

大单位条码

price2

N

Float

市场价 若未传递默认0.00

price3

N

Float

进货价 若未传递默认0.00

bigunits

N

String

大单位

package

N

Float

最低定量

minorder

N

String

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

goodsWeight

N

Float

小单位重量 单位 kg

goods_imgs

N

Object

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

userdefined

N

Object

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

content

N

String

详细描述,该字段总长度限制在65535，超过长度将被截取；支持富文本，如图片使用<img src="https://img.dhb168.com/a.jpg"/>;

orderNum

N

Int

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

librarydown

N

Int

库存下限 默认0

libraryup

N

Int

库存上限 默认0

librarysafe

N

Int

安全库存 默认0

count

N

Int

热度 默认0

keywords

N

String

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

multi

N

Object

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

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

小单位转中单位换算关系

putaway

N

String

指定商品上下架状态，F：下架；T：上架；默认T

commendid

N

String

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

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

参数名称

是否必须

参数类型

描述

field_1

N

String

自定义字段1

field_2

N

String

自定义字段2

field_3

N

String

自定义字段3

field_4

N

String

自定义字段4

field_5

N

String

自定义字段5

field_6

N

String

自定义字段6

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子元素

参数名称

是否必须

参数类型

参数说明

file_name

Y

String

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

order_num

N

Int

图片排序值，如：1.
入参示例
{
    "f":"addProduct",
    "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": []
}

rData返参示例：

参数异常：

{
    "rStatus": 101,
    "message": "trouble",
    "rData": {
        "emptyinfo": [
            {
                "message": "guid参数不能为空",
                "data": {
                    "name": "222",
                    "coding": "111",
                    "price1": 2.1,
                    "units": "盒",
                    "conversionnumber": 0,
                    "stockGuid": "6ec92137-fcb8-400f-98c7-6bebc66a6256",
                    "real_siteID": "",
                    "brandID": "",
                    "goods_allocation": "",
                    "model": "",
                    "barcode": "",
                    "conversion_barcode": "",
                    "price2": 2.9,
                    "price3": 0.9,
                    "bigunits": "",
                    "package": 0,
                    "minorder": "",
                    "goodsWeight": 0,
                    "goods_imgs": [],
                    "userdefined": {
                        "field_1": "",
                        "field_2": "",
                        "field_3": "",
                        "field_4": "",
                        "field_5": "",
                        "field_6": ""
                    },
                    "content": "",
                    "orderNum": 0,
                    "librarydown": 0,
                    "libraryup": 0,
                    "librarysafe": 0,
                    "count": 0,
                    "keywords": "",
                    "multi": [],
                    "subtitle": "",
                    "middle_unit_whole_price": 0,
                    "big_unit_whole_price": 0,
                    "middle_units": "",
                    "middle_barcode": "",
                    "base2middle_unit_rate": 0,
                    "putaway": "F",
                    "commendid": "",
                    "product_sid": 1029
                }
            }
        ]
    }
}

业务异常：

{
    "rStatus": 101,
    "message": "trouble",
    "rData": {
        "failed": [
            {
                "message": "该商品已被放置于回收站,可在订货宝恢复或彻底删除该商品后继续操作.",
                "data": {
                    "guid": "910b91a0-eebe-4972-a22b-4179617202c7",
                    "name": "222",
                    "coding": "111",
                    "price1": 2.1,
                    "units": "盒",
                    "stockGuid": "6ec92137-fcb8-400f-98c7-6bebc66a6256",
                    "real_siteID": "21071",
                    "brandID": "",
                    "goods_allocation": "",
                    "model": "",
                    "barcode": "",
                    "price2": 2.9,
                    "price3": 0.9,
                    "package": 0,
                    "minorder": "",
                    "goodsWeight": 0,
                    "goods_imgs": [],
                    "userdefined": [],
                    "content": "",
                    "orderNum": 0,
                    "librarydown": 0,
                    "libraryup": 0,
                    "librarysafe": 0,
                    "count": 0,
                    "keywords": "",
                    "multi": [],
                    "subtitle": "",
                    "putaway": "F",
                    "commendid": "",
                    "product_sid": 1029,
                    "stock_id": "2240"
                }
            }
        ]
    }
}

Back to top