Skip to main content

How to Integrate with NetSuite using Custom Integration Role

D
Written by Dom Kang
Updated this week

How to Integrate with NetSuite

Confido will connect with NetSuite programmatically via their SOAP and REST APIs. Below are the steps to fully connect.

1. Enable REST and SOAP

Navigate to Setup > Company > Enable Features. Under SuiteCloud, select SOAP WEB SERVICES, REST WEB SERVICES, and TOKEN-BASED AUTHENTICATION.

2. Create a Custom Integration Role

Before Confido can connect to NetSuite, you need to create a custom integration role with specific permissions. This role controls what data Confido can read and write.
​Below are the steps:

  1. Log in to NetSuite as an administrator.

  2. Navigate to Setup → Users/Roles → Manage Roles → New.

  3. Configure the General section:

    1. Set NAME to Confido Integration Role.

    2. Set CUSTOM/STANDARD to Custom.

    3. Set CENTER TYPE to Classic Center.

    4. Set EMPLOYEE RESTRICTIONS to none - no default.

  4. Configure Subsidiary Restrictions:

    1. Set ACCESSIBLE SUBSIDIARIES to X ALL.

    2. Leave ALLOW CROSS-SUBSIDIARY RECORD VIEWING unchecked.

  5. Configure Authentication:

    1. Leave SINGLE SIGN-ON ONLY unchecked.

    2. Check WEB SERVICES ONLY ROLE.

    3. Leave RESTRICT THIS ROLE BY DEVICE ID unchecked.

    4. Set TWO-FACTOR AUTHENTICATION REQUIRED to Not required.

    5. Set DURATION OF TRUSTED DEVICE to Per session.
      ​

  6. Enable all Permissions | Transactions at Full level except:

    1. Item Receipt: set to Edit.

  7. Enable all Permissions | Reports:

    1. Accounts Payable: set to View.

    2. SuiteAnalytics Workbook: set to Edit.
      ​

  8. Enable all Permissions | Lists at Full level except:

    1. Contact-Subsidiary relationship: set to View.

    2. Currency: set to Edit.

    3. Customers: set to Edit.

    4. Documents and Files: set to Edit.

    5. Entity-Subsidiary relationship: set to View.
      ​

  9. Enable all Permissions | Setup at Full level except:

    1. Custom HTML Layouts: set to View.
      ​

  10. Click Save.

3. Create a User with the Confido Role

A user can either be created net-new or the newly created Confido role can be added to an existing user (to minimize the number of seats). Often companies will have one use dedicated to integrations and in this case you can add the Confido Integration role!

To create a new user, navigate to Lists > Employees > Employees > New. Add the required information for the new user form. Select the Access tab and select Give Access and the Confido Integration role.

4. Create an Integration and Generate your Consumer Secrets

Navigate to Setup > Integration > Manage Integrations > New. Populate the form as specified below selecting Token-Based Authentication, TBA: Authorization Flow, Authorization Code Grant, Restlets, REST Web Services and providing https://app.merge.dev/oauth/callback as the callback URL and redirect URI.

Ensure that the max concurrency is at least 4.

Click save and make sure to leave this tab open or store the secrets in a safe place.

5. Create an Access Token to Generate Token Secrets

Navigate to Setup > Users/Roles > Access Tokens > New. Select the relevant application, user and role from the steps prior and Save. Leave this tab open or store the secrets in a safe place.

6. Enter your Newly Created Credentials into Confido

In Confido, Navigate to Integrations → Software, and click “Add an Additional Accounting System.”

Enter your NetSuite subdomain (the first 7 digits of your NetSuite URL).

Enter the Consumer Key and Consumer Secret from step 4.

Enter the Token ID and Token Secret from step 5.

Did this answer your question?