Skip to content

Commit b341eda

Browse files
stephanieelliottstephanieelliott
committed
Add Sage Intacct troubleshooting docs (New Expensify)
- Root: Configure, Connect, 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 b341eda

42 files changed

Lines changed: 3845 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/articles/new-expensify/connections/sage-intacct/Troubleshooting/Authentication-and-Login-errors/INT122-Sync-Error.md‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
---
2+
title: INT122 Sync Error in Sage Intacct Integration
3+
description: Learn what the INT122 sync error means and how to update Sage Intacct web services credentials and Sender ID settings to restore the connection.
4+
keywords: INT122, Sage Intacct authentication error, xmlgateway_expensify credentials, Sage Intacct Web Services Authorizations, Sender ID expensify lowercase, Sage Intacct sync authentication failure, Workspace Admin
5+
internalScope: Audience is Workspace Admins managing the Sage Intacct integration. Covers resolving the INT122 sync error caused by authentication and web services credential issues. Does not cover export data validation errors.
6+
---
7+
8+
# INT122 Sync Error in Sage Intacct Integration
9+
10+
If you see the error:
11+
12+
INT122 Sync Error: Authentication error during sync. Please reenter Sage Intacct admin credentials and attempt sync again.
13+
14+
This means the connection between the Workspace and Sage Intacct cannot be authenticated.
15+
16+
When authentication fails, syncing and exports will not work.
17+
18+
---
19+
20+
## Why the INT122 Sync Error Happens in Sage Intacct
21+
22+
The INT122 error typically occurs when:
23+
24+
- The credentials for the **xmlgateway_expensify** web services user are incorrect.
25+
- The password for the web services user was changed but not updated in the Workspace.
26+
- The required **Web Services Authorization (Sender ID)** is missing.
27+
- The Sender ID is not entered exactly as required.
28+
29+
If Sage Intacct cannot authenticate the integration user, the sync will fail.
30+
31+
This is an authentication issue, not a report data or export configuration issue.
32+
33+
---
34+
35+
## How to Fix the INT122 Sync Error
36+
37+
Follow the steps below to verify credentials and restore the connection.
38+
39+
---
40+
41+
## Confirm xmlgateway_expensify Credentials in Sage Intacct
42+
43+
1. Log in to Sage Intacct as an administrator.
44+
2. Locate the **xmlgateway_expensify** web services user.
45+
3. Confirm:
46+
- The username is correct.
47+
- The password is correct.
48+
- The user is active.
49+
- The user has the required module permissions.
50+
4. If the password was changed, update it in the Workspace connection settings.
51+
52+
Save any changes.
53+
54+
---
55+
56+
## Confirm Web Services Authorizations (Sender ID)
57+
58+
1. In Sage Intacct, go to **Company > Setup > Company**.
59+
2. Click **Security**.
60+
3. Click **Edit**.
61+
4. Scroll to **Web Services Authorizations**.
62+
5. Add **expensify** as a **Sender ID**.
63+
64+
Important:
65+
66+
- The Sender ID must be entered as **expensify** (all lowercase).
67+
- Do not use uppercase letters.
68+
- Do not add spaces.
69+
70+
If **expensify** is already listed and the error continues:
71+
72+
1. Remove it from the list.
73+
2. Add **expensify** again (all lowercase).
74+
3. Click **Save**.
75+
76+
---
77+
78+
## Retry the Sync
79+
80+
After confirming credentials and Sender ID settings:
81+
82+
1. Go to **Workspaces > [Workspace Name] > Accounting**.
83+
2. Select **Sync Now**.
84+
3. Confirm the sync completes successfully.
85+
86+
If authentication is configured correctly, the sync should complete without errors.
87+
88+
---
89+
90+
# FAQ
91+
92+
## Does the Sender ID Have to Be Lowercase?
93+
94+
Yes. The Sender ID must be entered exactly as **expensify** in all lowercase.
95+
96+
## Do I Need Sage Intacct Admin Access to Fix This?
97+
98+
Yes. Updating web services users and Web Services Authorizations requires administrator permissions in Sage Intacct.
99+
100+
## Does This Error Affect Exports?
101+
102+
Yes. If the sync fails due to authentication, exports and other integration features will not function until the connection is restored.

‎docs/articles/new-expensify/connections/sage-intacct/Troubleshooting/Authentication-and-Login-errors/INT176-Export-Error.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
---
2+
title: INT176 Export Error in Sage Intacct Integration
3+
description: Learn what the INT176 export error means and what to do when a session or connection issue prevents exporting to Sage Intacct.
4+
keywords: INT176, Sage Intacct session initialization error, Sage Intacct connection issue export, Sage Intacct integration session failure, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the Sage Intacct integration. Covers resolving the INT176 export error caused by session or connection failures. Does not cover report data validation or configuration errors.
6+
---
7+
8+
# INT176 Export Error in Sage Intacct Integration
9+
10+
If you see the error:
11+
12+
INT176 Export Error: Session initialization error. Please reach out to Concierge for additional support.
13+
14+
This means there is a session or connection issue between the Workspace and Sage Intacct that is preventing the export from starting.
15+
16+
The export cannot proceed because the integration session failed to initialize.
17+
18+
---
19+
20+
## Why the INT176 Export Error Happens in Sage Intacct
21+
22+
The INT176 error typically occurs when:
23+
24+
- The Sage Intacct integration session cannot be initialized.
25+
- Authentication credentials are temporarily invalid.
26+
- The connection between systems is interrupted.
27+
- There is a temporary backend communication issue.
28+
29+
Because this error relates to the integration session itself, it cannot be resolved by editing the report or updating coding fields.
30+
31+
This is a connection-level issue, not a data validation or configuration issue.
32+
33+
---
34+
35+
## How to Fix the INT176 Export Error
36+
37+
This error requires additional investigation.
38+
39+
Follow the steps below.
40+
41+
---
42+
43+
## Retry the Export Once
44+
45+
1. Open the report.
46+
2. Retry the export.
47+
3. If the error persists, continue to the next step.
48+
49+
---
50+
51+
## Contact Concierge for Support
52+
53+
Please reach out to **Concierge** and include:
54+
55+
- The full error message.
56+
- The report name or ID.
57+
- The date and time the export was attempted.
58+
59+
Concierge will review the integration logs and determine whether:
60+
61+
- The connection needs to be refreshed.
62+
- Credentials need to be reauthenticated.
63+
- A backend issue needs to be resolved.
64+
65+
---
66+
67+
# FAQ
68+
69+
## Can I Fix This by Running Sync Now?
70+
71+
No. This error is related to session initialization and typically requires backend review.
72+
73+
## Does This Mean the Integration Is Disconnected?
74+
75+
Not necessarily. It indicates a session issue. Concierge can confirm whether the connection needs to be refreshed or reconfigured.
76+
77+
## Does This Affect All Exports?
78+
79+
It can. If the integration session cannot initialize, additional exports may fail until the issue is resolved.

‎docs/articles/new-expensify/connections/sage-intacct/Troubleshooting/Authentication-and-Login-errors/INT245-Sync-Error.md‎

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
---
2+
title: INT245 Sync Error in Sage Intacct Integration
3+
description: Learn what the INT245 sync error means and how to update Sage Intacct web services user permissions or configure the reimbursable export option.
4+
keywords: INT245, Sage Intacct invalid credentials error, xmlgateway permissions Sage Intacct, Sage Intacct web services user permissions, reimbursable export option Vendor Bill, Sage Intacct sync error, Workspace Admin
5+
internalScope: Audience is Workspace Admins managing the Sage Intacct integration. Covers resolving the INT245 sync error caused by missing web services user permissions or incomplete reimbursable export configuration. Does not cover data validation export errors.
6+
---
7+
8+
# INT245 Sync Error in Sage Intacct Integration
9+
10+
If you see the error:
11+
12+
INT245 Sync Error: Invalid credentials for Sage Intacct. The Sage Intacct user is missing required permissions or the reimbursable export option isn’t fully configured.
13+
14+
This means either:
15+
16+
- The Sage Intacct web services user does not have the required permissions, or
17+
- The reimbursable export configuration was not completed correctly during setup.
18+
19+
Sync and exports will fail until this issue is resolved.
20+
21+
---
22+
23+
## Why the INT245 Sync Error Happens in Sage Intacct
24+
25+
The INT245 error typically occurs when:
26+
27+
- Required module permissions are missing for the Sage Intacct web services user.
28+
- The web services user subscription is incomplete.
29+
- The reimbursable export option (Expense Report vs Vendor Bill) was not fully configured during the connection process.
30+
- The Time & Expense module is not used, but the Workspace is configured to export as Expense Reports.
31+
32+
The resolution depends on how reimbursable expenses are configured to export.
33+
34+
---
35+
36+
# How to Fix the INT245 Sync Error
37+
38+
Follow the section below that matches your export configuration.
39+
40+
---
41+
42+
## If Reimbursable Expenses Export as Expense Reports
43+
44+
### Update Web Services User Permissions in Sage Intacct
45+
46+
1. Log in to Sage Intacct as an administrator.
47+
2. Go to **Company > Web Services Users**.
48+
3. Select the web services user used for the integration.
49+
4. Click the **Subscriptions** link.
50+
5. Confirm the correct applications are enabled.
51+
6. Click **Permissions** and verify the following access levels:
52+
53+
- **Administration:** All
54+
- **Company:** Read-only
55+
- **Cash Management:** All
56+
- **General Ledger:** All
57+
- **Time & Expense:** All
58+
- **Projects:** Read-only (only required if importing projects and customers)
59+
- **Accounts Payable:** All (required if exporting non-reimbursable expenses as Vendor Bills)
60+
61+
7. Click **Save**.
62+
63+
### Sync the Workspace
64+
65+
1. Go to **Settings > Workspaces**.
66+
2. Select your Workspace.
67+
3. Click **Accounting**.
68+
4. Click **Sync Now**.
69+
70+
If permissions are correct, the sync should complete successfully.
71+
72+
---
73+
74+
## If Reimbursable Expenses Export as Vendor Bills
75+
76+
This error may indicate that the reimbursable export configuration was not completed during setup.
77+
78+
If the **Time & Expense** module is not used in Sage Intacct, reimbursable expenses must export as **Vendor Bills**.
79+
80+
### Update the Reimbursable Export Option
81+
82+
1. Go to **Settings > Workspaces**.
83+
2. Select your Workspace.
84+
3. Click **Accounting**.
85+
4. Click **Configure**.
86+
5. Open the **Export** tab.
87+
6. Change the **Reimbursable export option** to **Vendor Bill**.
88+
7. Click **Save**.
89+
90+
Then:
91+
92+
1. Click **Sync Now** under **Accounting**.
93+
2. Confirm the sync completes without errors.
94+
95+
---
96+
97+
# FAQ
98+
99+
## Do I Need Sage Intacct Admin Permissions to Fix This?
100+
101+
Yes. Updating web services user subscriptions and permissions requires administrative access in Sage Intacct.
102+
103+
## What Does “No Expense Types Found” Mean?
104+
105+
This appears when the **Time & Expense** module is not used. In that case, reimbursable expenses should export as **Vendor Bills**, not Expense Reports.
106+
107+
## Does This Error Affect Exports?
108+
109+
Yes. If the sync fails due to permission or configuration issues, exports cannot proceed until the issue is resolved.

‎docs/articles/new-expensify/connections/sage-intacct/Troubleshooting/Authentication-and-Login-errors/INT498-Sync-Error.md‎

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
title: INT498 Sync Error in Sage Intacct Integration
3+
description: Learn what the INT498 sync error means and how to configure the required Intacct Cash Journal and Accrual Journal for Expensify Card before syncing.
4+
keywords: INT498, Sage Intacct liability credit card error, Intacct Cash Journal not configured, Intacct Accrual Journal missing, Expensify Card Sage Intacct sync error, Domain Company Cards journal configuration, Workspace Admin
5+
internalScope: Audience is Domain Admins and Workspace Admins managing Expensify Card with the Sage Intacct integration. Covers resolving the INT498 sync error caused by missing journal configuration for liability credit cards. Does not cover expense report export errors.
6+
---
7+
8+
# INT498 Sync Error in Sage Intacct Integration
9+
10+
If you see the error:
11+
12+
INT498 Sync Error: Sage Intacct couldn’t create the liability credit card because journal accounts aren’t configured.
13+
14+
This means the required Sage Intacct journals have not been selected for **Expensify Card** transactions.
15+
16+
Sage Intacct requires both a **Cash Journal** and an **Accrual Journal** to create the liability credit card account.
17+
18+
---
19+
20+
## Why the INT498 Sync Error Happens in Sage Intacct
21+
22+
The INT498 error typically occurs when:
23+
24+
- Expensify Card transactions are being exported.
25+
- A valid **Intacct Cash Journal** is not selected.
26+
- A valid **Intacct Accrual Journal** is not selected in Domain settings.
27+
28+
Without these journals configured, Sage Intacct cannot create or manage the required liability credit card account.
29+
30+
This is a Company Cards configuration issue, not an expense report export issue.
31+
32+
---
33+
34+
# How to Fix the INT498 Sync Error
35+
36+
Follow the steps below to configure the required journals and retry the sync.
37+
38+
---
39+
40+
## Configure Intacct Cash and Accrual Journals for Expensify Card
41+
42+
1. Go to **Settings > Domains**.
43+
2. Select your Domain.
44+
3. Click **Company Cards**.
45+
4. Open the **Settings** tab.
46+
5. Select a valid **Intacct Cash Journal** from the dropdown.
47+
6. Select a valid **Intacct Accrual Journal** from the dropdown.
48+
7. Click **Save**.
49+
50+
Both journals must be configured.
51+
52+
---
53+
54+
## Sync the Workspace
55+
56+
After updating the journal settings:
57+
58+
On web:
59+
60+
1. Go to the navigation tabs on the left and select **Workspaces**.
61+
2. Select your Workspace.
62+
3. Click **Accounting**.
63+
4. Click **Sync Now**.
64+
65+
On mobile:
66+
67+
1. Tap the navigation tabs on the bottom and select **Workspaces**.
68+
2. Select your Workspace.
69+
3. Tap **Accounting**.
70+
4. Tap **Sync Now**.
71+
72+
If the journals are configured correctly, the sync should complete successfully.
73+
74+
---
75+
76+
# FAQ
77+
78+
## Do I Need Both a Cash Journal and an Accrual Journal?
79+
80+
Yes. Sage Intacct requires both journals to create and manage liability credit card transactions.
81+
82+
## Who Can Update Company Card Journal Settings?
83+
84+
Only **Domain Admins** (or users with appropriate domain-level permissions) can update Company Card settings.
85+
86+
## Does the INT498 Sync Error Affect Expense Report Exports?
87+
88+
No. This error is specific to Expensify Card transactions and liability credit card creation.

0 commit comments

Comments
 (0)