事件产生时机：用户审批或管理员操作导致任务实例状态变化或审批人变化时推送事件，包括：

生成新的待办任务实例
待办任务实例状态发生变化，eg由激活变为挂起/完成/终止，由挂起变为激活，etc
已经生成的待办任务审批人发生改变（相同的task_instance_id再再次发送待办任务事件，但是审批人不同，例如加签、转办场景）
生成新的已完成任务实例（审批留痕记录)

事件

类别	详情
基本	-
事件类型	contract.process_instance.task_change
权限要求	-
推送方式	Webhook

事件体

名称	类型	描述
schema	string	事件模式
header	event_header	事件头
∟ event_id	string	事件 ID
∟ event_type	string	事件类型
∟ create_time	string	事件创建时间戳（单位：毫秒）
∟ token	string	事件 Token
∟ app_id	string	应用 ID
∟ tenant_key	string	租户 Key
event	-	-
∟ event_sequence_id	Long	全局自增序列号
∟ business_key	string	业务系统key
∟ product_code	String	单据来源，eg.contract
∟ process_instance_id	string	流程实例ID
∟ task_instance_id	string	任务实例ID
∟ task_status	string	任务状态 ACTIVATED、SUSPENDED COMPLETED、TERMINATED
∟ node_id	string	节点ID
∟ command_type	string	审批操作类型
∟ assignee_ids	List	审批人IDs，可能为空：没有审批人或审批人不是实际用户; 任务状态为ACTIVATED时,可能有多个审批人，表示任务为竞签模式，有多个审批人。
∟ create_time		任务开始时间
∟ end_time		任务结束时间
∟ task_comment	String	审批意见任务尚未审批、或用户未填写审批意见时为空。

task_status状态枚举值说明

Status	任务状态	说明
ACTIVATED	激活	“激活”状态的任务能够被审批
SUSPENDED	挂起	进入等待节点生成的待办任务状态为“暂存”，“暂存”状态的任务不能被审批，需要进行激活操作。如果没有使用等待节点功能，无需关注。
COMPLETED	完成	“激活”状态的任务在用户审批之后会变成“完成”状态
TERMINATED	终止	终止流程时处于“激活”状态的任务会变成“终止”状态；因用户审批操作“被动结束”的任务会变成“终止”状态。

assignee_ids 字段说明

对于状态为ACTIVATED的任务，assignee_ids列表表示可以审批该任务的审批人；在多人竞签场景下，有多个元素。
对于状态为COMPLETED/TERMINATED的任务，assignee_ids列表表示审批该任务的审批人；在多人竞签场
景下，为进行审批操作的审批人。

多人竞签场景审批人同意

多人竞签节点任务激活事件

当审批实例进入多人竞签节点后，会产生竞签节点任务激活事件：

assignee_ids列表可能有多个元素，每个元素表示一个审批人
多个审批人共用一个任务实例id

示例数据：

{
    "event_sequence_id": "1006418",
    "product_code": "contract",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "business_key": "7171395918258896904#0",
    "task_instance_id": "0b535eca-d096-40bc-b4c3-9f7396bae57f",
    "task_status": "ACTIVATED",
    "node_id": "UserTask_seal_0:2",
    "assignee_ids": [
        {
            "open_id": "ou_a60a04a781b8605208687f211b5079df",
            "union_id": "on_6b5405eeecfa8efb69d35795d565388d1",
            "user_id": "95bbagge"
        },
        {
            "open_id": "ou_9cfa5d63812b033856af8a1d47453c9a",
            "union_id": "on_55clc22048e8a09e462a974ad9f3dib3",
            "user_id": "578abla8"
        }
    ],
    "create_time": "1669803394441",
    "end_time": ""
}

多人竞签节点任务完成事件

当任意一个审批人同意后，该竞签任务实例完成,会产生竞签签节点任务完成事件

assignee_ids列表为实际审批人

示例数据：

{
    "event_sequence_id": "1006517",
    "product_code": "contract",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "business_key": "7171395918258896904#0",
    "task_instance_id": "0b535eca-d096-40bc-b4c3-9f7396bae57f",
    "task_status": "COMPLETED",
    "node_id": "UserTask_seal_0:2",
    "assignee_ids": [
        {
            "open_id": "ou_a60a04a781b8605208687f211b5079df",
            "union_id": "on_6b5405eeecfa8efb69d35795d56388d1",
            "user_id": "95bbagge"
        }
    ],
    "create_time": "1669803394000",
    "end_time": "1669803666527",
    "command_type": "general",
    "task_comment": "盖章通过"
}

多人竞签场景下审批人转办

多人竞签节点任务激活事件

当审批实例进入多人竞签节点后，会产生竞签节点任务激活事件：

assignee_ids列表可能有多个元素，每个元素表示一个审批人
多个审批人共用一个任务实例id

示例数据：

{
    "event_sequence_id": "1006518",
    "product_code": "contract",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "business_key": "7171395918258896904#0",
    "task_instance_id": "6ealf855-fc19-4dfa-b477-66194a0c7dda",
    "task status": "ACTIVATED",
    "node_id": "UserTask_archive_0:3",
    "assignee_ids": [
        {
            "open_id": "ou_a60a04a781b8605208687f211b5079df",
            "union_id": "on_6b5405eeecfa8efb69d35795d563888d1",
            "user_id": "95bbagge"
        },
        {
            "open_id": "ou_9cfa5d63812b033856af8a1d474530c9a",
            "union_id": "on_55c1c22048e8a09e462a974ad9f3dib3",
            "user_id": "578abla8"
        }
    ],
    "create_time": "1669803666561",
    "end_time": ""
}

转办后再次产生的竞签节点任务激活事件及留痕任务完成事件

当任意一个审批人转办后，该竞签任务实例还处于激活状态，但审批人发生变更，会再次产生该竞签节点任务激活事件：

assignee_ids列表为该任务最新审批人列表
审批人之间依然是竞签关系
且会为该审批人生成转办留痕任务，产生留痕任务完成事件。

留痕任务完成事件示例数据：

{
    "event_sequence_id": "1006617",
    "product_code": "contract",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "business_key": "7171395918258896904#0",
    "task_instance_id": "3955fad2-a7ed-4f2d-807e-d58446b64698",
    "task_status": "COMPLETED",
    "node_id": "UserTask_archive_0:3",
    "assignee_ids": [
        {
            "open_id": "ou_a60a04a781b8605208687f211b5079df",
            "union_id": "on_6b5405eeecfa8efb69d35795d56388d1",
            "user_id": "95bbagge"
        }
    ],
    "create_time": "1669803667000",
    "end_time": "1669804054667",
    "command_type": "transfer",
    "task_comment": "转给其他人处理"
}

转办后竞签节点任务激活事件示例数据：

{
    "event_sequence_id": "1006618",
    "product_code": "contract",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "business_key": "7171395918258896904#0",
    "task_instance_id": "6ealf855-fc19-4dfa-b477-66194a0c7dda",
    "task_status": "ACTIVATED",
    "node_id": "UserTask_archive_0:3",
    "assignee_ids": [
        {
            "open_id": "ou_9cfa5d63812b033856af8a1d47453c9a",
            "union_id": "on_55clc22048e8a09e462a974ad9f3d1b3",
            "user_id": "578abla8"
        },
        {
            "open_id": "ou_1574b69bd6ad8b2e790f8bd0ac3e3cb6",
            "union_id": "on_1fd17e7a89af6228a6bfe223531121dc",
            "user_id": "ba2b72c7"
        }
    ],
    "create_time": "1669804054667",
    "end_time": ""
}

多人竞签场景下审批人并加签

多人竞签节点任务激活事件

当审批实例进入多人竞签节点后，会产生竞签节点任务激活事件：

assignee_ids列表可能有多个元素，每个元素表示一个审批人
多个审批人共用一个任务实例id

示例数据：

{
    "event_sequence_id": "1006718",
    "product_code": "contract",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "business_key": "7171395918258896904#0",
    "task_instance_id": "55d8bcd8-0298-4c52-ae7f-ff8f192d56f62",
    "task_status": "ACTIVATED",
    "node_id": "UserTask_approve_0:1",
    "assignee_ids": [
        {
            "open_id": "ou_a60a04a781b8605208687f211b5079df",
            "union_id": "on_6b5405eeecfa8efb69d35795d56388d1",
            "user_id": "95bbagge"
        },
        {
            "open_id": "ou_9cfa5d63812b033856af8ald47453c9",
            "union_id": "on_55c1c22048e8a09e462a974ad9f3d1b3",
            "user_id": "578abla8"
        }
    ],
    "create_time": "1669805642348",
    "end_time": ""
}

加签后的相关事件

当任意一个审批人加签后，该竞签任务实例还处于激活状态 - 需加签人审批，但审批人发生变更，会再次产生该竞签节点任务激活事件：

assignee_ids列表为该任务最新审批人列表，即加签人
且会为该审批人生成加签留痕任务，产生留痕任务完成事件；

为被加签人生成新的待办任务，产生新任务激活事件。

加签留痕任务完成事件示例数据：

{
    "event_sequence_id": "1006817",
    "product_code": "contract",
    "business_key": "7171395918258896904#0",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "task_instance_id": "ble05e02-a743-4a01-b76a-85a0b40b9e4a",
    "task_status": "COMPLETED",
    "node_id": "UserTask_approve_0:1",
    "assignee_ids": [
        {
            "open_id": "ou_a60a04a781b8605208687f211b5079df",
            "union_id": "on_6b5405eeecfa8efb69d35795d56388d1",
            "user_id": "95bbagge"
        }
    ],
    "create_time": "1669805642000",
    "end_time": "1669805865897",
    "command_type": "parallelEndorsement",
    "task_comment": "并加签"
}

新任务激活事件（加签后竞签节点任务激活事件，针对加签人）示例数据：

{
    "event_sequence_id": "1006818",
    "product_code": "contract",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "business_key": "7171395918258896904#0",
    "task_instance_id": "cd380048-1800-41d0-96f5-47401a31a9ae",
    "task_status": "ACTIVATED",
    "node_id": "UserTask_approve_0:1",
    "assignee_ids": [
        {
            "open_id": "ou_1574b69bd6ad8b2e790f8bd0ac3e3cb6",
            "union_id": "on_1fd17e7a89af6228a6bfe223531121dc",
            "user id": "ba2b72c7"
        }
    ],
    "create_time": "1669805865898",
    "end_time": ""
}

加签后竞签节点任务激活事件（原任务针对原审批人）示例数据：

{
    "event_sequence_id": "1006819",
    "product_code": "contract",
    "process_instance_id": "f8669847-7883-4808-a19a-9690fadc73b7",
    "business_key": "7171395918258896904#0",
    "task_instance_id": "55d8bcd8-0298-4c52-ae7f-f8f192d56f62",
    "task status": "ACTIVATED",
    "node_id": "UserTask_approve_0:1",
    "assignee_ids": [
        {
            "open_id": "ou_a60a04a781b8605208687f211b5079df",
            "union_id": "on_6b5405eeecfa8efb69d35795d56388d1",
            "user_id": "95bbagge"
        }
    ],
    "create_time": "1669805865898",
    "end_time": ""
}

其他

对于飞书合同的审批事件(product_code=contract)，事件中的business_key格式
为"contract_id#business_type_code"。
如果需要获取合同的业务参数(合同编号、合同名称、金额等信息)，需要从business_key中截取出contract_id，调用查看合同详情。
如果需要获取更多任务实例、知会相关信息(节点名称、审批操作名称、表单链接)或查询任务实例、知会最新信息，
使用task_instance_id/notice_id与process_instance_id，查询任务实例详情(见"接口API"部分)。

事件体示例

    {
        "schema": "2.0",
        "header": {
                "event_id": "5e3702a84e847582be8db7fb73283c02",
                "event_type": "mdm.vendor.change_v1",
                "create_time": "1608725989000",
                "token": "rvaYgkND1GOiu5MM0E1rncYC6PLtF7JV",
                "app_id": "cli_9f5343c580712544",
                "tenant_key": "2ca1d211f64f6438"
        },
        "event": {
                "event_sequence_id": "2009632",
                "business_key": "7483435892527333701#12",
                "product_code": "contract",
                "process_instance_id": "4c4d8345-b945-4f28-ba09-3ef63f98210b",
                "task_instance_id": "953318f9-fb2a-48bc-b37c-784025c20d2f",
                "task_status": "TERMINATED",
                "status_code": "TERMINATED",
                "node_id": "UserTask_approve_0:1",
                "command_type": "autoEnd",
                "assignee_ids": [
                        7406260943266513191
                ],
                "create_time": "1742373220000",
                "end_time": "1742373470180"
        }
}

审批-待办任务变更

事件

事件体

task_status状态枚举值说明

assignee_ids 字段说明

多人竞签场景审批人同意

多人竞签节点任务激活事件

多人竞签节点任务完成事件

多人竞签场景下审批人转办

多人竞签节点任务激活事件

转办后再次产生的竞签节点任务激活事件及留痕任务完成事件

多人竞签场景下审批人并加签

多人竞签节点任务激活事件

加签后的相关事件

其他

事件体示例