当前位置: 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 公共请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 卖家账号, 由旺店通分配 | |
接口账号 | key | String | 是 | 由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里 | |
盐 | salt | String | 是 | 由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt. | |
接口名称 | method | String | 是 | 调用的接口名称 | |
版本号 | v | String | 是 | 1.0 | |
秒级时间戳 | timestamp | int | 是 | 秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。 | |
签名 | sign | String | 是 | 签名 |
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 | 货品别名 |
拼音 | pinyin | String | 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_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.响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | 是 | 0表示成功推送。 | |
返回信息 | message | String | 否 | 如果创建/修改成功message内容为空,否则为错误信息 | |
error_list | data | List<Map<String, Object>> | 是 | 错误信息 |
error_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
货品编号 | no | String | 40 | 是 | 货品编号 |
错误信息 | error | String | 40 | 是 | 错误信息 |
5.请求示例
[ [ { "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 } ] } ] ] | |
JAVA | |
C# |
6.响应示例
6.1 正常响应示例
{ "status": 0, "data": { "error_list": [] } } |
6.2 异常响应示例
{ "status": 0, "data": { "error_list": [ { "error": "单品条数不得超过500条或为空", "no": "testGoodsQ12-21 10:52:32_0" }, { "error": "单品条数不得超过500条或为空", "no": "testGoodsQ12-21 10:52:32_1" } ] } } |