Unibandh · Help centre
Recording planSign in
Unibandh · School management for Indian schools · Home
    Help centre/Attendance: daily register, alerts, devices and check-in/Lesson 6

    Add a biometric, RFID or face terminal

    Register a device, choose its vendor and serial number, set its punch window and what it marks, and save the one-time API token.

    Open /attendance/devicesRecording script
    6 min6 stepsOwner, Admin, PrincipalDemo: sign in as Owner

    Before you start

    Finish first: The daily attendance overview

    • You are an owner, admin or principal.
    • For a ZKTeco or eSSL terminal: its serial number (Menu → System Info → Device Info, or the label).

    Steps

    0 of 6 done
    1. You should see: Tabs Devices, Unmatched, Import, Rules, Geofences; tiles Active devices, Punches today, Unmatched user ids; a table with Device, Type, Serial, Last seen, Today, Unmatched, Mapped and Open; and an Add device button. The demo school has "Main gate biometric" (eSSL) and "Hostel RFID reader" (ZKTeco).

      Open /attendance/devices
    2. You should see: The Add device dialog with Name, Type (Fingerprint / biometric, RFID / smart card, Face recognition, QR scanner, GPS geofence (app)), Vendor (eSSL, ZKTeco, Mantra, Realtime, Matrix, Generic / other), Serial number (SN), Location, Timezone, Duplicate window (minutes), Accept punches from / until, Allowed source IPs (optional) and the checkboxes Marks students and Marks staff.

    3. You should see: The hint under the serial field reads "Required for ZKTeco/eSSL ADMS push; printed on the device and under Menu → System info."

      Untick Marks students on a staff-room device, or Marks staff on a classroom reader, so a stray punch cannot mark the wrong register.

    4. You should see: The toast "Device added" and the dialog now shows the alert "Device API token — shown once" with the token in a box and a copy button.

    5. You should see: The new device appears in the table with Last seen = Never.

      Lost the token? Open the device and click Token to issue a new one; the old one stops working immediately.

    6. You should see: An inactive device shows the alert "Device inactive: Punches from this device are rejected until it is reactivated."

    What you have now

    • A registered device with a serial number, punch window and (if needed) an API token, ready to connect.

    If something goes wrong

    "Permission denied: Only owners, admins and the principal can manage attendance devices."
    Ask an owner or admin to add the device or to change your role.
    The serial number is refused
    Serial numbers are unique across the whole platform. Check for typos or a device already registered elsewhere.

    Related guides

    • Connect a ZKTeco or eSSL terminal (ADMS) and test it
    • Map device user ids to people and resolve unmatched punches
    Maintain the holiday listNext: Connect a ZKTeco or eSSL terminal (ADMS) and test it