Preserve your accounting structure—from card swipe to closed books—with Divvy’s NetSuite integration. We do what any responsible software company would: start with your chart of accounts and fully customize Divvy to match.
The integration is set up within our app. It's important to note that a NetSuite administrator is required in order to integrate NetSuite with Divvy. See below for steps on how to integrate NetSuite to Divvy.
Table of Contents
Initial integration setup
First, make sure you're logged into NetSuite and Divvy as an Administrator to complete the setup.
From your Divvy dashboard, go to Settings > Integrations and launch the NetSuite connection wizard.
This wizard will walk you through connecting NetSuite to Divvy. Be careful not to rush through this. Each step is critical to a proper connection. Errors or skipped steps will cause the integration to not work properly.
Enable token-based authentication (TBA) - Follow the in app wizard to complete this step.
Navigate to Setup > Company > Enable Features
Go to the 'SuiteCloud' tab that's located on the blue secondary horizontal navigation bar.
Scroll down to the Manage Authentication section and check the box next to “Enable Token Based Authentication”.
Note: You may have enabled this for a previous integration so it may already be checked.
Create a new role and assign permissions.
Navigate to Setup > Users/Roles > Manage Roles > New
Note: When creating the role you may run into an option to choose a "center type". This is a default permission schema you may have from creating previous roles. You don't need to set this as you will set the permissions explicitly. If you are forced to, you can select any of the options and then adjust the permissions in the following steps.
Name the new role "Divvy Integration Role"
Add the permissions below and set the permission levels to match your needs. Include all the lists you are using to track credit card transactions in NetSuite.
Under Permissions, add permissions for Bills, Make Journal Entry, and Pay Bills. Set all levels to "Full".
Next, under Lists, add permissions for Accounts, Documents and Files, Subsidiaries, and Vendors as well as Classes, Departments, and Locations if applicable to credit card and bill pay journal entries. (Custom fields are not yet supported.) Set all levels to "Full".
Next, under Setup add Custom Fields, SOAP Web Services, and User Access Tokens. Set levels to "Full".
Assign the new role to an Admin.
Navigate to Setup > User/Roles > Manage Users.
Select the admin user who will be making journal entries through Divvy.
Under Access > Role, click ‘Edit’ to assign the “Divvy Integration Role” to your selected admin.
Then click ‘Add’ to save the assignment.
Click ‘Save’ to save to apply the new role to the admin.
Create an integration record.
Go to Setup > Integration > Manage Integrations > New.
Use the name “Divvy Integration”. Enable State Based Authentication and check the box next to Token Based Authentication.
Under OAuth 2.0, disable AUTHORIZATION CODE GRANT.
Enter “https://app.divvy.co/” under Callback URL. Then copy the URL exactly as is.
Click 'Save'. For this step, do not navigate away from this page. Copy the values from the confirmation page and paste them below. Remember to not navigate away from this page. Doing so will reset the keys and require you to repeat this step.
You may now go to Setup > Company > Company Information.
Find Account ID and paste it into the field on the right.
Create access token.
Go to Setup > Users/Roles > Access Tokens > New.
Select the Integration Record, User, and Role created or referenced in the previous steps.
Click ‘Save’ and STOP. Do not navigate away from the confirmation page. Copy the values from the confirmation page and paste them below. Remember to not navigate away from this page. Doing so will reset the keys and require you to repeat this step.
To sync receipt images from Divvy to NetSuite follow the steps below.
Note: Enabling receipts sync may incur extra costs from NetSuite.
First, open a new tab in your browser and log in to NetSuite as an administrator
Download the RESTlet script that will be added to NetSuite.
Go to Customization > Scripting > Scripts > New.
In the Script File field, select ‘- New -’.
Leave “FILE NAME” blank.
Under “SELECT FILE”, upload the RESTlet file downloaded from Step 1.
Click ‘Create Script Record’.
In the ‘NAME’ field, enter ‘Divvy RESTlet Script’ and click ‘Save’.
Now we'll create the RESTlet URL.
Click on ‘Deploy Script’.
Set the status to ‘Released’.
Under Audience, find ‘ROLES’ and click the Select All checkbox.
Click on ‘Save’.
Copy the External URL and paste in the field to the right of the text.
Configuring your integration
Now that you're connected to NetSuite, you can begin mapping your accounts and editing the facets of your integration.
Please keep in mind that changes in NetSuite that relate to the instructions above may cause the integration to break.
Divvy credit card account
Use the dropdown to the right to search and/or select the preferred credit card account for your integration.
Divvy bill pay account
Use the dropdown to the right to search and/or select the preferred bill pay account for your integration.
If you completed the syncing steps in the original instruction, then you can to turn receipt image syncing to NetSuite on and off.
Mapping your accounts
The accounts you selected in the integration wizard will be available for configuration here.
By selecting the 'Configure' button to the right of the account name, you'll trigger the new mapping experience. From this screen, you'll be able to:
Select account types (specifically within your Chart of Accounts)
Select Divvy field name
Please note that by changing the Divvy field name, you will reset the mapping for that account completely.
Save updated naming
See mapping status (via the icon on the right side of the row)