当前位置: API文档
goods_push.php(创建货品档案)
1.接口说明
| 1.1 接口描述:①批量推送货品资料给旺店通ERP②批量更新旺店通ERP货品档案资料(支持已经存在的货品(spu),新增单品(sku),good_list中good_no确定sku新增在哪个货品之下,将新增的spec_no以及对应信息放在spec_list,推送成功以后,sku将新增到对应的货品档案(spu)下。) |
| 1.2 适用版本:网页版 |
1.3 注意事项:更新货品档案时,good_no确认要更新的spu属性信息,good_no+spec_no确认要更新的sku属性信息。更新货品(spu)数据时,good_list中good_no对应的数据做变更,spec_list要包含至少一个已经存在的单品(sku)数据。更新单品(sku)数据时,good_list中good_no对应的数据不变,spec_list中spec_no对应的数据做变更,重新推送成功后,变更部分将会更新到ERP。 支持批量推送数据,每个请求建议包含50条以下的“goods_list”数据;goods_list下的spec_list条数不要超过500条 |
2.调用场景
| 2.1 自研商城、 |
3.请求参数说明
3.1 请求地址
| 环境 | HTTP地址 |
|---|---|
| 测试环境 | https://openapitest.huice.com/openapi/goods_push.php |
| 正式环境 | https://openapi.huice.com/openapi/goods_push.php |
3.2 公共请求参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| 卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
| 接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,申请流程单击这里 | |
| 时间戳 | timestamp | int | 是 | 北京时间1970-01 -01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务 端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
| 签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
3.3 业务请求参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
| 货品节点 | goods_list | data[ ] | 是 | 请求参数的1级数据节点,包含SPU所有属性信息的数据节点,节点下数据字段详见下述“goods_list” |
goods_list
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
| 货品编号 | goods_no | varchar | 40 | 是 | 代表货品(spu)所有属性的唯一编号,用于系统货品区分,,SPU概念介绍,单击这里 |
| 货品名称 | goods_name | varchar | 255 | 是 | 货品名称 |
| 货品简称 | short_name | varchar | 255 | 否 | 货品简称 |
| 品牌 | brand_name | varchar | 64 | 否 | 品牌名称 |
| 备注 | remark | varchar | 512 | 否 | 备注 |
| 自定义属性1 | spu_prop1 | varchar | 255 | 否 | 自定义属性1 |
| 自定义属性2 | spu_prop2 | varchar | 255 | 否 | 自定义属性2 |
| 自定义属性3 | spu_prop3 | varchar | 255 | 否 | 自定义属性3 |
| 自定义属性4 | spu_prop4 | varchar | 255 | 否 | 自定义属性4 |
| 自定义属性5 | spu_prop5 | varchar | 255 | 否 | 自定义属性5 |
| 自定义属性6 | spu_prop6 | varchar | 255 | 否 | 自定义属性6 |
| 单品节点 | spec_list | data[] | 是 | 请求参数的2级数据节点,包含sku所有属性信息的数据节点,节点下数据字段详见下述"spec_list" |
spec_list
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
| 商家编码 | spec_no | varchar | 40 | 是 | 代表单品(sku)所有属性的唯一编码,用于系统单品区分,SKU概念介绍单击这里 |
| 主条码 | barcode | varchar | 50 | 否 | 主条码 |
| 规格名称 | spec_name | varchar | 100 | 否 | 规格名称 |
| 最低价 | lowest_price | decimal | 19,4 | 否 | 最低价 同ref_cost_price作为成本价 |
| 图片url地址 | img_url | varchar | 1024 | 否 | 图片url地址 |
| 零售价 | retail_price | decimal | 19,4 | 否 | 商品标价,系统内手工建单时使用,传值时需谨慎 |
| 批发价 | wholesale_price | decimal | 19,4 | 否 | 批发价 |
| 成本价 | ref_cost_price | decimal | 19,4 | 否 | 成本价 |
| 重量 | weight | decimal | 19,4 | 否 | ERP默认重量单位:kg |
| 长 | length | decimal | 19,4 | 否 | 长(CM) |
| 宽 | width | decimal | 19,4 | 否 | 宽(CM) |
| 高 | height | decimal | 19,4 | 否 | 高(CM) |
| 备注 | spec_remark | varchar | 512 | 否 | 备注 |
| 规格自定义属性1 | prop1 | varchar | 255 | 否 | 规格自定义属性1 |
| 规格自定义属性2 | prop2 | varchar | 255 | 否 | 规格自定义属性2 |
| 规格自定义属性3 | prop3 | varchar | 255 | 否 | 规格自定义属性3 |
| 规格自定义属性4 | prop4 | varchar | 255 | 否 | 规格自定义属性4 |
| 规格自定义属性5 | prop5 | varchar | 255 | 否 | 规格自定义属性5 |
| 规格自定义属性6 | prop6 | varchar | 255 | 否 | 规格自定义属性6 |
| 规格自定义属性7 | prop7 | varchar | 255 | 否 | 规格自定义属性7 |
| 规格自定义属性8 | prop8 | varchar | 255 | 否 | 规格自定义属性8 |
| 规格自定义属性9 | prop9 | varchar | 255 | 否 | 规格自定义属性9 |
| 规格自定义属性10 | prop10 | varchar | 255 | 否 | 规格自定义属性10 |
4.响应参数
4.1 公共响应参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
| 错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
| 错误描述 | message | varchar | 255 | 是 | 错误描述 |
| 处理失败的错误列表 | errors | data | data[] | 否 | 处理失败的错误列表,当code为0且有错误信息时才非空.只列出同一批内有错误的记录.如果code=0,errors为空说明全部成功 |
4.2 业务响应参数
errors
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
| 错误的货品编号 | goods_no | varchar | 40 | 是 | 错误的goods_no |
| 错误信息的描述 | error | varchar | 255 | 否 | 错误信息的描述 |
5.请求示例
6.响应示例
6.1 正常响应示例
| JSON | {"code":0,"message":"","errors":[]} |
6.2 异常响应示例
| JSON | {"code":0,"message":"","errors":[{"goods_no":null,"error":"货品名称不能为空"}]} |