You're on this guide because you already have an active NetSuite integration and you're running into issues, such as export failures or sync issues. These are usually caused by your NetSuite role missing permissions that Float needs.
This guide walks you through migrating to Float's managed role, which Float creates and updates going forward, so you stop having to manually edit permissions every time something changes. Connecting is now a button click, with no manual integration or access token to set up.
Is this the right guide?
Use this guide only if you already have an active NetSuite integration.
Please note: To migrate, you'll first disconnect NetSuite in Float, then reconnect it using the managed role. Float will show a prompt that accounting data will be removed. Don't worry; as long as you reconnect to the same NetSuite account, you won't lose any accounting data, such as your GL codes. NetSuite exports and syncs won't run while you're disconnected, so we recommend completing all the steps in one sitting.
Guide Overview
How to migrate to the managed role
How to verify your new connection
Before you begin
Make sure you have:
- An administrator-level user on NetSuite
- Either an Administrator or Bookkeeper user role in Float
- Access to your current NetSuite integration in Float (Settings > Accounting Sync)
How to migrate to the managed role
Disconnect Your Current NetSuite Connection:
- Go to Settings > Accounting Sync
- Click the three vertical dots next to NetSuite, then click Disconnect
- A prompt will tell you that accounting data will be removed. Confirm to continue
Please note: You won't lose any data as long as you reconnect to the same NetSuite account. Your accounting data, such as your GL codes, stays linked to your NetSuite account.
Update Your SuiteBundle:
- In Settings > Accounting Sync, click NetSuite
- Click Update Suite Bundle. You may need to sign in to your NetSuite account first before you can proceed to the next step below
- Click Install in NetSuite
- Wait for the bundle status to show green
Some important considerations:
- During installation, you may see the Installed from field display "Sandbox" or "Production"
- This field does not affect your setup, so no action is required based on what appears on your screen
- If you don't see Update Suite Bundle, then your SuiteBundle is already up to date, and you can move to the step below
Attach the Float Integration Role (Managed) to Your User:
- In NetSuite, go to Setup > Users/Roles > Manage Users
- Click on your user and wait for the page to load
- Click Edit > navigate to the Access tab in the bottom navigation bar
- Navigate to Roles > add the Float Integration Role (Managed)
- Click Save
Please note: Attach the role before you connect. You'll need to select it when Float prompts you for a role.
Connect to NetSuite:
- Return to Float and go to Settings > Accounting Sync > NetSuite
- Click Connect
- When prompted to select a role, select Float Integration Role (Managed)
- Click Continue
That's it. You're connected.
How to verify your new connection
- Once connected, go back to Float > Settings > Accounting Sync
- Click Sync and confirm your NetSuite data flows into Float without errors
Please note: If anything looks wrong, you can reconnect to the same NetSuite account, and you won't lose any data.