Update NetSuite sync connection to Token-Based Authentication

With the upcoming NetSuite 2019.1 Release in early 2019, the integration between Bill.com and NetSuite will need to be set up via Token-Based Authentication.

Token-Based Authentication has already been enabled in your Bill.com account. To ensure the sync continues to work when NetSuite 2019.1 is released, follow the steps below to enable and connect via Token-Base Authentication.

Update the sync bundle

If not on the most recent sync bundle version: 3.0.9.d, uninstall and reinstall the sync bundle.

  1. In NetSuite, hover over Customization > SuiteBundler > Search & Install Bundles > Click List
    Search Bundle list
    • The bundle version number is under the Version column next to Bill.com Sync for NetSuite
      • If not 3.0.9.d or 3.0.10, uninstall the bundle
      • If already on bundle 3.0.9.d or 3.0.10, skip to Enable Token-Based Authentication below
  2. Hover over the green dropdown next to the Bill.com sync for NetSuite, click Uninstall
    Bundle list - uninstall
  3. Hover over Customization > SuiteBundler > Click Search & Install Bundles
  4. Type Bill.com into the Keywords field
  5. Click Search
  6. Click Bill.com Sync for NetSuite
    Search Bundle 3.0.10
    • If encountering a no access error, contact Bill.com support to have access to the bundle enabled
  7. Click Install
  8. Click I Agree for Bill.com SuiteBundle Terms
  9. Click Install Bundle
  10. Configure Bill.com Preferences in NetSuite again

Enable Token-Based Authentication

  1. Hover over Setup > Company > Click Enable features
    Enable Features
  2. Click SuiteCloud
  3. Scroll down to the Manage Authentication section
  4. Enable Token-Based Authentication
    Manage Authentication
  5. Click I agree on the SuiteCloud Terms of Service page
  6. Click Save

Create a new integration

A NetSuite Administrator will need to create an integration in NetSuite that will allow us to obtain the Consumer Key and Consumer Secret that is required to connect the sync.

Important: If syncing with multiple entities/subsidiaries, use the same Consumer Key and Consumer Secrets for all connections.

  1. In NetSuite, hover over Setup > Integrations > Manage Integrations > Click New
    Manage Integration
  2. Ensure State field is Enabled
  3. Enter Billcom in the Name field
  4. Check the box for Token-Based Authentication
  5. Click Save
    New Integration
  6. Copy and Save the Consumer Key and Consumer Secret, both will be required to connect the sync
    • Important: For security reasons, the only time the consumer key and consumer secret values are displayed is on the confirmation page. After leaving this page, these values cannot be retrieved from the system. If these credentials are lost or forgotten, they will need to be regenerated. Treat these values as you would a password.
      Consumer key:secret

Note: Do not reset previously created consumer key/secret or it will break other integrations connected to the NetSuite account.

Create access tokens

A NetSuite Administrator will need to create access tokens in NetSuite that will also be required to connect the sync.

Important: If syncing with multiple entities/subsidiaries, use the same access tokens for all connections.

  1. Click Manage Access Tokens from the Settings box on the Homepage in NetSuite
    Settings box
  2. Click New My Access Token
    New my access token
  3. Select the integration that was just created: Billcom in the Application Name field
  4. Click Save
    Access Token page
  5. Copy and Save the Token ID and Token Secret, both will be required to connect the sync
    • Important: For security reasons, the only time the consumer key and consumer secret values are displayed is on the confirmation page. After leaving this page, these values cannot be retrieved from the system. If these credentials are lost or forgotten, they will need to be regenerated. Treat these values as you would a password.
      Token Id:secret

Note: Do not reset previously created access token/secret or it will break other integrations connected to the NetSuite account.

Disconnect and reconnect the Sync

  1. In Bill.com, click the gear icon
  2. Click Setup under Sync
  3. Click Disconnect
  4. Click Yes to confirm
  5. Click the NetSuite tile
  6. Click Connect
  7. On the Sync Login page, enter the following:
    • Consumer Key: Paste the Consumer Key that was copied and saved
    • Consumer Secret: Paste the Consumer Secret that was copied and saved
    • OAuth Token: Paste the Token ID that was copied and saved
    • Token Secret: Paste the Token Secret that was copied and saved
    • Account ID: Retained from your previous connection
    • Subsidiary ID: Retained from your previous connection
  8. Click Save to run the sync

New Sync login page