待办消息对接-3.0(回调模式)
一、业务场景
该接口用于接收每刻单据流程变更所发送的回调消息。
注意事项
- 待办转已办数据说明
- 收到的数据为
- 1、taskId=taskId001,taskAssignee=张三,taskActionType=PROCESSING(创建待办);
- 2、taskId=taskId001,taskAssignee=李四,taskActionType=PROCESSING(创建待办);
- 3、taskId=taskId001,taskAssignee=张三,taskActionType=COMPLETED(创建已办);
- 4、taskId=taskId001,taskAssignee=李四,taskActionType=REMOVED(消除待办);
- 收到的数据为
- 接收到的taskId、taskAssignee一致,但taskActionType不一致的任务(如1、3;2、4),其中taskActionType=COMPLETED(3)为张三的待办转已办任务(代表此节点为该用户操作审批,用于三方系统的已办处理),taskActionType=REMOVED(4)为李四的待办转消除任务(代表或签节点等场景该用户不再需要处理任务,用于三方系统的消除任务处理)。
配置参数说明
字段 | 说明 |
---|---|
回调名称 | 自定义 |
回调类型 | 固定选择“单据流程变更通知3.0” |
回调地址 | 回调地址,每刻这边会先验证该url,只有返回的响应为{"success":true},每刻才会认为这是一个正确的url |
请求类型 | Http的请求类型,GET、POST、PUT等 |
超时时长 | 请求的超时时长,默认5000ms |
重试次数 | 如果回调失败,重新推送的最大次数 |
特殊说明
- 加密秘钥:每刻在推送数据的时候,会通过加密方式生成签名,并放在请求头中。加签的秘钥暂时不支持修改,管理员可以点击每刻报销的“设置-安全设置-系统安全策略-账号管理”中获取到key和secret
- 重试间隔:1s 5s 10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m 20m 30m 1h 2h
请求数据
请求数据示例:
{
"calloutParams": {
"serviceType": "PROCESS_CHANGE_NOTIFY_V3",
"procInsId": "4ab6fc3a-3797-11ef-b113-0a580af421a3",
"submitter": "MK001",
"reason": "审批意见",
"departmentCode": "DI35071680841784536",
"coverUserName": "张三",
"taskActionType": "REMOVED",
"sendAuthorizer": false,
"formSubTypeBizCode": "FT210924WRLLWCG",
"formName": "测试事由",
"eventTime": 1721195802088,
"legalEntityName": "测试公司抬头",
"departmentBizCode": "10002",
"departmentName": "WQQ3QQQ",
"formType": "REIMBURSE",
"formSubTypeName": "测试报销单",
"taskAssigneeUserCode": "UI87629314650014752",
"coverUser": "MK001",
"formCode": "MK24070004",
"formDataCode": "BX99250316511288327",
"completed": false,
"taskVersion": 78358206,
"legalEntityBizCode": "ELC21102210QTSWHS",
"legalEntityCode": "ELC21102210QTSWHS",
"abnormal": false,
"entCode": "MK00001",
"eventScenario": "FINANCE_AUDIT",
"taskAssignee": "MK002",
"taskName": "部门主管",
"submitterName": "张三",
"taskId": "4ab7e6b6-3797-11ef-b113-0a580af421a3",
"authorizedPerson": false
},
"uniqueId": "COT41195248"
}
请求参数说明:
字段名 | 类型 | 说明 |
---|---|---|
uniqueId | String | 待办唯一ID |
calloutParams | Json | 回调内容 |
calloutParams结构信息
字段名 | 类型 | 说明 |
---|---|---|
taskId | String | 每刻流程的任务ID(对应sso接口procTaskId) |
entCode | String | 公司编码 |
createTime | long | 从消息队列写入数据库的时间 |
status | String | 消息状态(0.未被推送,1.发送成功,2.发送失败) |
serviceType | String | 回调类型(PROCESS_CHANGE_NOTIFY_V2) |
procInsId | String | 每刻流程的实例ID |
submitter | String | 提交人员工号 |
reason | String | 审批意见、驳回理由、撤回理由 |
formType | String | 单据类型: REIMBURSE(报销单) PRECONSUME(申请单) LOAN(借款单) CONTRACT(合同) PAYMENT(付款单) REPAYMENT(还款单) |
formSubTypeName | String | 单据小类名称,企业自定义 |
formSubTypeBizCode | String | 单据小类编码内码,企业自定义 |
coverUser | String | 报销人员工号、申请人员工号、借款人工号 |
formCode | String | 单据号外码 |
formDataCode | String | 单据号内码 |
coverUserName | String | 报销人员姓名、申请人员姓名、借款人姓名 |
taskActionType | String | 任务类: PROCESSING 创建待办(流程新到达节点后会给处理人发送一条此类型任务) COMPLETED 创建已办(某一任务处理人处理成功后,会发送一条此类型任务) REMOVED 消除待办(或签/管理员审批等场景,其他任务处理人处理成功后,会给其余不再需要处理审批任务人员发送一条此类型任务) 通知类(不支持消除): URGE 催办 需要跳转的可以通过associatedTaskId拼接 COMMENT 评论(无taskId) AT @某人(无taskId) BACK_TO_SUBMITTER 驳回至提单人(无taskId) CC 抄送(无taskId) |
completed | boolean | 单据是否已完成 (只有最后一个已办/消除代办/抄送时,此参数才为true) |
abnormal | boolean | 是否异常流程 |
eventScenario | String | 节点类型: APPROVAL--审批 CASHIER_SETTLE--结算 FINANCE_AUDIT--审核 CC--抄送 SIGN--签收 SHARE_PLATFORM--共享审核节点 SUBMITTER--提单人待处理任务 |
formName | String | 表单名称(事由) |
eventTime | String | 事件发生时间(推送时间) |
taskAssignee | String | 该节点任务的单一处理人员工工号 |
taskName | String | 流程节点名称 |
submitterName | String | 提交人姓名 |
legalEntityName. | String | 单据上所选的公司抬头名称 |
legalEntityBizCode | String | 单据上所选的公司抬头业务编码 |
departmentName | String | 单据上所选的承担部门名称 |
departmentBizCode | String | 单据上所选的承担部门业务编码 |
associatedTaskId | String | 用于通知类型需要实现待办功能(有审批按钮)的单据链接,目前适用于催办 |