Installing the Box for Oracle NetSuite Bundle




Box for Oracle NetSuite augments or replaces the NetSuite File Cabinet, bringing the robust content management capabilities of Box right to the NetSuite interface. Joint NetSuite/Box customers can centralize in a single Box folder all documents associated with a particular NetSuite record. They can then access those documents from any device, without logging in to NetSuite.


This article details the first steps in connecting NetSuite with Box. It includes the procedures Admins must follow to:

  1. Install the Box SuiteApp Bundle in NetSuite
  2. Connect your NetSuite and Box accounts

After your NetSuite and Box accounts are connected, you need to configure each of your NetSuite record types to enable the integration and set up the default folder structure.


To install the Box for Oracle NetSuite integration, you must be both:

  • A NetSuite Admin with SuiteApp Bundle Installation privileges; and
  • A Box Admin with access to your company's Box Enterprise ID (EID) and the ability to enable custom applications

More information if you're upgrading from an earlier integration of Box for NetSuite. 


Installing the Box SuiteApp Bundle in NetSuite


IMPORTANT   If you are already using an earlier version of the Box for Oracle NetSuite integration, we strongly recommend you first install the newer version of the integration.  After it is fully installed and configured, then uninstall the earlier version to minimize any end user confusion.


To Install the Box SuiteApp Bundle in NetSuite

  1. In NetSuite, on the global dashboard, follow this path to go to the SuiteApp Bundle Installer: Customization > SuiteBundler > Search & Install Bundles.


    SuiteApp Bundle path.png


  1. In the search box, enter Box for Oracle NetSuite to ensures the integration displays in the search results.

Search and Install Bundles.jpg

  1. Click Box for Oracle NetSuite. The bundle record opens, and you can view details of the Bundle, including the custom records that will be created with the installation.
  2. Click Install.
  3. When prompted, click OK. The Installed Bundle screen displays.


    Installed bundle screen.png


The Box for Oracle NetSuite bundle status is pending. Installation takes approximately 10 minutes.


Bundle installation pending.png


Shortly after you initiate the installation, the status changes from Pending... to Executing...


Bundle installation executing.png


When the installation completes – approximately 10 minutes later – the status display changes to a green check mark.


Bundle installation completed.png


Congratulations! You’ve finished installing the Box for Oracle NetSuite bundle. However, the integration itself is not yet complete. Now you must set up and connect your NetSuite instance to your Box account.



Setting up and connecting your NetSuite instance to your Box account

 This is a two-part process. You must go into each application – first in NetSuite, and then in Box – to complete the connection.

  • Part 1:  In NetSuite, record your Box Enterprise ID
  • Part 2: In Box, enable the Box-for-NetSuite custom application


Part 1: To record your Box Enterprise ID

  1. In NetSuite, follow this path to go to your list of record types:
    Customization > Lists, Records & Fields > Record Types.Record Type list path.png


The Box for Oracle NetSuite bundle installs 6 new custom record objects.


Box Record Type list.png



The table below lists and explains each of the six new objects.



Box Record Object


Box Account Association

Stores the mapping between the individual NetSuite user and the individual Box user.  Everyone on NetSuite who also uses Box has a record inside this Box Account Association.

Box Folder Collaborations

Tracks Box permissions and collaborations on NetSuite-Box folders.

Box Integration Config

The primary configuration file for the integration.  Contains the Box Enterprise ID (EID), which is critical for connecting your NetSuite instance to your Box instance.

Box Record Folder

Stores the mapping between NetSuite records and Box folders.

Box Record Type Config

Contains the integration configuration for each NetSuite record type.  Here is where you enable and customize Box integration settings.  Completing this step enables the Box Content option to display in the corresponding NetSuite record screen.

Box Type Folder

Contains the mapping of NetSuite record types to Box folders.  Here is where you can specify a parent folder for the NetSuite object and Box parent folders.


  1. Connect your Box instance. To do this, click List to the right of Box Integration Config.

Box Integration Config List.png



  1. When the Box Integration Config List displays, click Edit.

Config List edit.png



  1. Log in to Box as the admin of your box Enterprise account (if you are not already logged in). In Box, locate your Box EID. To do this, follow this path:
    Box Admin Console > Account & Billing.

Box Admin Console.png

Box EID.png



  1. Copy your Box EID to your clipboard and return to NetSuite.
  2. In NetSuite, in the Box Integration Config record, in the Enterprise ID field, paste your Box EID. Then click Save.  

Box EID NetSuite integration.png


Note   If you're installing this integration over an earlier version, you''ll return to this screen later to enable a migration path.


Part 2: To enable the NetSuite v2 custom application

  1. In Box, follow this path to display your Box Apps screen:
    Admin Console > Enterprise Settings > Apps.
  2. Scroll to down to the Custom Applications section, then click Authorize New App.

Box Enterprise Settings.png

Box Authorize New App.png


  1. You are prompted for an API key. You need this to grant NetSuite access to your Box account. Enter the following key: pl0vgv5rriv0o4pzqmwy0dlkao2cleat
  2. Click Next.

App authorization API key.png


  1. The next prompt provides information on the access level of the NetSuite application in your Box instance. Click Authorize.

App authorization authorize.png



The Box for Oracle NetSuite application is now added to your Box Custom Applications list.


Custom app added.png


It’s done! Your NetSuite instance and Box corporate account are successfully connected, and you’ve completed the integration installation.


If you've installed this over an earlier version of this integration, proceed to enabling a migration path.

If this is a clean install, it’s time to set up the Box integration within your NetSuite records.


Version history
Revision #:
30 of 30
Last update:
‎10-17-2018 03:21 PM
Updated by: