自定义校验支持外部校验

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

UML图:

输入图片说明
Figure: 输入图片说明

自定义校验配置入口:

每刻报销--设置--智能风控建模--引用外部校验结果,配置对应外部校验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枚举
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-03-16 09:44:53

results matching ""

    No results matching ""

    results matching ""

      No results matching ""