API文档

goods.Goods.push（货品推送）

¥标准

1.接口说明

1.1 接口描述：①推送货品资料给ERP ②更新ERP货品档案资料

1.2 适用版本：客户端 V1.5.7.2及以上版本

1.3注意事项：

（1）该接口是pushGoods的替代接口. 接口以goods_no和spec_no来匹配货品和单品, 所以如果接口传入已经存在的goods_no或spec_no的时候对应的操作是修改操作。

（2）spu维度一次只能推一条，一个货品可以推送多条明细

2.调用场景

2.1 举例说明：自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明 3.1 请求地址

环境	HTTP地址
测试环境	http://47.92.239.46/openapi
正式环境	http://wdt.wangdian.cn/openapi

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	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	是	签名

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
货品信息	goodsInfo	Map<String,Object>		是	货品信息
单品信息列表	specInfoList	List<Map<String, Object>>		是	规格信息列表

名称

字段

类型

长度

必须

描述

货品信息

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	辅助单位名称
保质期计算方式	validity_type	Int	4	N	保质期计算方式 0：按天 1：按月默认0

4.响应参数

名称	字段	类型	必须	描述
状态码	status	Int	是	0表示成功推送。
货品id	data	Int	否	调用成功返回货品id,调用失败不返回该字段
返回信息	message	String	否	如果创建/修改成功message内容为空,否则为错误信息

名称

字段

类型

长度

必须

描述

状态码

status

Int

是

0表示成功推送。

货品id

data

Int

否

调用成功返回货品id,调用失败不返回该字段

返回信息

message

String

否

如果创建/修改成功message内容为空,否则为错误信息

5.请求示例

[{
"goods_no": "testGoodsQ03-26 00:51:10_0",
"goods_name": "testGoodsNameQ03-26 00:51:10_0",
"short_name": "shortName",
"auto_create_bc": true,
"class_name": "新建分类3",
"brand_name": "新建品牌3",
"unit_name": "个",
"aux_unit_name": "件",
"goods_type": 1,
"alias": "alias",
"pinyin": "ceshi",
"origin": "内蒙古呼和浩特市",
"remark": "货品备注",
"prop1": "P1",
"prop2": "P2",
"prop3": "P13",
"prop4": "P14",
"prop5": "P15",
"prop6": "P16",
"flag_name": "g_f"
},
[{
"spec_no": "spec_noQ03-26 00:51:10_0_0",
"spec_name": "spec_nameQ03-26 00:51:10_0_0",
"spec_code": "spec_code",
"barcode": "spec_noQ03-26 00:51:10_0_0",
"pack_score": 12,
"lowest_price": 200,
"unit_name": "个",
"aux_unit_name": "10个",
"remark": "单品备注",
"is_single_batch": 1,
"goods_label": "6"
}, {
"spec_no": "spec_noQ03-26 00:51:10_0_1",
"spec_name": "spec_nameQ03-26 00:51:10_0_1",
"spec_code": "spec_code",
"barcode": "spec_noQ03-26 00:51:10_0_1",
"pack_score": 12,
"lowest_price": 200,
"unit_name": "个",
"aux_unit_name": "10个",
"remark": "单品备注",
"is_single_batch": 1,
"goods_label": "6"
}, {
"spec_no": "spec_noQ03-26 00:51:10_0_2",
"spec_name": "spec_nameQ03-26 00:51:10_0_2",
"spec_code": "spec_code",
"barcode": "spec_noQ03-26 00:51:10_0_2",
"pack_score": 12,
"lowest_price": 200,
"unit_name": "个",
"aux_unit_name": "10个",
"remark": "单品备注",
"is_single_batch": 1,
"goods_label": "6"
}, {
"spec_no": "spec_noQ03-26 00:51:10_0_3",
"spec_name": "spec_nameQ03-26 00:51:10_0_3",
"spec_code": "spec_code",
"barcode": "spec_noQ03-26 00:51:10_0_3",
"pack_score": 12,
"lowest_price": 200,
"unit_name": "个",
"aux_unit_name": "10个",
"remark": "单品备注",
"is_single_batch": 1,
"goods_label": "6"
}]]

<?php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
require_once('wdtsdk.php');
  
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret");
  
$goodListNum = 2;
$specListNum = 4;
$editValue = "Q";
  
$goodsList = array();
  
//for ($i = 0; $i < $goodListNum; $i++) {
$i = 0;
$goods = new stdClass();
$goodsSuffix = $editValue.$dateStr."_".$i;
$goods->goods_no = "testGoods".$goodsSuffix;
$goods->goods_name = "testGoodsName".$goodsSuffix;
$goods->short_name = "shortName";
$goods->auto_create_bc = true;
$goods->class_name = "新建分类3";
$goods->brand_name = "新建品牌3";
$goods->unit_name = "个";
$goods->aux_unit_name = "件";
//$goods->cycle_name = "无";
$goods->goods_type = 1;
  
$goods->alias = "alias";
$goods->pinyin = "ceshi";
$goods->origin = "内蒙古呼和浩特市";
$goods->remark = "货品备注";
$goods->prop1 = "P1";
$goods->prop2 = "P2";
$goods->prop3 = "P13";
$goods->prop4 = "P14";
$goods->prop5 = "P15";
$goods->prop6 = "P16";
$goods->flag_name = 'g_f';
  
$specList = array();
for ($y = 0; $y < $specListNum; $y++) {
$specSuffix = $goodsSuffix."_".$y;
  $spec = new stdClass();
$spec->spec_no = 'spec_no'.$specSuffix;
$spec->spec_name = 'spec_name'.$specSuffix;
$spec->spec_code = 'spec_code';
$spec->barcode = $spec->spec_no;
 
$spec->pack_score = 12.0000;
$spec->lowest_price = 200.0000;
$spec->unit_name = '个';
$spec->aux_unit_name = '10个';
$spec->remark = '单品备注';
$spec->is_single_batch = 1;
$spec->goods_label = 6;
array_push($specList, $spec);
} 
$response = $client->call("goods.Goods.push ", $ goods, $ specList);
  
?>

<br>

6.响应示例

6.1 正常响应示例

JSON

{
    "status": 0,
    "data": 54645
}

6.2 异常响应示例

JSON

{
"status": 100,
"message": "商家编码已存在"
}