Invoiced integrates with NetSuite out of the box, a cloud-based ERP system. This document outlines how to setup and use the NetSuite integration.
The NetSuite integration ships with the following capabilities:
- Reading customers, open invoices, credit notes, and payments from NetSuite
- Writing payments received on Invoiced to NetSuite
- Data flows happen in real-time
In order to set up the NetSuite integration you first need these pieces of information:
- NetSuite Account ID
- OAuth Access Token
Below we will show you how to connect NetSuite with Invoiced, step-by-step.
First we need to install the Invoiced SuiteBundle, which will install an Invoiced integration and an Invoiced Integration role.
On NetSuite, go to Customization → SuiteBundler → Search & Install Bundles.
In the keyword box, type in Invoiced and click Search. Select the bundle with a bundle ID of 265184.
Click Install to install the bundle.
Once the bundle is installed, go to Setup → Company → General Preferences. Select the Custom Preferences tab.
Obtain an API key in Settings → Developers → New API Key in the Invoiced application.
Paste the API key into the Invoiced API Key field on NetSuite and click Save.
The next step is to create an OAuth Access Token for Invoiced on NetSuite. To do that there are few steps you need to follow.
You will need to pick a user that will that the access token will be based on and assign the Invoiced Integration role to that user.
Go to Setup → Users/Roles → Manage Users.
Select the user you plan to use for the integration and add the Invoiced Integration role to that user.
Go to Setup → Users/Roles → Access Tokens → New
Select Invoiced as the application name, the user from the previous step as the user, and Invoiced Integration as the role.
Copy-paste the token ID and token secret values into a text editor. NetSuite will not display this information again.
On Invoiced, go to Settings → Integrations in the Invoiced dashboard.
Click on Connect on the NetSuite integration.
Enter in the NetSuite account ID, token, and token secret for the Invoiced integration created earlier.
Click Save. NetSuite is now connected!
Once the bundle is installed and fully configured, new transactions will sync with NetSuite automatically. The integration does not sync data created prior to the bundle being installed and fully configured.
Here we have documented all of the limitations, nuances, and edge cases to be aware of when using the NetSuite integration.
- Customers on Invoiced are mapped to customers on NetSuite by the customer name.
When a sync fails you can check the SuiteScript logs in NetSuite.
If you are still unable to get your data synced then please contact firstname.lastname@example.org for further assistance.
Your NetSuite account ID is required in order to connect the integration. You can obtain your account ID from NetSuite with these steps: