你在什么情况下能用到？

当智书现有的表单校验无法满足业务校验场景时，可以请求外部业务系统的校验API来满足校验需求。
例如：采购单关联的中标供应商金额，是否小于预算余额。采购/预算等其他系统中的业务数据，智书合同侧无法判断，为了避免下游系统人工审阅业务数据，合同审批时被驳回，在提交合同时对提交的表单数据做校验，保证了合同关联的业务数据的有效性和审批效率。

可以帮你解决什么问题？

请求外部系统的API

规定外部系统返回的响应，从响应体中取出报错信息和跳转链接

使用指南

事前准备

开发同学需根据「技术文档」一节的要求，开发相应API

入口

配置API

参考外部数据源的请求体，由流程配置的管理员进行配置
（后续会跟外部数据源请求配置保持一致）

API响应格式

校验API响应的字段格式由智书合同侧定义，为固定格式

字段说明

字段	值类型	示例	说明
success	Boolean	true/false	是否通过校验
code	String	500	错误码，用于研发定位问题
errorMessage	String	采购单金额不能大于预算余额	报错信息，呈现给表单提交人员
errorTitle	String	报错单据查看	报错信息的跳转链接显示按钮
linkUrl	String	http://srm.example.com/ticket?number=procument - 001a	errorTitle 关联的跳转链接，该链接的域名需要联系智书合同运维配置域名白名单
text1	-	-	（此处未提及具体信息，无明确说明）
text2	-	-	（此处未提及具体信息，无明确说明）

默认传递字段

除页面上配置的字段外，还会额外传输一些默认字段。这里总结出来：

字段传输信息

字段名称	含义	传输位置
contractId	合同id	请求体
contractNumber	合同编号	请求体
belongedDepartmentId	合同所属部门id	请求体
applier	申请人id	请求体
submitterUserId	提交人id	- 请求体 - query参数 - 路径参数 - header参数
submitterEmployeeCode	提交人工号	- 请求体 - query参数 - 路径参数 - header参数

示例：

外部校验

你在什么情况下能用到？#

可以帮你解决什么问题？#

使用指南#

事前准备#

入口#

配置API#

API响应格式#

字段说明#

默认传递字段#

字段传输信息#