Payroll Automation
Omnivoo can automatically create and process payroll runs on a scheduled basis, so you never miss a pay date. The Payroll Automation page gives you visibility into upcoming scheduled payrolls and lets you trigger them manually when needed.
Payroll Automation is available to support administrators. Companies must have auto-run enabled in their Payroll Settings for automated payroll to apply to them.
Accessing Payroll Automation
- Log in to your Omnivoo dashboard.
- Navigate to Payroll > Automation.
- You will see stats cards, quick actions, and a table of scheduled payrolls.
Stats Overview
At the top of the page, summary cards show:
| Card | Description |
|---|---|
| Due Today | Number of payrolls scheduled for processing today |
| Upcoming | Number of payrolls scheduled in the future (within your selected look-ahead period) |
| Total Scheduled | Total number of scheduled payrolls across all companies |
| Last Run Processed | Number of payroll runs processed in the most recent automated run (appears after a run completes) |
Quick Actions
Run Automated Payroll
Click Run Automated Payroll to process all eligible payrolls immediately. This creates and processes payroll runs for every company that has auto-run enabled and a payroll due within the scheduled window.
This action affects all eligible companies at once. A confirmation dialog appears before processing begins. Use this when you want to batch-process all pending payrolls.
Refresh
Click Refresh to reload the scheduled payrolls list with the latest data.
Look-Ahead Period
Use the Look ahead dropdown to control how far into the future the scheduled payrolls table displays:
- 7 days (default)
- 14 days
- 30 days
Scheduled Payrolls Table
The table shows all upcoming payrolls with the following columns:
| Column | Description |
|---|---|
| Company | Company name and ID |
| Period | The payroll period (e.g., April 1 - April 30) |
| Pay Date | The scheduled salary disbursement date |
| Currency | The payroll currency for this company |
| Status | Either Due Today (green badge) or Scheduled (yellow badge) |
| Actions | A Trigger Now button to manually run payroll for that specific company |
Triggering Payroll for a Single Company
If you need to process payroll for one company ahead of schedule:
- Find the company in the Scheduled Payrolls table.
- Click Trigger Now next to that company.
- Confirm the action in the dialog that appears.
- A success message shows the created payroll run ID.
Use "Trigger Now" for individual companies when you need to process their payroll outside the normal schedule -- for example, if an employee's last day is before the next automated run.
Last Run Results
After running automated payroll (either via "Run Automated Payroll" or a scheduled job), a results card appears showing:
| Metric | Description |
|---|---|
| Companies Processed | Number of companies included in the run |
| Runs Created | Number of new payroll runs that were created |
| Runs Approved | Number of payroll runs that were auto-approved (for companies without approval requirements) |
| Errors | Number of errors encountered during the run |
If any errors occurred, an Error Details section lists each failed company with the specific error message.
How Automated Payroll Works
- Companies with auto-run enabled have their payroll automatically created on the scheduled day.
- The Run Automated Payroll button processes all eligible payrolls immediately, regardless of schedule.
- The Trigger Now button manually runs payroll for a specific company.
- Payrolls for companies that require approval are created in pending_approval status and still need manual approval before payments are disbursed.
Automated payroll creates the payroll run and calculates amounts, but companies with approval enabled still require a designated approver to review and approve before payments go out. See Payroll Settings for approval configuration.
Troubleshooting
No Payrolls Showing
If the scheduled payrolls table is empty:
- Check that the look-ahead period is set to a long enough window (try 30 days).
- Verify that companies have auto-run enabled in their payroll settings.
- Ensure companies have active employees on payroll.
Payroll Trigger Failed
If triggering payroll for a company fails:
- Check the error message for details (e.g., missing bank details, no active employees).
- Verify the company's payroll configuration is complete.
- Try refreshing and triggering again.