The NetSuite ODBC connector provides direct access to your NetSuite data using the Open Database Connectivity (ODBC) standard. It supports high-volume data integration and enables you to securely and efficiently retrieve data into Planful.
You can set up multiple ODBC connection profiles, use them in Data Load Rules (DLRs), and schedule automated data loads through Cloud Scheduler. This setup helps ensure smooth data integration while giving you control over how and when data is loaded.
Supported Load Types
You can load the following Load Types from NetSuite ODBC to Planful via DLRs:
Segment Hierarchies
GL Data
Transactions V2
External Source Model
Navigation: Maintenance > Administration > Configuration Tasks > Data Integration Configuration > Cloud Services > NetSuite ODBC
Note:
The NetSuite ODBC integration feature is available upon request. Contact your Planful Account Manager for more information.
Process Overview
Follow these steps to complete the NetSuite ODBC integration:
Prerequisites
Before creating a NetSuite ODBC profile in Planful, ensure the following details and configurations are available:
Field | Description |
|---|---|
Account ID |
|
Client ID |
|
Private Key |
|
Certificate |
|
How to Create a NetSuite ODBC Profile
To create a new NetSuite ODBC profile, do the following:
Navigate to Maintenance > Administration > Configuration Tasks > Data Integration Configuration > Cloud Services.
Click NetSuite ODBC.
Click New Profile.
Enter the following details:
Profile Name – A unique name for your NetSuite ODBC profile
Account ID - Your NetSuite Account ID
Client ID - OAuth 2.0 Client ID used in NetSuite
Certificate - The ID of the uploaded certificate in NetSuite.
Private Key - Generated on your local system, and the same should be uploaded to the NetSuite certificate, which helps to sign the JWT for OAuth 2.0 authentication.
Click Create.
Note:
You can create and manage multiple NetSuite ODBC profiles.
Once saved, the profile appears under Existing Profiles.
Once the NetSuite ODBC profile is successfully created, you can proceed to define a NetSuite ODBC Data Load Rule (DLR) to load your data into Planful.
How to Create a NetSuite ODBC DLR to Load Data
Users with DLR edit access can create NetSuite ODBC DLRs to load the following data types:
Segment Hierarchies
Data
GL Data
Transactions V2
External Source Model.
To create a NetSuite ODBC DLR, do the following:
Navigate to Maintenance > Data Integration > Data Load Rules
Go to New Data Load Rule.
Enter Name and Description.
Select Load Type as NetSuiteODBC.
Select the desired NetSuite ODBC profile
Select the Load Item (e.g., Data, Segment Hierarchies)
Select the desired Load Sub Item and click Next.
In the Query section, enter an SQL Query based on your data load needs.
Sample Query:
SELECT tranid, entity, amount, status FROM transaction WHERE type = 'Invoice' AND tranDate >= '2024-01-01'Complete the Define Overall Rule Settings step as required.
Note:
The following options are selected by default in the Define Overall Rule Settings for GL Data.
Parameters: Frequency and Time mapping are selected by default.
Frequency: Month
Time mapping: Down rows
Defaults: The Include in the data file field for Fiscal Year and Fiscal Month is set to Yes by default.
Complete Manipulate Input File and Define Data Mappings.
To learn more about the field explanations, click here.Click Save.
Once your NetSuite ODBC Data Load Rule (DLR) setup is complete, you can schedule the process using Cloud Scheduler to automate data loads.
How to Schedule a NetSuite ODBC DLR Using Cloud Scheduler to Load Data
Use Cloud Scheduler to automate the execution of your NetSuite ODBC Data Load Rule (DLR) on a recurring or ad hoc schedule.
Click Maintenance > Administration > Cloud Scheduler.
Click Process Flow.
Click Add to create a scheduled process to load NetSuite data automatically using the Data Load Rule created.
In the Code field, enter a unique process name.
Click Tasks.
Click the Add Task icon.
For Task Type, select Data Load Rule.
For Task Name, select the NetSuiteODBC Data Load Rule created earlier.
If data must be loaded before this data load, select dependencies.
Click Save.
Click Run Now to start the process immediately or schedule the time and date on the Scheduler tab, and then click Save & Schedule.
To learn more about Process Flow, click here.
Best Practices
Chunking/Incremental Loads: Pull by accounting period/date ranges and incremental keys (e.g., date_last_modified) instead of SELECT * across years.
Optimize Queries: Specially optimize joins, select only needed columns for the retrieval. Aggregate by period for trial balance/IS/BS data.
Follow standard Data Integrations Data Load Rule setup and data volume guardrail recommendations for efficient processing.
FAQ
How to generate a Client ID in NetSuite?
You must enable OAUTH 2.0 before you create a Client ID in NetSuite.
Navigate to Setup > Company > Enable Features > SuiteCloud tab.
Select the OAuth 2.0 checkbox and Save.
To create and copy the Client ID, use the following steps:
Navigate to Setup > Integrations > Manage Integrations > New.
Enter a name in the NAME field.
Select Enabled from the STATE drop-down list.
In the OAuth 2.0 section
Select the Check Client Credentials (Machine to Machine) Grant checkbox.
Select SuiteAnalytics Connect checkbox
Click Save.
Once saved, under Client Credentials, copy the CONSUMER KEY / CLIENT ID and save it.
Note:
CONSUMER KEY / CLIENT ID information is displayed only during the initial setup. It cannot be retrieved later.
How to generate ES512 keys and certificates (P-512)?
Open the Command Prompt and run the commands below:
To create a new folder and direct to the path
mkdir C:\certs\es512 cd C:\certs\es512To generate the EC private key (P-512)
"C:\Program Files\OpenSSL-Win64\bin\openssl.exe" ecparam -name secp521r1 -genkey -noout -out ec-key.pemThis creates the ec-key.pem file in the respective folder. Open this file to view the private key. This is needed when you create a NeSuite ODBC profile.
To create a self-signed certificate
"C:\Program Files\OpenSSL-Win64\bin\openssl.exe" req -new -x509 -key ec-key.pem -out ec-cert.pem -days 365This creates the ec-cert.pem file in the respective folder. Upload it in NetSuite under Setup > Integrations > OAuth 2.0 Client Credentials (M2M) Setup and note the Certificate ID.
How to Edit an Existing NetSuite ODBC Profile?
Editing an existing NetSuite ODBC allows users to update all the options except Private Key. To edit an existing NetSuite ODBC profile, do the following:
Navigate to Maintenance > Administration > Configuration Tasks > Data Integration Configuration > Cloud Services.
Click NetSuite ODBC.
Hover over an existing profile and click the Edit icon.
Notes:
To delete a profile, click Delete.
Profiles used in existing DLRs cannot be deleted.
On the Profile page, you can edit/update the details as required.
Once updated, click Save.