Plan: Available: All plans
Users: Not Available: All users Available: FYI Admins or User Group permissions
Practice Management Source: Not Available: APS, IRIS, MYOB AE & AO, CCH Central Available: FYI, Xero Practice Manager, MYOB Practice Management (formerly GreatSoft)
The Xero Tax integration allows FYI to automatically import tax returns and Notices of Assessment from Xero Tax. Once enabled, FYI can process and file these documents using automation processes.
This integration is available for practices using Xero Tax in Australia and New Zealand.
Note: Xero Tax cannot be connected when integrated with Practice Sync, for example MYOB AE/AO.
Connecting Xero Tax
Enable the Xero Tax App
To automatically file and process tax returns and assessments from Xero Tax, the Xero Tax app must be enabled in FYI.
- In FYI, go to Automation.
-
Select the Apps tab.
-
Locate Xero Tax and click the cog icon to open the settings.
-
In Xero Tax Settings, enable the Import tax assessments option.
-
Optional: Enable the Consider notices of assessment complete without payable date option if required.
This allows tax automation processes to trigger when a Notice of Assessment contains both a Date of Issue and the amount payable/refundable, even if the payable date field has not been completed.
Activate the Tax Automation Process
After enabling the Xero Tax App, the automation process responsible for importing the returns must be activated.
Refer to Xero Tax Return AutoFile (Australia and New Zealand Only) for instructions on activating the process.
Note: Once the integration and automation process has been configured, tax returns will be imported overnight.
Merge Fields
Once the Xero Tax integration has been enabled, new Merge Fields will be available to use in FYI.
Note: The Tax Merge Fields only work after lodgement. Tax Merge Fields are not available to use for Activity Statements.
These fields are used in the FYI pre-figured processes for Tax Assessments, which are triggered by tax returns and assessments from Xero Tax. If these Tax Merge Fields are used in any other processes (such as Custom Processes) or if a template with the Tax Merge Fields is used when creating a new Spreadsheet, they will retrieve the data from the most recent Tax Return or Assessment. Refer to Using Advanced Tax-Related Merge Fields.
| Field | Details | Merge Field Code |
|---|---|---|
| Est. Payable/Refundable | The amount of the estimated refund that is payable or refundable. |
In FYI: Word/Excel: |
| Estimated Income | The amount of the estimated income tax. |
In FYI: Word/Excel: |
| Income | The amount of the income tax. |
In FYI: Word/Excel: |
| Income variance | The amount of the variance from the estimate of the income tax. |
In FYI: Word/Excel: |
| Issue Date | The date it was issued by the ATO. |
In FYI: Word/Excel: |
| Lodgement Date | The date it was logged to the ATO. |
In FYI: Word/Excel: |
| Payable Date | The date the refund is payable. |
In FYI: Word/Excel: |
| Payable/Refundable | The amount of the refund that is payable or refundable. |
In FYI: Word/Excel: |
| Payable/Refundable Variance | The amount of the variance from the estimate of the amount payable or refundable. |
In FYI: Word/Excel: |
| Period From | The From date of the period. |
In FYI: Word/Excel: |
| Period To | The To date of the period. |
In FYI: Word/Excel: |
| State | The state of the tax submission, that is, Draft, Filed, Completed. |
In FYI: Word/Excel: |
| Type |
The Tax Type code. Refer to Using Advanced Tax-Related Merge Fields for a list of tax codes. |
In FYI: Word/Excel: |
| Year |
The most recent dataset of the relevant client. Merge Fields can be customised to select a specific year. Refer to Using Advanced Tax-Related Merge Fields. |
In FYI: Word/Excel: |