当前位置： 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

货品备注

货品自定义属性1

prop1

String

255

N

货品自定义属性1

货品自定义属性2

prop2

String

255

N

货品自定义属性2

货品自定义属性3

prop3

String

255

N

货品自定义属性3

货品自定义属性4

prop4

String

255

N

货品自定义属性4

货品自定义属性5

prop5

String

255

N

货品自定义属性5

货品自定义属性6

prop6

String

255

N

货品自定义属性6

是否自动创建品牌和分类

auto_create_bc

bool

1

N

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

单品信息列表


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

Int

6

N

有效期天数

最佳销售天数

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

prop1

String

255

N

单品自定义属性1

单品自定义属性2

prop2

String

255

N

单品自定义属性2

单品自定义属性3

prop3

String

255

N

单品自定义属性3

单品自定义属性4

prop4

String

255

N

单品自定义属性4

单品自定义属性5

prop5

String

255

N

单品自定义属性5

单品自定义属性6

prop6

String

255

N

单品自定义属性6

自定义价格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

辅助单位名称

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#

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"
            }
        ]
    }
}



常用工具