Oracle Netsuite

NetSuite connects with token-based authentication (TBA): a consumer key and secret from an integration record, plus a token ID and secret tied to a user and role. You set all of it up in NetSuite as an Administrator, then paste five values into Truto.

Install the Oracle Netsuite integration

Install Oracle Netsuite from Available integrations in each environment you connect accounts from.

1. Enable the web services and token-based authentication

1. Open the Enable Features page.
2. Under SuiteTalk, enable SOAP Web Services and REST Web Services.
3. Under Manage Authentication, enable Token-Based Authentication.

The subdomain Truto asks for is in the browser URL while you're signed in: for https://1234567.app.netsuite.com, it is 1234567.

2. Create a role

1. Open the New Role page and enter a name.
2. Under Accessible Subsidiaries, select All, and check Allow Cross-Subsidiary Record Viewing.
3. Under Selected Accounting Books, select All.
4. Add the permissions your use case needs. The permissions reference lists a set for a typical accounting integration.
5. Click Save.

3. Give the role to a user

1. On the Manage Users page, pick an existing user or create one.
2. On the Access tab, add the role from step 2.
3. Click Save.

4. Create an integration record

1. Open the Integrations page and create a new integration. Enter a name.
2. Under Token-based Authentication, check Token-Based Authentication.
3. Click Save.
4. NetSuite shows the Consumer Key and Consumer Secret once. Copy them somewhere safe.

5. Create an access token

1. Open the Access Tokens page and create a new token.
2. Select the integration record from step 4 as the application, the user from step 3, and the role from step 2. Enter a token name.
3. Click Save.
4. NetSuite shows the Token ID and Token Secret once. Copy them somewhere safe.

Connect an Oracle Netsuite account

1. Click Connect Account.

2. Enter a Tenant ID. This can be any ID you choose. Click Get connection link.

3. Open the generated link. You can also share it with your customer so they connect their own Oracle Netsuite account.

4. Select Oracle Netsuite.

5. Fill in the form and click Connect:

   Field	Required	What to enter
   Netsuite Subdomain	Yes	Your account ID as it appears in the browser URL: for https://1234567.app.netsuite.com, enter 1234567.
   Token ID	Yes	The Token ID from Create an access token.
   Token Secret	Yes	The Token Secret from Create an access token.
   Consumer Key / Client ID	Yes	The Consumer Key from Create an integration record.
   Consumer Secret	Yes	The Consumer Secret from Create an integration record. Truto signs every request with it, so a connection without it fails with 401. The form may show it as optional; fill it in anyway.

6. Close the tab when you see the connection successful message. The new account appears under Integrated Accounts. Click its Account ID to see its details and make API calls.

Permissions reference

A typical accounting integration uses the permissions below. Use the Read only column if you only read data, or Read and write if you also create or update records.

Transactions

Reports

Lists

Setup