Appendix A: Glossary of Terms
Active Assignment: A job assignment with a current start date and either no end date or an end date in the future. Employees can only punch time for active assignments.
Alias: A shortened identifier for an organization within the Zenople multi-tenant system, typically 3-8 characters.
Assignment Picker: The screen displayed when an employee has multiple active assignments, allowing selection of which job to attribute the punch to.
Bi-Directional Sync: Two-way data synchronization where changes made on the device are sent to the server AND changes made on the server are sent to the device.
Break Compliance: Policies and rules enforcing federal, state, and organizational requirements for employee meal and rest breaks.
CMS: Content Management System - the administrative backend of Zenople Web Application where timeclock configurations are created.
Contact Portal: A web interface for supervisors with limited contact-level access to review and correct employee timesheets.
Geo-Fencing: Technology that uses GPS coordinates to create virtual geographic boundaries, restricting time punches to specific physical locations.
Identification Form: A form displayed to employees whose PIN is not recognized, capturing First Name, Last Name, and Last 4 SSN for manual matching.
Kiosk Mode: A restricted device operation mode (Android) or Guided Access (iOS) that locks the device to a single application, preventing access to other device features.
Last Known Location: The most recent GPS coordinates cached on the device, used for geo-fence validation when current GPS is unavailable.
Overnight Shift: A work shift that spans across midnight, requiring employees to select the shift start date for all punches (both before and after midnight).
PIN Entry Screen: The default screen of ZenTime where employees enter their Personal Identification Number to access the time entry functions.
Punch Sequence: The required order of punch types (e.g., Clock In → Break Out → Break In → Clock Out) enforced by the timeclock configuration.
Recovery Sync: A priority synchronization process that occurs immediately when a device transitions from offline to online status, uploading locally stored data before downloading server updates.
RMS: Reports Management System - the reporting module of Zenople Web Application where various time and attendance reports are accessed.
Rounding Rules: Policies that adjust punch times to the nearest specified increment (e.g., round to nearest 15 minutes) for payroll calculation purposes.
SSN: Social Security Number - used as part of employee identification, with typically only the last 4 digits used for PIN or identification purposes.
Sync Fail Report: The "Aqore Zen Time Sync Fail Report" in RMS that logs punch data that could not be automatically processed, requiring administrator review.
Temporary Employee Record: A local database record created when an employee completes the identification form, used to store punches until the employee can be matched to a server profile.
Time Entry Screen: The screen displaying available punch buttons (Clock In, Break Out, Break In, Clock Out) and the current day's punch history.
Timeclock ID: A unique identifier for a specific timeclock configuration, determining all operational parameters for devices configured with that ID.
TMS: Time Management System - the core time and attendance module within Zenople Web Application.
Transaction Batch: A collection of time punches grouped together for processing, identified by source (e.g., "TimeClock App" for ZenTime punches).
Updated Time: An indicator shown on the timesheet when a punch has been modified after its initial recording, whether by rounding rules, supervisor correction, or system adjustment.
WebClock Setup: The configuration area within CMS where timeclocks are created and their properties (PIN type, geo-fencing, break compliance, etc.) are defined.
Work Date Selector: A screen that allows employees to choose which calendar date to attribute their current punch to, appearing in overnight shift scenarios or after extended offline periods.
Appendix B: Quick Reference - Admin Tasks
Initial Device Setup:
- Install ZenTime app from app store
- Launch app → Setup screen appears
- Enter: Company, Alias, Timeclock ID, Admin credentials
- Wait for configuration download
- Verify PIN Entry Screen appears
- Test with employee PIN
Force Manual Sync:
- Double-tap displayed time on PIN Entry Screen
- Watch for sync confirmation or error
- Check "Last Sync" timestamp (double-tap Company Name to view)
Exit/Reset Device:
- Double-tap Company Name
- Tap Exit button (bottom-left, visible for 10 seconds)
- Enter Admin/Supervisor credentials
- Wait for force sync to complete
- Device returns to setup screen
Export Punch Data:
- Double-tap Company Name
- Tap Export button (bottom-right, visible for 10 seconds)
- Locate exported JSON file in Downloads or Files app
- Transfer to computer or email for analysis
Review Sync Failures:
- Log into Zenople Web App
- Navigate to RMS
- Search for "Aqore Zen Time Sync Fail"
- Review entries by date or employee
- Correct underlying issues in employee profiles or assignments
- Manually attribute punches as needed
Appendix C: Quick Reference - Employee Tasks
Standard Clock In:
- Enter your PIN
- If multiple assignments, select correct one
- Tap "Clock In" button
- Wait for confirmation
- Walk away when screen returns to PIN entry
Standard Clock Out:
- Enter your PIN
- If multiple assignments, select same one as Clock In
- Tap "Clock Out" button
- Complete post-clock-out questions if displayed
- Wait for confirmation
Taking a Break:
- Before break: Enter PIN, tap "Break Out"
- Take your break
- After break: Enter PIN, tap "Break In"
View Your Timesheet:
- Enter your PIN
- Look at left-side grid on Time Entry Screen
- Review today's punches
- Note any "Updated Time" indicators
- Contact supervisor with questions
Forgot to Punch?:
- Don't try to go back in time
- Continue with your next scheduled punch
- Notify your supervisor
- Supervisor will add missing punch
- Check timesheet next time for correction
Appendix D: Support Checklist
Before Contacting Support, Gather:
- Company name and Alias
- Timeclock ID
- Device model and OS version
- Description of issue (what happened, what should have happened)
- When issue started (date and time)
- How many employees/devices affected
- Screenshots of error messages
- Steps already taken to troubleshoot
- Whether issue is consistent or intermittent
- Network connectivity status (online/offline)
- Last successful sync timestamp
- Device logs (if requested by support)
Information Support May Request:
- Specific employee IDs experiencing issues
- Punch timestamps in question
- Assignment details
- Timeclock configuration screenshots
- Network infrastructure details (IP addresses, firewall rules)
- Recent changes to employee profiles or timeclock configuration