待办消息如何与第三方APP集成

   工作流中的待办任务，可以采取两种方式和第三方系统进行集成。

第一种：通过API拉取苍穹待办

    在客户的第三方列表界面调用苍穹工作流提供的待办/已办API查询某个人的待办列表，直接格式化融合显示，获取的结果中已经包含了苍穹审批界面的URL,可以直接打开URL进行审批。如果是在移动端进行显示，建议URL参数中增加&device=mob，如果是PC段建议增加参数&device=pc. 

     拉取的方式不在第三方存储数据，数据量较大时，需要分页拉取。此种方式需要做单点登录工作，然后才能调用API拉取数据

    1. 拉取待办API: getToHandleTasksByUserId 

        调用方式：https://ierp.kingdee.com:2024/mainbiz/kapi/app/wf/getToHandleTasksByUserId?body={"start":0,"limit":10,"billno":"test","subject":"test","entityName":"test"}&access_token={access_token}

        参数示例说明：

•  access_token: 某个用户的单点登录之后获取的token，拉取当前用户的待办任务；

•  start/limit：从第几个开始，拉取多少个待办；
  

• billno: 根据单据编号查询；

• subject：根据任务主题查询；

• entityName：根据单据名称进行查询。

        返回值为json，拉取的结果如下图：

    2. 拉取已办任务API: getHandledTasksByUserId

        调用方式：https://ierp.kingdee.com:2024/mainbiz/kapi/app/wf/getHandledTasksByUserId?body={"start":0,"limit":10,"billno":"test","subject":"test","entityName":"test"}&access_token={access_token}{access_token}

        参数示例说明：

• access_token: 某个用户的单点登录之后获取的token，拉取当前用户的待办任务；

• start/limit：从第几个开始，拉取多少个待办；
  

• billno: 根据单据编号查询；

• subject：根据任务主题查询；

• entityName：根据单据名称进行查询。

  
  

        返回值为json，拉取的结果如下图：

    3. 获取待办&已办的数量：getTaskCountByType

       调用方式：https://ierp.kingdee.com:2024/mainbiz/kapi/app/wf/getTaskCountByType?body={"type":"toHandle"}

        参数示例说明：

        type: toHandle表示待办任务数量/handled表示已办任务数量。

        返回