> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Netsuite

> Instructions for integrating with Netsuite.

## Supported Features

<Badge color="blue">Cost Aggregation</Badge>

## Prerequisites

<Info>
  An account with administrator privileges is required for the prerequisites.
</Info>

### How to Log In to Netsuite

Go to the [Netsuite login page](https://system.na0.netsuite.com/pages/customerlogin.jsp?country=JP), enter your email address and password, and log in.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660794130002.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=a41e3372b3ee4e73c23f60672c7a8cb8" alt="Netsuite login screen" width="366" height="371" data-path="images/integrations/6el5kn3y4k/1660794130002.png" />

### 1. Enable Token-Based Authentication

After logging in to Netsuite, go to **Setup > Company > Enable Features** from the top menu.

Next, select **SuiteCloud** from the Enable Features page menu, and scroll down to the **Manage Authentication** section.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660795312643.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=9e5eab65385e53c5d16be7d12a952ada" alt="SuiteCloud menu" width="1264" height="408" data-path="images/integrations/6el5kn3y4k/1660795312643.png" />

Check the **TOKEN-BASED AUTHENTICATION** checkbox, then click the **SAVE** button at the bottom or top of the page.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660796251384.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=b7abb2430fbe76b93bb0e1a6777b641b" alt="Enable Token Authentication" width="1432" height="545" data-path="images/integrations/6el5kn3y4k/1660796251384.png" />

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660796315429.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=20ecf89e8d2a9f4bd42ceed85a1a1be9" alt="Save button" width="567" height="238" data-path="images/integrations/6el5kn3y4k/1660796315429.png" />

### 2. Create an Integration Record

Go to **Setup > Integration > Manage Integrations > New** from the top menu.

The Integration input form will appear. Fill it in as follows:

* Enter `ITMC Integration API` in the NAME field
* Under Token-based Authentication: **check TOKEN-BASED AUTHENTICATION**
* Under Token-based Authentication: **uncheck TBA: AUTHORIZATION FLOW**
* Under OAuth 2.0: **uncheck AUTHORIZATION CODE GRANT**

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660804087855.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=390e03aea569ef723b127e37aa7f0788" alt="Integration settings" width="1394" height="880" data-path="images/integrations/6el5kn3y4k/1660804087855.png" />

After filling in the form, click **SAVE**. The **CONSUMER KEY / CLIENT ID and CONSUMER SECRET / CLIENT SECRET** will appear at the bottom of the page — save them. Click Back to finish.

<Info>
  Note that CONSUMER KEY / CLIENT ID and CONSUMER SECRET / CLIENT SECRET **will not be displayed again**.
</Info>

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660804308711.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=3fc73559fed35dfff4af032e56434b8c" alt="Consumer Key and Secret" width="1239" height="910" data-path="images/integrations/6el5kn3y4k/1660804308711.png" />

### 3. Create a Role (Preparation for Token Creation)

To create a Token, it must be associated with a Role. Go to **Setup > Users/Roles > Manage Roles** from the top menu.

The Role input form will appear. Fill it in as follows:

* Enter **ITMC Integration API** in the NAME field
* Enter **itmc\_integration\_api** in the ID field
* Select **Accounting Centre** for CENTRE TYPE
* Under Subsidiary Restrictions, select **ALL** and **check ALLOW CROSS-SUBSIDIARY RECORD VIEWING**

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660806656954.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=2eb8d3a1bb3c7f8ae9ca5e23498d9cec" alt="Create Role" width="1128" height="633" data-path="images/integrations/6el5kn3y4k/1660806656954.png" />

Then enter the **Permissions** as shown below and click **SAVE**. Some items may not appear depending on your configuration — that is fine; add the available permissions.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660807327527.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=db7bd31268cd2e21cf35b87a9808fbbd" alt="Permissions settings" width="1605" height="425" data-path="images/integrations/6el5kn3y4k/1660807327527.png" />

|              | Permission                              | Level |
| ------------ | --------------------------------------- | ----- |
| Transactions | Bills                                   | View  |
| Transactions | Credit Card                             | View  |
| Transactions | Credit Card Refund                      | View  |
| Transactions | Expense Report                          | View  |
| Transactions | Find Transaction                        | View  |
| Transactions | Make Journal Entry                      | View  |
| Transactions | Receive Order                           | View  |
| Transactions | Check ※ Not available in Netsuite Japan | View  |
| Lists        | Accounts                                | View  |
| Lists        | Currency                                | View  |
| Lists        | Departments                             | View  |
| Lists        | Employee Record                         | View  |
| Lists        | Employees                               | View  |
| Lists        | Items                                   | View  |
| Lists        | Record Custom Field                     | View  |
| Lists        | Vendors                                 | View  |
| Setup        | Bulk Manage Roles                       | Full  |
| Setup        | Log in using Access Tokens              | Full  |

### 4. Create or Update an Employee

Go to **Lists > Employees > Employees** from the top menu, then select **New** to create a new employee.
Select **Search** to find and edit the Employee you want to update the Role for.

In the Role section at the bottom of the Employee form, add **ITMC Integration API**.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660809069391.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=bb918da3479f8f796a1fe68915712033" alt="Employee Role settings" width="568" height="345" data-path="images/integrations/6el5kn3y4k/1660809069391.png" />

### 5. Create an Access Token

Go to **Setup > Users/Roles > Access Tokens > New** from the top menu.

The Access Token creation form will appear. Fill it in as follows and click **SAVE**.

The **TOKEN ID and TOKEN SECRET** will be generated — save them.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660812461222.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=759abece4e217d58b8f7547a4b26064e" alt="Create Access Token" width="765" height="444" data-path="images/integrations/6el5kn3y4k/1660812461222.png" />

* Select **ITMC Integration API** for APPLICATION NAME
* For USER, select the **Employee whose Role was created or updated in the "Create or Update an Employee" step**
* Select **ITMC Integration API** for ROLE

<Info>
  Note that TOKEN ID and TOKEN SECRET will not be displayed again.
</Info>

### 6. Upload the Suitelet Script File

Go to **Customization > Scripting > Scripting > New** from the top menu. Hover over the SCRIPT FILE tab and a `+ icon` will appear — click it.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660813684390.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=a2452ffaa578e770d6b87c95df5f7227" alt="Add Script File" width="693" height="219" data-path="images/integrations/6el5kn3y4k/1660813684390.png" />

A file form popup will appear.

Download and extract the **zip** file below. There is a **.js file** named **tmc\_integration\_api\_restlest** — click **SELECT FILE** to select it, then click **SAVE**. **※Do not change the file name or add any text input to the downloaded file.**

[itmc\_integration\_api\_restlest.js.zip](/images/integrations/6el5kn3y4k-netsuite/001.zip)

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660813309124.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=e4c7741a4b3531cc13304a6cde2dbc96" alt="Upload Script File" width="565" height="357" data-path="images/integrations/6el5kn3y4k/1660813309124.png" />

Next, verify that the SCRIPT FILE matches the file name you just saved, then click **Create Script Record**.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660814382227.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=f6ace9ae1efd5fede46382d3a6ffbc0c" alt="Create Script Record" width="679" height="230" data-path="images/integrations/6el5kn3y4k/1660814382227.png" />

The Script form will appear. Fill it in as follows and click SAVE.

* NAME: ITMC Integration API
* Under Developments, enter the following and click **Add** for each:
  * TITLE: **ITMC Integration API**
  * ID: **\_itmc\_integration\_api**
  * STATUS: **Released**

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660815148082.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=fee8ee0e0c07839fe2a8bbb59e45d97d" alt="Script settings" width="1443" height="659" data-path="images/integrations/6el5kn3y4k/1660815148082.png" />

On the next screen, select **Deploy Script**.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660815446543.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=c669ed9fbe1ff899151d9bb65d714974" alt="Deploy Script" width="698" height="220" data-path="images/integrations/6el5kn3y4k/1660815446543.png" />

The Script Deployment form will appear. Select **ITMC Integration API** from **Audience ROLES** and click **SAVE**.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660815604313.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=eb36f0afc4d86a681593fe529572baff" alt="Script Deployment settings" width="592" height="812" data-path="images/integrations/6el5kn3y4k/1660815604313.png" />

The **EXTERNAL URL** will be displayed — save it.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660815769347.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=65dc42448fe3eff387224ad7b6addf50" alt="External URL" width="1062" height="313" data-path="images/integrations/6el5kn3y4k/1660815769347.png" />

### 7. How to Obtain Your Account ID

Go to **Setup > Company > Company Information** from the top menu and save the **ACCOUNT ID**.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660816106237.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=b7851c233997863ee04ffde57c89144a" alt="Account ID" width="977" height="515" data-path="images/integrations/6el5kn3y4k/1660816106237.png" />

## Integration Setup

In the MoneyForward Admina integration screen, search for **Netsuite**.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660816232734.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=1f6629c5713d069a74611f173bd04585" alt="Admina integration screen" width="1093" height="553" data-path="images/integrations/6el5kn3y4k/1660816232734.png" />

Enter the information obtained in the previous steps as follows, then click **Connect**.

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6el5kn3y4k/1660816312321.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=e6d6da0a89b723af9621d67baf3e92ef" alt="Integration information input" width="402" height="737" data-path="images/integrations/6el5kn3y4k/1660816312321.png" />

* **Workspace Key:** ACCOUNT ID (Step 7)
* **Client ID:** CONSUMER KEY / CLIENT ID (Step 2)
* **Client Secret:** CONSUMER SECRET / CLIENT SECRET (Step 2)
* **Token ID:** TOKEN ID (Step 5)
* **Token Secret:** TOKEN SECRET (Step 5)
* **External URL:** EXTERNAL URL (Step 6)

Once the integration with Netsuite is successful, the registered user information will appear in the account list.

If the process does not complete successfully, go to the Status tab on the integration screen, click **Edit**.
Try connecting again.

If the issue persists, please contact us via chat.

For an overview of the Netsuite integration, see the [integration page](http://admina.moneyforward.com/en/integrations/netsuite).
