Who can use this feature
Roles: Owner, Admin, Staff, Client
Plans: Available on Standard, Plus, Advanced and Scale
How to connect Xero Payroll to Syft
Choose the relevant entity from "Home" or use the dropdown selector; completing this process for entity X will pull through entity X’s payroll data.
Navigate to "Connections", click "Add connection", click "Payroll" and select Xero Payroll. You will be prompted to re-authorize your Xero entities which will initiate the data fetch for the payroll data.
Integration Requirements
To ensure a smooth integration between Syft and Xero Payroll, the following conditions must be met:
Matching Entities: The accounting entity on Syft and its matching payroll connection must correspond to the same entity (and organization) on Xero.
User Access: The user authorizing the payroll connection on Syft must have access to the payroll portion of the organization on Xero. Without this access, the payroll API cannot be accessed.
Entity Selection on Syft: When connecting payroll, the user must have the same entity on Syft selected as the one being connected on Xero. The entity must be selected on Syft when adding Xero payroll. Once the initial set up (data fetch) is complete, the connection can then be shared acorss entities as normal.
By ensuring these requirements are met, users can successfully authorize and integrate Xero Payroll with Syft, enabling seamless payroll management and data synchronization.
Important to note
Syft requires that you already have your Xero accounting entity already on Syft beforehand. The entity must have completed its setup on Syft i.e. the entity cannot still be loading data from Xero in its initial setup.
Xero Payroll connections can only be added on the matching Xero entity on Syft. After the initial setup is complete the connection can be shared with other entities.
Departmental data will not be pulled through which means that a single “Totals” connection will be created.
Scopes Used
Connecting your Xero Payroll account to Syft involves specific permissions and roles. This section outlines the necessary scopes and requirements for a successful integration.
When authorizing the payroll connections on Xero, the following scopes will be shown to you, the user:
"openid": Indicates that the Syft application intends to use the user’s identity.
"profile": Includes the user's first name, last name, full name and Xero user ID.
"email": Accesses the user's email address.
"offline_access": Grants a refresh token for long-term access without requiring the user to log in again.
"payroll.employees.read": Allows viewing of the company's employees.
"payroll.payruns.read": Allows viewing of the pay runs.
"payroll.payslip.read": Allows viewing of the pay slips.
"accounting.settings": Allows viewing and modification of the organization settings.
"accounting.settings.read": Allows viewing of the organization settings.
Xero Permissions
To authorize any API connection, the Xero user must meet the following role requirements:
Standard or Adviser Role: The user must have either the Standard or Adviser role in (Payroll or Accounting) to authorise any API connection.
Payroll Administrator: Only users with payroll administrator access (payroll admin role) can authorize access to payroll endpoints .