待办消息对接-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）为李四的待办转消除任务（代表或签节点等场景该用户不再需要处理任务，用于三方系统的消除任务处理）。

配置参数说明

特殊说明

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,
    "approvedAmount": "100.00"
  },
  "uniqueId": "COT41195248"
}

请求参数说明：

calloutParams结构信息

五、主动查询待办列表

3.0 客户可通过此接口主动查询回调消息

接口地址

GET /api/openapi/callout/v3/query?pageIndex={pageIndex}&pageSize={pageSize}&uuid={uuid}&eventTimeStartAt={eventTimeStartAt}&eventTimeEndAt={eventTimeEndAt}&formCode={formCode}&taskId={taskId}&taskAssignee={taskAssignee}&calloutState={calloutState}&customerProcessStatus={customerProcessStatus}

请求参数

注：uuid / formCode / eventTimeStartAt+eventTimeEndAt 三选一必传（R-4 严格模式）；若都不传返回 CALL_OUT_V3_001 参数错误。

eventTimeStartAt 与 eventTimeEndAt 必须同时 > 0 才生效；任一 ≤ 0 时该过滤条件被忽略（不会生成 1970-01-01 退化区间）。

3.0 字段命名

响应数据示例

{
  "code": "200",
  "message": "success",
  "data": {
    "total": 2,
    "calloutList": [
      {
        "uuid": "COT41195248",
        "entCode": "EC21051411IKTDZ5",
        "taskId": "4ab7e6b6-3797-11ef-b113-0a580af421a3",
        "formCode": "MK24070004",
        "formDataCode": "BX99250316511288327",
        "formType": "REIMBURSE",
        "procInsId": "7b51050e-a06e-11ef-b113-0a580af421a3",
        "taskActionType": "PROCESSING",
        "taskAssignee": "MK002",
        "taskAssigneeName": "张三",
        "submitter": "250065",
        "submitterName": "李四",
        "taskName": "领导审批",
        "calloutState": "COMPLETED",
        "customerProcessStatus": "UNPROCESSED",
        "customerProcessedAt": null,
        "formCompletedAt": null,
        "eventTime": 1721195802088,
        "invokeTime": 1,
        "lastCallTime": 1724000000000,
        "calloutResult": "SUCCESS",
        "returnResult": "{\"success\":true}"
      }
    ]
  }
}

响应字段

六、更新待办状态

接口地址

PUT /api/openapi/callout/v3/update

请求参数

{
  "items": [
    {
      "uuid": "COT41195248",
      "status": "1"
    }
  ]
}

业务规则：

• 全部成功 → data.items 为空
• 部分失败 → data.items 列出失败项（uuid + message）
• 已 SUCCESS 的消息不会被 FAILED 覆盖（R-10）

响应数据示例

{
  "code": "200",
  "message": "success",
  "data": {
    "items": []
  }
}

错误码