NetSuite

NetSuite is a cloud-based suite of business management applications. It offers a comprehensive set of tools for enterprise resource planning (ERP), financial management, customer relationship management (CRM), and e-commerce, providing a unified platform for businesses to streamline their operations and manage various aspects of their organization.

Refer to NetSuite's official documentation to see all available endpoints from the NetSuite API.

Authorize Connection to NetSuite

In NetSuite

To authorize your NetSuite account, you will need your account ID, client ID, client secret, a private key(= API token), a certificate ID. Follow these steps:

1. Add a new integration to NetSuite
2. Generate an RSA key
3. Upload public key to NetSuite

Add a New Integration in NetSuite

In your NetSuite account, navigate to the Setup page. Continue to the Integration page and click on **Manage Integration.

Click on New to add a new integration and fill in the following information:

1. Name: Integration label, e.g. Dataddo.
2. Uncheck everything in the section Token-based Authentication. If it's not possible to uncheck anything, follow these steps:
   1. In the OAuth 2.0 section: Check Client credentials.
   2. In the Token-based Authentication: Uncheck all fields.
3. In the OAuth 2.0 section and Scope checkboxes, check all available fields (RESTLETS, REST WEB SERVICES, SUITEANALYTICS CONNECT).
4. In the OAuth 2.0 section check Client Credentials (Machine to Machine grant).
   
5. Save the integration.
6. Copy the Client ID (Consumer ID) and Client Secret (Consumer Secret) at the bottom of the page.

Generate an RSA Key

On your machine with OpenSSL installed, run the following command to generate two keys.

1. A public key auth-cert.pem to upload to NetSuite, and
2. A private key auth-key.pem to upload to Dataddo

openssl req -x509 -newkey rsa:4096 -sha256 -keyout auth-key.pem -out auth-cert.pem -nodes -days 730

Upload Public Key to NetSuite

1. In your NetSuite account, navigate to the Setup page and select Integration and continue to the Manage Authentication section.
2. Go to OAuth 2.0 Client Credentials (M2M) Setup and click on New.
3. Configure the following fields:
   1. Entity: Select a user with the Log in using OAuth 2.0 Access Tokens permission.
   2. Role: Select a role with the Log in using OAuth 2.0 Access Tokens permission.
   3. Application: Select your application/integration e.g. Dataddo. You will see your integration only if you checked the Client Credentials (Machine to Machine grant) box when adding it.
4. Select the public key from the previous step as the Certificate.
5. Once you Save, copy the Certificate ID.

In Dataddo

First upload the Private Key to Dataddo.

1. Navigate to the Security page.
2. Go to the Certificates & Tokens tab and click on Add Certificate.
3. Choose RSA Private Key certificate type and upload the the private key you generated in App Store Connect.

Then create a NetSuite authorizer.

1. On the Authorizers page, click on Authorize New Service and select NetSuite.
2. Fill in the following fields:
   1. Account ID: Your NetSuite account ID.
   2. Client ID: Your NetSuite client ID.
   3. Client Secret: NetSuite client secret.
   4. Private Key: Private key you uploaded to Dataddo.
   5. Certificate ID: Certificate ID to the private key.
3. Rename your authorizer for easier identification and click on Save.

How to Create a NetSuite Data Source

1. On the Sources page, click on the Create Source button and select the connector from the list.
2. From the drop-down menu, choose your account.
   Didn't find your account?

   Click on Add new Account at the bottom of the drop-down and follow the on-screen prompts. You can also go to the Authorizers tab and click on Add New Service.

3. Name your data source and select your Object and Attributes. SuiteQL query will be auto-generated based on the object and attributes you selected.
4. [Optional] Modify the SuiteQL query if e.g. your object or attributes weren't available for selection.
5. Configure your snapshotting preferences. Choose your sync frequency or the exact synchronization time under Show advanced settings.
6. Preview your data by clicking on the Test Data button in the top right corner. You can adjust the date range for a more specific time frame.
7. Click on Save and congratulations, your new data source is ready!

List of Available Attributes

To check all available NetSuite object attributes to select the right ones, follow these steps:

1. In your Netsuite account, navigate to the Setup page, and continue to Records Catalog. Here, you will find a list of available standard and custom records (=objects in Dataddo).
2. Select your record, and make sure you're on the Fields tab to see all available fields (=attributes in Dataddo).
3. In Dataddo, select only fields (attributes) which you see in the Records Catalog, or add them manually in the SuiteQL query modification step.

Troubleshooting

Data Preview Unavailable

If there is no data preview after clicking on Test Data, there might be a problem with your source configuration. The most common causes are:

• Date range: Try a smaller date range. You can load the rest of your data afterward through our manual data load function.
• Insufficient permissions: Please make sure your authorized account has the Log in using OAuth 2.0 Access Tokens permission.
• Invalid metrics, attributes, or breakdowns: You may not have any data for the selected metrics, attributes, or breakdowns.
• Incompatible combination of metrics, attributes, or breakdowns: The combination you have selected cannot be queried together. Please refer to the service's documentation to view a full list of metrics that can be included in the same source.

Missing Object or Attributes

If your object or attributes aren't available for selection during data source configuration, modify or rewrite your SuiteSQL query.

For the full list of Netsuite objects and attributes, see the Netsuite Analytics Browser.

Increasing the Amount of Extracted Rows

The initial data extraction load is pre-set to 1,000 rows. To raise the number of extracted rows, click on your data source, navigate to the Advanced Settings and change the Limit.

NetSuite Connection Keeps Breaking

If your NetSuite keeps breaking after a few days, make sure the Client Credentials (Machine to Machine grant) is checked during Authorization.

Invalid Login Attempt Error Message

Make sure the account you're authorizing has the Log in using OAuth 2.0 Access Tokens permission. Carefully follow all Authorization steps.

Transformation Error

ERROR MESSAGE

cannot append value to column ID customlist_vitsoe_region: unhandled data type of map. Please modify the transformation to parse this, column can't contain non-scalar data (objects, arrays)

To overcome this issue, rename the customlist_vitsoe_region.name field in your SuiteQL query. The whole query should look like this:

SELECT foreigntotal, type, tranid, entity, tosubsidiary, trandate, shipdate, shippingaddress, custbody_vitsoe_job_owner, customlist_vitsoe_region.name as name FROM transaction, customlist_vitsoe_region WHERE transaction.custbody_vitsoe_region=customlist_vitsoe_region.id

This issue is caused during data tranformation. When extracting NetSuite data, Dataddo receives a field called name coming from the customlist_vitsoe_region table. However, the Dataddo NetSuite connector extracts a field called customlist_vitsoe_region.name (in MongoDB this would be an object because dots can't be used as field names). In the modified SuiteQL query, the two fields are connected using the AS clause.