Skip to content

Commit 86fc3e9

Browse files
stephanieelliottstephanieelliott
committed
Add New Expensify NetSuite troubleshooting docs
- Authentication-and-Login-errors: 9 articles - Connection-errors: 7 articles - Export-Errors: 57 articles (incl. NS0521-Sync-Error in Export-Errors) - Sync-Errors: 16 articles - NetSuite-FAQ.md Part of Integration Errors Revamp (splitting PR #83106). Made-with: Cursor
1 parent e1773e4 commit 86fc3e9

87 files changed

Lines changed: 9135 additions & 0 deletions

File tree

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/netsuite/Troubleshooting/Authentication-and-Login-errors/NS0029-Export-Error.md‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
---
2+
title: NS0029 Export Error in NetSuite Integration
3+
description: Learn what the NS0029 export error means when exporting reports to NetSuite and what to do to resolve the connection issue.
4+
keywords: NS0029, NetSuite export error, unable to export report NetSuite, NetSuite connection issue, Expensify NetSuite integration, report export failed NetSuite, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the NetSuite integration. Covers resolving the NS0029 export error caused by NetSuite connection issues. Does not cover general NetSuite integration setup or configuration.
6+
---
7+
8+
# NS0029 Export Error in NetSuite Integration
9+
10+
If you see the error:
11+
12+
NS0029 Export Error: Unable to export this report due to an error.
13+
14+
This means there is a connection issue between the Workspace and NetSuite.
15+
16+
The error appears when you attempt to export a report to NetSuite and the export fails.
17+
18+
---
19+
20+
## Why the NS0029 Export Error Happens in NetSuite
21+
22+
The NS0029 error typically indicates that Expensify is unable to successfully communicate with NetSuite at the time of export.
23+
24+
Common causes include:
25+
26+
- An expired or disconnected NetSuite integration.
27+
- Authentication issues between Expensify and NetSuite.
28+
- Permission changes in NetSuite.
29+
- Temporary connectivity issues.
30+
- A change to the NetSuite role or token used for the integration.
31+
32+
Because this error is tied to the NetSuite connection, it cannot be resolved directly from the report itself.
33+
34+
This is a connection or authentication issue, not a report data issue.
35+
36+
---
37+
38+
## How to Fix the NS0029 Export Error
39+
40+
Follow the steps below to resolve the issue.
41+
42+
### Retry the Export
43+
44+
1. Open the report.
45+
2. Retry exporting to NetSuite.
46+
47+
If the issue was temporary, the export may complete successfully.
48+
49+
### Contact Concierge for Assistance
50+
51+
If the error persists:
52+
53+
1. Do not delete the report.
54+
2. Reach out to **Concierge**.
55+
3. Include:
56+
- The report ID.
57+
- Confirmation that you’re seeing the **NS0029 Export Error**.
58+
- The approximate time the export was attempted.
59+
60+
Concierge will review the NetSuite connection, check authentication and permission settings, and help restore the integration so you can export the report successfully.
61+
62+
---
63+
64+
# FAQ
65+
66+
## Can I Retry the Export After Seeing the NS0029 Export Error?
67+
68+
Yes. If the issue was temporary, retrying the export may resolve it. If it continues to fail, the integration likely needs review.
69+
70+
## Does the NS0029 Export Error Affect Other Reports?
71+
72+
Yes. If the issue is related to your NetSuite connection or authentication, other report exports may also fail until the connection is fixed.
73+
74+
## Should I Reconnect NetSuite Myself?
75+
76+
Do not disconnect the NetSuite integration unless directed by Concierge. Reconnecting without guidance may require reconfiguration.

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

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
---
2+
title: NS0109 Sync Error in NetSuite Integration
3+
description: Learn what the NS0109 sync error means and how to refresh or update your NetSuite admin credentials to restore syncing.
4+
keywords: NS0109, NetSuite login failed, failed to login to NetSuite, NetSuite admin credentials, refresh NetSuite token, NetSuite sync error, Expensify NetSuite integration, NetSuite authentication error, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the NetSuite integration. Covers resolving the NS0109 sync error caused by invalid or expired NetSuite admin credentials. Does not cover full NetSuite integration setup or advanced NetSuite configuration.
6+
---
7+
8+
# NS0109 Sync Error in NetSuite Integration
9+
10+
If you see the error:
11+
12+
NS0109 Sync Error: Failed to login to NetSuite. Please verify your admin credentials.
13+
14+
This means the Workspace is unable to authenticate with NetSuite.
15+
16+
When authentication fails, reports and data cannot sync between Expensify and NetSuite.
17+
18+
---
19+
20+
## Why the NS0109 Sync Error Happens in NetSuite
21+
22+
The NS0109 error typically indicates an issue with the NetSuite credentials used for the integration.
23+
24+
Common causes include:
25+
26+
- The NetSuite admin password was changed.
27+
- The access token was revoked or expired.
28+
- The integration credentials were updated in NetSuite but not refreshed in the Workspace.
29+
- The integration role permissions were modified in NetSuite.
30+
- The NetSuite role associated with the token was disabled.
31+
32+
When credentials are no longer valid, Expensify cannot log in to NetSuite and syncing fails.
33+
34+
This is an authentication issue, not a report data issue.
35+
36+
---
37+
38+
## How to Fix the NS0109 Sync Error
39+
40+
Follow the steps below to verify and refresh your NetSuite credentials.
41+
42+
### Verify the NetSuite Admin Credentials
43+
44+
1. Confirm the correct NetSuite admin account is being used.
45+
2. Verify the integration role is active and has the required permissions.
46+
3. Confirm the account ID, role ID, consumer key, consumer secret, token ID, and token secret match what is configured in NetSuite.
47+
4. Update any credentials that were recently changed.
48+
5. Click **Save** in the Workspace if changes were made.
49+
50+
### Generate a New NetSuite Access Token
51+
52+
If the credentials appear correct but the error persists:
53+
54+
1. Log in to NetSuite as an administrator.
55+
2. Navigate to the Access Token configuration for the integration role.
56+
3. Generate a new access token.
57+
4. Copy the new token ID and token secret.
58+
5. Update the credentials in the Workspace.
59+
6. Click **Save**.
60+
7. Click **Sync Now** under **Settings > Workspaces > Accounting**.
61+
62+
### Retry the Sync
63+
64+
1. Go to **Settings > Workspaces**.
65+
2. Select your Workspace.
66+
3. Click **Accounting**.
67+
4. Click **Sync Now**.
68+
69+
If the credentials are valid, syncing should resume successfully.
70+
71+
### Contact Concierge if the Error Persists
72+
73+
If you are unsure which credentials changed or continue to see the NS0109 error, reach out to **Concierge** and include:
74+
75+
- The full error message.
76+
- Confirmation that you are seeing **NS0109**.
77+
- The approximate time the sync was attempted.
78+
79+
---
80+
81+
# FAQ
82+
83+
## Does the NS0109 Sync Error Affect All Exports?
84+
85+
Yes. If Expensify cannot log in to NetSuite, all report exports and sync activity will fail until the credentials are corrected.
86+
87+
## Do I Need a NetSuite Admin to Fix the NS0109 Sync Error?
88+
89+
Yes. Only a NetSuite administrator, or someone with the correct integration role and permissions, can verify credentials or generate a new access token.
90+
91+
## Should I Disconnect and Reconnect NetSuite?
92+
93+
Do not disconnect the integration unless directed by Concierge, as reconnecting may require full reconfiguration.

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

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
title: NS0123 Sync Error in NetSuite Integration
3+
description: Learn what the NS0123 sync error means and how to enable the Expensify integration in NetSuite to restore syncing.
4+
keywords: NS0123, NetSuite integration not enabled, Expensify integration NetSuite, enable Expensify in NetSuite, NetSuite sync error, Setup Integrations Manage Integrations, Expensify NetSuite connection, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the NetSuite integration. Covers resolving the NS0123 sync error caused by the Expensify integration being disabled in NetSuite. Does not cover full NetSuite integration setup or credential troubleshooting.
6+
---
7+
8+
# NS0123 Sync Error in NetSuite Integration
9+
10+
If you see the error:
11+
12+
NS0123 Sync Error: The Expensify integration is not enabled in NetSuite. Please enable it under Setup > Integrations > Manage Integrations in NetSuite.
13+
14+
This means the Expensify integration is currently turned off in NetSuite.
15+
16+
When the integration is not enabled, reports and data cannot sync between the Workspace and NetSuite.
17+
18+
---
19+
20+
## Why the NS0123 Sync Error Happens in NetSuite
21+
22+
The NS0123 error typically indicates that the **Expensify integration is disabled in NetSuite**.
23+
24+
This may happen if:
25+
26+
- The integration was never enabled.
27+
- The integration was manually disabled in NetSuite.
28+
- Changes were made to NetSuite integration settings.
29+
- A NetSuite update affected integration permissions.
30+
31+
Until the integration is enabled again, all syncing between the Workspace and NetSuite will fail.
32+
33+
This is an integration status issue, not a credential or report data issue.
34+
35+
---
36+
37+
## How to Enable the Expensify Integration in NetSuite
38+
39+
Follow the steps below to re-enable the integration.
40+
41+
### Enable the Expensify Integration in NetSuite
42+
43+
1. Log in to NetSuite as an administrator.
44+
2. Go to **Setup > Integrations > Manage Integrations**.
45+
3. Locate the **Expensify Integration**.
46+
4. Enable the integration.
47+
5. Click **Save**.
48+
49+
Confirm the integration is fully enabled before leaving the page.
50+
51+
### Sync the Workspace in Expensify
52+
53+
After enabling the integration in NetSuite:
54+
55+
On web:
56+
57+
1. Go to the navigation tabs on the left and select **Workspaces**.
58+
2. Select your Workspace.
59+
3. Click **Accounting**.
60+
4. Click the three-dot menu next to the NetSuite connection.
61+
5. Click **Sync Now**.
62+
63+
On mobile:
64+
65+
1. Tap the navigation tabs on the bottom and select **Workspaces**.
66+
2. Select your Workspace.
67+
3. Tap **Accounting**.
68+
4. Tap the three-dot menu next to the NetSuite connection.
69+
5. Tap **Sync Now**.
70+
71+
Once the integration is enabled and synced, exports should resume normally.
72+
73+
---
74+
75+
# FAQ
76+
77+
## Does the NS0123 Sync Error Stop All Report Exports?
78+
79+
Yes. If the Expensify integration is not enabled in NetSuite, all report syncing and exports to NetSuite will fail until the integration is turned back on.
80+
81+
## Do I Need NetSuite Admin Access to Fix the NS0123 Sync Error?
82+
83+
Yes. Only someone with the appropriate permissions in NetSuite can enable integrations under **Setup > Integrations > Manage Integrations**.
84+
85+
## Do I Need to Reconnect the Integration?
86+
87+
No. Re-enabling the integration in NetSuite and selecting **Sync Now** in the Workspace is typically sufficient.

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

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
---
2+
title: NS0318 Sync Error in NetSuite Integration
3+
description: Learn what the NS0318 sync error means and how to update the Expensify Connect bundle in NetSuite to resolve invoice export permission issues.
4+
keywords: NS0318, NetSuite permissions error, could not import items NetSuite, Expensify Connect bundle, update NetSuite bundle, invoice export NetSuite, SuiteBundler, Workspace Admin
5+
internalScope: Audience is Workspace Admins using the NetSuite integration. Covers resolving the NS0318 sync error caused by an outdated Expensify Connect bundle during invoice exports. Does not cover general NetSuite credential errors or full integration setup.
6+
---
7+
8+
# NS0318 Sync Error in NetSuite Integration
9+
10+
If you see the error:
11+
12+
NS0318 Sync Error: Could not import items due to permissions error. Please update your NetSuite bundle version.
13+
14+
This usually means the **Expensify Connect bundle** in NetSuite is out of date.
15+
16+
This error most commonly appears when exporting an **invoice** from the Workspace to NetSuite.
17+
18+
---
19+
20+
## Why the NS0318 Sync Error Happens in NetSuite
21+
22+
The NS0318 error typically indicates:
23+
24+
- The **Expensify Connect bundle** in NetSuite is not updated to the latest version.
25+
- You are exporting an **invoice** from the Workspace.
26+
- NetSuite permissions do not align with the current integration requirements.
27+
28+
An outdated bundle can cause permission mismatches that prevent invoice items from importing correctly into NetSuite.
29+
30+
This is a bundle version or permission alignment issue, not a general credential error.
31+
32+
---
33+
34+
## How to Fix the NS0318 Sync Error
35+
36+
Follow the steps below based on what you are exporting.
37+
38+
### Confirm What You Are Exporting
39+
40+
1. Open the report in the Workspace.
41+
2. Confirm whether you are exporting:
42+
- An **invoice**, or
43+
- An **expense report**.
44+
45+
If you are exporting an expense report:
46+
47+
- Refresh the page.
48+
- Go to **Settings > Workspaces > Accounting**.
49+
- Click **Sync Now**.
50+
- Confirm the Workspace synced successfully.
51+
52+
If you are exporting an invoice, continue to the next step.
53+
54+
### Update the Expensify Connect Bundle in NetSuite
55+
56+
1. Log in to NetSuite as an administrator.
57+
2. Go to **Customization > SuiteBundler > Search & Install Bundles > List**.
58+
3. Locate the **Expensify Connect bundle**.
59+
4. Update the bundle to the latest available version.
60+
5. Confirm the update completes successfully.
61+
62+
After updating the bundle:
63+
64+
1. Return to the Workspace.
65+
2. Retry exporting the invoice to NetSuite.
66+
67+
### Reconfirm the NetSuite Connection (If Needed)
68+
69+
If the Expensify Connect bundle is already on the latest version and the error continues:
70+
71+
1. Review the NetSuite connection settings in the Workspace.
72+
2. Confirm the correct account ID, role, and permissions are configured.
73+
3. Click **Sync Now** under **Settings > Workspaces > Accounting**.
74+
75+
If the issue persists, reach out to **Concierge** and include:
76+
77+
- The full error message.
78+
- Confirmation that you are seeing **NS0318**.
79+
- The invoice ID.
80+
81+
---
82+
83+
# FAQ
84+
85+
## Does the NS0318 Sync Error Affect Expense Report Exports?
86+
87+
No. This error primarily affects invoice exports. If you see it while exporting an expense report, refresh the page and confirm the sync completed.
88+
89+
## Do I Need NetSuite Admin Access to Update the Expensify Connect Bundle?
90+
91+
Yes. Updating bundles in NetSuite requires administrator-level permissions.
92+
93+
## Do I Need to Reinstall the Bundle?
94+
95+
No. In most cases, updating the existing Expensify Connect bundle to the latest version is sufficient.

0 commit comments

Comments
 (0)