NS0384 Sync Error
NS0384 Sync Error in NetSuite Integration
If you see the error:
NS0384 Sync Error: Permission error encountered when querying NetSuite for ‘Classification’. Please confirm the token is assigned to the Expensify Integration role by viewing the ‘Access Token’ in NetSuite.
This means the NetSuite access token does not have the required permissions to query Classifications.
Without proper Classification access, the Workspace cannot sync Class, Department, Location, or related data.
Why the NS0384 Sync Error Happens in NetSuite
The NS0384 error typically occurs when:
- The access token is not assigned to the Expensify Integration role.
- The Expensify Integration role does not have required List permissions.
- The role is missing required Setup permissions for token access.
- The token is tied to a different user or role than expected.
Access tokens in NetSuite are tied to both a specific User and Role. If either is misconfigured, NetSuite blocks Classification queries.
This is a role and token permission issue, not a bundle or general login issue.
How to Fix the NS0384 Sync Error
Follow the steps below to confirm token assignment and role permissions.
Confirm the Access Token Is Assigned to the Expensify Integration Role
- Log in to NetSuite as an administrator.
- Search for Access Tokens.
- Click View next to the token used for the NetSuite connection.
- Confirm:
- The User is correct.
- The Role is set to Expensify Integration.
If the role is incorrect:
- Generate a new token tied to the correct user and Expensify Integration role.
- Update the credentials in the Workspace connection settings.
Confirm Expensify Integration Role Permissions
- Go to Setup > Users/Roles > Manage Roles.
- Select Expensify Integration.
- Click Edit.
- Review the Permissions section.
Required List Permissions
Confirm the following are set correctly:
| Permission | Level |
|---|---|
| Accounts | Full |
| Classes | View |
| Currency | View |
| Customers | View |
| Departments | Full |
| Employees | Full |
| Expense Categories | View |
| Items | View |
| Locations | View |
| Projects | View |
| Subsidiaries | View |
| Vendors | Full |
Required Setup Permissions
Confirm the following are set correctly:
| Permission | Level |
|---|---|
| Access Token Management | Full |
| Log in using Access Tokens | Full |
| User Access Tokens | Full |
| SOAP Web Services | Full |
| Custom Record Types | Full |
| Deleted Records | Full |
Click Save after making any updates.
Sync the Workspace
After confirming role and token settings:
On web:
- Go to the navigation tabs on the left and select Workspaces.
- Select your Workspace.
- Click Accounting.
- Click the three-dot menu next to the NetSuite connection.
- Click Sync Now.
On mobile:
- Tap the navigation tabs on the bottom and select Workspaces.
- Select your Workspace.
- Tap Accounting.
- Tap the three-dot menu next to the NetSuite connection.
- Tap Sync Now.
Retry the sync after confirming all permissions match the required settings.
FAQ
Does the NS0384 Sync Error Affect Category or Tag Imports?
Yes. If Classification permissions are restricted, Class, Department, Location, and related data will fail to sync.
Do I Need NetSuite Admin Access to Fix the NS0384 Sync Error?
Yes. You must have administrator permissions to manage roles and update List and Setup permissions in NetSuite.
Do I Need to Reinstall the Bundle?
No. In most cases, correcting the token assignment and role permissions is sufficient.
