Xero Tax Return AutoFile (Australia and New Zealand Only)

The Xero - Tax Return process automatically files batches of all tax returns (received electronically via Xero Tax).  The process calls out to Xero Tax on a scheduled daily basis (overnight) to retrieve all newly issued returns since the process was last run.

The tax returns that have been automatically filed are displayed in the Client - Tax tab and in the Documents list (in the Client - Documents tab or the main Documents list). For information on what is automatically created in FYI from Xero Tax, and where they display, refer to Displaying the Auto-Filed Tax Returns.

The Xero Tax Return process is only triggered when the return is a refund or nil, or if it has a date payable populated. If it is a payable notice but does not have a payable date, the process will not be triggered.

Note: The Xero Tax automation does not process Tax Returns retrospectively. The automation will only run for updates after either the Start Date selected in the automation or the date the automation was set to active, whichever is later.

Enabling Xero Tax Integration

To automatically file and process tax returns and assessments from Xero Tax (using the Tax automations). the Xero Tax app must be enabled by an FYI Admin. Refer to Enabling Xero Tax Integration (Australia and New Zealand Only) or Connecting FYI to Xero Tax for GreatSoft Practices.

Editing the Tax Return AutoFile

  1. From FYI, click the Automation menu option.
  2. Go to the Processes tab.
  3. In Xero - Tax Return, click the cog icon to edit this process.

  4. To make this process active, change the Status to "Active".
  5. Review the settings and steps and make any changes if needed.

The Trigger for the Tax Return AutoFile is "Scheduled Daily".

The Filter for this process is "All tax returns".

Select the name of the Owner of the process. If the process fails, an email will be sent to this user as a notification. You can set this as "Me" to set yourself as the owner.

Start From allows you to enter the date you want to start retrieving the documents. If you enter a date in the past, this will import documents from that date, This will only import documents that have not already been imported.

Last Run shows the date the process was last run. It includes a green tick or a red X icon to indicate if the process ran as a success or with an error.  Refer to Automation History.

Note: If you need to reset the process, for example, if the step was deleted, click Reset. This will restore the process back to the default configurations. 

Process Steps

The step in the Tax Return AutoFile is to import from the Application Xero Tax and Action is set to Import Tax Return to file the returns that have been imported. The following shows how these are set by default.


The Filing section determines how the document is filed. These are set up with merge fields to include the from and to tax period in the file name, and to file the document in the relevant Year category.

Name - the Name includes the merge fields for the Tax Return ({{Tax_Type}} | {{TaxPeriodFrom}} - {{TaxPeriodTo}}).

AutoFile is disabled so the document will be filed using the settings in this process step.

Cabinet is set as default to "Final Reports & Returns".

For Year, this includes the merge field "TaxYear" so the email will be automatically filed in the relevant tax year for the Year category.

Filing - defaults to "Filed" so the email will be automatically filed.

In the Workflow section, the Owner is set as the client's Manager and the Status is set as "Client Signed".

You can change any options for Filing, Workflow, or creating a Task, and enable Comments as required (refer to Automation Notifications). You can add steps if required. Refer to Automation Process Steps and the articles in the section Process Step Details.

Note: The Workflow Status options available in the drop-down will depend on the Approval Level assigned to the user in their User Profile. For example, a User with an Approval Level of None will not be able to view or select "Pending Client Signature". Refer to Workflow Basics and Managing Users

Note: If you need to change any filing details, such as the Cabinet, for different types of returns, this can be done once the document is imported in FYI. 

Note: Once everything is set up, note that the returns are imported overnight.


Was this article helpful?
0 out of 2 found this helpful