当前位置： API文档

goods.Goods.queryWithSpec（货品档案查询）

¥标准

1.接口说明

1.1 接口描述：获取ERP的货品档案资料
1.2 适用版本：客户端 V1.6.0.7及以上版本
1.3 增量获取：支持
1.4 时间跨度：start_time和end_time最大跨度为30天

1.5注意事项：开始时间和结束时间是 货品 或 单品 最后修改时间的范围
【权限校验】：品牌权限（旺店通客户端-采购-采购权限管理界面控制品牌权限）

2.调用场景

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

3.请求参数说明

   3.1 请求地址

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

  3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是卖家账号, 由旺店通分配
接口账号keyString
是由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
盐saltString
是由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
是调用的接口名称
版本号vString
是1.0
秒级时间戳timestampint
是秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
是签名
分页大小page_sizeint
否分页大小，分页查询必传
分页编号page_noint
否分页编号，分页查询必传，标准接口page_no从0开始
是否计算查询结果的总条数calc_totalint
否是否计算查询结果的总条数, 需要计算则1, 否则填0         

   3.3 业务请求参数

名称字段类型长度
必须描述

查询参数

params

Map<String, Object>


是

查询参数

分页

pagerPager
是分页

params

名称字段类型长度
必须描述

商家编码

spec_no

String

40否

商家编码（如果不传时间，则spec_no和goods_no必须传一个）

货品编号goods_noString40否货品编号
品牌名称

brand_name

String

64
否

品牌名称

分类名称

class_name

String

100否

分类名称

条码barcodeString50否条码
是否隐藏已删除的货品。hide_deletedboolean1否0:返回全部;1:隐藏已删除   默认隐藏
开始时间start_timeString40否起始修改时间    最大跨度为30天
结束时间end_timeString40否

结束修改时间, 不填默认为当前时间   最大跨度为30天

pager

名称字段类型长度
必须描述
分页大小page_sizeInt4否分页大小
页号page_noInt4否

从0开始

4.响应参数

名称字段类型长度
必须描述
状态码statusInt
是

状态码,0表示正常

错误信息messageString
是

无错误信息不返回

货品数据data

Map<String, Object>


是货品相关数据

data

名称字段类型长度
必须描述

货品数据

goods_list

List<Map<String, Object>>


是

货品数据

总数

total_count

Int

11是

查询条件总单据数

goods_list

名称字段类型长度
必须描述
货品id

goods_id

Int
是唯一键
货品编号

goods_no

String40是货品编号
货品名称goods_nameString255是货品名称
货品简称short_nameString255是货品简称
货品别名aliasString255是货品别名
货品类别goods_typeint4是

货品类别

0：其它

1：销售货品

2：原材料

3：包装物

4：周转材料

5：虚拟商品

6：固定资产

8：分装箱

9：周期送货品

10：赠品

规格数spec_countInt11是规格数
品牌名称brand_nameString64是品牌名称
品牌idbrand_idInt11是品牌id
备注remarkString512是备注
自定义属性1prop1String255是自定义属性1
自定义属性2prop2String255是自定义属性2
自定义属性3prop3String255是自定义属性3
自定义属性4prop4String255是自定义属性4
自定义属性5prop5

String

255是自定义属性5
自定义属性6

prop6

String

255是自定义属性6
自定义属性7

prop7

String

255是自定义属性7
自定义属性8

prop8

String

255是自定义属性8
自定义属性9

prop9

String

255是自定义属性9
自定义属性10

prop10

String

255是自定义属性10
自定义属性11

prop11

String

255是自定义属性11
自定义属性12

prop12

String

255是自定义属性12
自定义属性13

prop13

String

255是自定义属性13
自定义属性14

prop14

String

255是自定义属性14
自定义属性15

prop15

String

255是自定义属性15
自定义属性16

prop16

String

255是自定义属性16
自定义属性17

prop17

String

255是自定义属性17
自定义属性18

prop18

String

255是自定义属性18
自定义属性19

prop19

String

255是自定义属性19
自定义属性20

prop20

String

255是自定义属性20
产地
origin

String

64是产地
分类名称class_name

String

64是分类名称
分类IDclass_idint
是分类ID主键
基本单位unit_name

String

20是基本单位
辅助单位aux_unit_name

String

20是辅助单位
标记名称flag_name

String

32是标记名称
货品已删除deleted

Int

11是0代表未删除   大于0代表已删除
最后修改时间goods_modifiedString40是最后修改时间
创建时间goods_createdString40 是

创建时间, 时间格式 YYYY-MM-DD HH:MM:SS

最后修改时间modifiedString40 是

最后修改时间，格式：yyyy-MM-dd HH:mm:ss

品牌编号brand_noString64是

品牌编号

水洗标washing_labelString20是

水洗标

基本单位id

unit

Int11是

基本单位id

辅助单位id

aux_unit

Int11是

辅助单位id

标记id

flag_idInt11是

标记id

单品信息详情spec_listList<Map<String, Object>>
是单品信息详情

spec_list

名称字段类型长度
必须描述
货品idgoods_idInt
是货品唯一键
单品idspec_idInt
是单品唯一键
商家编码spec_noString80是商家编码
规格码spec_codeString40是规格码
主条码barcodeString50是主条码
规格名称spec_nameString100是规格名称
最低价lowest_priceDecimal(19,4)
是最低价
零售价retail_priceDecimal(19,4)
是零售价
批发价wholesale_priceDecimal(19,4)
是批发价
会员价member_priceDecimal(19,4)
是会员价
市场价market_priceDecimal(19,4)
是市场价
有效期天数validity_daysInt11是有效期天数
最佳销售天数sales_daysInt11是最佳销售天数
最佳收货天数receive_daysInt11是最佳收货天数

重量(kg)

weightDecimal(19,4)
是

重量(kg)

长(cm)

lengthDecimal(19,4)
是

长(cm)

宽(cm)


widthDecimal(19,4)
是

宽(cm)

高(cm)

heightDecimal(19,4)
是

高(cm)

启用序列号sn_typeInt4是

启用序列号(原is_sn_enable)  0:未启用  1:已启用

允许低于成本价is_lower_costboolean1是

允许低于成本价

true：是

false：否

航空禁运is_not_use_airInt1是航空禁运
仓库流程wms_process_maskint
4是

默认0：无仓库流程

（需要的仓库流程相加）

2：无需验货 

8：需要质检 

16：无需拣货

32：无需唯一码

64：无需自动打印吊牌

128：不计结构
256：电子面单不打印
512：不计绩效
1024：管理克重
2048：退货入库不校验

税率tax_rateDecimal(19,4）
是税率 (该字段已在客户端停止维护入口，仅支持历史已配置数据的查询。

如需获取最新税率信息，请改用 tax_code 字段。)

拆分large_typeint4是

大件类别

0、 普通件

1、 普通大件（可与非大件一起发）

2、 独立大件（不可和小件一起发）

3、按箱规拆分

      -1、非单发件

货品标签goods_labelString255是货品标签，多个标签用英文逗号隔开
货品已删除deletedint11
是0代表未删除  大于0代表已删除
备注remarkString512是备注
最后修改时间spec_modified

int

40
是最后修改时间
创建时间spec_createdString40是

创建时间, 时间格式 YYYY-MM-DD HH:MM:SS

自定义属性1prop1String255是自定义属性1
自定义属性2prop2String255是自定义属性2
自定义属性3prop3String255是自定义属性3
自定义属性4prop4String255是自定义属性4
自定义属性5prop5String255是自定义属性5
自定义属性6prop6String255是自定义属性6
自定义属性7

prop7

String

255是自定义属性7
自定义属性8

prop8

String

255是自定义属性8
自定义属性9

prop9

String

255是自定义属性9
自定义属性10

prop10

String

255是自定义属性10
自定义属性11

prop11

String

255是自定义属性11
自定义属性12

prop12

String

255是自定义属性12
自定义属性13

prop13

String

255是自定义属性13
自定义属性14

prop14

String

255是自定义属性14
自定义属性15

prop15

String

255是自定义属性15
自定义属性16

prop16

String

255是自定义属性16
自定义属性17

prop17

String

255是自定义属性17
自定义属性18

prop18

String

255是自定义属性18
自定义属性19

prop19

String

255是自定义属性19
自定义属性20

prop20

String

255是自定义属性20
自定义价格1custom_price1Decimal(19,4）
是自定义价格1
自定义价格2custom_price2Decimal(19,4）
是自定义价格2
图片URLimg_urlString1024是图片URL
基本单位spec_unit_nameString20是基本单位
辅助单位spec_aux_unit_nameString20是辅助单位
税务编码tax_codeString40是税务编码
打包积分pack_score
Decimal(19,4）
是打包积分
拣货积分

pick_score

Decimal(19,4）
是拣货积分
验货积分scan_scoreDecimal(19,4）
是验货积分
单品标记名称spec_flag_nameString32是单品标记名称
条码个数barcode_countInt
是条码个数
销售积分sale_scoreDecimal(19,4）
是销售积分
是否出库不验货

is_not_need_examine

Int
是

是否出库不验货

1：出库不验货

0：出库验货

基本单位id

spec_unit

Int11是

基本单位id

辅助单位id

spec_aux_unit

Int11是

辅助单位id

备注换货货品的换货识别符

exchange_name

String500否

备注换货货品的换货识别符（无值该字段不返回）

备注换货货品的最大限制数量

max_limit_num

Decimal(19,4）
否

备注换货货品的最大限制数量（无值该字段不返回）

更多图片img_more_urlString[]
是单品多张图片的 URL 列表（数组）
条码信息barcode_list

List<Map<String,Object>>


是条码信息，没有时为空数组

barcode_list

名称字段类型长度
必须描述
条码
barcodeString50否条码
类型typeInt4否

货品类型，这里默认为1

是否主条码
is_master
Int
1
否

是否主条码

1：是

0：否·

最后修改时间
modified
String
40
否
最后修改时间，

格式: yyyy-MM-dd HH:mm:ss

5.请求示例

json格式请求报文

[{
"start_time": "2020-01-01 00:00:00",
"end_time": "2020-01-20 00:00:00",
"hide_deleted": 1
}]
PHP
<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");
 
$parMap = new stdClass();
$parMap->start_time = "2020-01-01 00:00:00";
$parMap->end_time = "2020-01-20 00:00:00";
$parMap->hide_deleted=1;
 
 
$pager = new Pager(1, 0, true);
$data = $client->pageCall("goods.Goods.queryWithSpec", $pager, $parMap);
 
?>
JAVA

C#

CURL
curl --location 'http://47.92.239.46/openapi?key=wdtapi3-test2&method=goods.Goods.queryWithSpec&salt=1566006427136280c53ba-14aa-48dd-a36e-1c2dbfb3a17c&sid=wdtapi3&timestamp=448969418&v=1.0&sign=98430717e203684717eacbed0de16ff6&page_no=0&page_size=100&calc_total=1' \
--header 'Content-Type: application/json' \
--data '[{
"start_time": "2020-01-01 00:00:00",
"end_time": "2020-01-20 00:00:00",
"hide_deleted": 1
}]'

6.响应示例

   6.1 正常响应示例 

JSON
{
	"status": 0,
	"data": {
		"goods_list": [{
			"goods_no": "wangdiantong",
			"origin": "",
			"class_id": 7,
			"goods_modified": 1678351062000,
			"remark": "12323213aaa",
			"aux_unit_name": "哒哒哒哒哒",
			"goods_created": "2017-08-06 22:01:20",
			"flag_name": "无",
			"spec_list": [{
				"spec_id": 1,
				"goods_id": 1,
				"spec_no": "wangdiantong",
				"spec_code": "LL ",
				"barcode": "wangdiantong",
				"spec_name": "暂无",
				"lowest_price": 0,
				"retail_price": 234,
				"wholesale_price": 0,
				"member_price": 0,
				"market_price": 0,
				"spec_created": "2017-08-06 22:01:20",
				"validity_days": 0,
				"sales_days": 0,
				"receive_days": 0,
				"weight": 0.2,
				"length": 1,
				"width": 2,
				"height": 3,
				"sn_type": 0,
				"is_lower_cost": false,
				"tax_rate": 0,
				"wms_process_mask": 8,
				"deleted": 0,
				"large_type": 0,
				"remark": "dsfdk;ds123",
				"spec_modified": 1683771314000,
				"prop1": "自定义属性1",
				"prop2": "自定义属性2",
				"prop3": "自定义属性3",
				"prop4": "自定义属性4",
				"prop5": "自定义属性5",
				"prop6": "自定义属性6",
				"img_url": "cos:\/\/IMG135.jpg",
				"is_not_use_air": 0,
				"custom_price1": 0,
				"custom_price2": 0,
				"spec_unit_name": "口",
				"spec_aux_unit_name": "锅",
				"goods_label": "",
				"tax_code": "",
				"barcode_list": [{
					"barcode": "wangdiantong",
					"type": 1,
					"is_master": 1,
					"modified": "2022-08-31 11:18:59"
				}]
			}],
			"alias": "",
			"modified": "2023-03-09 16:37:42",
			"spec_count": 1,
			"class_name": "短袖1",
			"goods_name": "wangdiantong",
			"goods_id": 1,
			"brand_name": "发发拉",
			"prop6": "",
			"prop5": "",
			"prop4": "",
			"brand_id": 2179,
			"prop3": "",
			"prop2": "",
			"unit_name": "箱",
			"prop1": "",
			"pinyin": "",
			"deleted": 0,
			"short_name": "",
			"goods_type": 1
		}],
		"total_count": 1
	}
}

   6.2 异常响应示例

JSON
{
"status": 100,
"message": "参数中必须包含起止时间"
}



常用工具