...
使用场景:企业对于提交表单等,可以对数据进行加密、解密,保障数据存储安全。
接口地址:自建应用申请相关权限,配置接口地址:自建应用申请审批相关权限,配置“审批-更新”接口地址
请求方式: POST
Content-Type:"application/json"
接口描述:调用外部接口进行加密或者解密
应用权限: 数据安全-数据安全 数据集成、审批管理
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必要 | 数据类型 | 备注 |
---|---|---|---|---|---|
approveId | 审批单号 | body | 否 | String | 兔展系统生成的审批单号信息 |
approveThirdId | 第三方系统的审批单号 | body | 是 | String | 审批提交成功后,返回的第三方系统的审批编号 |
...
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注说明 |
---|---|---|---|---|---|
approverNum | 审批员工号 | body | 是 | List<String> | 内部系统的员工号信息 |
approverName | 审批员工姓名 | body | 否 | List<String> | 内部系统的员工号姓名信息 |
nodeStatus | 审批节点状态 | body | 是 | String | 在第三方系统审批完成后,审批单节点的状态信息,分为1未审批(审批中),2审批通过,3审批驳回 |
nodeStatusName | 审批节点状态名称 | body | 否 | String | 在第三方系统审批完成后,审批单节点的状态信息的中文名称,未审批(审批中),审批通过,审批驳回 |
approveOpinion | 审批员工意见 | body | 是 | String | 审批中回复的意见信息 |
approveTime | 审批时间 | body | 是 | Date | 审批的操作时间 |
3、订阅系统默认审批单信息接口
使用场景:企业对于提交表单等,可以对数据进行加密、解密,保障数据存储安全。:使用营销平台里的默认审批功能,用户提交审批、审批步骤到下一个审批节点、审批完成、审批驳回、撤回审批的时候
接口地址:自建应用申请相关权限,配置接口地址:自建应用申请审批相关权限,配置“审批-订阅”接口地址
请求方式: POST
Content-Type:"application/json"
接口描述:调用外部接口进行加密或者解密关键节点调用此接口将审批单信息提交三方
应用权限: 数据安全-数据安全 数据集成、审批管理
注意事项:由于是推送给三方的,兔展并不关心是否成功,不会进行重试
...
参数 | 参数说明 | 类型 | 是否必选 | 备注 |
---|---|---|---|---|
approveId | 第三方审批单号 | String | 是 |
4、三方回传审批信息接口
使用场景:兔展侧提交外部审批单给三方,三方某个审批节点通过或驳回时调用回传兔展侧更新审批单信息。
接口地址:/api/approval/approve/echoThirdPartyApprove
请求方式: POST
Content-Type:"application/json"
接口描述:回传审批单的审批结果,给三方的固定回调接口
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必填 | 数据类型 | 备注说明 |
---|---|---|---|---|---|
approveThirdId | 第三方系统的审批单号 | body | 是 | String | 审批提交成功后,返回的第三方系统的审批编号 |
approveResult | 审批单结果状态 | body | 是 | String | 在第三方系统审批完成后,审批单的状态信息,1审批未结束,2审批完成 |
approveNodeList | 审批节点信息 | body | 是 | ApproveNodeDTO | 会有多个节点信息 |
ApproveNodeDTO
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注说明 |
---|---|---|---|---|---|
approverNum | 审批员工号 | body | 是 | List<String> | 内部系统的员工号信息 |
approverName | 审批员工姓名 | body | 否 | List<String> | 内部系统的员工号姓名信息 |
nodeStatus | 审批节点状态 | body | 是 | String | 在第三方系统审批完成后,审批单节点的状态信息,分为1未审批(审批中),2审批通过,3审批驳回 |
nodeStatusName | 审批节点状态名称 | body | 否 | String | 在第三方系统审批完成后,审批单节点的状态信息的中文名称,未审批(审批中),审批通过,审批驳回 |
approveOpinion | 审批员工意见 | body | 是 | String | 审批中回复的意见信息 |
approveTime | 审批时间 | body | 是 | Date | 审批的操作时间 |
响应参数
参数名称 | 参数说明 | 请求类型 | 类型 | 是否必选 | 备注说明 |
---|---|---|---|---|---|
code | 响应码 | body | String | 是 | 200表成功,其他为异常情况 |
errorCode | 错误码 | body | String | 否 | 错误码 |
msg | 信息 | body | String | 是 | 提示信息 |
data | 数据 | body | T | 否 |
错误码:
code | errorCode | msg | 备注 |
---|---|---|---|
100316 | APPROVAL_THIRD_PARTY_PARAMETER_EMPTY | 三方审批相关请求参数为空 | 必填字段为空,报此错 |
100324 | APPROVAL_RULE_IS_END | 三方审批单已结束 | |
100326 | APPROVAL_THIRD_PARTY_NOT_EXIST | 审批单不存在 |