NS0521 Sync Error
NS0521 Sync Error in NetSuite Integration
If you see the error:
NS0521 Sync Error: Permission error querying NetSuite for ‘Subsidiary’.
This means the NetSuite integration does not have proper access to subsidiary records.
This error is typically related to permission restrictions in OneWorld or Non-OneWorld NetSuite accounts.
Why the NS0521 Sync Error Happens in NetSuite
The NS0521 error occurs because of permission restrictions tied to how subsidiaries are configured in NetSuite.
The resolution depends on whether your account is:
- A OneWorld account, or
- A Non-OneWorld account.
If the integration role does not have access to subsidiary records, NetSuite blocks the sync.
This is a subsidiary permission issue, not a token formatting or general login error.
Fix the NS0521 Sync Error for OneWorld Accounts
In OneWorld accounts, the Expensify Integration role must have access to all required subsidiaries.
Update Subsidiary Access on the Expensify Integration Role
- Log in to NetSuite as an administrator.
- Go to Setup > Users/Roles > Manage Roles.
- Select Expensify Integration.
- Click Edit.
- Under subsidiary access, confirm that either:
- All is selected, or
- Selected is chosen and all required subsidiaries are highlighted.
- Click Save.
Sync the Workspace
After updating the role permissions:
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 export or sync once complete.
Fix the NS0521 Sync Error for Non-OneWorld Accounts
In Non-OneWorld accounts, this error is typically related to the Expensify Connect bundle configuration.
Reinstall the Expensify Connect Bundle
- Log in to NetSuite as an administrator.
- Go to Customization > SuiteBundler > Search & Install Bundles > List.
- Locate the Expensify Connect bundle.
- Uninstall the bundle.
- Delete the Expensify Integration role.
- Reinstall the Expensify Connect bundle.
- During installation, do not edit or modify the default role permissions.
Sync the Workspace
After reinstalling:
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.
FAQ
Does the NS0521 Sync Error Affect All Workspaces?
It can. If the NetSuite role or bundle configuration is incorrect, all Workspaces connected to that NetSuite account may experience syncing issues.
Do I Need NetSuite Admin Access to Fix the NS0521 Sync Error?
Yes. Updating roles, managing subsidiary access, and reinstalling bundles require NetSuite administrator permissions.
Do I Need to Reconnect the Integration?
No. In most cases, correcting subsidiary access or reinstalling the bundle and selecting Sync Now is sufficient.