当前位置: API文档
goods.Goods.push(货品推送)
1.1 接口描述:①推送货品资料给ERP ②更新ERP货品档案资料 |
1.2 适用版本:客户端 V1.2.5.6及以上版本 |
1.3 增量获取:不支持 |
1.4 时间跨度:start_time和end_time最大跨度为30天 |
1.5注意事项:该接口是pushGoods的替代接口. 接口以goods_no和spec_no来匹配货品和单品, 所以如果接口传入已经存在的goods_no或spec_no的时候对应的操作是修改操作。 |
2.1 举例说明:自研商城、SCM、SRM、财务系统、SAP等系统的对接 |
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/ |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | 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 | 是 | 签名 | |
分页大小 | page_size | int | 否 | 分页大小,分页查询必传 | |
分页编号 | page_no | int | 否 | 分页编号,分页查询必传 | |
是否计算查询结果的总条数 | calc_total | int | 否 | 是否计算查询结果的总条数, 需要计算则1, 否则填0 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
货品信息 | goodsInfo | Map<String,Object> | 是 | 货品信息 | |
单品信息列表 | specInfoList | 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, 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产 0其它 |
简称 | short_name | String | 255 | N | 简称 |
别名 | alias | String | 255 | 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 |
specInfoList | |||||
名称 | 字段 | 类型 | 长度 | 是否必须 | 描述 |
商家编码 | spec_no | String | 40 | Y | 商家编码 |
规格码 | spec_code | String | 40 | Y | 规格码 |
条码 | barcode | String | 50 | N | 条码 |
规格名称 | spec_name | String | 100 | Y | 单品名称 |
仓库流程 | wms_process_mask | Int | 4 | N | 默认0 (需要的仓库流程相加) 2、无需验货 8、需要质检 16、无需拣货 32、无需唯一码 64、无需自动打印吊牌 |
货品标签 | goods_label | String | 11 | N | 默认无,可选值:自定义货品标签的名称(参考属性名称编辑页面->货品标签)多个标签使用英文逗号拼接 |
sn类型 | sn_type | Int | 4 | N | 默认0,0不启用序列号 1强序列号 2弱序列号 |
是否同一批次出库 | is_single_batch | Int | 4 | N | 默认0,0,不启用同一批次,1,使用同一批次 |
最低价 | 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 | 宽度 | |
税率 | tax_rate | Decimal(19,4) | N | 税率 | |
大件类型 | large_type | Int | 4 | N | 默认0, 0非大件1普通大件2独立大件(不可和小件一起发)-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 |
是否允许低于成本 | 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 | 入库积分 | |
质检积分 | inpsect_score | Decimal(19,4) | N | 质检积分 | |
税务编码 | tax_code | String | 40 | N | 税务编码 |
基本单位名称 | unit_name | String | 20 | N | 基本单位名称 |
辅助单位名称 | aux_unit_name | String | 20 | N | 辅助单位名称 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | 是 | 0表示成功推送。 | |
货品id | data | Int | 否 | 调用成功返回货品id,调用失败不返回该字段 | |
返回信息 | message | String | 否 | 如果创建/修改成功message内容为空,否则为错误信息 |
JSON | { "data": 101 } |
JSON | { "status": 100, "message": "商家编码已存在" } |