Overview
This article explains the Xero Diagnostics page designed to assist users troubleshoot issues with the synchonisation or resolve unexpected outcomes.
Admin > Xero > Diagnostics
There are 3 groups of fields on this page:
- Configuration Status
- Synchronisation effective dates
- Default accounts
Status Information
The status information fields include:
| Field | Description |
|---|---|
| Configuration ID | the very first time a user loads the Admin > Xero page, a configuration entry is created and stored in the database. The configuration stores important information required by the system, such as the status, session tokens, default account information and run time information. |
| Config Status | The status of the configuration. Two statuses are supported:
By default, a configuration record is created in an Active state so service providers can get up and running with Xero integration easily. An Inactive status will occur when a session token has expired, or by manual intervention by Emersion staff. An inactive configuration does not mean the link between Xero and Emersion is broken or does not exist. But no synchronisation will occur while the configuration is in an inactive status. If the status is disabled, the session expiry date/time is in the future and you are not certain why it is inactive, please contact the Emersion Customer Service team to assist. |
| Session Expiry | When a physical connection between Xero and Emersion is established, a user session is created and automatically set to expire in 12 months' time. This field shows the date and time the session is due to expire. Expired sessions are the most common reason that synchronisation stops. |
| Last Fetch Time | This shows the date and time that the synchronisation pollers synchronised, or attempted to synchronise data between Xero and Emersion. |
Default Accounts
Start Synchronisation
These fields all relate to controlling how much data is synchronised to Xero when a connection is established for the first time.
Particularly when Xero has been established in a business for some time, it is common to want to start synchronising data from a specific point in time. If these dates were not set, all invoices, payments and credit notes would attempt to be brought into Emersion.
Synchronisation of data before these dates is not possible.
These fields are automatically set by the system. They default to the day and time a user in your company first visits the Xero > Admin section. To vary these dates, please contact the Emersion Customer Support team.