Generate NetSuite Authentication Tokens for the Emburse NetSuite Integration
Emburse and NetSuite recommend using the token-based authentication (TBA) method as a best practice to allow integration with your NetSuite account. This allows users to continually access NetSuite without having to re-enter login credentials for NetSuite every time. TBA is the easiest to maintain and stabilizes the integration processes by reducing timeout and credentials errors.
In this article, we'll provide all necessary instructions to collect the required keys to fully connect your Emburse Professional and NetSuite account.
You may not need to be a Full Administrator in NetSuite to run this integration. If you are not a Full Administrator, you will need to work with your IT department to install the appropriate authentication tokens.
Download the Emburse Integration Bundle
Downloading the Emburse Integration Bundle will include the Emburse Integration user role, which will be required to complete your installation.
-
In your NetSuite account, select Customization. Then select SuiteBundler > Search & Install Bundle.
-
Search for Emburse in the search bar. Emburse Integration Role should appear.
-
Select Emburse Integration Role and select Install on the following page. In the forthcoming steps, you will apply the Emburse Integration Role to your Integration User.
The Emburse Integration Role bundle includes a pre-packaged NetSuite integration named Emburse TBA. Do not use Emburse TBA when you create your token or select an Application Name. Use only the integration record you create in the steps in this article.
Retrieve Your NetSuite Account ID
-
Log in to NetSuite and navigate to the Setup menu. Select Company > Company Information.
Locate the Account ID field and copy the value provided. This ID will be entered in the Account field in the Emburse NetSuite Integration Account Credentials tab.
Verify or Enable Token-Based Authentication
Your Emburse integration will require token authentication details from NetSuite. To see if your organization already has tokens enabled, log in to NetSuite and navigate to the Setup menu. Select Users/Roles > Access Tokens.
If you do not see Access Tokens as an option, you must enable this feature in NetSuite.
From the Setup menu, select Company > Enable Features.
Select the SuiteCloud tab.
Under Manage Authentication, enable Token-Based Authentication.
Create Your NetSuite Token Authentication Information
We recommend having a Notepad app open so you can copy and paste your required NetSuite token values when they appear in steps 2 and 3. The four values you will be generating in NetSuite are:
Consumer Key
Consumer Secret
Token ID
Token Secret
Step 1. Assign a User to a Token-Based Authentication Role
In NetSuite, you must grant a user the token-based authentication role.
We recommend creating a new, "dummy" user (for example, a user named "Emburse Integration") so there's no chance of them being made inactive and losing the authentication.
In NetSuite, navigate to the Setup menu.
Select Users/Roles > Manage Users.
-
Either:
Select an existing user and select Edit, or
Create a new employee record for a user such as “Emburse Integration.”
On the Employee Record page, open the Access tab.
In the Role field, select the Emburse Integration Role.
Select Add.
Select Save.
Step 2. Create Emburse Access for Token-Based Authentication
The next step is to create an Integration record and generate the authentication information needed to allow Emburse to integrate with NetSuite.
-
On the Setup menu in NetSuite, select Integration > Integration Management > Manage Integrations.
Select New to add a new integration record.
Enter a Name for your application, for example,
Emburse Professional Integration.(Optional) In Description, enter a note such as
Emburse Token-Based Authentication.Confirm that the application State is Enabled.
(Optional) In Note, enter any notes if desired.
-
On the Authentication tab, select Token-based Authentication.
There are several options on the Authentication tab. Ensure that only the Token-based Authentication option is selected. If other items are selected (such as TBA: Authorization Flow or Authorization Code Grant), clear these options before selecting Save.
Select Save.
The confirmation page displays the Consumer Key and Consumer Secret for this application.
The Consumer Key and Consumer Secret values will only be displayed on this confirmation page. After you leave this page, these values cannot be retrieved from the system. If you lose or forget these credentials, you will need to start again to obtain new values.
Copy the Consumer Key and Consumer Secret values into a notepad or text app.
Step 3. Create a TBA Token
On the NetSuite Setup menu, navigate to Users/Roles > Access Tokens.
Select New Access Token.
Select the Application Name you created for the integration record in Step 2. Create Emburse Access for Token-Based Authentication. Do not select the bundled integration named Emburse TBA.
Select the User you enabled with the Emburse Integration role in Step 1.
In Role, select Emburse Integration Role.
(Optional) The Token Name is already populated by default, but you may enter your own name for this token if desired.
Select Save.
The confirmation page displays the Token ID and Token Secret.
The Token ID and Token Secret values will only be displayed on this confirmation page. After you leave this page, these values cannot be retrieved from the system. If you lose or forget these credentials, you will need to create a new token and obtain new values.
Copy the Token ID and Token Secret values into a notepad or text app.