连接考勤设备（任何品牌）或上传文件

Kaam360 支持任何品牌的考勤设备。导入打卡有三种方式，可同时使用：

• ZKTeco 及兼容设备（大多数 ZKTeco 人脸、指纹和刷卡终端，以及许多以其他品牌销售的设备）会自动发送每次打卡。办公室无需安装任何软件。
• 任何其他设备、系统或程序使用密钥将打卡发送到一个网址。
• 没有 Cloud Server 设置的旧考勤机：办公室里的小型 Windows 程序 Kaam360 Connector 会通过网络读取它们。
• 文件：任何考勤软件导出的 CSV 或 Excel 文件，或 ZKTeco 设备保存到 U 盘的 attlog 文件。

您需要管理班次和考勤权限。打开人员模块中的考勤设备。

1. 为每个人设置设备上的编号

每个人在设备上都有一个用户编号（ID、PIN 或 AC No.）。在人员在设备上的编号下，输入每个人的设备上的编号，离开输入框即可保存。所有设备使用相同编号。

2a. 连接 ZKTeco 或兼容设备

1. 点击添加设备，选择ZKTeco 或兼容设备（自动发送打卡）。
2. 输入名称（例如“正门”）和设备的序列号（见设备菜单 > 系统信息）。
3. 如果设备时钟设置的时区与组织不同，请选择设备的时区。
4. 可选：在仅限此网络地址（可选）中填写办公室的固定地址。来自其他地址的请求将被拒绝。
5. 点击保存。然后在设备上按照在设备上下的步骤操作：菜单，然后通讯（COMM.），然后云服务器设置（部分型号为 ADMS）。输入页面上显示的服务器地址，以及开启 HTTPS 时的端口 443（如果设备不支持 HTTPS，则关闭 HTTPS 并使用 80）。保存，如设备提示则重启。
6. 几分钟内设备会显示为在线，其打卡会自动传来，包括未连接期间保存的打卡。

2b. 连接其他设备、系统或程序

1. 点击添加设备，选择其他设备、系统或程序（发送到网址）。
2. 输入名称，然后点击保存。
3. 立即复制设备的密钥：它只显示这一次。如果丢失，点击设备旁的新密钥；旧密钥会立即失效。
4. 其他系统使用 POST 将打卡发送到显示的地址，请求头为 Authorization: Bearer 加上密钥，正文如下：{ "punches": [ { "person": "37", "time": "2026-11-04T09:01:00+05:00", "direction": "in", "id": "a-unique-id" } ] }。"person" 是设备编号（也可以使用 "email"）；带时差的时间（+05:00）按原样计算，不带时差的时间按设备时区读取；"direction" 和 "id" 可选，使用相同 id 重复发送的打卡只保存一次。

2c. 上传文件

1. 在上传文件下选择文件。
2. Kaam360 显示前几行，并猜测哪一列是人员、日期和时间，以及上班或下班。请检查并修改错误之处。如果文件用电子邮件标识人员，请勾选此列为电子邮件地址。
3. 点击添加打卡记录。Kaam360 会告诉您添加了多少、已存在多少、多少在等待匹配人员以及多少无法读取。再次上传同一文件不会重复添加。

2d. 没有 Cloud Server 的旧考勤机：Kaam360 Connector

有些考勤机，例如许多 ZKTeco K 系列机型，没有 Cloud Server（ADMS）设置，因此无法自行发送打卡记录。Kaam360 Connector 是一个装在办公室 Windows 电脑上的小程序，它通过办公室网络读取考勤机，并把打卡记录发送到这里。

1. 点击 添加设备，选择 Kaam360 Connector（读取办公室网络中的旧考勤机）。输入 名称，然后点击 保存。
2. 立即复制设置代码：它只显示这一次。如果丢失，请点击设备旁的 新密钥，然后选择 在用 Kaam360 Connector？显示设置代码。
3. 在与考勤机处于同一网络的 Windows 电脑上，点击 下载 Kaam360 Connector。右键点击 Kaam360Connector.exe，选择以管理员身份运行。
4. 粘贴设置代码，然后输入考勤机的 IP 地址（在考勤机上：菜单、COMM.、以太网、IP 地址），如有通讯密码也一并输入。连接器会检查考勤机并发送打卡记录（首次发送最近 60 天）。
5. 此后，只要电脑开着（重启后也是），它就每 5 分钟自动运行一次。设备在这里显示为 在线。再次运行该程序可立即读取、添加其他考勤机或将其删除。

请在工作时间保持这台电脑开机。如果电脑关机，打卡记录会留在考勤机上，等电脑重新开机后再发送。

通信密钥（COMM Key） 是在考勤机上设置的数字，通常为 0（无）：Menu、COMM.、Comm Key（某些型号为 PC Connection 或 Device Password）。它不是设置码。连接器通过 4370 端口以 TCP 或 UDP 与考勤机通信，并会自动尝试两者（ZKTeco K50 等较旧的设备通常使用 UDP）。如果考勤机没有响应，请检查 IP 地址、通信密钥、考勤机的 PC 连接端口是否为 4370，以及电脑上的防火墙是否阻止了 4370 端口。 另外，请关闭连接到考勤机的其他考勤软件（ZKTime、ZKBioTime、ZKAccess 或类似软件）：许多考勤机同一时间只与一个程序通信。如果考勤机仍然没有响应，连接器会显示它通过 TCP 和 UDP 看到的情况；请把这条信息发给支持团队。

尚无人使用的编号的打卡

当设备发送的编号在 Kaam360 中还不属于任何人时，其打卡会保存在待匹配人员的打卡下。在编号旁选择这是谁？：此人会立即获得该编号及其所有打卡。

关注设备状态

列表显示每台设备的状态：在线、不久前最近上线、自某时起无活动（一天无联系：请检查电源、网络和设置）、尚未连接或已关闭，以及最后一次打卡和已发送的数量。移除设备会保留其打卡记录。