NS0384 Sync Error
NS0384 Sync Error in NetSuite Integration
If you see the error:
NS0384: 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 permission to query Classification records.
Why the NS0384 Sync Error Happens in NetSuite
The NS0384 error occurs when:
- The access token is not assigned to the Expensify Integration role.
- The Expensify Integration role is missing required List or Setup permissions.
- The token is associated with a different role than expected.
- Role permissions were modified after the token was created.
Access tokens in NetSuite are tied to both a User and a Role. If the role lacks required permissions, the sync will fail.
How to Fix the NS0384 Sync Error
Step One: Confirm the 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 Expensify.
- Confirm the token is assigned to the Expensify Integration role.
If the role is incorrect, generate a new token tied to the correct user and role.
Step Two: Confirm Required List Permissions
- In NetSuite, go to Setup.
- Select Users/Roles.
- Click Manage Roles.
- Select Expensify Integration.
- Click Edit.
- Scroll to Permissions.
- Open the Lists tab.
- Confirm the permissions match the table below.
List Permissions
| Permission | Level |
|---|---|
| Accounts | Full |
| Classes | View |
| Currency | View |
| Custom Record Entries | View |
| Customers | View |
| Departments | Full |
| Documents and Files | Full |
| Employee Record | Full |
| Employees | Full |
| Expense Categories | View |
| Imported Employee Expenses | View |
| Items | View |
| Locations | View |
| Projects | View |
| Record Custom Field | View |
| Subsidiaries | View |
| Tax Records | View |
| Tax Schedules | View |
| Vendors | Full |
Step Three: Confirm Required Setup Permissions
- While editing the Expensify Integration role,
- Open the Setup tab.
- Confirm the permissions match the table below.
Setup Permissions
| Permission | Level |
|---|---|
| Access Token Management | Full |
| Custom Lists | View |
| Custom Record Types | Full |
| Custom Segments | View |
| Deleted Records | Full |
| Log in using Access Tokens | Full |
| Managed Accounting Periods | View |
| SOAP Web Services | Full |
| SuiteSignOn | Full |
| User Access Tokens | Full |
Save the role after confirming all permissions.
Step Four: Sync the Workspace in Expensify
- In Expensify, go to Settings.
- Select Workspaces.
- Select your Workspace.
- Click Accounting.
- Click Sync.
FAQ
Does NS0384 Mean the Token Is Invalid?
Not necessarily. The token may be valid but tied to a role missing required permissions.
Do I Need to Reconnect NetSuite?
If the token is tied to the wrong role, you must generate a new token and reconnect. If permissions were simply missing, updating the role and running Sync is usually sufficient.
