api_goodsspec_push.php(创建平台货品)
¥标准
1.接口说明
1.1 接口描述:在推送销售订单给旺店通ERP之前,需要映射匹配ERP系统单品或者设置同步库存的策略时调用 注:仅支持自有/其他平台店铺 |
1.2 适用版本:网页版 |
1.3 注意事项: ①本接口仅支持ERP内店铺平台类型为“自有”的店铺创建平台货品,货品明细一次不能超过2000条; ②平台货品SPU下多个SKU,规格ID不能为空,并且店铺名+货品ID+规格ID要唯一,SPU和SKU概念介绍,单击这里 |
2.调用场景
3.请求参数说明
3.1 请求地址
环境 | HTTP地址 |
---|
测试环境 | https://openapitest.huice.com/openapi/api_goodsspec_push.php |
正式环境 | https://openapi.huice.com/openapi/api_goodsspec_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 业务请求参数
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
货品节点
| api_goods_info | data
|
| 是 | 请求参数的1级数据节点,包含平台(商城)商品所有属性信息的数据节点,节点下数据字段详见下述“api_goods_info” |
api_goods_info
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
平台ID | platform_id | smallint | 6 | 是 | 详情介绍,单击这里
|
店铺编号 | shop_id | varchar | 20 | 是 | 代表店铺所有属性的唯一编码,用于店铺区分,ERP内支持自定义(ERP店铺界面设置),用于创建指定店铺平台货品数据信息 |
平台货品节点 | goods_list | data[ ]
|
| 是 | 请求参数的2级数据节点,包含平台商品属性信息的数据节点,节点下数据字段详见下述“goods_list” |
goods_list
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
货品ID | goods_id | varchar | 40 | 是 | 平台系统货品主键,和创建原始订单接口中含义相同,是十分重要的字段,SPU和SKU概念介绍,单击这里,(注意:店铺名+货品ID+规格ID要保证唯一) |
规格ID | spec_id | varchar | 40 | 是 | 平台系统货品规格id,SPU和SKU概念介绍,单击这里,(注意:店铺名+货品ID+规格ID要保证唯一) |
货品编码 | goods_no | varchar | 40 | 是 | 平台系统货品SPU码,尽量不要为空,SPU和SKU概念介绍,单击这里 |
规格编码 | spec_no | varchar | 40 | 是 | 平台系统SKU唯一码,SPU和SKU概念介绍,单击这里 |
状态 | status | tinyint | 4 | 是 | 0删除 1在架 2下架 |
货品名称 | goods_name | varchar | 255 | 否 | 平台系统货品名称 |
平台规格码 | spec_code | varchar | 40 | 否 | 平台系统规格编码 |
规格名称 | spec_name | varchar | 100 | 否 | 平台系统规格名称 |
图片url | pic_url | varchar | 255 | 否 | 平台系统图片url |
价格 | price | decimal | 19,4 | 否 | 商品价格 |
平台库存 | stock_num | decimal | 19,4 | 否 | 平台上商品的库存量 |
平台类目 | cid | varchar | 40 | 否 | 平台系统商品所属类目 |
4.响应参数
4.1 公共响应参数
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
错误码 | code | int | 40 | 是 | 状态码:0表示成功,其他表示失败 |
错误原因 | message | varchar | 255 | 是 | 错误原因 |
返回的新增货品个数 | new_count | int | 10
| 是 | 返回的新增货品个数 |
返回的更新货品个数 | chg_count | int | 10
| 是 | 返回的更新货品个数 |
4.2 业务响应参数
errors
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
错误的goods_id | goods_id | varchar | 40 |
| 错误的goods_id |
错误的spec_id | spec_id | varchar | 40 |
|
|
错误信息的描述 | error | varchar | 255 | 否 | 错误信息的描述 |