商品查询
- 接口：common/commodities/v2/findByPage
- Method：GET
- 数据格式：json
- 接口说明：根据条件查询商品信息
1、最少有一个属性有值，不支持无条件查询
2、根据时间范围查询，start_datetime、end_datetime为必填字段，时间范围不超过7天
3、返回字段根据配置而定，不配置情况下只返回默认字段
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
| bizId |
String |
业务唯一识别码 |
true |
255 |
| timestamp |
long |
时间戳 |
true |
无 |
| data.page_num |
Integer |
分页页数 (最小1) |
true |
无 |
| data.page_size |
Integer |
分页条数 (最小1， 最大100) |
true |
无 |
| data.start_datetime |
long |
最后更新时间-开始时间(13位数字时间戳) |
true |
13 |
| data.end_datetime |
long |
最后更新时间-结束时间(13位数字时间戳) |
true |
13 |
请求示例
{
"bizId" : "80801fe9-1630-482e-adb7-19a7e3a49fc6",
"timestamp" : 1591260596617,
"data":{
"end_datetime":"1773540174000",
"page_num":1,
"page_size":1,
"start_datetime":"1710468174000"
}
}
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| resCode |
Integer |
响应状态码（见附录） |
| resMsg |
String |
返回信息描述 |
| data.page_num |
Integer |
当前页数 |
| data.total_page |
Integer |
总页数 |
| data.page_size |
Integer |
分页条数 |
| data.total_count |
Integer |
总条数 |
| data.page_info |
Array |
数据结果列表 |
| data.page_info.code |
String |
商品信息唯一编码 |
| data.page_info.tax_commodity_code |
String |
商品税收编码 |
| data.page_info.name |
String |
商品名称 |
| data.page_info.unit_code |
String |
商品单位代码 |
| data.page_info.tax_code |
String |
商品税率 |
| data.page_info.abbreviation |
String |
商品信息的简称 |
| data.page_info.price |
BigDecimal |
商品单价 |
| data.page_info.description |
String |
商品描述信息 |
| data.page_info.specification |
String |
商品的规格型号 |
| data.page_info.enabled_flag |
String |
商品信息是否被启用 |
返回示例
{
"resCode": 200000,
"resMsg": "SUCCESS",
"data": {
"page_size": 1,
"page_num": 1,
"total_count": 7,
"total_page": 7,
"is_first_page": true,
"is_last_page": false,
"page_info": [
{
"code": "code1",
"uniqueKey": "code1",
"name": "商品名称1",
"unit_id": 17,
"unit_code": "02",
"price": 200.00,
"tax_code": "17%",
"tax_code_id": 327,
"description": "商品的描述信息1",
"enabled_flag": "Y",
"deleted_flag": "N",
"abbreviation": "谷物",
"tax_commodity_code": "1010101020000000000",
"specification": "商品的规格型号1"
}
]
}
}