---

GET /tenant/attendance/group/{id}
返回参数
略，同列表接口
```
{
"id": 1, // 考勤组 ID
"name": {
"en": "agroup1", // 考勤组名称-英文
"zh-CN": "研发中心考勤组", // 考勤组名称-中文简体
"zh-HK": "研發中心考勤組", // 考勤组名称-中文繁体
"original": "agroup1" // 原始输入的考勤组名称
},
"timezone": "Australia/Sydney", // 考勤组所属时区（IANA 标准），影响考勤日切和统计
"rule": {
"no_shift_policy": "anytime" // 未排班时的打卡规则: anytime(随时打卡), business_hours(正常上下班), select_shift(自选班次)
},
"place": {
"radius": 100, // 全局默认打卡允许半径（单位：米）
"location": [
{
"id": "loc_001", // 地点唯一标识
"name": "北京研发中心", // 办公地点名称
"address": "海淀区中关村软件园 1 号楼", // 地点详细地址
"country": "中国",
"province": "北京市",
"city": "北京市",
"zip": "100000",
"lat": 39.9042, // 地点纬度
"lng": 116.4074, // 地点经度
"radius": 100 // 该特定地点的打卡半径，若为 0 或 null 则取外层全局半径
}
]
},
"member": [
{ "tenant_account_id": 1 }, // 考勤组绑定的员工账号 ID 列表
{ "tenant_account_id": 2 }
],
"correction": {
"is_allow": true, // 是否允许发起补卡申请
"allowed_types": ["normal", "late", "leave_early", "missing"], // 允许补卡的场景: normal(正常), late(迟到), leave_early(早退), missing(缺卡)
"review_tenant_account_id": 1, // 补卡审批负责人账号 ID
"day_limit": 7, // 允许申请过去 X 天内的补卡（补卡时效限制）
"frequency": 3, // 每个周期内允许补卡的次数上限
"frequency_type": "natural_month", // 补卡次数重置周期: natural_month(自然月), custom(自定义)
"frequency_start_day": 0 // 周期起始日，0 表示周期第一天（如月首）
},
// --- 操作者信息 ---
"creator_type": "admin", // 创建者类型: admin(系统管理员), tenant_account(员工)
"creator_id": 10001, // 创建者账号 ID
"creator": { // "with[]": "creator"
"id": 1,
"name": "Abc"
},
"editor_type": "admin", // 最后编辑者类型
"editor_id": 10001, // 最后编辑者账号 ID
"editor": { // "with[]": "editor"
"id": 1,
"name": "Abc"
},
"created_at": "2026-01-07 15:51:35", // 考勤组创建时间
"updated_at": "2026-01-07 15:51:38" // 考勤组最后一次修改时间
}
```
---

POST /tenant/attendance/group
请求参数

```
{
"name": {
"zh_CN": "研发中心考勤组" // 考勤组名称（多语言 Map）
},
"timezone": "Asia/Shanghai", // 时区（IANA 标准，创建后不可修改）
"rule": {
"no_shift_policy": "business_hours" // 未排班规则: anytime(随时打卡), business_hours(正常上下班), select_shift(自选班次)
},
"place": {
"radius": 100, // 全局默认打卡半径（单位：米）
"location": [
{
"id": "fe_unique_id_001", // 前端生成的唯一标识符
"name": "总部大楼", // 地点名称
"address": "科技园路 88 号", // 详细地址
"country": "中国", // 国家
"province": "广东省", // 省份
"city": "深圳市", // 城市
"zip": "518000", // 邮政编码
"lat": 22.5319, // 纬度 (Latitude)
"lng": 113.9489, // 经度 (Longitude)
"radius": 100 // 该地点特定半径（若不设置则取外层默认值）
}
]
},
"member": {
"allow_users": [1001], // 允许打卡的员工 ID 列表
"allow_depts": [201] // 允许打卡的部门 ID 列表
},
"correction": {
"is_allow": true, // 是否允许补卡开关
"allowed_types": [
"late", // 迟到补卡
"leave_early", // 早退补卡
"missing", // 缺卡/漏打卡
"normal" // 正常补卡（如外勤补录）
],
"review_tenant_account_id": "10001", // 补卡审批人 ID
"day_limit": 5, // 补卡天数限制（可申请过去几天内的补卡）
"frequency": 3, // 补卡次数限制
"frequency_type": "natural_month", // 周期类型: natural_month(自然月), custom(自定义周期)
"frequency_start_day": 1 // 周期起始日（custom 模式下生效，1-31）
}
}
```

返回参数
略，返回考勤组对象

---

PUT /tenant/attendance/group/{id}
请求参数
略，同更新参数
返回参数
略，返回考勤组对象

---

DELETE /tenant/attendance/group/{id}
请求参数
无
返回参数
略


// prd
配置项
说明
规则
考勤组名称
用于标识不同考勤组
必填，最多50字符

需要打卡的人员
选择员工加入考勤组（拉起此店铺的团队成员列表，需要有搜索，筛选）
选择员工时使用 priateMateria 中的 selectHolder组件

考勤组时区
一期不开放设置，仅提示
本期默认为店铺时区
优先级“店铺时区——设置人本地设备时区”
创建后不可修改


- 考勤类型：仅支持排班制（与排班功能联动）
- 未排班打卡规则：
  - ○ 选项1：按照店铺营业时间打卡（默认规则）
  - ○ 选项2：员工需先选班次后打卡

  支持方式
本期仅支持APP定位
GPS定位
有效范围
GPS定位半径（米）
100米
考勤地点
支持最多200个考勤地点
需要分装地址组件@Gene 
店铺地址（可删除）
默认规则
未设置时任意地点可打卡
-


配置项
说明
默认值
允许补卡
是否允许员工补卡
是
补卡类型
缺卡、迟到、早退、正常
缺卡、迟到
审批补卡人
指定审批人
店主
补卡时间
可申请过去N天内（0-180）
7天
补卡次数
每人每月最多补卡次数
3次
补卡周期
按自然月或自定义周期
按自然月
1. 在 考勤设置 > 补卡设置 设置项中，勾选 允许补卡。只有勾选了 允许补卡，此考勤组的成员才能进行补卡。
2. 补卡类型：勾选哪些情况下允许成员补卡。成员只可以对所勾选的情况进行补卡，未勾选的情况不可以补卡。
  - 如果勾选了“迟到”：成员可以对“迟到”、“严重迟到”进行补卡。
  - 如果勾选了“正常”：成员可以对“正常”、“无需打卡”进行补卡。 
3. 补卡时间：限制成员只能申请过去几天内的补卡（支持填写范围：0-180）。如果超过该天数，成员就不能补卡。
注：填写 0，则表示成员只能申请当日的补卡。
4. 补卡次数和周期：
  - 补卡次数：限制成员每人每月最多可补卡的次数（支持填写范围：0-999）。
  - 补卡周期：选择 按自然月 或 按自定义周期 来计算补卡周期。
    - 按自然月：即每月 1 日至每月最后一日为一个周期。
    - 按自定义周期：自定义设置每月的起始日，往后一个月为一个周期，例如当月 16 日至次月 15 日。 
注：自定义周期不支持设置 29 日、30 日、31 日为起始日。

