Skip to content

Commit 636466d

Browse files
stephanieelliottstephanieelliott
committed
Add Xero troubleshooting docs (New Expensify)
- Root: Configure, Connect, Xero-Troubleshooting. - Troubleshooting: Auth, Connection, Export, Sync errors, FAQ. - Hub pages already exist on main. Part of Integration Errors Revamp (splitting PR #83106).
1 parent 26ccc41 commit 636466d

30 files changed

Lines changed: 2847 additions & 0 deletions

‎docs/articles/new-expensify/connections/xero/Troubleshooting/Authentication-and-Login-errors/XERO01-Error.md‎

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
---
2+
title: XERO01 Error in Xero Integration
3+
description: Learn what the XERO01 error means and how to resolve connection issues between New Expensify and Xero.
4+
keywords: XERO01, Xero connection error, unable to complete action to Xero, Expensify Xero integration error, Xero sync issue, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the Xero integration in New Expensify. Covers resolving the XERO01 error related to connection issues between Expensify and Xero. Does not cover specific Xero category, tax, or bank account configuration errors.
6+
---
7+
8+
# XERO01 Error in Xero Integration
9+
10+
If you see the error:
11+
12+
XERO01 Error: Unable to complete action to Xero. Please reach out to Concierge for additional assistance.
13+
14+
It means there is a connection issue between the Workspace and Xero.
15+
16+
This error prevents the report or transaction from syncing successfully to Xero.
17+
18+
---
19+
20+
## Why the XERO01 Error Happens in Xero
21+
22+
The XERO01 error typically indicates a disruption in communication between the Workspace and Xero.
23+
24+
Common causes include:
25+
26+
- An expired or disconnected Xero connection.
27+
- Authentication or authorization issues.
28+
- Changes to Xero organization permissions.
29+
- Temporary service interruptions in Xero.
30+
31+
Because this error relates to the integration connection, it cannot be resolved by editing the report itself.
32+
33+
This is a connection issue, not a category or tax configuration issue.
34+
35+
---
36+
37+
# How to Fix the XERO01 Error
38+
39+
Follow the steps below to confirm the connection and retry the export.
40+
41+
---
42+
43+
## Confirm the Xero Connection in the Workspace
44+
45+
1. Go to **Settings > Workspaces**.
46+
2. Select your Workspace.
47+
3. Click **Accounting**.
48+
4. Review the Xero connection status.
49+
5. If prompted, reconnect or reauthorize the Xero integration.
50+
6. Click **Save**.
51+
7. Click **Sync Now**.
52+
53+
After reconnecting, retry the export.
54+
55+
---
56+
57+
## Contact Concierge if the Error Persists
58+
59+
If the error continues after reconnecting:
60+
61+
On web:
62+
1. Go to the navigation tabs on the left.
63+
2. Click **Concierge**.
64+
3. Start a new message and reference the **XERO01 Error**.
65+
66+
On mobile:
67+
1. Tap the navigation tabs on the bottom.
68+
2. Tap **Concierge**.
69+
3. Start a new message and reference the **XERO01 Error**.
70+
71+
Include:
72+
73+
- The full error message.
74+
- The report name or ID.
75+
- The date and time the export was attempted.
76+
77+
Concierge will review the connection and help restore the integration.
78+
79+
---
80+
81+
# FAQ
82+
83+
## Should I Retry the Export Before Contacting Concierge?
84+
85+
Yes. You can retry the export in case the issue was temporary. If the error persists, contact Concierge.
86+
87+
## Does the XERO01 Error Affect All Exports?
88+
89+
It can. If the Xero connection is disrupted, multiple reports or exports may fail until the connection is restored.

‎docs/articles/new-expensify/connections/xero/Troubleshooting/Authentication-and-Login-errors/XERO11-Sync-Error.md‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: XERO11 Sync Error in Xero Integration
3+
description: Learn what the XERO11 sync error means and how to reconnect your Xero integration in New Expensify.
4+
keywords: XERO11, Xero connection expired, reconnect Xero New Expensify, Xero sync error, Expensify Xero integration, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the Xero integration in New Expensify. Covers resolving the XERO11 sync error related to expired Xero credentials and reconnection steps. Does not cover Xero export mapping, tax, or category configuration.
6+
---
7+
8+
# XERO11 Sync Error in Xero Integration
9+
10+
If you see the error:
11+
12+
XERO11 Sync Error: The connection to Xero has expired. Please follow prompts in the Workspace to reconnect.
13+
14+
This means the authentication credentials for your Xero connection have expired.
15+
16+
Until the connection is reauthenticated, syncing and exports to Xero will fail.
17+
18+
---
19+
20+
## Why the XERO11 Sync Error Happens in Xero
21+
22+
The XERO11 error typically occurs when:
23+
24+
- The Xero authentication token has expired.
25+
- The Xero connection was revoked in Xero.
26+
- The connected Xero admin user no longer has access.
27+
- Xero requires reauthorization for security reasons.
28+
29+
Xero requires periodic reauthentication to maintain a secure integration.
30+
31+
This is a connection issue, not a category or export mapping issue.
32+
33+
---
34+
35+
# How to Reconnect Xero in New Expensify
36+
37+
Follow the steps below to restore the connection.
38+
39+
---
40+
41+
## Reconnect the Xero Integration in the Workspace
42+
43+
On web:
44+
45+
1. Go to **Settings > Workspaces**.
46+
2. Select your Workspace.
47+
3. Click **Accounting**.
48+
4. Click the three-dot icon next to the Xero connection.
49+
5. Click **Sync now**.
50+
6. When prompted, click **Reconnect**.
51+
7. Log in using the Xero admin credentials originally used to connect the Workspace.
52+
8. Complete the authorization flow.
53+
54+
On mobile:
55+
56+
1. Tap the navigation tabs on the bottom.
57+
2. Tap **Workspaces**.
58+
3. Select your Workspace.
59+
4. Tap **Accounting**.
60+
5. Tap the three-dot icon next to the Xero connection.
61+
6. Tap **Sync now**.
62+
7. When prompted, tap **Reconnect** and complete the authorization flow.
63+
64+
---
65+
66+
## Retry the Sync or Export
67+
68+
After reconnecting:
69+
70+
1. Go to **Settings > Workspaces > [Workspace Name] > Accounting**.
71+
2. Click **Sync now**.
72+
3. Retry exporting the report if needed.
73+
74+
If the connection was successfully restored, syncing and exports should complete normally.
75+
76+
---
77+
78+
# FAQ
79+
80+
## Do I Need Xero Admin Access to Reconnect?
81+
82+
Yes. You must use a Xero account with admin permissions for the connected organization.
83+
84+
## Will Previously Failed Exports Retry Automatically?
85+
86+
No. You may need to manually retry exports after the connection has been restored.

‎docs/articles/new-expensify/connections/xero/Troubleshooting/Authentication-and-Login-errors/XERO45-Sync-Error.md‎

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
title: XERO45 Sync Error in Xero Integration
3+
description: Learn what the XERO45 sync error means and how to disconnect and reconnect Xero in New Expensify to restore syncing.
4+
keywords: XERO45, Xero invalid authentication token, disconnect Xero New Expensify, reconnect Xero Workspace, Expensify Xero integration, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the Xero integration in New Expensify. Covers resolving the XERO45 sync error related to expired or invalid authentication tokens and reconnection steps. Does not cover Xero export mapping, tax, or category configuration.
6+
---
7+
8+
# XERO45 Sync Error in Xero Integration
9+
10+
If you see the error:
11+
12+
XERO45 Sync Error: Unable to sync Xero data due to an invalid authentication token. Please disconnect and reconnect Xero in the Workspace.
13+
14+
This means the authentication token connecting the Workspace to Xero has expired or is no longer valid.
15+
16+
Until the connection is refreshed, syncing and exports will fail.
17+
18+
---
19+
20+
## Why the XERO45 Sync Error Happens in Xero
21+
22+
The XERO45 error typically occurs when:
23+
24+
- The Xero authentication token has expired.
25+
- The Xero connection was revoked in Xero.
26+
- The connected Xero account credentials were changed.
27+
- The Xero admin user who authorized the connection no longer has access.
28+
29+
When the token is invalid, the Workspace cannot access Xero data.
30+
31+
This is a connection issue, not an export mapping issue.
32+
33+
---
34+
35+
# How to Fix the XERO45 Sync Error
36+
37+
Follow the steps below to disconnect and reconnect the Xero integration.
38+
39+
---
40+
41+
## Save Your Workspace Accounting Configuration
42+
43+
Before disconnecting:
44+
45+
On web:
46+
1. Go to **Settings > Workspaces**.
47+
2. Select your Workspace.
48+
3. Click **Accounting**.
49+
4. Review and save your settings under:
50+
- **Export**
51+
- **Coding**
52+
- **Advanced**
53+
54+
Disconnecting may remove imported options and configuration settings.
55+
56+
On mobile:
57+
1. Tap the navigation tabs on the bottom.
58+
2. Tap **Workspaces**.
59+
3. Select your Workspace.
60+
4. Tap **Accounting**.
61+
5. Review your accounting configuration settings.
62+
63+
---
64+
65+
## Disconnect Xero From the Workspace
66+
67+
On web:
68+
1. Go to **Settings > Workspaces > [Workspace Name] > Accounting**.
69+
2. Click the three-dot icon next to the Xero connection.
70+
3. Click **Disconnect from Xero**.
71+
4. Click **Disconnect** to confirm.
72+
5. Refresh the page to confirm the connection is removed.
73+
74+
On mobile:
75+
1. Tap the navigation tabs on the bottom.
76+
2. Tap **Workspaces**.
77+
3. Select your Workspace.
78+
4. Tap **Accounting**.
79+
5. Tap the three-dot icon next to the Xero connection.
80+
6. Tap **Disconnect** and confirm.
81+
82+
---
83+
84+
## Reconnect to Xero in the Workspace
85+
86+
1. In **Settings > Workspaces > [Workspace Name] > Accounting**, click **Connect to Xero**.
87+
2. Log in using the appropriate Xero admin credentials.
88+
3. Select the correct Xero organization.
89+
4. Complete the authorization flow.
90+
5. Click **Save** if prompted.
91+
92+
---
93+
94+
## Run Sync
95+
96+
1. Go to **Settings > Workspaces > [Workspace Name] > Accounting**.
97+
2. Click the three-dot icon.
98+
3. Click **Sync now**.
99+
100+
If the connection is successfully restored, syncing and exports should complete normally.
101+
102+
---
103+
104+
# FAQ
105+
106+
## Do I Need Xero Admin Access to Reconnect?
107+
108+
Yes. You must use a Xero account with admin permissions for the connected organization.
109+
110+
## Will Disconnecting Remove My Configuration?
111+
112+
It may remove imported options and accounting settings. Save your configuration before disconnecting so you can reapply any custom settings if needed.

‎docs/articles/new-expensify/connections/xero/Troubleshooting/Authentication-and-Login-errors/XERO84-Sync-Error.md‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
title: XERO84 Sync Error in Xero Integration
3+
description: Learn what the XERO84 sync error means and how to select the correct Xero organization for your Workspace in New Expensify.
4+
keywords: XERO84, Xero organization not selected, select Xero company Expensify, Xero sync error organization, Expensify Xero integration, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the Xero integration in New Expensify. Covers resolving the XERO84 sync error related to missing Xero organization selection. Does not cover authentication token, connection expiration, or export mapping issues.
6+
---
7+
8+
# XERO84 Sync Error in Xero Integration
9+
10+
If you see the error:
11+
12+
XERO84 Sync Error: There was a problem syncing Xero data. Please select which Xero organization or company this Workspace should sync with.
13+
14+
This means no Xero organization is selected in your Workspace settings.
15+
16+
Until an organization is selected, the Workspace cannot sync data with Xero.
17+
18+
---
19+
20+
## Why the XERO84 Sync Error Happens in Xero
21+
22+
The XERO84 error typically occurs when:
23+
24+
- The Workspace is connected to Xero.
25+
- No specific **Xero organization** has been selected in the Workspace configuration.
26+
- The organization selection was cleared or not completed during setup.
27+
28+
Without selecting an organization, the Workspace does not know which Xero company to sync with.
29+
30+
This is a configuration issue, not an authentication token or export mapping issue.
31+
32+
---
33+
34+
# How to Fix the XERO84 Sync Error
35+
36+
Follow the steps below to select the correct Xero organization and retry the sync.
37+
38+
---
39+
40+
## Select the Xero Organization in the Workspace
41+
42+
On web:
43+
44+
1. Go to **Settings > Workspaces**.
45+
2. Select your Workspace.
46+
3. Click **Accounting**.
47+
4. Click **Export**.
48+
5. At the top of the page, select the correct **Xero organization** from the dropdown.
49+
6. Click **Save**.
50+
51+
On mobile:
52+
53+
1. Tap the navigation tabs on the bottom.
54+
2. Tap **Workspaces**.
55+
3. Select your Workspace.
56+
4. Tap **Accounting**.
57+
5. Tap **Export**.
58+
6. Select the appropriate **Xero organization**.
59+
7. Tap **Save**.
60+
61+
---
62+
63+
## Run Sync
64+
65+
After saving:
66+
67+
1. Go to **Settings > Workspaces > [Workspace Name] > Accounting**.
68+
2. Click the three-dot icon next to the Xero connection.
69+
3. Click **Sync now**.
70+
71+
If the correct organization is selected, the sync should complete successfully.
72+
73+
---
74+
75+
# FAQ
76+
77+
## Why Don’t I See My Xero Organization in the Dropdown?
78+
79+
Make sure you are logged in with a Xero account that has access to the organization. If needed, disconnect and reconnect using the correct Xero admin account.
80+
81+
## Do I Need Xero Admin Access to Select the Organization?
82+
83+
Yes. The connected Xero account must have access to the organization you want to sync with.

0 commit comments

Comments
 (0)