Important:
- New installations: Install the Celigo SuiteApp (integrator.io SuiteApp) when prompted, and then select Verify to continue. You do not need to install the integrator.io SuiteBundle.
- Existing installations: Integrations that currently use the integrator.io SuiteBundle continue to work.
Before we begin
Enable the Date Format in NetSuite: Scheduled flows in the integration app retrieve data from NetSuite based on the last modified date and time. To enable the Date Format in NetSuite:
- In the NetSuite top navigation bar, select Setup > Company > General Preferences. Specify a format for Date Format and Long Date Format. If you want to allow users to override your preferences, check these corresponding boxes in the Overriding Preferences tab.
- Token ID and Token Secret are displayed only once and cannot be retrieved if misplaced. We recommend saving the Token ID and Token Secret in a password manager like LastPass.
- If you haven’t already, sign up for an integrator.io account.
Install Celigo SuiteApp and connector in NetSuite
Step 1: Install Celigo integrator.io SuiteApp in NetSuite
Install the Celigo SuiteApp (integrator.io SuiteApp) in NetSuite.
Step 2: Install Celigo Salesforce Connector [IO] SuiteApp in NetSuite
- In NetSuite, go to Customization > SuiteCloud Development > SuiteApp Marketplace
- In the KEYWORDS textbox, enter “Celigo Salesforce Integration App” and select Search
- Select Install.
Notes:
- Installation of the SuiteApp with the Administrator role is recommended.
- Celigo integrator.io Full Access w/o 2FA[Locked] should work as an alternate role for installation, with a few modifications in permissions for Custom Body, Custom Entity, and Custom Item fields to Full.
Configure Token-Based authentication
Step 1: Enable Token-Based authentication
- Sign in to your NetSuite administrator account.
- From the top navigate to Setup > Company > Enable Features.
- Select SuiteCloud.
- Scroll down to the Manage Authentication section.
- Enable the TOKEN-BASED AUTHENTICATION checkbox.
- Select Save.
Step 2: Create a custom role
Notes:
- The Celigo integrator.io Full Access w/o 2FA[Locked] role is a locked role. You can't use this role but you can create a new role using this locked role and customize it based on your specifications.
- The newly created role should have required permissions set on it. You can see Configure role based permissions for Salesforce-NetSuite (IO) integration app in NetSuite.
- Custom role names can be alphanumeric.
- From the top, select Setup and navigate to Users/Roles > Manage Roles.
- Search for the Celigo integrator.io Full Access w/o 2FA [Locked] role and select the Customize link next to the role.
- Change the role Name.
- Select Save.
Step 3: Assign role to NetSuite user
- From the top select Setup and navigate to Users/Roles > Manage Users.
- From the Manage Users page, select the Name of the user for whom you want to provide Token-based Access.
- From the Employee page to the top left, select Edit.
- Select Access.
- In the Roles tab, add the custom role you created to the existing list of roles.
- Select Save.
Step 4: Create Access Tokens for integrator.io
Notes:
- NetSuite displays the Token ID and Token Secret.
- We recommend that you make a note of and store your credentials in a password management app.
- You will need the Token ID and Token Secret details while setting up a connection on the integration app.
- From the top, select Setup and navigate to Users/Roles > Access Tokens.
- At the top, select new Access Token.
- From the Application Name dropdown, select High Tech Connector (Token-Based Auth.)
- Select List next to the User dropdown menu.
- From the list of users, select the relevant user.
- Select the custom role you created from the list of roles under the role dropdown.
- The Token Name is auto-populated.
- Select Save.
Install the Salesforce - NetSuite integration app
Step 1: Configure the NetSuite Connection
Notes:
- If you haven’t already, sign up for the integrator.io account.
- If you have a license for the integration app already, you will see the Install button on the integration app tile.
- The integration app has been upgraded to version 1.11.4. You can now update your integration app to unlock additional functionality; see Upgrade your integration app.
- If you don’t have a license, select Contact sales to get in touch with our sales consultants.
- Log in to your integrator.io account.
- From the top, navigate to Marketplace > Salesforce > Salesforce - NetSuite (IO).
- Select Install.
- You will be redirected to the My Integrations home page on your integration app.
- Find the Salesforce - NetSuite (IO) tile and select the Click to continue setup link.
- From your Salesforce - NetSuite Setup page, select the Click to Configure link next to NetSuite Connection.
- Notes
- Basic authentication: If you choose basic authentication, you’ll need to provide the username and password for your NetSuite account to establish a connection between your integration app and your NetSuite account.
- Token authentication: if you choose token authentication, you’ll need to enter the Token Id and Token Secret fields.
- Notes
- Select Test to verify your connection.
- You will see a Connection is working message.
- Select Save.
- Your NetSuite connection status will now change to “Configured.”
Step 2: Configure the Salesforce Connection
- From your Salesforce - NetSuite Setup page, select the Click to Configure link next to Salesforce Connection.
- On the Salesforce Connection [Salesforce - NetSuite (IO)] window, fill in the connection details.
- Select Save & Authorize.
- You will be redirected to your Salesforce login page.
- Enter your Salesforce login credentials and select “Log In.”
- You’ll be redirected to the Salesforce- NetSuite Setup page on the integration app.
- Your Salesforce connection status will now change to “Configured.”
Note: If Save & Authorize fails before the Salesforce sign-in page opens, with integration_app_iclient_missing_error (Missing salesforce._iClientId. Connections linked to Integration Apps require their own iClient.), the Salesforce connection wasn’t created for this integration app. This happens, for example, when it was created under Resources > Connections and then linked to the app. Create the connection from this step instead (Click to Configure next to Salesforce Connection), and then authorize it.
Step 3: Install the Integrator package in Salesforce
-
Select the Click to Install link to install the Salesforce Integrator Package.
Note: We recommend that you install the latest version of Integrator Distributed Adapter v1.16.3 in your integration app.
Important: Install or upgrade Integrator Distributed Adaptor before you install the Celigo NetSuite Package in Step 4. If Integrator Distributed Adaptor is missing or older than the version the Celigo NetSuite Package requires, Salesforce stops the install with an error like: This package can't be installed. Package "Integrator Distributed Adaptor", Version 1.16.4 or later must be installed first. Install or upgrade Integrator Distributed Adaptor to the version named in the error, and then install the Celigo NetSuite Package again. To check the installed version, in Salesforce, go to Setup > Installed Packages.
- A new Install lntegrator Distributed Adaptor page will open in a new tab.
- Select the profile on which you want to install the package.
- Select Install.
- Enable the “Yes, grant access to these third-party web sites” checkbox.
- Select Continue.
- Select Done.
- Go back to your integration app Setup page, select Verify Now.
- The Salesforce Integrator Package status will change to Installed.
Step 4: Install Salesforce NetSuite Connector package in Salesforce
-
Select the Click to Install link to install the Salesforce Connector Package.
Note: We recommend that you upgrade your Celigo NetSuite Package v1.9.0 to ensure a smoother release.
- A new Install Celigo NetSuite Package page will open in a new tab.
- Select the profile on which you want to install the package.
- Enable the I acknowledge that I’m installing a Non-Salesforce Application that is not authorized for distribution as part of the Salesforce’s AppExchange Partner Program checkbox.
- Select Install.
- Select Done.
- Go back to your integration app Setup page, select Verify Now.
- The Salesforce Connector Package status will change to Installed.
Step 5: Install the integrator.io SuiteApp
For the Celigo SuiteApp (integrator.io SuiteApp), the Installed status appears automatically if you have already installed the integrator.io SuiteApp. If you have not installed the integrator.io SuiteApp, select Install to install the Celigo SuiteApp. Log in to NetSuite when prompted, complete the installation, and then select Verify.
Step 6: Install Salesforce - NetSuite Connector SuiteApp in NetSuite
-
Select the Click to Install link to install the NetSuite Connector SuiteApp.
Note: Install the latest version of SuiteApp v1.10.3.
- You will be redirected to your NetSuite Login page.
- Enter your NetSuite credentials.
-
- Once the SuiteApp installation is successful, you’ll be redirected to the Salesforce - NetSuite Settings page.
FAQ
Where can I find release notes for the Integrator Distributed Adaptor (IDA) package?
The Salesforce – NetSuite integration app release notes cover changes to the integration app only. Updates to the Integrator Distributed Adaptor (IDA) managed package, such as version 1.16 to 1.17, aren't published as release notes. To confirm which IDA package version is installed in your Salesforce org, contact Celigo Support with your Salesforce org ID.