待办消息对接-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
重试次数 如果回调失败,重新推送的最大次数

特殊说明

  1. 加密秘钥:每刻在推送数据的时候,会通过加密方式生成签名,并放在请求头中。加签的秘钥暂时不支持修改,管理员可以点击每刻报销的“设置-安全设置-系统安全策略-账号管理”中获取到key和secret
  2. 重试间隔: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 用于通知类型需要实现待办功能(有审批按钮)的单据链接,目前适用于催办
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""