获取预警信息接口

接口说明

接口地址:/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'}]}"
      }
    ]
  }
}

results matching ""

    No results matching ""