--- title: "Getting Started" slug: "getting-started-2" tags: ["AqoreZenTime", "ZenTime"] updated: 2026-03-11T11:45:23Z published: 2026-03-11T11:45:23Z canonical: "zenoplesupport.aqore.com/getting-started-2" --- > ## Documentation Index > Fetch the complete documentation index at: https://zenoplesupport.aqore.com/llms.txt > Use this file to discover all available pages before exploring further. # Getting Started ### App Access Methods ZenTime is distributed through multiple channels to accommodate different organizational deployment strategies: **Android Devices:** - **Distribution**: Google Play Store - **Installation**: Search "ZenTime" or use direct link provided by IT department - **Updates**: Need to exit and manually need to update for now. Automatic updates through Play Store/App Store can be achieved in the future after MDM. **iOS Devices:** - **Distribution**: Apple App Store - **Installation**: Search "ZenTime" or use direct link provided by IT department - **Updates**: Automatic updates through App Store (configurable) - **Enterprise Deployment**: Available through Apple Business Manager for corporate deployments **Web Access:** - **Platform**: Zenople Web Application portal - **Use Case**: Administrative configuration and reporting ### Device Setup (Admin/Supervisor Only) The initial device setup process establishes the connection between the physical tablet device and the organizational timeclock configuration. This is a one-time setup process performed by admin or supervisors. #### Initial Setup Screen Fields When launching ZenTime for the first time (or after a reset), the application presents a setup configuration screen with the following required fields: **I. Company Field** - **Purpose**: Identifies the tenant organization within the Zenople multi-tenant system - **Format**: Full legal company name or designated tenant identifier - **Example**: "ABC Manufacturing Corp" or "XYZ Healthcare Services" - **Validation**: Must match exactly with registered tenant name in Zenople system **II. Alias Field** - **Purpose**: Provides a shortened identifier for the organization - **Format**: Typically 3-8 character alphanumeric code - **Example**: "ABCMFG" or "XYZHEALTH" - **Validation**: Must match registered alias in system - **Usage**: Streamlines login process and system identification **III. Timeclock ID Field** - **Purpose**: Specifies which timeclock configuration to load onto the device - **Format**: Numeric identifier - **Critical Function**: This ID determines ALL operational parameters for the device **Timeclock ID Controls the Following Properties:** 1. **Punch Sequence Rules** - Valid punch order (e.g., Clock In → Break Out → Break In → Clock Out) - Prevention of duplicate punch types - Required punch progression logic 2. **Geo-Location Settings** - GPS coordinate boundaries (latitude/longitude with radius) - Location validation requirements - GPS accuracy thresholds - Handling of location services being disabled 3. **PIN Type Configuration** - 4-digit PIN option - 6-digit PIN option - Last 4 digits of SSN as PIN - Name + Last 4 SSN combination - Custom PIN formats if configured 4. **Reset Timer Settings (Reset timer while setting up time clock property)** - Automatic return to PIN entry screen after inactivity - Configurable timeout duration (typically 15-120 seconds) - Security lockout parameters 5. **IP Address Validation** - Allowed IP address ranges - Network-based access restrictions - VPN requirement settings - IP whitelist configurations 6. **Break Compliance Configuration** - Federal/state break policy requirements - Mandatory break surveys and questions - Break duration minimum/maximum settings - Break timing windows (e.g., must occur between hours 3-5 of shift) 7. **Post Clock-Out Question Setup** - Survey questions presented after clock-out - Required vs. optional questions - Question types (multiple choice, text entry, rating scale) - Conditional question logic **IV. Username/Password Fields** - **Purpose**: Authenticates the admin or supervisor performing the setup - **Requirements**: - Must be valid Admin or Supervisor account credentials - Account must have permission to access the specified Timeclock ID - Account must belong to the specified Company/Alias - **Validation Process**: - System verifies username exists - Password is validated against the encrypted stored value - Role permissions are checked (Admin or Supervisor required) - Timeclock ID access rights are verified - If all checks pass, device configuration proceeds #### Post-Setup Device State **Successful Setup Results:** Once all fields are validated and setup completes successfully, the device transitions from setup mode to operational mode: 1. **Screen Transition**: Setup screen is replaced with PIN Entry Screen 2. **Configuration Storage**: All timeclock properties are downloaded and cached locally 3. **Employee Interface Activation**: Device is now ready for employee time punching 4. **Background Sync Initialization**: 10-minute sync cycle begins (if online) 5. **Offline Capability**: Device can now operate without internet connection using cached data **PIN Entry Screen** becomes the default screen, displaying: - Company name/logo - PIN entry keypad - Customer name - Department name - Timeclock name - Online/offline status indicator - Current date and time ### Supported Roles and Responsibilities ZenTime operates with a clear role-based access model. Each role has specific permissions and capabilities within the application. #### Employee Role **Primary Responsibilities:** - Punch in at shift start - Punch out at shift end - Log break periods (break out/break in) - View personal timesheet entries - Select work assignment (if multiple jobs) - Complete required surveys and compliance questions - Respond to clock-out questionnaires **Capabilities:** - Access time entry screen using personal PIN - View current day punch history - View previous punch entries (limited historical view) - See "Updated Time" markers for edited entries - Navigate multi-assignment selection screens **Restrictions:** - Cannot access device setup or configuration - Cannot view other employees' time entries - Cannot export data - Cannot reset device - Cannot modify system settings #### Admin/Supervisor Role **Primary Responsibilities:** - Perform initial device setup - Configure timeclock properties - Reset device when necessary - Export time punch data - Monitor device sync status - Resolve synchronization conflicts - Maintain device operational status **Capabilities:** - Access setup screen - Enter admin/supervisor credentials for privileged operations (exiting/resetting timeclock) - Force device reset and reconfiguration - Perform manual sync operations - Force Sync - Export JSON data files - View sync status and error logs - Perform manual sync operations **Access Method:** - Double-tap company name to reveal admin/supervisor functions to exit/reset the timeclock (10-second visibility window) - Perform manual force sync operations by double-tapping on the green/red indicator.