API文档

1.接口说明

1.1 接口描述：在ERP内创建货品档案

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_type	tinyint	1	是	货品类别 1销售商品 0其它
货品名称	goods_name	varchar	255	是	货品名称
货品简称	short_name	varchar	255	否	货品简称
品牌	brand_name	varchar	64	否	品牌名称
基本单位	unit_name	varchar	20	否	基本单位
备注	remark	varchar	512	否	备注
辅助单位名称	aux_unit_name	varchar	255	否	辅助单位名称
标记名称	flag_name	varchar	255	否	标记名称
单品节点	spec_list	data[]		是	请求参数的2级数据节点，包含sku所有属性信息的数据节点,节点下数据字段详见下述"spec_list"

spec_list

名称	字段	类型	长度	必须	描述
商家编码	spec_no	varchar	40	是	代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍单击这里
规格码	spec_code	varchar	40	否	规格编码
主条码	barcode	varchar	50	否	主条码
规格名称	spec_name	varchar	100	否	规格名称
基本单位	spec_unit_name	varchar	20	否	基本单位名称
最低价	lowest_price	decimal	19,4	否	最低价 Y用作成本价
图片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_aux_unit_name	varchar	255	否	单品辅助单位名称
备注	spec_remark	varchar	512	否	备注

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	10	否	只有page_no = 0 时，才返回的符合条件的数据总条数，用来分页

4.2 业务响应参数

errors

名称	字段	类型	长度	必须	描述
错误的货品编号	goods_no	varchar	40	是	错误的goods_no
错误信息的描述	error	varchar	255	否	错误信息的描述

goods_push.php（创建货品档案）