website logo
Contact SupportSign In
⌘K
Welcome!
How It Works
Accounts Receivable
Account Statements
A/R Inbox
Bad Debt
Credit Holds
Credit Notes
Custom Fields
Customer Portal
Customers
Emails
Estimates
Importing Data
Invoices
Payment Incentives
Payments
Reporting
Sales Tax
Smart Chasing
Subscription Billing
Integrations
Accounting Sync
Avalara
ChartMogul
Earth Class Mail
Lob
Salesforce
Single Sign-On
Slack
Twilio
Zapier
Setting Up Invoiced
Testing
User Permissions
Release Notes
FAQs
Videos
Developer Docs
Docs powered by archbee 
27min

NetSuite

Invoiced has an integration with NetSuite, a cloud-based ERP system. This document outlines how to setup and use the NetSuite integration.

Overview

The NetSuite integration ships with the following capabilities:

  • Reading customers, open invoices, credit notes, and payments from NetSuite
  • New data from NetSuite is synced every 15 minutes
  • Payments generated on Invoiced post to NetSuite in real-time
Document image

Setup

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.

Install The Invoiced SuiteBundle

First we need to install the Invoiced SuiteBundle, which will install an Invoiced integration and an Invoiced Integration role.

  1. On NetSuite, go to Customization → SuiteBundler → Search & Install Bundles.
  2. In the keyword box, type in Invoiced and click Search. Select the bundle with a bundle ID of 265184.
  3. Click Install to install the bundle.
  4. Once the bundle is installed, go to Page: Invoiced Integration
  5. Obtain an API key in Settings → Developers → New API Key in the Invoiced application.
  6. Paste the API key into the API Key field on NetSuite and click Save.

Setting Up an OAuth Access Token

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.

Assign the Invoiced Integration role to a user

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.

  1. Go to Setup → Users/Roles → Manage Users.
  2. Select the user you plan to use for the integration and add the Invoiced Integration role to that user.

Create the access token

  1. Go to Setup → Users/Roles → Access Tokens → New
  2. Select Invoiced as the application name, the user from the previous step as the user, and Invoiced Integration as the role.
  3. Copy-paste the token ID and token secret values into a text editor. NetSuite will not display this information again.

Connecting NetSuite on Invoiced

  1. On Invoiced, go to Apps → NetSuite in the Invoiced dashboard.
  2. Click Install.
  3. Enter in the NetSuite account ID, token, and token secret for the Invoiced integration created earlier.
  4. Click Save. NetSuite is now connected!

Usage

Reading data from NetSuite to Invoiced, such as when a new invoice is available, will sync every 15 minutes. You can see when the last sync happened on the Invoiced Integration page. If you wish to run a one-off sync, you can click the Sync Now button.Once the bundle is installed and fully configured, new transactions will sync with NetSuite automatically.

Writing data from Invoiced to NetSuite will sync instantly.

Once the integration is fully configured, new transactions will sync with Invoiced on a going forward basis. The integration does not sync data created prior to the integration being installed. See Importing Data for instructions on how to import transactions prior to installing Invoiced.

Mapping Custom Fields

It's quick and easy to map a custom field in Netsuite to a custom field in Invoiced. If you haven't created a custom field in Invoiced yet, you'll find instructions here. To create the mapping, you need to know the field IDs from both Netsuite and Invoiced.

In Netsuite, enter "customization" in the search bar and select New Invoiced Mapping Customization. In the field "Netsuite Field ID" enter the ID from your custom field in Netsuite. In the field "Invoiced field ID" enter metadata.xyz, where xyz is the ID from your custom field in Invoiced. Select the Record Type for your field and save.

Document image
Document image

Edge Cases

Here we have documented all of the limitations, nuances, and edge cases to be aware of when using the NetSuite integration.

  • If you use the Sync Now button, then the Netsuite governance limit will be lower than the scheduled script that runs every 15 minutes. You may not see all of your data synced with the Sync Now button, however, you can initiate another sync once it is finished or wait for the next scheduled sync.

Troubleshooting

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 Invoiced Support for further assistance.

Finding Your NetSuite Account ID

Your NetSuite account ID is required in order to connect the integration. You can obtain your account ID from NetSuite with these steps:

  1. Within the NetSuite application, hover over the Setup tab and click Company → Company Information.
  2. You should see an Account ID field. This is the account ID that you will use in the connection steps.
Did this page help you?
Yes
No
UP NEXT
QuickBooks Desktop
Docs powered by archbee 
TABLE OF CONTENTS
Overview
Setup
Install The Invoiced SuiteBundle
Setting Up an OAuth Access Token
Assign the Invoiced Integration role to a user
Create the access token
Connecting NetSuite on Invoiced
Usage
Mapping Custom Fields
Edge Cases
Troubleshooting
Finding Your NetSuite Account ID