自定义校验支持外部校验
业务场景:
需要在每刻系统-自定义校验模块支持由外部提供的外部校验逻辑。用户提单时,根据配置的外部校验url在前端表单页面展示。
UML图:

自定义校验配置入口:
每刻报销--设置--智能风控建模--引用外部校验结果,配置对应外部校验url即可。
请求参数:
请求示例
{
"formDataCode":"xxxxxxxx",
"formType":"xxxxxx",
"formData":{
}
}
每刻推送的formData字段格式:
详细文档地址:每刻推送的表单数据格式
若validationResult有多条,取第一条的level和targetClassify
targetCode:单据/费用/发票的code
响应参数:
注意事项
- validationResult字段如果为空,则表示校验全部通过,不会提示异常信息。
- validationResult字段如果不为空,则会在页面上提示验证信息,内部的文字内容则在message中进行包裹。
- 若返回多条数据,且targetClassify有多种类型,则取第一条数据的level和targetClassify;若targetClassify都为EXPENSE,则均会返回。
响应示例
{
"success": true,
"errorMsg": "success为false的时候,errormsg返回的报错信息",
"data": {
"validationResult": [
{
"level": "NEED_REASON",
"message": "单据级报错",
"targetClassify": "FORM"
},
{
"level": "NEED_REASON",
"message": "费用级报错",
"targetClassify": "EXPENSE",
"targetCode": "EXPENSECODE"
}
]
}
}
响应参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| success | boolean | 是 | 标记请求是否成功返回。 需返回data.validationResult下信息/响应成功,则返回true; 业务失败/请求异常/需返回errorMsg内信息等返回false。 |
| errorMsg | String | 是 | 当success为false,则必填 |
| data.validationResult | validationResultDto | 否 | 具体异常信息,若success为true,且有值,则以此返参为准 |
validationResultDto参数说明:
| 参数 | 用法含义 |
|---|---|
| level | 异常等级。可选值: ERROR:禁止提交 WARNING:允许提交,仅警告 NEED_REASON:允许提交,但必须填写理由 INFO:允许提交,只记录校验结果 |
| message | 错误信息,level为ERROR/WARNING时必填 |
| targetClassify | 异常类型。FORM:单据;EXPENSE:费用 |
| targetCode | 异常费用code。当targetClassify为EXPENSE时,可以填写每刻费用code,用于异常行定位 |
level:
| 可取值 | 用法含义 |
|---|---|
| ERROR | 禁止提交 |
| WARNING | 允许提交,仅警告 |
| NEED_REASON | 允许提交,但必须填写理由 |
| INFO | 允许提交,只记录校验结果 |
修改记录
2026-02-26 新增level枚举