申请单提交接口
说明
该接口用于对已导入的申请单进行提单操作,将暂存状态的申请单提交进入审批流程。
接口限制
10次/秒/企业
注意事项
- 申请单必须存在,否则会校验失败。
- 提单时,会自动执行该单据所配置的审批流程,与员工手动提单相同。
- 在提单时,会正常触发预算占用、费控智能审核、自定义校验等校验。
- 例如预算管控:若为强控,则会提单失败;若为弱控,则提交成功(单据详情内会显示预算弱控提示信息)。
- 例如自定义校验:若错误等级为"ERROR"(错误)、"NEED_REASON"(警告但需填写理由),则会提单失败;其他校验类型,则提交成功(单据详情内会显示校验异常信息)。
接口地址
/api/openapi/receive/application/submit
请求类型
POST
请求参数
参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| formCode |
String |
是 |
单据编码 |
参数样例
{
"formCode": "MK23050266"
}
响应参数
响应参数说明
| 字段 |
字段类型 |
字段说明 |
| code |
String |
返回结果 |
| message |
String |
返回提示 |
| data |
Json |
返回结果 |
| success |
boolean |
是否成功 |
参数样例
- 正常响应参数示例
{
"code": "ACK",
"message": "操作成功",
"data": "MK23050266",
"success": true
}
- 校验异常响应参数示例
{
"code": "NACK",
"message": "申请单不存在",
"data": null,
"success": false
}
- 每刻系统校验异常响应参数示例
当每刻系统的智能审核、多维费控、预算校验异常时会返回失败
| 字段 |
字段类型 |
字段说明 |
| level |
String |
异常级别 |
| targetClassify |
String |
触发校验类型 |
| targetKey |
String |
触发校验的那条数据的Code主键,校验类型为FORM时,该字段为空 |
| ruleClassify |
String |
校验触发的类型 |
| message |
String |
校验信息 |
| needReason |
boolean |
是否需要理由 |
{
"code": "NACK",
"message": "系统校验失败",
"data": [
{
"level": "ERROR",
"targetClassify": "REIMBURSE_EXPENSE",
"targetKey": "CODE01",
"ruleClassify": "BUDGET_MATCH",
"message": "预算组织-打车预算科目 额度870.00 报销10000.00",
"needReason": false
}
],
"success": false
}
修改记录
2026-04-17 新增申请单提单文档