NetSuite - Integration Setup

Before You Start

Make sure both Martus and NetSuite are available and open. In Martus, navigate to Setup > NetSuite. You'll configure NetSuite and then complete the fields in Martus using the steps below.

STEP 1: Add Your NetSuite Account ID to Martus

1. In NetSuite, go to Setup > Company > Company Information and copy the Account ID. NOTE: This ID is case-sensitive!
   
   
   
   
2. Paste the Account ID in Martus in Setup > NetSuite > AccountId.
3. Set the Integration Record in Martus to "Custom Integration Record".
   
   

STEP 2: Enable NetSuite Features in SuiteCloud

1. In NetSuite, go to Setup > Setup Tasks > Enable Features.
2. Click SuiteCloud.
3. Turn on REST WEB SERVICES and TOKEN-BASED AUTHENTICATION. 
4. Click Save.
   
   

STEP 3: Enable NetSuite Features in Analytics

1. Click Analytics. 
2. Turn on SuiteAnalytics Workbook. 
3. Click Save.

STEP 4: Set Manage NetSuite Integration Options

Use the Preferred Method OR the Backup Method

Preferred Method - Use the Martus App in SuiteApps.

1. Go to SuiteApps.
2. Search for "Martus".
   
   
   
3. Click on our app.
4. Click Install. Accept the confirmation popup.
   
   
   
5. Navigate to Setup > Integrations > Manage Integrations.
6. Verify you see Martus - Production.

Assign a Role to the User

When using SuiteApps to set up the integration, a new Role has been created for you and you need to assign it to a user. Choose the option desired for custom segments.

Option 1: No Custom Segments to be used for Dimensions

A new Role has been created for you in Manage Role called “Martus” . 

Pick a user (typically an admin) and assign this role to them. This will allow you to make the connection in NetSuite to Martus through this role. 

1. Go to Manager > Users
2. Edit the user
3. Click Access
4. Add the role "Martus"

Option 2: Has Custom Segments to be used for Dimensions

A new Role has been created for you in Manage Roles called “Martus” . 

1. Click Customize on that role.
2. Under Permissions > Custom Record, add the Custom Segments you want to use as a dimension with Full Level.

3. Save the Role.

   
   
   

   
   

Backup Method - Manual Setup without SuiteApps

1. Go to Setup > Integration > Manage Integrations.
   
   
   
   
2. Click New.
3. Name the Integration 'Martus'.
4. Check - TOKEN-BASED AUTHENTICATION.
5. Uncheck - TBA: AUTHORIZATION FLOW CALLBACK URL.
6. Uncheck- AUTHORIZATION CODE GRANT. 
7. Check - CLIENT CREDENTIALS (MACHINE TO MACHINE) GRANT.
8. Check - REST WEB SERVICES.
9. Click Save.

   
   

   Once you click Save, the Client Credentials will appear, and you can add these to Martus.

   
   

STEP 5: IN MARTUS (Setup > NetSuite) - Update Martus Consumer Key and Download Public Key

1. Copy the Consumer Key from NetSuite and paste it in Martus in Setup > NetSuite > Consumer Key.
   
   
   

2. Click Save in Martus.

3. Click Generate Public Key. This certificate will appear in the table:

   
   

   
   

4. Click Download and save the certificate on your computer.

STEP 6: Update NetSuite and Obtain Certificate ID

1. Setup > Integration > OAuth 2.0 Client Credentials (M2M) Setup.
2. Click Create New.
3. Select the Application (Integration) whose consumer key you pasted in Martus and the appropriate role and entity.
4. Import the certificate you downloaded in Step 5 above.
5. Copy the Certificate Id from NetSuite.
   
   

STEP 7: IN MARTUS - Update Martus with the Certificate ID

1. Paste the Certificate Id from NetSuite into the table in Martus in Certificate Id.
2. Click Save.
   
   
   
3. In Advanced Settings, select the certificate as the Current Certificate.
   
   
   
4. Click Save.