Simple Connect Documentation
Overview
Simple Connect is the simple way to export NetSuite Saved Searches into external software via REST. After setting up a Simple Connect User and a Simple Connect Search record, users can quickly and easily export the data they need.
Getting Started
Creating a Simple Connect User
- Log in to NetSuite.
- Navigate to Setup > Simple Connect > New Simple Connect User.
- Set NetSuite User Account to the employee who will use this account.
- The user will receive an email to complete the setup process.
- Set the Simple Connect Username.
- Choose a memorable username.
- Click Invite User.
- The employee will receive an email with a setup link. Click this link.
- On the Complete Simple Connect User Setup screen, set the Simple Connect Password.
- Password entry will be visible (not hidden), so be careful during screen sharing.
- Click Submit.
If the email isn't received, navigate to Setup > Company > Sent Email List to find the email.
Setting Up a Saved Search for Simple Connect
Example: Single Record per Row (e.g., Non-Inventory items)
- Navigate to Lists > Saved Searches > New.
- Select Item.
- Name the search (suggested prefix: SC).
- Set the search as Public.
- Add the first Criteria filter as:
- Formula Numeric:
{internalid} - Condition: Greater than
- Value:
0 - Add other desired criteria (e.g., Type is Non-inventory).
- Navigate to Results tab.
- First SORT BY field:
- Formula Numeric:
{internalid} - First result row:
- Formula Number:
{internalid} - Custom Label:
ROWKEY -
Add additional result rows as needed.
-
Save the search.
Example: Multiple Rows per Record (e.g., Sales Order lines)
Use the same steps as above, but for the formula:
- Formula example for multiple lines:
({internalid}*10000) + TO_NUMBER({line})
Set this formula for both the criteria and the ROWKEY in results.
Setting Up the Simple Connect Search Record
- Navigate to Setup > Simple Connect > Simple Connect Search > New.
- Populate the Saved Search field with the created search.
- Add Simple Connect Users to the sublist and assign the execution role.
- Save the record.
- A URL will populate for accessing search data.
Access Simple Connect via Excel
- Open Excel.
- Navigate to the Data tab.
- Click Get Data > From Other Sources > From Web.
- Paste the URL from the Simple Connect Search record.
- Click OK.
- Choose Basic on the authentication screen.
- Enter your Simple Connect username and password.
- Click Connect.
- Once data preview appears, click Load.
Tips for Simple Connect in Excel
- Rename queries to match data clearly:
-
Double-click 'Queries', rename under 'Properties'.
-
When updating search results:
- Double-click your query to open the power query editor.
- Remove 'Changed Type' and 'Promoted Headers'.
-
Under "Applied Steps", click on Source and check the contents in this step.
The contents should look something like this:
= Csv.Document(Web.Contents("https://examplesimpleconnecturl.com"),[Delimiter=",", Columns=20, Encoding=65001, QuoteStyle=QyoteStyle.None])If this step is specifying a format (delimiter, columns, etc.), this can all get removed. Modify the step so that it looks like this:= Csv.Document(Web.Contents("https://examplesimpleconnecturl.com"))- Click Refresh. - After refresh, click Use First Row as Headers. - If the power query is still using the old headers, delete Changed Type under "Applied Steps" again. - Click on Promoted Headers and refresh the query again. - Click Close & Load.
Access Simple Connect via REST
- Make a GET request to the URL provided in the Simple Connect Search record.
- Authentication: Use Basic Auth with your username and password.
- Results returned in CSV format.