Xero Payroll Integration for Scheduling
Overview
This guide explains how to set up Xero Payroll Integration for Scheduling between Astalty and Xero.
Astalty allows you to integrate with your Xero account so that Timesheet Batches created from Scheduling can be sent directly to Xero for payroll processing. This integration reduces manual payroll entry and ensures that employee hours recorded in Astalty are accurately transferred to Xero.
The accounting and payroll workflows use the same Xero connection but have different setup requirements. Accounting invoice sync needs the Xero accounting connection and invoice settings such as a default sales account. Payroll export additionally needs Xero selected as the payroll platform, payroll authorisation scopes, employee and Pay Item mappings, employment details and payroll calendars. A connection configured only for accounting is not enough for payroll export.
Once configured, you will be able to:
- Map Pay Items from Xero to Astalty
- Export reviewed Timesheet Batches from Astalty to Xero as draft timesheets
- Process payroll in Xero using the hours recorded in Astalty
Prerequisites
Before setting up the integration, ensure the following requirements are met:
- You have access to the HR details of the employees whose employment records you set up.
- The authorising Xero user can grant the accounting and Australian payroll scopes requested by Astalty, including access to employees, payroll calendars, Pay Items and timesheets, and optional read-only access to pay runs. Confirm current Xero access requirements with your Xero administrator.
- Your Xero organisation uses Xero Payroll AU and has the employees and Pay Items required for the export.
- Employees exist in both Astalty and Xero.
- You have a Payroll Calendar set up in Xero and assigned to each employee. Xero controls the current screens and available calendar types.
- You have selected Xero as the payroll platform and synced the required payroll calendars. If you create manually dated batches, also select a default payroll calendar in Astalty's Xero settings. A manually dated batch uses that default for validation; a batch generated from a synced calendar uses the calendar selected for that batch.

Getting Setup
Complete these guides in order:
- Configuring Xero in Astalty
- Setting up Pay Items and Employee Pay Templates in Xero
- Setting up Pay Groups and Employees in Astalty
- Sync Payroll Calendars from Xero
- Process Timesheet Batches for Xero Payroll Integration
How a Pay Run Moves from Astalty to Xero
- Review and approve the shifts, travel, breaks, on-call work and other records for the pay period.
- Create a Timesheet Batch for the correct Xero payroll calendar and period.
- Select Export Xero Timesheet (API) and run Validate. Errors must be fixed. Warnings can mean Astalty will replace an existing draft, remove earlier hours for a worker who left the batch, or leave one worker out while sending the rest. A worker is left out when Xero already holds, for them, a timesheet for this period that isn't a draft, a draft another Astalty batch for these dates sent, a timesheet that overlaps the batch without matching it, a later timesheet, or a posted pay run for a later period, or when their Xero employee has no ordinary earnings rate - see Timesheet Already Exists. Approved timesheets an earlier export of this batch sent can be reverted with a switch beside Continue anyway.
- Select the employees, accept the export checks and select Create Export. Astalty sends each worker separately and records a Completed, Partially failed, or Failed result.
- In Xero, review each draft timesheet, confirm the earnings rates, daily units and payroll totals, then approve the timesheets and process the pay run. Approve again any timesheet Astalty reverted to draft.
If you correct and re-export the same batch, Astalty replaces the hours in an existing draft for that worker. It also removes earlier hours from the draft of a worker who has left the batch, provided that draft came from a recorded export of the same batch and is still a draft. See Process Timesheet Batches for Xero Payroll Integration for the conflict and recovery rules.