当前位置： API文档

goods.Goods.batchPush（货品批量推送）

¥标准

1.接口说明

1.1 接口描述：①批量推送货品资料给ERP ②更新ERP货品档案资料
1.2 适用版本：客户端 V1.4.3.2及以上版本
1.3注意事项：spu维度一次不超过50条，一个goodsInfo下sku维度一次不超过500条

2.调用场景

2.1 举例说明：自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/openapi

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是卖家账号, 由旺店通分配
接口账号keyString
是由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
盐saltString
是由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
是调用的接口名称
版本号vString
是1.0
秒级时间戳timestampint
是秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
是签名

   3.3 业务请求参数

名称字段类型长度
必须描述

货品信息

goodsInfo

List<Map<String, Object>>


是

货品信息


goodsInfo

名称字段类型长度
必须描述

货品编号

goods_no

String

40

Y

货品编号

货品名称

goods_name

String

255

Y

货品名称

分类名称

class_name

String

64

N

分类名称,不传或为空则默认为’无’

品牌名称

brand_name

String

64

N

品牌名称, 不传或为空则默认为’无’

基本单位名称

unit_name

String

20

N

基本单位名称, 不传或为空则默认为’无’

辅助单位名称

aux_unit_name

String

20

N

辅助单位名称, 不传或为空则默认为’无’

货品标记名称

flag_name

String

32

N

货品标记名称, 不传或为空则默认为’无’

货品类别

goods_type

Int


4

N

默认0, 

0：其它

1：销售货品

2：原材料

3：包装物

4：周转材料

5：虚拟商品

6：固定资产

8：分装箱

货品简称

short_name

String


255

N

货品简称

货品别名

alias

String


255

N

货品别名

拼音pinyinString


40

N

拼音

产地

origin

String


64

N

产地

货品备注

remark

String


512

N

货品备注

是否自动创建品牌和分类

auto_create_bc

bool

1

N

如果品牌,分类不存在,是否自动创建.不填默认为false

货品自定义属性1prop1String255N货品自定义属性1
货品自定义属性2prop2String255N货品自定义属性2
货品自定义属性3prop3String255N货品自定义属性3
货品自定义属性4prop4String255N货品自定义属性4
货品自定义属性5prop5

String

255N货品自定义属性5
货品自定义属性6

prop6

String

255N货品自定义属性6
货品自定义属性7

prop7

String

255N货品自定义属性7
货品自定义属性8

prop8

String

255N货品自定义属性8
货品自定义属性9

prop9

String

255N货品自定义属性9
货品自定义属性10

prop10

String

255N货品自定义属性10
货品自定义属性11

prop11

String

255N货品自定义属性11
货品自定义属性12

prop12

String

255N货品自定义属性12
货品自定义属性13

prop13

String

255N货品自定义属性13
货品自定义属性14

prop14

String

255N货品自定义属性14
货品自定义属性15

prop15

String

255N货品自定义属性15
货品自定义属性16

prop16

String

255N货品自定义属性16
货品自定义属性17

prop17

String

255N货品自定义属性17
货品自定义属性18

prop18

String

255N货品自定义属性18
货品自定义属性19

prop19

String

255N货品自定义属性19
货品自定义属性20

prop20

String

255N货品自定义属性20

单品信息列表


spec_list

List<Map<String, Object>>



Y


单品信息列表

spec_list

名称字段类型长度
必须描述

商家编码

spec_no

String

40

Y

商家编码

规格码

spec_code

String

40

N


规格码

条码

barcode

String

50

N

条码

规格名称

spec_name

String

100

N

规格名称

仓库流程

wms_process_mask

Int

4

N

默认0 （需要的仓库流程相加）

2、无需验货 8、需要质检 16、无需拣货

32、无需唯一码

64、无需自动打印吊牌

货品标签

goods_label

String

11

N

默认无,可选值:自定义货品标签的名称(参考属性名称编辑页面->货品标签)多个标签使用英文逗号拼接

启用序列号

sn_type

Int

4

N

默认0,0不启用序列号 1强序列号 2弱序列号

最低价

lowest_price

Decimal(19,4)


N

最低价

零售价

retail_price

Decimal(19,4)


N

零售价

批发价

wholesale_price

Decimal(19,4)


N

批发价

会员价

member_price

Decimal(19,4)


N

会员价

市场价

market_price

Decimal(19,4)


N

市场价

有效期天数

validity_days

smallint


N

有效期天数

有效期计算方式

validity_type

int


N

默认0,0按天，1按月

最佳销售天数

sales_days

Int

11

N

最佳销售天数

最佳收货天数

receive_days

Int

11

N

最佳收货天数

重量

weight

Decimal(19,4)


N

重量

高

height

Decimal(19,4)


N

高

长

length

Decimal(19,4)


N

长

宽

width

Decimal(19,4)


N

宽

拆分

large_type

Int

4

N

默认0, 0非大件1普通大件2独立大件（不可和小件一起发) 3按箱规拆分 -1非单发件

自定义价格1

custom_price1

Decimal(19,4)


N

自定义价格1

自定义价格2

custom_price2

Decimal(19,4)


N

自定义价格2

允许低于成本

is_lower_cost

boolean

1

N

默认0,0:不允许,1 允许

图片链接

img_url

String

1024

N

图片链接

单品备注

remark

String

512

N

单品备注

销售积分

sale_score

Decimal(19,4)


N

销售积分

打包积分

pack_score

Decimal(19,4)


N

打包积分

拣货积分

pick_score

Decimal(19,4)


N

拣货积分

分拣积分

sort_score

Decimal(19,4)


N

分拣积分

扫描积分

scan_score

Decimal(19,4)


N

扫描积分

补货积分

supply_score

Decimal(19,4)


N

补货积分

上架积分

shelve_score

Decimal(19,4)


N

上架积分

入库积分

stockin_score

Decimal(19,4)


N

入库积分

质检积分

inspect_score

Decimal(19,4)


N

质检积分

分装积分

packing_score

Decimal(19,4)


N

分装积分

操作积分

operate_score

Decimal(19,4)


N

操作积分

称重积分

weigh_score

Decimal(19,4)


N

称重积分

发货积分

consign_score

Decimal(19,4)


N

发货积分

税务编码

tax_code

String

40

N

税务编码

基本单位名称

unit_name

String

20

N

基本单位名称

辅助单位名称

aux_unit_name

String

20

N

辅助单位名称

辅助箱体积

aux_volume

Decimal(19,4)


N

记录单品按照箱规辅助单位计算出的完整箱规的体积

单品自定义属性1prop1String255N单品自定义属性1
单品自定义属性2prop2String255N单品自定义属性2
单品自定义属性3prop3String255N单品自定义属性3
单品自定义属性4prop4String255N单品自定义属性4
单品自定义属性7prop7String255N单品自定义属性7
单品自定义属性8prop8String255N单品自定义属性8
单品自定义属性9prop9String255N单品自定义属性9
单品自定义属性10prop10String255N单品自定义属性10
单品自定义属性11prop11String255N单品自定义属性11
单品自定义属性12prop12String255N单品自定义属性12
单品自定义属性13prop13String255N单品自定义属性13
单品自定义属性14prop14String255N单品自定义属性14
单品自定义属性15prop15String255N单品自定义属性15
单品自定义属性16prop16String255N单品自定义属性16
单品自定义属性17prop17String255N单品自定义属性17
单品自定义属性18prop18String255N单品自定义属性18
单品自定义属性19prop19String255N单品自定义属性19
单品自定义属性20prop20String255N单品自定义属性20

4.响应参数

名称字段类型长度
必须描述
状态码statusInt
是

0表示成功推送。

返回信息message

String


否如果创建/修改成功message内容为空,否则为错误信息
error_listdata

List<Map<String, Object>>


是
错误信息

error_list

名称字段类型长度
必须描述
货品编号no
String40
是货品编号
错误信息error

String

40
是
错误信息

5.请求示例

json格式请求报文
[
    [
        {
            "goods_no": "testGoodsQ12-26 11:28:14_0",
            "goods_name": "testGoodsNameQ12-26 11:28:14_0",
            "short_name": "shortName",
            "auto_create_bc": true,
            "class_name": "社区团购三级",
            "brand_name": "新建品牌3",
            "goods_type": 1,
            "alias": "alias",
            "pinyin": "ceshi",
            "origin": "内蒙古呼和浩特市",
            "remark": "货品备注",
            "prop1": "P1",
            "prop2": "P2",
            "prop3": "P13",
            "prop4": "P14",
            "prop5": "P15",
            "prop6": "P16",
            "flag_name": "",
            "spec_list": [
                {
                    "spec_no": "spec_noQ12-26 11:28:14_0_0",
                    "spec_name": "spec_nameQ12-26 11:28:14_0_0",
                    "spec_code": "spec_code",
                    "barcode": "spec_noQ12-26 11:28:14_0_0",
                    "is_not_need_examine": 1,
                    "pack_score": 12,
                    "lowest_price": 200,
                    "remark": "单品备注",
                    "sn_type": 1,
                    "retail_price": 1,
                    "wholesale_price": 1,
                    "market_price": 1,
                    "is_single_batch": 1,
                    "custom_price1": 1,
                    "custom_price2": 2
                },
                {
                    "spec_no": "spec_noQ12-26 11:28:14_0_1",
                    "spec_name": "spec_nameQ12-26 11:28:14_0_1",
                    "spec_code": "spec_code",
                    "barcode": "spec_noQ12-26 11:28:14_0_1",
                    "is_not_need_examine": 1,
                    "pack_score": 12,
                    "lowest_price": 200,
                    "remark": "单品备注",
                    "sn_type": 1,
                    "retail_price": 1,
                    "wholesale_price": 1,
                    "market_price": 1,
                    "is_single_batch": 1,
                    "custom_price1": 1,
                    "custom_price2": 2
                }
            ]
        },
        {
            "goods_no": "testGoodsQ12-26 11:28:14_1",
            "goods_name": "testGoodsNameQ12-26 11:28:14_1",
            "short_name": "shortName",
            "auto_create_bc": true,
            "class_name": "社区团购三级",
            "brand_name": "新建品牌3",
            "goods_type": 1,
            "alias": "alias",
            "pinyin": "ceshi",
            "origin": "内蒙古呼和浩特市",
            "remark": "货品备注",
            "prop1": "P1",
            "prop2": "P2",
            "prop3": "P13",
            "prop4": "P14",
            "prop5": "P15",
            "prop6": "P16",
            "flag_name": "",
            "spec_list": [
                {
                    "spec_no": "spec_noQ12-26 11:28:14_1_0",
                    "spec_name": "spec_nameQ12-26 11:28:14_1_0",
                    "spec_code": "spec_code",
                    "barcode": "spec_noQ12-26 11:28:14_1_0",
                    "is_not_need_examine": 1,
                    "pack_score": 12,
                    "lowest_price": 200,
                    "remark": "单品备注",
                    "sn_type": 1,
                    "retail_price": 1,
                    "wholesale_price": 1,
                    "market_price": 1,
                    "is_single_batch": 1,
                    "custom_price1": 1,
                    "custom_price2": 2
                },
                {
                    "spec_no": "spec_noQ12-26 11:28:14_1_1",
                    "spec_name": "spec_nameQ12-26 11:28:14_1_1",
                    "spec_code": "spec_code",
                    "barcode": "spec_noQ12-26 11:28:14_1_1",
                    "is_not_need_examine": 1,
                    "pack_score": 12,
                    "lowest_price": 200,
                    "remark": "单品备注",
                    "sn_type": 1,
                    "retail_price": 1,
                    "wholesale_price": 1,
                    "market_price": 1,
                    "is_single_batch": 1,
                    "custom_price1": 1,
                    "custom_price2": 2
                }
            ]
        }
    ]
]
PHP

JAVA
C#
CURL
curl --location 'http://47.92.239.46/openapi?key=wdtapi3-test2&method=goods.Goods.batchPush&salt=1566006427136280c53ba-14aa-48dd-a36e-1c2dbfb3a17c&sid=wdtapi3&timestamp=448987694&v=1.0&sign=9fc35554db70ae574a11e80320ab924b' \
--header 'Content-Type: application/json' \
--data '[
    [
        {
            "goods_no": "testGoodsQ12-26 11:28:14_0",
            "goods_name": "testGoodsNameQ12-26 11:28:14_0",
            "short_name": "shortName",
            "auto_create_bc": true,
            "class_name": "社区团购三级",
            "brand_name": "新建品牌3",
            "goods_type": 1,
            "alias": "alias",
            "pinyin": "ceshi",
            "origin": "内蒙古呼和浩特市",
            "remark": "货品备注",
            "prop1": "P1",
            "prop2": "P2",
            "prop3": "P13",
            "prop4": "P14",
            "prop5": "P15",
            "prop6": "P16",
            "flag_name": "",
            "spec_list": [
                {
                    "spec_no": "spec_noQ12-26 11:28:14_0_0",
                    "spec_name": "spec_nameQ12-26 11:28:14_0_0",
                    "spec_code": "spec_code",
                    "barcode": "spec_noQ12-26 11:28:14_0_0",
                    "is_not_need_examine": 1,
                    "pack_score": 12,
                    "lowest_price": 200,
                    "remark": "单品备注",
                    "sn_type": 1,
                    "retail_price": 1,
                    "wholesale_price": 1,
                    "market_price": 1,
                    "is_single_batch": 1,
                    "custom_price1": 1,
                    "custom_price2": 2
                },
                {
                    "spec_no": "spec_noQ12-26 11:28:14_0_1",
                    "spec_name": "spec_nameQ12-26 11:28:14_0_1",
                    "spec_code": "spec_code",
                    "barcode": "spec_noQ12-26 11:28:14_0_1",
                    "is_not_need_examine": 1,
                    "pack_score": 12,
                    "lowest_price": 200,
                    "remark": "单品备注",
                    "sn_type": 1,
                    "retail_price": 1,
                    "wholesale_price": 1,
                    "market_price": 1,
                    "is_single_batch": 1,
                    "custom_price1": 1,
                    "custom_price2": 2
                }
            ]
        },
        {
            "goods_no": "testGoodsQ12-26 11:28:14_1",
            "goods_name": "testGoodsNameQ12-26 11:28:14_1",
            "short_name": "shortName",
            "auto_create_bc": true,
            "class_name": "社区团购三级",
            "brand_name": "新建品牌3",
            "goods_type": 1,
            "alias": "alias",
            "pinyin": "ceshi",
            "origin": "内蒙古呼和浩特市",
            "remark": "货品备注",
            "prop1": "P1",
            "prop2": "P2",
            "prop3": "P13",
            "prop4": "P14",
            "prop5": "P15",
            "prop6": "P16",
            "flag_name": "",
            "spec_list": [
                {
                    "spec_no": "spec_noQ12-26 11:28:14_1_0",
                    "spec_name": "spec_nameQ12-26 11:28:14_1_0",
                    "spec_code": "spec_code",
                    "barcode": "spec_noQ12-26 11:28:14_1_0",
                    "is_not_need_examine": 1,
                    "pack_score": 12,
                    "lowest_price": 200,
                    "remark": "单品备注",
                    "sn_type": 1,
                    "retail_price": 1,
                    "wholesale_price": 1,
                    "market_price": 1,
                    "is_single_batch": 1,
                    "custom_price1": 1,
                    "custom_price2": 2
                },
                {
                    "spec_no": "spec_noQ12-26 11:28:14_1_1",
                    "spec_name": "spec_nameQ12-26 11:28:14_1_1",
                    "spec_code": "spec_code",
                    "barcode": "spec_noQ12-26 11:28:14_1_1",
                    "is_not_need_examine": 1,
                    "pack_score": 12,
                    "lowest_price": 200,
                    "remark": "单品备注",
                    "sn_type": 1,
                    "retail_price": 1,
                    "wholesale_price": 1,
                    "market_price": 1,
                    "is_single_batch": 1,
                    "custom_price1": 1,
                    "custom_price2": 2
                }
            ]
        }
    ]
]'

6.响应示例

   6.1 正常响应示例 

JSON
{
    "status": 0,
    "data": {
        "error_list": []
    }
}

   6.2 异常响应示例

JSON
{
    "status": 0,
    "data": {
        "error_list": [
            {
                "error": "单品条数不得超过500条或为空",
                "no": "testGoodsQ12-21 10:52:32_0"
            },
            {
                "error": "单品条数不得超过500条或为空",
                "no": "testGoodsQ12-21 10:52:32_1"
            }
        ]
    }
}



常用工具