# PayCat

Source: https://docs.astalty.com.au/guide/integrations/paycat

> Sync approved timesheets, pay groups, cost codes, and leave to PayCat payroll.

Scheduling add-on - This feature requires the Scheduling add-on, which is available on Astalty Premium. See How to enable Scheduling.

![](https://docs.astalty.com.au/assets/paycat-logo.png)

The PayCat integration connects Astalty to payroll so an approved timesheet batch can be validated and sent directly, or exported as a compatible CSV.

## What It Does

- **Sync timesheet batches** directly to PayCat, or export them as a compatible CSV.
- **Link your team** to PayCat employee profiles.
- **Map pay groups** so each shift is paid at the right rate - including [per-shift pay group overrides](https://docs.astalty.com.au/guide/scheduling/setup/services-and-charges/paying-different-rates-for-different-shifts) and separate work types for work either side of a sleepover.
- **Map [cost codes](https://docs.astalty.com.au/guide/finance/cost-codes)** to PayCat locations so wages are split across your business.
- **Sync approved [leave](https://docs.astalty.com.au/guide/scheduling/leave)** into payroll when Leave is available, leave types are mapped and **Sync leave automatically** is enabled.
- **Configure sleepover shift export** behaviour to match your payroll requirements.
- **Send [custom allowances](https://docs.astalty.com.au/guide/scheduling/setup/custom-allowances)** from shifts as their own timesheet lines, each mapped to a work type.

## How It Works

Once connected and configured, the integration is driven from [timesheet batches](https://docs.astalty.com.au/guide/scheduling/timesheet-batches). When you export or sync a batch, Astalty uses the pay group attached to each shift and its optional cost code mapping. When automatic leave sync is enabled, approved Astalty leave is queued for creation in PayCat.

Astalty reuses the mappings on every sync. After setup, approve timesheets and send the batch.

### PayCat Interprets the Award, Not Astalty

Astalty sends PayCat the hours worked and the **work type** each line belongs to - ordinary hours, kilometres, sleepover, and so on. PayCat applies your award rules to those lines and works out penalties, overtime and allowances.

This is the opposite of the [Xero payroll integration](https://docs.astalty.com.au/guide/scheduling/xero-integration-in-scheduling), where Astalty interprets the award itself and sends Xero pay lines that are already classified. Two consequences on a PayCat account:

- Pay group mapping has **work types only** - there are no Saturday, Sunday, public holiday, afternoon, night, overtime or allowance slots to map for shifts, because PayCat derives them.
- [On-call](https://docs.astalty.com.au/guide/scheduling/on-call-roster) is the exception. Astalty interprets it itself and sends each on-call rate on its own work type, so a pay group whose workers are on call maps its on-call rows too. See [Mapping On-Call Pay Items](https://docs.astalty.com.au/guide/scheduling/on-call-roster#mapping-on-call-pay-items).
- A timesheet batch's **Award Interpretation** tab still shows Astalty's own interpretation of the shift, with a note that PayCat calculates award pay itself from the timesheets Astalty sends, so what it pays can differ from these figures.

Astalty still interprets the award for [scheduling costs](https://docs.astalty.com.au/guide/scheduling/scheduling-costs), [award alerts](https://docs.astalty.com.au/guide/scheduling/scheduling-award-alerts) and the [Award Pay Report](https://docs.astalty.com.au/guide/reports/schads-pay-report), but they use Astalty's implemented rules and rates. They can differ from PayCat, so review the relevant award limitations and the final pay run.

> **Meal breaks under SCHADS**
>
> On a SCHADS shift over 5 hours with no break recorded, PayCat deducts an unpaid 30-minute meal break unless its automatic meal break rule is switched off. On most shifts, a meal break recorded in Astalty replaces that deduction. See [Meal breaks on Employment Hero, PayCat and QuickBooks Payroll](https://docs.astalty.com.au/guide/scheduling/scheduling-faq/schads-interpretations-in-astalty#meal-breaks-on-employment-hero-paycat-and-quickbooks-payroll) for the exceptions.

## Connecting It

Choose PayCat as the payroll platform before connecting the integration.

1. **Set PayCat as your payroll platform.** Go to **[Settings > Scheduling](https://app.astalty.com.au/settings/scheduling)** and, under **Payroll & Awards**, set the **Platform** to **PayCat**.
2. **Connect the integration.** Go to **[Settings > Integrations](https://app.astalty.com.au/settings/integrations)** - the **PayCat** card now appears. Select **Connect** and follow the prompts to authorise the connection. Once authorised, choose the PayCat **business** Astalty should sync with. See [Businesses and employing entities](#businesses-and-employing-entities).
3. **Configure it.** Once connected, select **Configure** to link **employees**, map **pay groups**, **[cost codes](https://docs.astalty.com.au/guide/finance/cost-codes)** and **[leave types](https://docs.astalty.com.au/guide/scheduling/leave)**, and set sleepover export behaviour.

**Cost Codes** appears only when cost codes are enabled for the account. **Custom Allowances** appears when your account uses [custom allowances](https://docs.astalty.com.au/guide/scheduling/setup/custom-allowances); map each one to the PayCat work type that pays it.

## Businesses and Employing Entities

The business you choose is a payroll file, with its own employees, settings and pay runs. The list contains every business the PayCat user who authorised the connection can access, so if a payroll file is missing, that user needs access to it in PayCat.

**Additional employing entities** - extra ABNs that pay some of the employees inside that same payroll file - are never listed there, because PayCat assigns each employee to an entity on their own employee record. Once a business is selected, the PayCat card lists any additional employing entities inside it, so you can confirm your other entity is already covered.

Astalty uses the same payroll connector and mapping workflow for PayCat and [Employment Hero](https://docs.astalty.com.au/guide/integrations/employment-hero), so [Businesses and Employing Entities](https://docs.astalty.com.au/guide/integrations/employment-hero#businesses-and-employing-entities) there explains the shared behaviour in full.

## Employees

Open **Settings > Integrations > PayCat > Configure > Employees**. Link each Astalty user who will appear in a timesheet batch to one PayCat employee. The bulk link drawer automatically suggests employees with matching email addresses; review every suggestion before selecting **Link Employees**. One PayCat employee cannot be linked to more than one Astalty user.

For the complete filter, bulk link and bulk pay group workflow, see [Employees](https://docs.astalty.com.au/guide/integrations/employment-hero#employees). The controls use the PayCat label on a PayCat account.

## Sending Timesheet Batches

Once employees and pay groups are mapped, open a [timesheet batch](https://docs.astalty.com.au/guide/scheduling/timesheet-batches) and use the **Actions** menu:

- **Send to PayCat** - validates the batch, then creates the timesheets in PayCat. The **PayCat Sync Results** card shows the status, number of timesheets sent, any failure reason and employees whose lines were dropped.
- **Replace in PayCat** - available after a batch has been sent. Deletes timesheets in the batch's date range for its workers and replaces them with the current batch, so use it instead of sending twice.
- **Export PayCat Timesheet (CSV)** - produces a CSV you can import into PayCat by hand.

Validation runs before anything is sent. Blocking errors stop the send; warnings don't, and leave an **Export anyway** button. See [Employment Hero validation errors](https://docs.astalty.com.au/guide/scheduling/timesheet-batches#employment-hero-validation-errors) - the checks are identical, just named after PayCat.

> **Replacing is destructive**
>
> **Replace in PayCat** removes all timesheets in that date range for the workers in the batch, including any entered directly in PayCat, before re-creating the batch. It also removes lines that an earlier send of this batch created for a worker the current batch no longer sends. Validation names those lines first. PayCat keeps any line a pay run has already processed, and the sync results name anything it refused to clear. Sending a batch twice instead of replacing it can create duplicate entries.

If you delete a batch after sending it, its lines can remain in PayCat. When you validate another batch covering those dates, Astalty warns for each affected worker. Select **Remove lines**, review the worker and date range, then select **Remove from PayCat** if those lines should not be paid. PayCat keeps any line a pay run has already processed and Astalty reports each line it could not remove.

## Switching From Another Payroll Platform

Changing **Settings > Scheduling > Payroll & Awards > Platform** changes labels and the authorisation host, but it does not remove the saved payroll credentials or selected business.

1. Open the existing payroll integration under **Settings > Integrations** and select **Disconnect**.
2. Change **Platform** to **PayCat**.
3. Connect PayCat, choose its business and review every employee, pay group, cost code and leave mapping before sending a batch.
