Connecting biometric devices

• API pull — the platform connects to the device or its server on a schedule. Needs the device to be reachable from the internet.
• Webhook push — the device or a small bridge on your network posts punches to us. Works when the device is on a private LAN, because the connection goes outward.
• File import — export the log from the device software and upload it. Needs no connectivity at all.

Devices on an office LAN cannot be reached from a cloud service directly. If your device is not internet-facing, use webhook mode with the bridge, or file import. Neither requires opening your network.

Every punch is stored twice: as the raw event exactly as the device reported it, and as a mapped punch attached to an employee.

That is why a mis-configured device is recoverable. If a device was reporting IDs that matched nobody, fixing the mapping and reprocessing rebuilds attendance for those days — the underlying events were never discarded.

Re-importing the same file does not create duplicates; events are matched on device, user and timestamp.