Mobile Workforce, Time, and Pay

The mobile Workforce screens use live data from the organization selected in your signed-in session. They never substitute preview team members, time entries, training records, or pay figures when a workspace is empty or cannot be loaded.

Every screen below is reached from the crew workspace's More list, not a tab-bar stop. A crew member who also has Manage team sees the manager-only rows — Team Timecards, and the pending queue inside Availability & Time Off — on the same list as their own crew rows.

Owner and manager screens

These rows need the effective Manage team permission:

• Team for the current team directory, role, crew, truck, and live shift

status. While this screen remains open and online, it refreshes the live shift snapshot every 30 seconds.

• Team Timecards for This week, Last week, or This month. A

summary strip totals hours, how many teammates need review, and how many have an open shift, followed by each teammate's hours and status — Pending, Approved, Changed, or Open shift. A location-pinned manager sees only teammates pinned to one of their own locations, plus any unpinned (all-location) teammate.

• Review Timesheet for one teammate's shift entries in the exact period

selected on Team Timecards. Approving is blocked while any shift in that period still has no clock-out; clock it out first. If a shift inside an already-approved period is edited afterward, that period's status returns to Changed so it can be reviewed again.

Team directory in the internal Android preview

The expanded read-only Team directory is available in the internal Android preview only; it is not part of the production mobile app. Teammates with Manage team can see active members visible to them, including each person's name, job title or role, crew, and truck. Team members counts those visible active members. Clocked in counts clocked-in teammates only at locations the viewer can access. If a member's shift status is hidden across the organization, the row shows Status unavailable.

The directory has loading, retry, and empty states and is read-only; it has no contact, pay, or invitation controls. V2 does not track breaks, so there is no On break total or per-member break status.

Defining what the organization requires, and recording when someone completes it, happens on the web at Settings → Training and certifications (also Manage team) — not on mobile.

Every Workforce page can be scrolled far enough for its final row, form button, or navigation control to sit above the persistent mobile tab bar and raised Create button. If a final control is only partly visible, continue scrolling before selecting it.

Employee Time Clock

Crew leads and technicians reach Time clock from the crew More list. When you are not currently clocked in, the screen offers today's crew jobs as an optional job to clock into, plus No job for a general shift; pick one and tap Clock in. While clocked in, the screen shows how long you have been on the clock and against which job, and the same action becomes Clock out. An optional note travels with whichever entry you are opening or closing — a note left while clocking out does not touch the note already saved on the entry you just clocked into.

Only one open (not yet clocked out) entry can exist per person at a time; the server enforces this even if two devices signed into the same account try to clock in at once. Clock-in and clock-out timestamps are set by the server, not the device clock, so a phone with the wrong time cannot record a shift that has not happened yet. Today lists every entry recorded that calendar day, each with its time range, linked job (or No job), note, and running or final duration.

Time clock entries save the same offline-first way as the rest of the crew workspace: a clock-in or clock-out recorded without a connection is queued and syncs automatically once the device reconnects, and a retried sync can never create a duplicate entry or double-apply the same clock-in or clock-out.

Break records and timesheet review

The service now accepts break start and end actions and provides net-time and manager-review data. Native break controls and review screens are limited to an internal Android preview; they are not generally available to mobile users. Authenticated mobile use and end-to-end offline sync and conflict behavior have not been verified on a device.

In the internal preview, an open shift offers Start break and End break. Clock out is unavailable while a break is active. Net worked time deducts confirmed break duration. The preview is designed to show queued offline break actions immediately and replay them in order. After the server confirms an action, the last confirmed total remains visible with Updating total… until the new total syncs. Retrying an action does not apply it twice. Offline conflict visibility remains unverified.

For managers, Team Timecards shows pending and rejected action counts. Review Timesheet shows server-computed net shift time, break duration (and when an active break began), and each pending or rejected action with its reason and time. Approval requires visibility of the full selected period; a partial-period view cannot be approved. Pending actions block approval until they sync or are resolved. An authorized manager may reject a pending, unmatched break-end record with a required reason of 1 to 500 characters; its audit history is retained. After rejection, the preview refreshes and shows that a manager resolved the record, when, and the manager's note. Approval acknowledgment clears, so the manager must review the refreshed list and explicitly acknowledge every rejected or conflicting item before approval. When later valid time data changes an approved timesheet, its status returns to Changed.

In the preview, the Team directory's On break count and status appear only when an authorized teammate's current, location-visible shift shows an active break. An absent, hidden, or ambiguous shift remains unavailable and is not treated as off the clock. Existing job-based Crew Pay and commission calculations do not change. Break records and controls do not enable canvassing location collection: route capture remains off, and the raw-point retention purge is paused.

Office teammates with reporting access can already read every crew member's time entries; see Crew Pay for the pay policy and splits behind those entries, and Team Timecards above for the mobile review and approval flow.

Availability and time off

Availability & Time Off works online only — there is no offline cache for it. Each signed-in crew member maintains their own recurring weekly hours and can submit a date-bounded time-off request:

• Weekly hours: turn each weekday Off or Available, and enter a

start and end time (24-hour HH:MM) for every available day. Saving replaces all seven days at once.

• Request time off: enter a start and end date (YYYY-MM-DD) and an

optional reason. A new request begins Pending. A request that overlaps an existing pending or approved request for the same person is refused.

• My requests lists your own requests and their status.

Owners and admins with Manage team additionally see a Team requests queue of every pending request org-wide, with Approve and Decline. A manager can never review their own request — it does not appear in their own queue, and a second reviewer is required.

Training and certifications

Training & Certifications is read-only on mobile: it shows your own status against whatever the office has configured, and does not let you record a completion yourself. Each requirement shows as Complete, Expired, Required (missing), or Optional, with its expiry date when the office set one. Use the filter chips to narrow the list; a summary strip totals how many requirements are required, expired, and complete.

Expiry is derived from the requirement's Valid for (days) setting, counted from your completion date. A requirement with no valid-for period never expires.

My Pay

My Pay is the third tab in the crew bottom bar. It is shown only when your base role is Crew and the organization has a saved policy at Settings → Crew pay; otherwise the screen explains that it isn't turned on for your role or organization yet. It covers the last 90 days and reuses the same completed-job pay calculations the office's Crew Pay policy already produced — this screen does not calculate anything on its own.

The headline figure is labeled Calculated pay. It is an earnings calculation, not confirmation that payroll has been settled or paid. When there are no qualifying completed jobs in the window, the screen shows an honest empty state.

If a screen cannot load

Use Retry after checking connectivity. A permission error means your effective role, or the organization's Crew Pay configuration, does not authorize that screen. Ask an owner to review team permissions; do not switch organizations to work around access controls.