Source and destination

Polytomic connects to NetSuite using an Integration record and API-only role.


NetSuite sandbox

Connecting Polytomic to a Netsuite sandbox is no different than connecting to a production instance; the same instructions apply. Indeed, if you have a Netsuite sandbox available we recommend you create two Netsuite connections in Polytomic: one to your sandbox for testing and one to your production instance.

Preparing NetSuite for Polytomic

Polytomic requires that web service-related features be enabled for your NetSuite account

To enable these features navigate to SetupCompanyEnable Features. The click the SuiteCloud tab.

Under SuiteTalk (Web Services) enable "SOAP Web Services" and "REST Web Services"


SuiteTalk features to enable.

Under Manage Authentication enabled "Token-based Authentication"


Authentication features to enable.

Create and Configure an Integration

Netsuite uses an Integration record to authenticate requests from Polytomic.

To create an Integration navigate to SetupIntegrationsManage IntegrationsNew.

Give the Integration a name such as "Polytomic" and enable "Token-based authentication".

"TBA: Authorization Flow" and "Authorization Code Grant" should be disabled.

After you click "Save", make a note of the Consumer Key & Consumer Secret listed under Client Credentials. You'll need these when connection Polytomic to Netsuite.

Create a Role

Navigate to SetupUsers/RolesManage Roles and click "New Role".

Give this role a name like "Polytomic" and check "Do Not Restrict Employee Fields" and "Web Services Only Role".

Under Permissions the available permissions are listed in several tabs.

Add the following in the Transactions tab:

  • Cash Sale (View)
  • Cash Sale Refund (View)
  • Credit Memo (View)
  • Customer Payments (View)
  • Customer Deposits (View)
  • Customer Refunds (View)
  • Find Transaction (View)
  • Invoice (Full)
  • Invoice Approval (View)
  • Sales Order (Full)

Add the following in the Reports tab:

  • SuiteAnalytics Workbook (Edit)
  • Transaction Detail (View)

Add the following in the Lists tab:

  • Accounts (Full)
  • Contact Roles (Full)
  • Contacts (Full)
  • Customers (Full)
  • Employee Record (View)
  • Items (View)
  • Payment Methods (View)
  • Vendors (Full)

Add the following permissions in the Setup tab:

  • Access Token Management (Full)
  • Custom Body Fields (View)
  • Custom Column Fields (View)
  • Custom Entity Fields (View)
  • Custom Fields (View)
  • Custom Item Fields (View)
  • Custom Lists (View)
  • Custom Record Types (View)
  • Custom Transaction Fields (View)
  • Log in using Access Tokens (Full)
  • REST Web Services (Full)
  • SOAP Web Services (Full)
  • User Access Tokens (Full)

Create a User for Polytomic

We recommend that you create a dedicated user for Polytomic. You can do this by navigating to SetupUsers/RolesManage Users.

In the *Access tab, assign the role you created above to the user.

Create an Access Token

The final step to complete in Netsuite is creating an Access Token for Polytomic.

Navigate to SetupUsers/RolesAccess TokensNew.

Select the Integration you created as the Application, then select the User and Role you created.

After the access token is created, make note of the Token ID and Token Secret. You'll need these values when connecting Polytomic to NetSuite.

Connecting Polytomic to Netsuite

  1. In Polytomic, go to ConnectionsAdd ConnectionNetSuite.

  2. Pick your connection name and enter your NetSuite Account ID. You can find this by navigating to SetupCompanyCompany Information in NetSuite.

  3. Finally, enter the Consumer Key, Consumer Secret, Token, and Token Secret provided by NetSuite during all the previous steps.

  1. Click Save.