| 构造器和说明 |
|---|
Builder() |
| 限定符和类型 | 方法和说明 |
|---|---|
Group.Builder |
adjustRange(Integer adjustRange)
微调范围,默认为 50 米
示例值:50
|
Group.Builder |
allowApplyPunch(Boolean allowApplyPunch)
定位不准时是否允许申请打卡
示例值:true
|
Group.Builder |
allowOutPunch(Boolean allowOutPunch)
是否允许外勤打卡
示例值:true
|
Group.Builder |
allowPcPunch(Boolean allowPcPunch)
是否允许pc打卡
示例值:true
|
Group.Builder |
allowRemedy(Boolean allowRemedy)
是否允许补卡
示例值:true
|
Group.Builder |
allowRemedyTypeEarly(Boolean allowRemedyTypeEarly)
允许早退补卡(需要允许补卡才能设置生效)
示例值:true
|
Group.Builder |
allowRemedyTypeLack(Boolean allowRemedyTypeLack)
允许缺卡补卡(需要允许补卡才能设置生效)
示例值:true
|
Group.Builder |
allowRemedyTypeLate(Boolean allowRemedyTypeLate)
允许迟到补卡(需要允许补卡才能设置生效)
示例值:true
|
Group.Builder |
allowRemedyTypeNormal(Boolean allowRemedyTypeNormal)
允许正常补卡(需要允许补卡才能设置生效)
示例值:true
|
Group.Builder |
antiCheatPunchConfig(AntiCheatConfig antiCheatPunchConfig)
防作弊打卡配置,不传入时默认关闭/不更新(仅灰度租户有效,如需使用请联系技术支持)
示例值:
|
Group.Builder |
bindDefaultDeptIds(String[] bindDefaultDeptIds)
默认出勤的部门id列表
示例值:
|
Group.Builder |
bindDefaultUserIds(String[] bindDefaultUserIds)
默认出勤的用户ID列表
示例值:
|
Group.Builder |
bindDeptIds(String[] bindDeptIds)
绑定的部门 ID(与「need_punch_members」同时使用时,以当前字段为准)。
|
Group.Builder |
bindUserIds(String[] bindUserIds)
绑定的用户 ID(与「need_punch_members」同时使用时,以当前字段为准),对应employee_type
示例值:
|
Group |
build() |
Group.Builder |
calendarId(Integer calendarId)
国家日历 id,(0:不根据国家日历休息, 1:中国,2:美国,3:日本,4:印度,5:新加坡),默认 1
示例值:1
|
Group.Builder |
clockInAbnormalSettings(ClockInAbnormalSettings clockInAbnormalSettings)
异常卡豁免配置
示例值:
|
Group.Builder |
clockInNeedPhoto(Boolean clockInNeedPhoto)
每次打卡均需拍照
示例值:true
|
Group.Builder |
effectNow(Boolean effectNow)
是否立即生效,默认 false
示例值:true
|
Group.Builder |
effectTime(String effectTime)
生效时间,精确到秒的时间戳
示例值:1611476284
|
Group.Builder |
exceptDeptIds(String[] exceptDeptIds)
排除的部门 ID(该字段已下线)
示例值:
|
Group.Builder |
exceptUserIds(String[] exceptUserIds)
参加考勤的人员id列表
示例值:
|
Group.Builder |
faceDowngrade(Boolean faceDowngrade)
脸识别失败时允许普通拍照打卡
示例值:true
|
Group.Builder |
faceLiveNeedAction(Boolean faceLiveNeedAction)
人脸打卡规则, false:开启活体验证 true:0动作验证,仅在 face_punch_cfg = 1 时有效
示例值:true
|
Group.Builder |
facePunch(Boolean facePunch)
是否开启人脸打卡
示例值:true
|
Group.Builder |
facePunchCfg(Integer facePunchCfg)
人脸打卡规则, 1:每次打卡均需人脸识别 2:疑似需要
示例值:1
|
Group.Builder |
fixshiftEffectTime(String fixshiftEffectTime)
固定班次生效时间,精确到秒的时间戳
示例值:1611476284
|
Group.Builder |
freePunchCfg(FreePunchCfg freePunchCfg)
配置自由班制
示例值:
|
Group.Builder |
goOutNeedPunch(Integer goOutNeedPunch)
外出期间是否需打卡,默认为0。
|
Group.Builder |
goOutNeedPunchCfg(LeaveNeedPunchCfg goOutNeedPunchCfg)
请假离岗或返岗打卡规则,单位:分钟
示例值:
|
Group.Builder |
gpsRange(Integer gpsRange)
GPS打卡的地址范围
示例值:300
|
Group.Builder |
groupId(String groupId)
考勤组的Id, 需要从获取用户打卡结果信息的接口中获取groupId,修改考勤组时必填
示例值:6919358128597097404
|
Group.Builder |
groupLeaderIds(String[] groupLeaderIds)
考勤主负责人 ID 列表,必选字段(需至少拥有考勤组管理员权限),对应employee_type
示例值:
|
Group.Builder |
groupName(String groupName)
考勤组名称
示例值:开心考勤
|
Group.Builder |
groupType(Integer groupType)
考勤类型 0:固定考勤 2:排班考勤, 3:自由班次
示例值:0
|
Group.Builder |
hideClockInRule(Boolean hideClockInRule)
是否隐藏打卡规则(仅灰度租户有效,如需使用请联系技术支持)
示例值:false
|
Group.Builder |
hideStaffPunchTime(Boolean hideStaffPunchTime)
是否隐藏员工打卡详情
示例值:true
|
Group.Builder |
leaveNeedPunch(Boolean leaveNeedPunch)
请假离岗或返岗是否需打卡,默认为空
示例值:false
|
Group.Builder |
leaveNeedPunchCfg(LeaveNeedPunchCfg leaveNeedPunchCfg)
请假离岗或返岗打卡规则,单位:分钟
示例值:
|
Group.Builder |
locations(Location[] locations)
地址列表(仅追加,不会覆盖之前的列表)
示例值:
|
Group.Builder |
machines(Machine[] machines)
考勤机列表
示例值:
|
Group.Builder |
memberEffectTime(String memberEffectTime)
参加考勤的人员、部门变动生效时间,精确到秒的时间戳
示例值:1611476284
|
Group.Builder |
memberStatusChange(MemberStatusChange memberStatusChange)
人员异动打卡设置
示例值:
|
Group.Builder |
needPunchMembers(PunchMember[] needPunchMembers)
需要打卡的人员配置(新)
示例值:
|
Group.Builder |
needPunchSpecialDays(PunchSpecialDateShift[] needPunchSpecialDays)
必须打卡的特殊日期
示例值:
|
Group.Builder |
newCalendarId(String newCalendarId)
节假日id,(如果考勤组使用了自定义节假日,请用此参数传入节假日id,可在假勤设置-节假日模块页面路径获取)
示例值:7302191700771358252
|
Group.Builder |
noNeedPunchMembers(PunchMember[] noNeedPunchMembers)
无需打卡的人员配置(新)
示例值:
|
Group.Builder |
noNeedPunchSpecialDays(PunchSpecialDateShift[] noNeedPunchSpecialDays)
无需打卡的特殊日期
示例值:
|
Group.Builder |
orgChangeAutoAdjust(Boolean orgChangeAutoAdjust)
人员异动开关(人员组织架构变更后是否允许自动调整到该考勤组)
示例值:false
|
Group.Builder |
outPunchAllowedAdjustAddr(Boolean outPunchAllowedAdjustAddr)
外勤打卡允许微调地址(需要允许外勤打卡才能设置生效)
示例值:true
|
Group.Builder |
outPunchAllowedHideAddr(Boolean outPunchAllowedHideAddr)
外勤打卡允许员工隐藏详细地址(需要允许外勤打卡才能设置生效)
示例值:true
|
Group.Builder |
outPunchNeedApproval(Boolean outPunchNeedApproval)
外勤打卡需审批,先审批后打卡(需要允许外勤打卡才能设置生效)
示例值:true
|
Group.Builder |
outPunchNeedPhoto(Boolean outPunchNeedPhoto)
外勤打卡需拍照(需要允许外勤打卡才能设置生效)
示例值:true
|
Group.Builder |
outPunchNeedPostApproval(Boolean outPunchNeedPostApproval)
外勤打卡需审批,先打卡后审批(需要允许外勤打卡才能设置生效)
示例值:true
|
Group.Builder |
outPunchNeedRemark(Boolean outPunchNeedRemark)
外勤打卡需填写备注(需要允许外勤打卡才能设置生效)
示例值:true
|
Group.Builder |
overtimeClockCfg(OvertimeClockCfg overtimeClockCfg)
加班打卡规则
示例值:
|
Group.Builder |
punchDayShiftIds(String[] punchDayShiftIds)
固定班次必需填
示例值:
|
Group.Builder |
punchType(Integer punchType)
打卡类型,位运算。
|
Group.Builder |
remedyDateLimit(Boolean remedyDateLimit)
补卡时间是否限制(需要允许补卡才能设置生效)
示例值:true
|
Group.Builder |
remedyDateNum(Integer remedyDateNum)
补卡时间,几天内可以发起补卡(需要允许补卡才能设置生效)
示例值:3
|
Group.Builder |
remedyLimit(Boolean remedyLimit)
补卡次数是否限制(需要允许补卡才能设置生效)
示例值:true
|
Group.Builder |
remedyLimitCount(Integer remedyLimitCount)
补卡次数(需要允许补卡才能设置生效)
示例值:3
|
Group.Builder |
remedyPeriodCustomDate(Integer remedyPeriodCustomDate)
补卡自定义周期起始日期
示例值:1
|
Group.Builder |
remedyPeriodType(Integer remedyPeriodType)
补卡周期类型
示例值:1
|
Group.Builder |
replaceBasicPic(Boolean replaceBasicPic)
是否允许替换基准图片
示例值:true
|
Group.Builder |
restClockInNeedApproval(Boolean restClockInNeedApproval)
休息日打卡需审批
示例值:true
|
Group.Builder |
saveAutoChanges(Boolean saveAutoChanges)
是否直接保存可以自动变更的冲突规则
示例值:false
|
Group.Builder |
showCumulativeTime(Boolean showCumulativeTime)
是否展示累计时长
示例值:true
|
Group.Builder |
showOverTime(Boolean showOverTime)
是否展示加班时长
示例值:true
|
Group.Builder |
subGroupLeaderIds(String[] subGroupLeaderIds)
考勤子负责人 ID 列表,对应employee_type
示例值:
|
Group.Builder |
timeZone(String timeZone)
时区
示例值:Asia/Shanghai
|
Group.Builder |
travelNeedPunch(Integer travelNeedPunch)
出差期间是否需打卡,默认为0。
|
Group.Builder |
travelNeedPunchCfg(LeaveNeedPunchCfg travelNeedPunchCfg)
请假离岗或返岗打卡规则,单位:分钟
示例值:
|
Group.Builder |
workDayNoPunchAsLack(Boolean workDayNoPunchAsLack)
自由班次下工作日不打卡是否记为缺卡
示例值:true
|
public Group.Builder groupId(String groupId)
示例值:6919358128597097404
groupId - public Group.Builder groupName(String groupName)
示例值:开心考勤
groupName - public Group.Builder timeZone(String timeZone)
示例值:Asia/Shanghai
timeZone - public Group.Builder bindDeptIds(String[] bindDeptIds)
示例值:
bindDeptIds - public Group.Builder exceptDeptIds(String[] exceptDeptIds)
示例值:
exceptDeptIds - public Group.Builder bindUserIds(String[] bindUserIds)
示例值:
bindUserIds - public Group.Builder exceptUserIds(String[] exceptUserIds)
示例值:
exceptUserIds - public Group.Builder groupLeaderIds(String[] groupLeaderIds)
示例值:
groupLeaderIds - public Group.Builder subGroupLeaderIds(String[] subGroupLeaderIds)
示例值:
subGroupLeaderIds - public Group.Builder allowOutPunch(Boolean allowOutPunch)
示例值:true
allowOutPunch - public Group.Builder outPunchNeedApproval(Boolean outPunchNeedApproval)
示例值:true
outPunchNeedApproval - public Group.Builder outPunchNeedPostApproval(Boolean outPunchNeedPostApproval)
示例值:true
outPunchNeedPostApproval - public Group.Builder outPunchNeedRemark(Boolean outPunchNeedRemark)
示例值:true
outPunchNeedRemark - public Group.Builder outPunchNeedPhoto(Boolean outPunchNeedPhoto)
示例值:true
outPunchNeedPhoto - public Group.Builder outPunchAllowedHideAddr(Boolean outPunchAllowedHideAddr)
示例值:true
outPunchAllowedHideAddr - public Group.Builder outPunchAllowedAdjustAddr(Boolean outPunchAllowedAdjustAddr)
示例值:true
outPunchAllowedAdjustAddr - public Group.Builder adjustRange(Integer adjustRange)
示例值:50
adjustRange - public Group.Builder allowPcPunch(Boolean allowPcPunch)
示例值:true
allowPcPunch - public Group.Builder allowRemedy(Boolean allowRemedy)
示例值:true
allowRemedy - public Group.Builder remedyLimit(Boolean remedyLimit)
示例值:true
remedyLimit - public Group.Builder remedyLimitCount(Integer remedyLimitCount)
示例值:3
remedyLimitCount - public Group.Builder remedyDateLimit(Boolean remedyDateLimit)
示例值:true
remedyDateLimit - public Group.Builder remedyDateNum(Integer remedyDateNum)
示例值:3
remedyDateNum - public Group.Builder allowRemedyTypeLack(Boolean allowRemedyTypeLack)
示例值:true
allowRemedyTypeLack - public Group.Builder allowRemedyTypeLate(Boolean allowRemedyTypeLate)
示例值:true
allowRemedyTypeLate - public Group.Builder allowRemedyTypeEarly(Boolean allowRemedyTypeEarly)
示例值:true
allowRemedyTypeEarly - public Group.Builder allowRemedyTypeNormal(Boolean allowRemedyTypeNormal)
示例值:true
allowRemedyTypeNormal - public Group.Builder showCumulativeTime(Boolean showCumulativeTime)
示例值:true
showCumulativeTime - public Group.Builder showOverTime(Boolean showOverTime)
示例值:true
showOverTime - public Group.Builder hideStaffPunchTime(Boolean hideStaffPunchTime)
示例值:true
hideStaffPunchTime - public Group.Builder hideClockInRule(Boolean hideClockInRule)
示例值:false
hideClockInRule - public Group.Builder facePunch(Boolean facePunch)
示例值:true
facePunch - public Group.Builder facePunchCfg(Integer facePunchCfg)
示例值:1
facePunchCfg - public Group.Builder faceLiveNeedAction(Boolean faceLiveNeedAction)
示例值:true
faceLiveNeedAction - public Group.Builder faceDowngrade(Boolean faceDowngrade)
示例值:true
faceDowngrade - public Group.Builder replaceBasicPic(Boolean replaceBasicPic)
示例值:true
replaceBasicPic - public Group.Builder antiCheatPunchConfig(AntiCheatConfig antiCheatPunchConfig)
示例值:
antiCheatPunchConfig - public Group.Builder machines(Machine[] machines)
示例值:
machines - public Group.Builder gpsRange(Integer gpsRange)
示例值:300
gpsRange - public Group.Builder locations(Location[] locations)
示例值:
locations - public Group.Builder groupType(Integer groupType)
示例值:0
groupType - public Group.Builder punchDayShiftIds(String[] punchDayShiftIds)
示例值:
punchDayShiftIds - public Group.Builder freePunchCfg(FreePunchCfg freePunchCfg)
示例值:
freePunchCfg - public Group.Builder calendarId(Integer calendarId)
示例值:1
calendarId - public Group.Builder needPunchSpecialDays(PunchSpecialDateShift[] needPunchSpecialDays)
示例值:
needPunchSpecialDays - public Group.Builder noNeedPunchSpecialDays(PunchSpecialDateShift[] noNeedPunchSpecialDays)
示例值:
noNeedPunchSpecialDays - public Group.Builder workDayNoPunchAsLack(Boolean workDayNoPunchAsLack)
示例值:true
workDayNoPunchAsLack - public Group.Builder effectNow(Boolean effectNow)
示例值:true
effectNow - public Group.Builder remedyPeriodType(Integer remedyPeriodType)
示例值:1
remedyPeriodType - public Group.Builder remedyPeriodCustomDate(Integer remedyPeriodCustomDate)
示例值:1
remedyPeriodCustomDate - public Group.Builder punchType(Integer punchType)
示例值:1
punchType - public Group.Builder effectTime(String effectTime)
示例值:1611476284
effectTime - public Group.Builder fixshiftEffectTime(String fixshiftEffectTime)
示例值:1611476284
fixshiftEffectTime - public Group.Builder memberEffectTime(String memberEffectTime)
示例值:1611476284
memberEffectTime - public Group.Builder restClockInNeedApproval(Boolean restClockInNeedApproval)
示例值:true
restClockInNeedApproval - public Group.Builder clockInNeedPhoto(Boolean clockInNeedPhoto)
示例值:true
clockInNeedPhoto - public Group.Builder memberStatusChange(MemberStatusChange memberStatusChange)
示例值:
memberStatusChange - public Group.Builder leaveNeedPunch(Boolean leaveNeedPunch)
示例值:false
leaveNeedPunch - public Group.Builder leaveNeedPunchCfg(LeaveNeedPunchCfg leaveNeedPunchCfg)
示例值:
leaveNeedPunchCfg - public Group.Builder goOutNeedPunch(Integer goOutNeedPunch)
示例值:0
goOutNeedPunch - public Group.Builder goOutNeedPunchCfg(LeaveNeedPunchCfg goOutNeedPunchCfg)
示例值:
goOutNeedPunchCfg - public Group.Builder travelNeedPunch(Integer travelNeedPunch)
示例值:0
travelNeedPunch - public Group.Builder travelNeedPunchCfg(LeaveNeedPunchCfg travelNeedPunchCfg)
示例值:
travelNeedPunchCfg - public Group.Builder needPunchMembers(PunchMember[] needPunchMembers)
示例值:
needPunchMembers - public Group.Builder noNeedPunchMembers(PunchMember[] noNeedPunchMembers)
示例值:
noNeedPunchMembers - public Group.Builder saveAutoChanges(Boolean saveAutoChanges)
示例值:false
saveAutoChanges - public Group.Builder orgChangeAutoAdjust(Boolean orgChangeAutoAdjust)
示例值:false
orgChangeAutoAdjust - public Group.Builder bindDefaultDeptIds(String[] bindDefaultDeptIds)
示例值:
bindDefaultDeptIds - public Group.Builder bindDefaultUserIds(String[] bindDefaultUserIds)
示例值:
bindDefaultUserIds - public Group.Builder overtimeClockCfg(OvertimeClockCfg overtimeClockCfg)
示例值:
overtimeClockCfg - public Group.Builder newCalendarId(String newCalendarId)
示例值:7302191700771358252
newCalendarId - public Group.Builder allowApplyPunch(Boolean allowApplyPunch)
示例值:true
allowApplyPunch - public Group.Builder clockInAbnormalSettings(ClockInAbnormalSettings clockInAbnormalSettings)
示例值:
clockInAbnormalSettings - public Group build()
Copyright © 2026. All rights reserved.