Overview
This article will walk you through the steps of connecting GUIDEcx and NetSuite so you can build recipes and install pre-built ones!
You will need to do the following in NetSuite to connect your NetSuite instance to GUIDEcx:
Enable Web Services & Token-Based Authentication in NetSuite.
Create an Integration Record
Create an Integration Role
Assign the Integration Role
Create an Access Token for the Integration User
Once you've done that, you'll be able to start creating/using NetSuite recipes!
Setting Up the NetSuite Integration
BEFORE YOU START. You must have the following before connecting to NetSuite:
Admin GUIDEcx access.
Access to NetSuite Admin account.
Correct NetSuite permissions.
Step 1: Enable Web Services & Token-Based Authentication in NetSuite
Watch video of this step
Watch video of this step
Click on the Setup tab in NetSuite
Select Company > Enable Features
Navigate to the SuiteCloud tab and scroll down to the following sections:
Scroll to the top and click Save.
Step 2: Create an Integration Record in NetSuite
Watch video of Step 2
Watch video of Step 2
Click on the Setup tab
Navigate to Integration > Manage Integrations > Click New
Create the Integration Record
Name your Integration something memorable, like Elan or GUIDEcx Recipe Builder.
Make sure the STATE is Enabled
Ensure the TOKEN-BASED AUTHENTICATION is checked
Deselect AUTHORIZATION FLOW (under Token-Base Authentication section) and AUTHORIZATION CODE GRAND (under OAuth 2.0 section)
Click Save
Once saved, NetSuite will provide a Consumer Key/Client ID and Consumer Secret/Client Secret. Save those somewhere secure because you'll need them to set up the GUIDEcx integration and you can't access them later.
Step 3: Create an Integration Role in NetSuite
Watch video of Step 3
Watch video of Step 3
We recommend that you create a separate integration role just for your integrations. This integration role must have permission to read and write to the records relevant to your integrations. This integration role also must have the ability to log in through RESTlets or SuiteTalk (web services).
Click on the Setup tab in NetSuite
Select Users/Roles > Manage Roles > New
Set up the Role:
Name the Role something amazing, like Elan or GUIDEcx Integration Role.
Allow for ALL and Cross-Subsidiary record viewing.
*Optional: Set the Authentication to "Web Services Only". This allows you to only interact with the APIs. You cannot log in as this user.
Set the following permissions with FULL LEVEL access.
These are the minimum set of permissions:
Step 4: Assign the Integration Role in NetSuite
Watch video of Step 4
Watch video of Step 4
Click on the Setup tab in NetSuite
Select Users/Roles > Manage Users
From here you can edit an existing one or create a new one. If you'd like to create a new user you can follow the steps below:
Click on the Lists tab in NetSuite
Add an EMPLOYEE (this way they can access everything they need to)
Step 5: Create Access Token for Integration User
Watch video of Step 5
Watch video of Step 5
You can now create an access token for the integration user. If the integration user has User Access Tokens permissions, they can create and revoke their own tokens. If the integration user has only Log in using Access Tokens permissions, you must ask a user with Access Token Management permissions to create an access token for the integration user.
Click on the Setup tab in NetSuite
Select Users/Roles > Access Tokens > New
Set up Access Token
Select the Integration you just created
Select the User you just created
Select the Role you just created
Click Save
Once saved, NetSuite will provide a Token ID and Token Secret. Save those somewhere secure because you'll need them to set up the GUIDEcx integration and you can't access them later.
Step 6: Connect to NetSuite in GUIDEcx
Watch video of Step 6
Watch video of Step 6
Access the Recipe Builder in GUIDEcx
Select the Recipes tab
Click Create Project
Add a NetSuite Project
Create a New Connection
Search for "NetSuite". It will be under the GUIDEcx Connect Recommended App Section.
Fill out the following fields:
Connection Name
Location (this is the project in Recipe Builder)
Account ID (found in NetSuite: Setup > Integration > Web Services Preferences)
Token ID (from Step 5)
Token Secret (from Step 5)
Account Timezone. The timezone your NetSuite instance works in.
Leave Ignore read-only fields as No.
Add in the Consumer Key and Secret under Advance Settings (from Step 2)
Connect!
You're now ready to install pre-built recipes and build new recipes between GUIDEcx and NetSuite!