待办消息对接-2.0

一、业务场景

该接口用于主动查询每刻单据流程变更所发送的消息。

注：

• 仅支持旗舰版。
• 暂不支持分期单、还款单。
• 在开发之前，请联系每刻集成做企业配置（创建企业库）。
• 查询待办列表接口返回的数据正序（时间从早到晚）。
• 需在每刻报销-设置-系统集成-回调管理下新增回调接口，选择“单据流程变更通知2.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）为李四的待办转消除任务（代表或签节点等场景该用户不再需要处理任务，用于三方系统的消除任务处理）。
• 拉取数据时，应在列表接口增加入参status=0查询到所有未被处理的任务。在数据分发/入库处理成功后，应调用状态更新接口更新状态为1（发送成功），防止查询到重复数据。

二、环境地址

生产环境地址：https://todo.maycur.com
测试环境地址：http://8.136.253.237:9088

完整请求地址：${对应环境地址}/${对应业务请求地址}
例:调用测试环境鉴权接口:http://8.136.253.237:9088/api/openapi/auth/login

三、鉴权

接口地址

/api/openapi/auth/login

请求类型

POST

请求参数

请求参数说明：

secret加密算法：

secret=DigestUtils.sha256Hex(appSecret（集成注册待办企业库后提供） + ":" + appCode（集成注册待办企业库后提供） + ":" + timestamp（13位毫秒时间戳）);

请求参数示例：

{
  "appCode": "AP3OL****9JPC",
  "secret": "3b2d2dee55f114850ee0*******5b4ca181bbe3666e2b457e",
  "timestamp": "1684490229417"
}

响应数据

响应数据示例：

{
    "code": "200",
    "message": "success",
    "data": {
        "entCode": "EC2012****VN3XQY",
        "appCode": "AP3OL****9JPC",
        "tokenId": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJPUEVOX0FQSSIsImVudENvZGUiOiJFQzIwMTIxMTFPVk4zWFFZIiwiY2x1c3RlckNvZGUiOiJERVgiLCJleHAiOjE2ODI0MjAzNDgsImp0aSI6Im1heWN1cl9qd3RfaWQifQ.Cy3mGXIK4FNaXEGf_l8mTUTzEw3_W8HBYv3yiaz1638"
    }
}

响应参数说明：

后续操作必须将tokenId放入请求header中。

//header
tokenId：tokenId

四、查询待办列表

接口地址

/api/openapi/callback?pageIndex=1&pageSize=100&uuid={uuid}&status={status}&eventTimeStartAt={eventTimeStartAt}&eventTimeEndAt={eventTimeEndAt}&formCode={formCode}}&taskId={taskId}&taskAssignee={taskAssignee}

请求类型

GET

请求参数

请求参数说明：

响应数据

响应数据示例：

{
  "code": "200",
  "message": "请求错误提示信息",
  "data": {
    "total":2,
    "items":[
      {
        "uuid": "1467735365297360896",
        "status": "0",
        "taskId": "a4006583-5659-11ec-9245-d6a1901c2c80",
        "entCode": "EC21051411IKTDZ5",
        "abnormal": false,
        "formCode": "MK21120006",
        "formName": "aa",
        "formType": "PRECONSUME",
        "taskName": "部门负责人",
        "completed": false,
        "coverUser": "15765111190",
        "eventTime": 1638770354697,
        "procInsId": "a37dc7dc-5659-11ec-9245-d6a1901c2c80",
        "submitter": "15765111190",
        "createTime": 1638770354953,
        "formDataCode": "PC2112061BDG7VNK",
        "taskAssignee": "0001",
        "coverUserName": "帅博",
        "eventScenario": "APPROVAL",
        "submitterName": "帅博",
        "taskActionType": "PROCESSING",
        "formSubTypeName": "出差申请单",
        "formSubTypeBizCode": "FT210517XN6L5DS"
      },
      {
        ...
      }
    ]
  }
}

响应参数

响应参数说明：

五、更新待办状态

接口地址

/api/openapi/callback

请求类型

PUT

请求参数：

注意：数组长度最大值为200个，超出时整批失败。

请求参数示例：

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

请求参数说明：

响应参数

响应参数示例：

{
  "code": "200",
  "message": "",
  "data": {
    "items":[  //错误数据集合
      {
        "uuid":"1463898256236810240",
        "message":"请求错误提示信息"
      }
    ]
  }

}

data.items响应参数说明：