概述

本文介绍了什么是事务能力，如何接入事务能力，事务接口能力介绍等内容。

名词解释

名称	解释
待办	需要完成的工作事项称为待办。
事务	通过完成一系列的待办以达成目标称为事务，分为简单事务和流程事务。
简单事务	简单的业务，通常需要一人或多人完成相同的待办，如志愿填报、活动报名等。
流程事务	复杂的流程类业务，需要完成多条待办，待办之间存在如串行、并行的关联关系，如入职面试、费用报销等审批流程。
办理记录	将事务中办理待办的记录绘制成一条完整的记录，包括事务的开始时间、结束时间、待办办理人、办理时间、待办状态等。
发起人	创建事务的人。
应办人	被指定执行办理任务的人。
办理人	最终执行办理任务的人。

什么是事务能力

平台提供了一套完整的事务接口能力，将来自不同业务系统的事务集中至一处统一展示，支持两种办理方式（详情办理和快捷办理），提高管理和工作效率。除了将业务系统的事务集中到系统中，还支持同步到钉钉上。

如何接入事务能力

接入方式	描述	接入教程
推模式(推荐)	中台提供接口，由业务方调用接口，将数据推送到中台，实现统一待办展示和状态流转等。	从开放平台接入 从POA接入
拉模式(不推荐)	业务方适配中台数据结构，提供相应的接口，由中台调用接口，实现待办统一展示、处理。	接入说明
页面集成	具备提醒意义的业务，且有完善的前端页面，提供页面地址、获取提醒信息的接口地址，可以将页面集成到平台。 注意：平台使用简约主题时，不支持页面集成方式	页面集成

详情办理

业务方的待办在平台用户端统一展示，但不可以直接操作完成。需要业务方在创建待办时指定应办人并传入业务方的详情页地址，应办人在用户端收到待办，直接跳转到业务方的详情页进行操作。

快捷办理

业务方的待办在平台用户端统一展示，并且可以通过业务方设置的快捷办理按钮进行操作。需要业务方在创建待办时设置快捷办理按钮，执行人在用户端收到待办，可以直接通过按钮进行操作。

事务接口能力介绍

API	说明	简单事务API	流程事务API	旧版API
创建待办	创建一个待办任务。	创建待办	创建待办	创建实例与任务
完成待办	将待办任务更新为已完成。	完成待办	完成待办	-
完成&创建待办	将待办任务更新为已完成，同时创建一个关联的新待办。	-	完成待办	任务办理
转办待办	修改待办任务的应办人。	-	转办待办	转办事务
传阅待办	为被传阅人创建一个只读的待办任务。	-	传阅待办	传阅事务
传阅标记已读	更新被传阅待办任务的阅读状态为已读。	-	传阅标记已读	传阅已读事务
挂起待办	更新待办任务的状态为挂起状态。	-	挂起待办	挂起事务
激活待办	更新待办任务的状态为激活状态。	-	激活待办	激活事务
撤回待办	将待办任务撤回，如有需求可以同时创建一个新待办。	-	撤回待办	撤回事务
终止待办	将待办任务终止。	-	终止待办	终止事务
催办待办	向待办任务的应办人发起催办提醒。	-	催办待办	催办事务
删除待办	将删除待办任务删除。	删除待办	删除待办	删除事务
恢复待办	恢复待办任务。	-	恢复待办	恢复事务
更新事务状态	更新事务的状态。	更新状态	-	-