Getting Started & Setup
Why can't I see the Rotaready integration option in Company Settings?
Availability is controlled by a setting on your Paycircle company, so the option isn't present for every company by default. If you can't see it, check that you have company settings access, then contact support to have the integration enabled.
What credentials do I need to connect Rotaready to Paycircle?
You need three things from Rotaready: a Realm ID, a Key and a Secret. Contact Rotaready by emailing [email protected]. Save these securely as soon as you receive them, because they won't be visible again once the connection is saved.
The connection is failing. What should I check?
The message is the same whichever credential is at fault, so it won't tell you which one to look at. Check all three of the following:
⚠️Warning! Don't disconnect and reconnect to resolve a connection error. Disconnecting removes every employee link, the salary settings and your site selection, and it switches off your reference period setup. See Managing Rotaready integration.
The realm: check that it contains letters and numbers only, and remember that it is case-sensitive.
The key and secret: check for typos, then confirm with Rotaready that they are still valid.
Check whether the Rotaready environment is active.
Why is the 4-4-5 option not showing in the integration settings?
The 4-4-5 option appears only for companies with a Monthly pay frequency, and it is hidden rather than greyed out. Check and update the pay frequency setting in Paycircle before you try to configure reference periods. The integration must also already be connected.
Do I need to set up 4-4-5 reference periods?
Only if your business operates on a 4-4-5 weekly cycle. If you run a standard calendar month payroll, you don't need it. See Configure 4-4-5 reference periods.
Our pay date falls at the end of the month. Can we still use 4-4-5?
A last-day-of-month pay date commonly fails this test. Each pay period's pay date must fall after the end of its reference period. If a single month in the tax year fails that test, the whole configuration is rejected. For an end-of-month pay date, see Set up offset reference periods for Rotaready, which anchors periods to the pay date instead.
What happens if a new site is added in Rotaready after the integration has been set up?
⚠️Warning! Don't disconnect and reconnect to pick up a new site. Once it is linked, the new site also needs mapping to a business category. Until it is mapped, employees at that site raise a Critical alert, which blocks the payroll run until the alert is dismissed.
Sites are selected while the connection is first established, and that screen can't be reached again afterwards. A site added later therefore can't be linked from within Paycircle, and you need to raise it with support.
Employee Matching
An employee exists in Rotaready but won't appear in the mapping screen. Why?
In Rotaready, the employee needs both a site and a payroll calendar, and the company must be connected to that site on that calendar. The payroll calendar is the usual cause. If it is missing, or the employee's site wasn't one of those selected at connection, the employee doesn't appear at all. They are absent rather than listed as unmatched, and no warning is raised.
Why isn't automatic matching finding a match for an employee?
Automatic matching requires the National Insurance number to be identical in both systems. The comparison is exact, so a difference in spacing or capitalisation prevents a match. An employee without a National Insurance number in Rotaready will never be matched automatically.
Can I undo a match if it was done incorrectly?
Yes. On the Rotaready Data Sync page, click Review matches under Employees, find the employee, then click Undo. The employee returns to the list of people available to match, and you can rematch them correctly.
📌Note: Undoing a match removes the link only. Data already written into Paycircle at the point of matching stays as it is, so check the record before you rematch.
Pay Elements
What is the 'Gross Addition (Units)' and do I need it?
It is the name of a standard Paycircle adjustment type, and shift and hours-based pay is created against it. It isn't a pay element you create with that name. If you're unsure whether your pack is set up correctly, check with your Paycircle administrator before go-live.
A pay element warning is showing on the compatibility check screen. How do I fix it?
Note the element name as shown on screen.
Go to pay elements in Paycircle, then create the element using that name.
Return to the compatibility check, then refresh. The warning should clear.
Matching is on the element name, and it isn't case-sensitive, so capitalisation doesn't need to agree. Spacing and punctuation do.
Can I manually map pay elements with different names between the two systems?
No. The integration matches pay elements by name only, and there is no manual mapping tool.
What happens if an element doesn't match?
⚠️Warning! On a rota sign-off, a mismatch stops that whole import, not just that element or employee. Nothing is written for any employee in it, and the pay period keeps the values from the last successful import. Figures may therefore look wrong rather than missing.
Holiday behaves differently. A missing Holiday Pay element causes holiday to be skipped for every employee, with a warning, while the rest of the import still processes.
Does the integration support cover shifts?
Yes. When an employee works a cover shift at a different site, the shift data flows automatically from Rotaready into Paycircle through the rota sign-off process. The employee stays on their home payroll throughout.
If you want cover shifts to be clearly identifiable on payslips, create dedicated shift types in Rotaready, such as 'Bar Staff Cover', alongside 'Bar Staff'. These appear as separate lines in the current period view and on payslips.
Paycircle handles cost attribution automatically. When a cover shift arrives from a different entity to the employee's home site, Paycircle applies the business category of that site to the relevant pay element, so no manual override is needed. The attribution carries through to payroll runs, payslips, the Payment Summary report and journal exports.
For this to work, every entity that employees may cover at must have a business category assigned in Paycircle. See Cross-Site Cover Shift Processing for full details.
Events and the Rotaready Updates Page
Why are events not processing?
The most common reason is that the pay period is in a Calculated state. The integration pauses automatically during this time to prevent data conflicts. Events process automatically once the pay period leaves the Calculated state, so no action is needed.
What is a Critical alert, and how is it different from a warning or error?
Critical is the highest severity level. Warnings don't block processing, and errors indicate a failed event. A Critical alert signals that something has happened that will prevent an employee from being paid correctly if it isn't resolved. A red banner at the top of the Rotaready Updates page shows how many Critical alerts need dismissing before you can run payroll.
How do I dismiss a Critical alert?
⚠️Important! Always resolve the underlying issue before you dismiss a Critical alert. Dismissing an alert without taking action leaves the employee in an incorrect state and may prevent their shifts from flowing correctly.
Click Team, then click Rotaready Updates to view the alert and see which employee it affects.
Fix the underlying issue manually in Paycircle first.
After you resolve the issue, find the alert, then click Dismiss. The system asks you to confirm before it clears the alert.
Administrator roles other than Admin Lite can dismiss alerts. Every dismissal is recorded in the activity log, with the user, the date and time, and the text of the alert.
Multi-Payroll
Can the integration support multiple payrolls?
Yes. The integration supports customers with multiple payrolls across a single Rotaready environment. Each Rotaready site and payroll calendar combination maps to a specific Paycircle payroll company.
An employee has moved from one payroll to another. How is that handled?
You move the employee manually, using the Move Payroll function in Paycircle. The integration doesn't carry out the move. When it detects the change, it raises a Critical alert so you can review and action the move before payroll runs. Contact support when an employee is moving payrolls so the move can be handled correctly.
