获取预警信息接口
接口说明
接口地址:/gys/warning-service/integrate/list
接口用途:第三方系统按需获取预警信息
请求方式:POST
请求参数类型:JSON格式
重点说明:
- 时间过滤条件是数据库每条记录的时间戳,不是应用报告的生成时间。
- 每次查询默认查出满足条件的前200条数据,如果第201条及之后的数据的时间戳与第200条相同,则一同查出,一次查询一般是200条数据
- 取下一页数据时需要将上一次请求返回的数据中的maxTimestamp的值给下一次请求链接中的beginTimestamp。
- 数据不包含开始时间但包含结束时间。
请求参数
参数 | 类型 | 必填 | 取值范围(字符长度) | 描述 |
---|---|---|---|---|
syncCode | String | Y | 0-255 | 同步编码 |
beginTimestamp | String | Y | 开始时间, 字符串,时间包含毫秒,格式为yyyyMMddHHmmssSSS, 不能为空 如 20160319101010000,2016年3月19号10点10分10秒000毫秒 |
|
status | Number | N | 0,1 | 预警处理状态, 0(未处理),1(已处理),默认:0 |
types | Array[String] | N | TareException: 车辆皮重异常, LoadMaterialAbnormal: 车辆装料异常 UnloadMaterialAbnormal: 车辆卸料异常 ThroughTimeAbnormal: 车辆进出场异常 RepeatWeight: 重复出场称重异常 bdzcyj: 整车超负差 bdclyj: 材料超负差 MiniConfirmationWarning:确认量异常 ConversionRatioAbnormal:换算系数异常 RepeatPrint:磅单重复打印预警 空:查所有 |
响应数据格式:
字段名称 | 字段说明 | 数据类型 | 是否必填 | 说明 |
---|---|---|---|---|
code | 响应状态码 | Number | Y | 200:处理成功 500:处理失败 |
success | 是否成功 | Boolean | Y | true:成功false:失败 |
data | 响应数据 | Object | Y |
data数据结构如下:
字段名称 | 字段说明 | 数据类型 | 是否必填 | 说明 |
---|---|---|---|---|
beginTimestamp | 此次查询的开始时间 | String | Y | 格式:20160319101010000 |
list | 预警信息列表 | Array[Object] | Y | |
maxTimestamp | 下次查询的开始时间 | String | N | 格式: 20160319101010000 |
endTimestamp | 此次查询的结束时间 | String | N | 格式: 20160319101010000 |
data->list数据结构如下:
字段名称 | 字段说明 | 数据类型 | 是否必填 | 说明 |
---|---|---|---|---|
id | 预警主键id | bigint(20) | Y | 物料预警信息主键id |
projectId | 项目id | bigint(20) | Y | 产生预警的项目id |
triggerDeptName | 项目名称 | String | Y | 产生预警的项目名称 |
bizCode | 业务编码 | String | Y | 收料:RECEIVE_BILL |
guid | 预警guid | String | Y | 预警信息全局唯一标示 |
type | 预警类型 | String | Y | |
typeName | 预警类型名称 | String | Y | |
createTime | 触发时间 | Date | Y | 格式:2021-12-12 12:12:122 |
status | 预警状态 | tinyint(4) | Y | 0:未处理,1:已处理 |
produceChannel | 产生源 | tinyint(4) | Y | 0:云端1:项目端 |
refData | 产生预警的业务数据快照,json的字符串标示形式 | text | Y | 例如:磅单数据。 磅单数据格式参照:【获取磅单接口】 |
refBillGuid | 业务数据guid | String | Y | 例如:磅单guid |
refName | 业务数据名称/编码 | String | Y | 例如:磅单编码 |
refBillId | 业务数据id | bigint(20) | Y | 例如:磅单id |
refBillMaterialUniqId | 业务数据明细行主键id,多个用逗号拼接 | String | Y | 例如:磅单材料行id拼接的字符串 |
refId | 单据id或者单据明细行id,多个引用id用逗号分隔 | String | N | 例如:磅单id或者磅单明细行id |
message | 预警信息 | String | N | 预警文字描述 |
reasonCode | 预警原因code | String | N | |
reason | 预警原因描述 | String | N | |
resultCode | 处理结果code | String | N | |
result | 处理结果描述 | String | N | |
processDate | 处理时间 | Date | N | |
processorName | 处理人 | String | N | |
remark | 备注 | String | N | |
processChannel | 处理源 | tinyint(4) | N | 0:云端1:app端2:项目端4:三方系统 |
updateTime | 最后更新时间 | Date | N | |
extend | 扩展数据 | text | N |
请求数据格式:
{
"syncCode":"xxx"
"beginTimestamp": "20160319101010000",
"status": 0,
"types": [ "ConversionRatioAbnormal" ]
}
成功返回值说明
{
"code": 200,
"success": true,
"data": {
"beginTimestamp": 20160319101010000,
"maxTimestamp": 20160319101010000,
"endTimestamp": 20160319101010000,
"list": [
{
"id": 470728724943360,
"projectId": 1456353,
"triggerDeptName": "花香四季一期",
"bizCode": "RECEIVE_BILL",
"guid": "4635189d-54ca-4c0e-a47c-562f54bc3b38",
"type": "ConversionRatioAbnormal",
"typeName": "合同偏差预警",
"createTime": "2021-12-12 12:12:122",
"refBillGuid": "ae60e252-1338-4058-b636-ad19e55155e7",
"refName": "YS-20220112-JHGTQ5D-001",
"refBillId": 470728721678848,
"refId": 470728721678848,
"refBillMaterialUniqId": "470728722809344,470728722809345",
"message": "圆钢Φ6.5运单数量运单数量为90,吨,实际重量为97.9 吨,合同运行偏差(3%,-3%),实际偏差-5%,换算系数1.2;圆钢Φ18运单数量运单数量为90,吨,实际重量为97.9 吨,合同运行偏差(3%,-3%),实际偏差-5%,换算系数1.2。xx项目,xx供应商",
"reasonCode": "conversion_error",
"reason": "换算系数有误",
"processDate": "2021-06-11 16:16:56",
"processorName": "管理员",
"status": 0,
"refData": "{'BDBH':'BL-20170228YHXMJBZ1-01-0001','GUID':'2ddff2d9-050d-4fc9-97e4-36f95d4bf316','projectName':'xxx项目','GYSMC':'xxx物资有限公司','MZ':12,'PZ':1,'JZ':11,'CPH':'鲁123138','CCSJ':'20170228100645','CPSJ':'20170228100645','BDCL':[{'BDCLID':400001,'CLBM':'181801180103180103001','CLMC':'挂篮模板','JLDW':'匹','HSXS':0.05,'YDSL':220,'YDZL':11,'SJSL':200,'SJZL':10,'SJWC':-9.09,'PCLX':'吨','PCJG':0,'ZC':3,'FZ':-3,'QRL':10,'BDCLYSYJ':[{'LX':'PURCHASE_CONTRACT','DJID':535197949432320,'DSFDJID':'535197902893568','DJMXID':535197950972417,'DSFDJMXID':'535154169925632'}]}],'YSYJ':[{'LX':'WAY_BILL','DJID':535197949432320,'DSFDJID':'535197902893568','DJMXID':535197950972417,'DSFDJMXID':'535154169925632'}]}"
}
]
}
}