# QuickBooks Payroll

Source: https://docs.astalty.com.au/guide/integrations/quickbooks-payroll

> Sync approved timesheets, pay groups, cost codes, and leave to QuickBooks Payroll.

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

![The QuickBooks logo.](https://docs.astalty.com.au/assets/quickbooks-payroll-logo.png)

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

> **This is QuickBooks Payroll (AU), not QuickBooks accounting**
>
> Astalty uses the same payroll connector and mapping workflow for QuickBooks Payroll, [Employment Hero](https://docs.astalty.com.au/guide/integrations/employment-hero) and [PayCat](https://docs.astalty.com.au/guide/integrations/paycat). On a QuickBooks Payroll account, Astalty uses the **QuickBooks Payroll** label and its provider-specific authorisation address.
>
> It is not the same as QuickBooks accounting, and it is unrelated to the **Quickbooks** line item style on the [invoices export](https://docs.astalty.com.au/guide/exports/invoices-export).

## What It Does

- **Sync timesheet batches** directly to QuickBooks Payroll, or export them as a compatible CSV.
- **Link your team** to QuickBooks Payroll 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 QuickBooks Payroll 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 QuickBooks Payroll.

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

### QuickBooks Payroll Interprets the Award, Not Astalty

Astalty sends worked times and mapped work types. QuickBooks Payroll applies the award or agreement configured in payroll and calculates the resulting penalties, overtime and allowances. Astalty's own **Award Interpretation** view can therefore differ from the final pay run. Review the payroll result before finalising pay.

[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).

> **Meal breaks under SCHADS**
>
> On a SCHADS shift over 5 hours with no break recorded, QuickBooks Payroll 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 QuickBooks Payroll as the payroll platform before connecting the integration.

1. **Set QuickBooks Payroll as your payroll platform.** Go to **[Settings > Scheduling](https://app.astalty.com.au/settings/scheduling)** and, under **Payroll & Awards**, set the **Platform** to **QuickBooks Payroll**.
2. **Connect the integration.** Go to **[Settings > Integrations](https://app.astalty.com.au/settings/integrations)**. The payroll card now reads **QuickBooks Payroll**. Select **Connect** and complete the provider authorisation flow. Astalty does not ask you to paste an API key.
3. **Choose your business.** Back in Astalty, select the QuickBooks Payroll **business** timesheets should be sent to. Until a business is chosen, the integration flags that it isn't ready to sync. See [Businesses and employing entities](#businesses-and-employing-entities).
4. **Configure it.** Select **Configure** to map your **pay groups**, **[cost codes](https://docs.astalty.com.au/guide/finance/cost-codes)**, and **[leave types](https://docs.astalty.com.au/guide/scheduling/leave)**, to link your **employees** to their QuickBooks Payroll profiles, and to set your 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 QuickBooks Payroll work type that pays it.

![The QuickBooks Payroll card on the Integrations settings page, marked Connected, listing what the integration can do (sync approved timesheet batches, export CSV files, map pay groups and cost codes, configure sleepover export behaviour), with the Configure button.](https://docs.astalty.com.au/assets/quickbooks-payroll-integration-card-guide.png)

## 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 QuickBooks Payroll user who authorised the connection can access, so if a payroll file is missing, that user needs access to it in QuickBooks Payroll.

**Additional employing entities** - extra ABNs that pay some employees inside that payroll file - are not separate business choices. QuickBooks Payroll assigns each employee to an entity on the employee record. Once a business is selected, the connection card lists additional employing entities returned for that business, including an ABN where one is available.

Because this uses the same Astalty connector, [Businesses and employing entities](https://docs.astalty.com.au/guide/integrations/employment-hero#businesses-and-employing-entities) on the Employment Hero page explains this in full.

## Employees

Open **Settings > Integrations > QuickBooks Payroll > Configure > Employees**. Link each Astalty user who will appear in a timesheet batch to one QuickBooks Payroll employee. The bulk link drawer automatically suggests employees with matching email addresses; review every suggestion before selecting **Link Employees**. One QuickBooks Payroll 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 QuickBooks Payroll label on this account.

## Sending Timesheet Batches

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

- **Send to QuickBooks Payroll** - validates the batch, then creates the timesheets. The **QuickBooks Payroll Sync Results** card shows the status, number of timesheets sent, any failure reason and employees whose lines were dropped.
- **Replace in QuickBooks Payroll** - available after a batch has been sent. This 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 QuickBooks Payroll Timesheet (CSV)** - produces a CSV you can import by hand.

Validation runs before anything is sent. Blocking errors stop the send; warnings can be reviewed before selecting **Export anyway**.

> **Replacing is destructive**
>
> **Replace in QuickBooks Payroll** removes all timesheets in that date range for the workers in the batch, including any entered directly in QuickBooks Payroll, 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. QuickBooks Payroll 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 QuickBooks Payroll. 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 QuickBooks Payroll** if those lines should not be paid. QuickBooks Payroll keeps any line a pay run has already processed and Astalty reports each line it could not remove.

## Switching From Another Payroll Platform

Astalty holds one payroll connection at a time, and changing the **Platform** setting does not disconnect the account you were already connected to. If you're moving from Employment Hero or PayCat:

1. Go to **[Settings > Integrations](https://app.astalty.com.au/settings/integrations)**, open the existing payroll integration and select **Disconnect**.
2. Change the **Platform** under **[Settings > Scheduling](https://app.astalty.com.au/settings/scheduling)** > **Payroll & Awards** to **QuickBooks Payroll**.
3. Connect QuickBooks Payroll and re-select your business.

> **Disconnect before you switch**
>
> If you change the platform without disconnecting first, the existing credentials and selected business remain. Always disconnect the old provider, then connect the new provider and review the selected business and mappings before sending a batch.
