当前位置: API文档
goods.Goods.push2(货品推送2)
1.1 接口描述:①推送货品资料给ERP ②更新ERP货品档案资料 |
1.2 适用版本:客户端 V1.4.9.3及以上版本 |
1.3注意事项: (1)接口以goods_no和spec_no来匹配货品和单品, 所以如果接口传入已经存在的goods_no或spec_no的时候对应的操作是修改操作。 (2)spu维度一次只能推一条,一个货品可以推送多条明细 |
2.1 举例说明:自研商城、SCM、SRM、财务系统、SAP等系统的对接 |
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/openapi |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | 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 | 是 | 签名 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
货品信息 | 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, 0:其它 1:销售货品 2:原材料 3:包装物 4:周转材料 5:虚拟商品 6:固定资产 8:分装箱 |
货品简称 | 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 | 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 | 辅助单位名称 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | 是 | 0表示成功推送。 | |
返回信息 | message | String | 否 | 如果创建/修改成功message内容为空,否则为错误信息 | |
货品id | data | Map<String,Object> | 否 | 货品信息 |
data
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
货品id | goods_id | Int | 是 | 货品id | |
货品编号 | goods_no | String | 是 | 货品编号信息 | |
单品信息 | spec_info_list | List<Map<String,Object>> | 是 | 单品信息 |
spec_info_list:
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
单品id | spec_id | Int | 是 | 单品id | |
商家编码 | spec_no | String | 是 | 商家编码 |
JSON | { "data": { "goods_id": 20225796, "goods_no": "testGoodsQ11-21-09-46-14_0", "spec_info_list": [ { "spec_id": 6726, "spec_no": "spec_noQ11-21-09-46-14_0_1" } ] }, "status": 0 } |
JSON | { "data": { "message": "未知错误" }, "status": 100 } |