Order Invoicer
Netsuite

Configure NetSuite

Set up Token-Based Authentication (TBA) to connect Order Invoicer to NetSuite

Prerequisites

Before you begin, make sure that:

  • You have an active NetSuite account (production or sandbox)
  • You have administrator access to your NetSuite account
  • The SuiteTalk REST Web Services and Token-Based Authentication features are enabled

Order Invoicer connects to NetSuite via Token-Based Authentication (TBA / OAuth 1.0a). You will therefore need to provide five values:

  • Account ID (e.g. 1234567 or 1234567_SB1 for a sandbox)
  • Consumer Key and Consumer Secret (from an Integration record)
  • Token ID and Token Secret (from an Access Token)

Enable the required features

Enable SuiteTalk REST and TBA

  1. Log in to NetSuite with an administrator account
  2. Go to Setup → Company → Enable Features
  3. On the SuiteCloud tab, check:
    • REST Web Services
    • Token-Based Authentication
  4. Save

If these options do not appear, check that your NetSuite license includes SuiteCloud Plus. Contact your NetSuite reseller if needed.

Retrieve your Account ID

Find your Account ID

  1. Go to Setup → Company → Company Information
  2. Note the value of the Account ID field (e.g. 1234567 in production, 1234567_SB1 for a sandbox)

The Account ID is used in the API URL (https://{accountId}.suitetalk.api.netsuite.com) and in the signature of each request. Keep it as is — Order Invoicer normalizes it automatically.

Create an Integration record

The Integration record provides the Consumer Key / Consumer Secret pair.

Create the Integration

  1. Go to Setup → Integration → Manage Integrations → New
  2. Fill in:
    • Name: Order Invoicer
    • State: Enabled
  3. Check:
    • Token-Based Authentication
    • ❌ Uncheck the other methods (TBA: Authorization Flow, OAuth 2.0, User Credentials)
  4. Click Save

Copy the Consumer Key and Consumer Secret

After saving, NetSuite displays only once:

  • Consumer Key
  • Consumer Secret

Copy both values immediately and keep them somewhere safe.

These values are only displayed once. If you lose them, you will need to reset the Integration.

Create a dedicated role and user

Order Invoicer recommends a dedicated user with a minimal role to limit the scope of access.

Create a role

  1. Go to Setup → Users/Roles → Manage Roles → New
  2. Fill in Name: Order Invoicer Integration
  3. On the PermissionsSetup tab, add:
    • Log in using Access Tokens (Full)
    • REST Web Services (Full)
    • User Access Tokens (Full)
  4. On the PermissionsLists tab, add:
    • Customers (Full)
    • Items (View)
    • Subsidiaries (View) — only for OneWorld accounts
  5. On the PermissionsTransactions tab, add:
    • Invoice (Full)
    • Find Transaction (View)
  6. Click Save

Assign the role to a user

  1. Go to Setup → Users/Roles → Manage Users
  2. Select or create a dedicated user (e.g. order-invoicer@votre-domaine.com)
  3. On the Access tab, add the Order Invoicer Integration role
  4. Click Save

The user does not need to log in to the NetSuite interface — the Access Token acts on their behalf.

Create an Access Token

The Access Token provides the Token ID / Token Secret pair.

Generate the token

  1. Go to Setup → Users/Roles → Access Tokens → New
  2. Select:
    • Application Name: Order Invoicer (the Integration created earlier)
    • User: the dedicated user
    • Role: Order Invoicer Integration
  3. Token Name: Order Invoicer Token
  4. Click Save

Copy the Token ID and Token Secret

NetSuite displays only once:

  • Token ID
  • Token Secret

Copy both immediately.

As with the Integration, these values are only displayed at creation. If lost, you will need to regenerate the Access Token.

Enter your credentials in Order Invoicer

From the NetSuite connection form in Order Invoicer, fill in the five fields:

FieldValue
NetSuite Account ID1234567 or 1234567_SB1
Consumer Keyfrom the Integration
Consumer Secretfrom the Integration
Token IDfrom the Access Token
Token Secretfrom the Access Token

The connector automatically validates your credentials by making a signed request to the NetSuite API.

Troubleshooting

"Invalid credentials" error

  • Check that the five values were copied in full, with no leading or trailing spaces
  • Account ID: if your account is a sandbox, the _SB1 (or _SB2, etc.) suffix is required
  • Check that the Integration and the Access Token are in the Enabled state (not revoked)
  • Check that the role has the Log in using Access Tokens and REST Web Services permissions

"INSUFFICIENT_PERMISSION" error

  • The role assigned to the user does not have the Customers (Full) or Invoice (Full) permissions
  • Update the role's permissions and try again

"INVALID_LOGIN_ATTEMPT" error

  • The user linked to the token is disabled or no longer has access to the role
  • Check the user's Access tab

Invoice creation rejected on a OneWorld account

  • OneWorld accounts require a mandatory subsidiary field on customers and invoices
  • This first version of Order Invoicer does not yet populate this field — contact our support to enable subsidiary mapping

API reference

Support

If you run into difficulties:

  1. See the troubleshooting section above
  2. Consult the official NetSuite documentation
  3. Contact our support: contact@orderinvoicer.com

On this page