目录
使用前提：
账号登录兔展营销云工作台，有“审批管理”菜单，有 审批规则配置 权限；
“数据集成”，自建应用，开通“审批”类型的自建应用权限；
1、提交审批接口
使用场景：提交审批时，所用的规则为外部规则，则调用规则所配置的审批自建应用内的“审批-提交”接口，向三方提交审批单
接口地址：自建应用申请审批相关权限，配置“审批-提交”接口地址
请求方式： POST
请求数据类型
[ "application/xml" ]
响应数据类型
[ Content-Type： "application/json" ]
接口描述：向三方提交外部审批单
应用权限： 数据集成、审批管理
...
参数名称 | 参数说明 | 是否必须 | 数据类型 | 备注 |
|---|---|---|---|---|
code | 返回编码 | 是 | String | 200表成功，其他不通过 |
msg | 返回信息 | 否 | String | 信息提示 |
thirdApproveId | 第三方审批单号，成功必传 | 是 | String | 审批提交成功后，返回的第三方系统的审批编号 |
2、更新审批接口
使用场景：在兔展营销平台审批详情中主动向三方获取外部审批单信息：在兔展营销系统，审批管理-发起的审批-查看-审批查看-审批状态-更新状态 按钮触发 主动向三方获取外部审批单信息。接口2和接口4是互斥的，接口4是外部三方主动回调兔展接口进行更新审批单状态
接口地址：自建应用申请审批相关权限，配置“审批-更新”接口地址
请求方式： POST
请求数据类型
[ "application/xml" ]
响应数据类型
[ Content-Type： "application/json" ]
接口描述：主动更新外部审批单信息
应用权限： 数据集成、审批管理
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必要 | 数据类型 | 备注 |
|---|---|---|---|---|---|
| approveId | 审批单号 | body | 否 | String | 兔展系统生成的审批单号信息 |
| approveThirdId | 第三方系统的审批单号 | body | 是 | String | 审批提交成功后，返回的第三方系统的审批编号 |
...
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | 备注说明 |
|---|---|---|---|---|---|
| approverNum | 审批员工号 | body | 是 | List<String> | 内部系统的员工号信息 |
| approverName | 审批员工姓名 | body | 否 | List<String> | 内部系统的员工号姓名信息 |
| nodeStatus | 审批节点状态 | body | 是 | String | 在第三方系统审批完成后，审批单节点的状态信息，分为1未审批（审批中），2审批通过，3审批驳回1未审批（审批中），2审批通过，3审批驳回，4审批撤销 |
| nodeStatusName | 审批节点状态名称 | body | 否 | String | 在第三方系统审批完成后，审批单节点的状态信息的中文名称，未审批（审批中），审批通过，审批驳回 |
| approveOpinion | 审批员工意见 | body | 是 | String | 审批中回复的意见信息 |
| approveTime | 审批时间 | body | 是 | Date | 审批的操作时间 |
3、订阅系统默认审批单信息接口
使用场景：使用营销平台里的系统默认审批，用户提交审批、审批步骤到下一个审批节点、审批完成、审批驳回、撤回审批的时候，向三方推送审批单信息
接口地址：自建应用申请审批相关权限，配置“审批-订阅”接口地址
请求方式： POST
请求数据类型
[ "application/xml" ]
响应数据类型
[ Content-Type： "application/json" ]
接口描述：关键节点调用此接口将审批单信息提交三方
应用权限： 数据集成、审批管理
注意事项：
1、由于是推送给三方的，兔展并不关心是否成功，不会进行重试
...
参数 | 参数说明 | 类型 | 是否必选 | 备注 |
|---|---|---|---|---|
| approveId | 第三方审批单号 | String | 是 |
4、三方回传审批信息接口
使用场景：兔展侧提交外部审批单给三方，三方某个审批节点通过或驳回时调用此接口回传兔展侧更新审批单信息。：使用前提，有审批-订阅的自建应用权限集。兔展侧提交外部审批单给三方，三方某个审批节点通过或驳回时调用此接口回传兔展侧更新审批单信息。
接口地址：/api/approval/approve/echoThirdPartyApprove
请求方式： POST
请求数据类型
[ "application/json" ]
响应数据类型
[ Content-Type： "application/json" ]
接口描述：回传审批单的审批结果,给三方的固定回调接口
请求头参数
属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
X-Token | string | 是 | 自建应用 accessToken 。 1、获取企业自建应用访问X-Token |
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必填 | 数据类型 | 备注说明 |
|---|---|---|---|---|---|
approveThirdId | 第三方系统的审批单号 | body | 是 | String | 审批提交成功后，返回的第三方系统的审批编号 |
approveResult | 审批单结果状态 | body | 是 | String | 在第三方系统审批完成后，审批单的状态信息，1审批未结束，2审批完成 |
| approveNodeList | 审批节点信息 | body | 是 | ApproveNodeDTO | 会有多个节点信息 |
...
参数名称 | 参数说明 | 请求类型 | 类型 | 是否必选 | 备注说明 |
|---|---|---|---|---|---|
| code | 响应码 | body | String | 是 | 200表成功，其他为异常情况 |
| errorCode | 错误码 | body | String | 否 | 错误码 |
| msg | 信息 | body | String | 是 | 提示信息 |
| data | 数据 | body | T | 否 | boolean类型，true代表操作成功，false代表操作失败 |
错误码：
code | errorCode | msg | 备注 |
|---|---|---|---|
| 100316 | APPROVAL_THIRD_PARTY_PARAMETER_EMPTY | 三方审批相关请求参数为空 | 必填字段为空，报此错 |
| 100324 | APPROVAL_RULE_IS_END | 三方审批单已结束 | |
| 100326 | APPROVAL_THIRD_PARTY_NOT_EXIST | 审批单不存在 |
...