Skip to main content

CheckWorkRights Integration

Automatically block or limit rostering in Tanda based on CheckWorkRights right to work, visa and licence checks

CheckWorkRights (CWR) runs right to work, visa, licence and background checks on your employees. The CheckWorkRights integration sends those check results into Tanda as qualifications, so Tanda's roster rules can block an employee from being rostered, or limit their hours, whenever their check results say they should be.

This help guide explains how the integration works, what you need to set up in Tanda, and how student visa hour limits are handled.

What does this guide cover?

  • How the integration works

  • What you need before you start

  • Setting up the CWR qualifications in Tanda

  • What each check result means for your roster

  • Student visa hour limits and term breaks

  • FAQs

How the integration works

Each check type you switch on in CheckWorkRights has a matching qualification in Tanda, named with a – CWR suffix, for example Right to Work – CWR or RSA – CWR. When an employee's check result changes in CheckWorkRights, CWR updates that qualification on their Tanda profile, including its expiry and effective dates. Changes usually reach Tanda within seconds.

Tanda then applies its normal qualification rules:

  • If the employee is cleared, they can be rostered.

  • If their check carries an hours limit (such as a student visa), Tanda stops them being rostered over that limit.

  • If they are not cleared, or a check has expired, Tanda blocks the roster from being published with them on it.

CheckWorkRights also monitors visa holders on an ongoing basis through VEVO, so when a visa is granted, changed, cancelled or expires, the qualification in Tanda is updated without anyone having to re-check the employee.

Please note: The integration is one-way, from CheckWorkRights to Tanda. It only creates and updates the qualifications labelled – CWR. Your other qualifications and the rest of each employee's profile are not changed.

What you need before you start

  • A CheckWorkRights account running the checks you want to use for rostering.

  • A Tanda account with the Qualifications feature turned on. See Managing Qualifications, Licences, and Certifications.

  • Employees who exist in both Tanda and CheckWorkRights, linked by their Tanda employee ID. The integration does not create employees in Tanda.

  • A Tanda login with access to Workforce > Qualifications, which you will use to connect CheckWorkRights and complete the one-time setup below.

Setting up the CWR qualifications in Tanda

You connect the integration from inside CheckWorkRights using your own Tanda login, so there are no API tokens to copy. CheckWorkRights then walks you through each check type you switch on.

Some rostering settings can only be changed in Tanda, so there is a one-time step for each check type. CheckWorkRights shows you exactly which settings to tick, and won't start sending updates for that check type until you confirm it's done.

In Tanda

  1. Go to Workforce > Qualifications.

  2. Click the pencil icon next to the – CWR qualification that CheckWorkRights asked you to configure.

  3. Under Rostering, tick Block roster publishing so that an expired, pending or over-hours qualification stops the roster being published.

  4. Set Should block publishing outside of effective dates ranges as instructed by CheckWorkRights for that check type.

  5. If the check type has an hours limit, enter the Maximum Hours and choose per week or per fortnight. For student visas, fortnightly matches how the government limit is calculated.

  6. Click Save, then return to CheckWorkRights and confirm the step is complete.

Please note: If a qualification is linked to specific teams, the roster block only applies to shifts rostered in those teams. To block across your whole roster, leave the CWR qualifications unlinked from teams, or link them to every team that needs them. See Managing Qualifications, Licences, and Certifications for more detail.

In CheckWorkRights

Once each check type is confirmed, use Sync all employees in CheckWorkRights to send every current employee's check results to Tanda in one go. You don't need to wait for statuses to change before the roster rules start working. You can also re-sync an individual employee from their CheckWorkRights profile at any time.

What each check result means for your roster

Each CWR qualification is assessed on its own. An employee can only be rostered for a shift if every one of their CWR qualifications allows it, so the most restrictive result always applies.

  • Unrestricted work rights (for example, citizens and permanent residents): rosterable, with no end date.

  • Visa that allows work: rosterable until the visa expiry date.

  • Licence or certification current (for example, RSA or Working With Children Check): rosterable until it expires.

  • Working Holiday visa: rosterable until the 6-month limit with your business is reached.

  • New visa granted or renewal verified: rosterable with the updated dates.

  • No valid visa, or a visa, licence or Working Holiday limit has expired: blocked.

  • One check allows the shift but another doesn't (for example, valid work rights but an expired RSA): blocked.

Roster buffer

In CheckWorkRights you can set a roster buffer, which adds a set number of days to every expiry date sent to Tanda. This lets managers keep rostering ahead while an employee's new visa or licence comes through. For example, if a visa expires on 30 June and the new visa is linked on 1 July, the buffer stops that employee disappearing from next month's roster.

The buffer only applies to expiry. If a check comes back with no work rights or a critical visa status, the employee is blocked in Tanda straight away.

Student visa hour limits and term breaks

For student visa holders, CheckWorkRights receives the visa conditions from the Department of Home Affairs and collects the supporting evidence, such as the Confirmation of Enrolment (CoE), course start date and term break dates. Once your team verifies that evidence in CheckWorkRights, the dates are sent to the student's CWR qualification in Tanda.

  • Before the course starts: the student is blocked from rostering. The block lifts automatically on the course start date.

  • During study periods (condition 8105): the student is rosterable, but limited to the maximum hours on the qualification, usually 48 hours per fortnight.

  • During verified term breaks: the hours limit does not apply for those dates, and comes back automatically when study resumes.

  • Family members of Masters by Research or PhD students (condition 8104): limited to 48 hours per fortnight until the primary student's course start is verified, then unlimited.

Example: A student starts on 1 January with verified breaks from 1 to 15 April and 1 to 30 September. In Tanda they are limited to 48 hours per fortnight from 1 January to 31 March, unlimited from 1 to 15 April, limited from 16 April to 31 August, unlimited in September, and limited again from 1 October.

To get a heads-up before a student goes over their hours, turn on the Qualification maximum hours risk key alert under Settings > Notifications and Tasks > Key Alerts.

FAQs

Will this change how our managers roster?

No. Managers keep building rosters in Tanda as they do today. The only difference is that they can't publish a shift for an employee who isn't cleared, or roster a student over their allowed hours. The reason is shown on the roster warning and on the employee's profile.

Does it stop someone clocking in?

No. Tanda checks qualifications when a roster is published and when shifts are claimed, not when someone clocks in. Use CheckWorkRights reporting, or the Missing or Expired Qualifications report under Reports > Workforce Reports, to spot anyone working without valid rights.

Can we edit or delete the CWR qualifications in Tanda?

Please don't change the dates or status on an employee's CWR qualification. They are managed from CheckWorkRights, and changes made in Tanda are not sent back. Deleting a CWR qualification from Workforce > Qualifications stops updates for that check type until it is set up again in CheckWorkRights. You can still adjust the rostering settings on the qualification, such as maximum hours, if CheckWorkRights asks you to.

An employee was added straight into Tanda. Why isn't their qualification updating?

Employees created directly in Tanda, outside your usual hiring process, aren't linked to CheckWorkRights until their record in CheckWorkRights has their Tanda employee ID. Once linked, re-sync the employee from their CheckWorkRights profile.

Does it work across multiple locations?

Yes. The integration covers every employee in your connected Tanda account across all locations, as long as each one is linked to their CheckWorkRights record.

Can we start checks from Tanda?

Not at the moment. Checks are started in CheckWorkRights or from your ATS or HRIS.

How do we disconnect the integration?

You can revoke CheckWorkRights' access from Tanda at any time. Existing CWR qualifications stay on employee profiles but will no longer be updated.

For questions about check results, VEVO monitoring or the CheckWorkRights side of the setup, contact CheckWorkRights directly. For anything in Tanda, reach out to support@tanda.co.

Did this answer your question?