---
title: "Getting Started"
slug: "getting-started-2"
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.