Skip to content

用户任务状态变更

Tip: 了解事件订阅的使用场景和配置流程,请点击查看 事件订阅概述

事件

当用户任务变更后,推送该用户的任务状态变更消息。

事件类型

attendance.user_task.updated_v1

事件体

名称类型描述
schemastring事件模式
headerevent_header事件头
 ∟event_idstring事件 ID
 ∟event_typestring事件类型
 ∟create_timestring事件创建时间戳(单位:毫秒)
 ∟tokenstring事件 Token
 ∟app_idstring应用 ID
 ∟tenant_keystring租户 Key
event-事件体
 ∟employee_idstring飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID
 ∟employee_nostring飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号
 ∟group_idstring考勤组 ID,可用于按 ID 查询考勤组
 ∟shift_idstring班次 ID,可用于按 ID 查询班次
 ∟dateint日期,格式为yyyyMMdd
 ∟status_changeslist状态变更数组
  ∟before_statusstring变更前打卡结果,值为:【NoNeedCheck(无需打卡),SystemCheck(系统打卡),Normal(正常),Early(早退),Late(迟到),Lack(缺卡)】
  ∟current_statusstring变更后打卡结果,值为:【NoNeedCheck(无需打卡),SystemCheck(系统打卡),Normal(正常),Early(早退),Late(迟到),Lack(缺卡)】
  ∟before_supplementstring变更前结果补充,值为:【None(无),ManagerModification(管理员修改),CardReplacement(补卡通过),ShiftChange(换班),Travel(出差),Leave(请假),GoOut(外出),CardReplacementApplication(补卡申请中),FieldPunch(外勤打卡)】
  ∟current_supplementstring变更后打卡结果补充,值为:【None(无),ManagerModification(管理员修改),CardReplacement(补卡通过),ShiftChange(换班),Travel(出差),Leave(请假),GoOut(外出),CardReplacementApplication(补卡申请中),FieldPunch(外勤打卡)】
  ∟work_typestring上下班状态变更,值为:【on(上班),off(下班)】
  ∟indexstring任务中的第几次上下班
事件示例
json
{
  "schema": "2.0",
  "header": {
    "event_id": "2a0b662d75f87508a016a8da8b225a46",
    "token": "drIibiox5ZEZl5UvuRL3Uf3LNwD0fB6e",
    "create_time": "1615381917559",
    "event_type": "attendance.user_task.updated_v1",
    "tenant_key": "2fce678eb60d1651",
    "app_id": "cli_a0c27934a1f8100b"
  },
  "event": {
    "date": 20210310,
    "employee_id": "2b68933a",
    "employee_no": "",
    "group_id": "6935645428507557915",
    "shift_id": "6938006252085739521",
    "status_changes": [
      {
        "before_status": "Normal",
        "before_supplement": "None",
        "current_status": "Late",
        "current_supplement": "None",
        "index": 1,
        "work_type": "on"
      }
    ],
    "task_id": "6936733176245026817",
    "time_zone": "Asia/Shanghai"
  }
}

内容来源:飞书开放平台 · 自动爬取整理