> ## Documentation Index
> Fetch the complete documentation index at: https://integrations.docs.commenda.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Oracle NetSuite

> Learn how to set up our Oracle NetSuite integration.

To authenticate NetSuite, the following credentials are required:

* Consumer Key
* Consumer Secret
* Token ID
* Token Secret

This guide will demonstrate how to locate or generate these credentials within NetSuite.

## Pre-requisites

Before setting up the integration, make sure you meet the following requirements:

* You possess **Administrator** permissions in your company’s NetSuite instance or have access permissions shared with you by another user.

<aside>
  💡 The standard Administrator role is available in the list of roles on the Manage Roles page.
</aside>

## Install the Bundle

<Steps>
  <Step title="First Step">
    In your NetSuite account, navigate to **Customization** > **SuiteBundler** > **Search & Install Bundles** > **List** or search for Search & Install Bundles in the Search bar.

    <img src="https://mintcdn.com/rootfi-commenda/JIWggfJznJdOtanp/images/netsuite/Untitled.png?fit=max&auto=format&n=JIWggfJznJdOtanp&q=85&s=d47470cfed2738b3036ee4365362643a" alt="Untitled" width="2806" height="1114" data-path="images/netsuite/Untitled.png" />
  </Step>

  <Step title="Second Step">Search for the **RootFi Bundle** or bundle ID **489902** using the Keyword box. <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%201.png" alt="Untitled" /></Step>
  <Step title="Third Step">Select the bundle and click **Install**. <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%202.png" alt="Untitled" /></Step>

  <Step title="Fourth Step">
    The bundle will begin installing and you maybe directed to the Installed Bundles page. It may take up to 5 minutes to install. <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%203.png" alt="Untitled" />
  </Step>
</Steps>

## Create a new integration to generate the Consumer Key and Consumer Secret

<Steps>
  <Step title="First Step">
    Navigate to **Setup** > **Integration** > **Manage Integrations** > **New** to create a new integration. <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%204.png" alt="Untitled" />
  </Step>

  <Step title="Second Step">
    Create an integration with the below details:

    * Any value can be populated in the **NAME** field
    * The **CONCURRENCY LIMIT** should be left unpopulated
    * Ensure the **REST WEB SERVICES box is checked** under SCOPE
    * The **TOKEN-BASED AUTHENTICATION** and **TBA AUTHORIZATION FLOW** boxes should be checked
    * Fill in the **CALLBACK URL** and **REDIRECT URI** with a value of \[[ROOTFI CALLBACK URL](/api-reference/v3/overview/environments#callback-urls)]\([ROOTFI CALLBACK URL](/api-reference/v3/overview/environments#callback-urls))

          <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%205.png" alt="Untitled" />
  </Step>

  <Step title="Third Step">
    Save the integration to generate the **Consumer Key** and **Consumer Secret**. **This will only be shown once, so store them in a secure place.**

    <img src="https://mintcdn.com/rootfi-commenda/JIWggfJznJdOtanp/images/netsuite/consumer_key_and_consumer_secret_screenshot.png?fit=max&auto=format&n=JIWggfJznJdOtanp&q=85&s=fad85bd0cea8127f79df65dbefafb120" alt="consumer key and consumer secret screenshot.png" width="2000" height="1164" data-path="images/netsuite/consumer_key_and_consumer_secret_screenshot.png" />
  </Step>

  <Step title="Fourth Step">
    The bundle will begin installing and you maybe directed to the Installed Bundles page. It may take up to 5 minutes to install. <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%203.png" alt="Untitled" />
  </Step>
</Steps>

## Assign a user to the role

<Steps>
  <Step title="First Step">
    Navigate to **Setup** > **Users/Roles** > **Manage Users** or search **Manage Users** in the Search bar.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%206.png" alt="Untitled" />
  </Step>

  <Step title="Second Step">
    In the Manage Users page, either select a user to assign the Role to.

    <aside>
      💡 Most users use an existing user (often yourself) so that an additional NetSuite seat is not consumed.
    </aside>

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%207.png" alt="Untitled" />
  </Step>

  <Step title="Third Step">
    In the user's employee record, click **Edit** and go to the **Access** tab. In your Access tab, go to Roles and select **RootFi Role Permission**.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%208.png" alt="Untitled" />
  </Step>
</Steps>

## Create an access token to get your Token ID and Secret

<Steps>
  <Step title="First Step">
    In your **Setup** tab, go to **User Roles** > **Access Tokens** > **New** or search **New Access Token** in the search bar to begin creating a New Access Token.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%209.png" alt="Untitled" />
  </Step>

  <Step title="Second Step">
    Select the Application Name (name of the integration you created in Step 2), User and Role (RootFi Role Permission) and click **Save** to generate a new access token.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%2010.png" alt="Untitled" />
  </Step>

  <Step title="Third Step">
    Copy the **Token ID** and **Token Secret** provided. **This will only be shown once, so store them in a secure place.**

    <img src="https://mintcdn.com/rootfi-commenda/JIWggfJznJdOtanp/images/netsuite/token_id_and_token_secret_screenshot.png?fit=max&auto=format&n=JIWggfJznJdOtanp&q=85&s=0eec7a4cce0bc15b2446fb6900dc5bbc" alt="token id and token secret screenshot.png" width="2000" height="1023" data-path="images/netsuite/token_id_and_token_secret_screenshot.png" />
  </Step>
</Steps>

## Finding your NetSuite Account ID

<Steps>
  <Step title="First Step">Log into your NetSuite portal</Step>

  <Step title="Second Step">
    Copy the subdomain of the URL at the top of your browser and enter it within the Connect Link. In the below screenshot it is **`8635772-sb1`.** <img src="https://mintcdn.com/rootfi-commenda/JIWggfJznJdOtanp/images/netsuite/Screenshot_2024-04-19_at_2.53.59_PM.png?fit=max&auto=format&n=JIWggfJznJdOtanp&q=85&s=57f7a589107a5ed4d38193c324b83040" alt="Screenshot 2024-04-19 at
    2.53.59 PM.png" width="1450" height="264" data-path="images/netsuite/Screenshot_2024-04-19_at_2.53.59_PM.png" />
  </Step>
</Steps>

## Enter credentials in the Connect flow

<img src="https://mintlify.s3.us-west-1.amazonaws.com/rootfi-commenda/images/netsuite/Untitled%2011.png" alt="Untitled" />

* **Consumer Key**: Confirmation screen after creating the integration (Step 2)
* **Consumer Secret**: Confirmation screen after creating the integration (Step 2)
* **Token ID**: Confirmation screen after creating your Access Token (Step 3)
* **Token Secret**: Confirmation screen after creating your Access Token (Step 3)
