当前位置: API文档

api_goodsspec_push.php(创建平台货品)

¥标准

1.接口说明

   1.1 接口描述:在推送销售订单给旺店通ERP之前,需要映射匹配ERP系统单品或者设置同步库存的策略时调用    注:仅支持自有/其他平台店铺     
   1.2 适用版本:网页版

   1.3 注意事项:

      ①本接口仅支持ERP内店铺平台类型为“自有”的店铺创建平台货品,货品明细一次不能超过2000条;

      平台货品SPU下多个SKU,规格ID不能为空,并且店铺名+货品ID+规格ID要唯一,SPU和SKU概念介绍,单击这里

2.调用场景

   2.1 调用场景:自研商城对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapitest.huice.com/openapi/api_goodsspec_push.php
正式环境https://openapi.huice.com/openapi/api_goodsspec_push.php

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。
接口账号appkeyString
本开放平台“自助对接”功能模块内自助申请,获取方式点击这里
时间戳timestampint
北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。
签名signString
API输入参数签名结果,签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度
必须描述
货品节点
api_goods_infodata

请求参数的1级数据节点,包含平台(商城)商品所有属性信息的数据节点,节点下数据字段详见下述“api_goods_info”

 api_goods_info

名称字段类型长度
必须描述
平台IDplatform_idsmallint6详情介绍,单击这里
店铺编号shop_idvarchar20代表店铺所有属性的唯一编码,用于店铺区分,ERP内支持自定义(ERP店铺界面设置),用于创建指定店铺平台货品数据信息
平台货品节点goods_listdata[ ]

请求参数的2级数据节点,包含平台商品属性信息的数据节点,节点下数据字段详见下述“goods_list”

   goods_list

名称字段类型长度
必须描述
货品IDgoods_idvarchar40平台系统货品主键,和创建原始订单接口中含义相同,是十分重要的字段,SPU和SKU概念介绍,单击这里,(注意:店铺名+货品ID+规格ID要保证唯一)
规格IDspec_idvarchar40平台系统货品规格id,SPU和SKU概念介绍,单击这里,(注意:店铺名+货品ID+规格ID要保证唯一)
货品编码goods_novarchar40平台系统货品SPU码,尽量不要为空,SPU和SKU概念介绍,单击这里
规格编码spec_novarchar40平台系统SKU唯一码,SPU和SKU概念介绍,单击这里
状态statustinyint40删除 1在架 2下架
货品名称goods_namevarchar255平台系统货品名称
平台规格码spec_codevarchar40平台系统规格编码
规格名称spec_namevarchar100平台系统规格名称
图片urlpic_urlvarchar255平台系统图片url
价格pricedecimal19,4商品价格
平台库存stock_numdecimal19,4平台上商品的库存量
平台类目cidvarchar40平台系统商品所属类目

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint40状态码:0表示成功,其他表示失败
错误原因messagevarchar255错误原因
返回的新增货品个数new_countint10
返回的新增货品个数
返回的更新货品个数chg_countint10
返回的更新货品个数

   4.2 业务响应参数

errors

名称字段类型长度必须描述
错误的goods_idgoods_idvarchar40
错误的goods_id
错误的spec_idspec_idvarchar40

错误信息的描述errorvarchar255错误信息的描述



常用工具