Step 4 - Setting Up NetSuite (Amazon Integration)

This article assumes that:

  • You have already created a NetSuite account.
  • You are familiar with creating Items, Sales Order/Cash Sales and the accounting processes you will be using.

FarApp provides two different authentication methods to allow integration with your NetSuite account. FarApp and NetSuite recommend using the token-based authentication (TBA) method. This method is the most secure, easiest to maintain and most stable. It also reduces the likelihood of timeout and credential errors.

Please see this article for instructions for updating your NetSuite account and FarApp integration to use the token-based authentication method: https://support.farapp.com/hc/en-us/articles/115013718667-NetSuite-Token-Based-Authentication. This article overviews NetSuite Setup now and the FarApp Setup part follows.

If you prefer to not use token-based authentication, please follow the steps below.

Preparing NetSuite to Connect to FarApp

  1. Log in to NetSuite as an administrator.
  2. Navigate to Setup > Company > Enable Features.
  3. Select the SuiteCloud tab.
  4. In the section SuiteTalk (Web Services), make sure the Web Services checkbox is checked. If not, check the box, and save your settings.
  5. Navigate to Setup > Integration > Web Services Preferences.
  6. Copy Account Number for use below.
  7. Navigate to Setup > Integration > Web Services Preferences.
  8. In the upcoming steps you will be giving FarApp access to your NetSuite. You can choose to assign the user you give FarApp an the administrator role—usually internal ID 3. (You can find your current user rule ID following that steps at https://support.farapp.com/hc/en-us/articles/115014364008-How-to-Find-Your-NetSuite-Role-ID.) If you do not want to give the FarApp user the administrator role, you will need to make sure that the FarApp user has the following permissions:
  • Lists > Accounts Full
  • Lists > Customers Full
  • Lists > Items Full
  • Lists > Locations View
  • Lists > Payment Methods View
  • Lists > Documents and Files Full
  • Transactions > Sales Order Full
  • Transactions > Sales Order Approval Full
  • Transactions > Find Transaction Full
  • Transactions > Item Fulfillment View
  • Setup > Web Services Full
  • Setup > Accounting Lists View
  • Setup > Custom Item Fields View
  • Setup > Custom Transaction Fields Full
  • Setup > Custom Fields Full
  • Setup > Custom Lists Full
  • Setup > Custom Record Types Full
  • Setup > Other Custom Fields View
  • Setup > Other Lists View
  • Setup > Custom Body Fields Full
  • Lists > Currency View
  • Lists > Shipping Items
  • Transactions > Invoice View
  • Transactions > Fulfill Sales Orders View
  • Transactions > Credit Memos
  • Transactions > Fulfill Sales Orders Full (for 3PL integrations only)

Installing the FarApp Bundle on NetSuite

FarApp's NetSuite bundle (just called FarApp for simplicity) is used to push item updates to FarApp from NetSuite in real-time to improve update speeds. If FarApp is doing product and/or inventory updates, you should install the bundle. You can read more about using the FarApp bundle here: https://support.farapp.com/hc/en-us/articles/219375948-FarApp-NetSuite-Bundle

*Please note, should enter your FarApp credentials (the credentials you use to log into FarApp) in the two separate locations mentioned in the section below, otherwise you will get invalid credentials errors in NetSuite after installing the bundle. This will prevent you from creating transactions in NetSuite until the credentials are entered correctly.

*Please make sure to only install the FarApp bundle only on NetSuite the account you currently have connected to FarApp at: https://app.farapp.com/settings#/netsuite_settings (e.g. if you have both a NetSuite sandbox and live NetSuite, please ensure you have bundle installed only on one of these at a time)

To install the bundle, follow these steps in NetSuite. Please note that once started all the steps must be completed:

  1. Make sure you are logged in to NetSuite as an admin user.
  2. Go to Customization->SuiteBundler->Search & Install Bundles.
  3. Enter FarApp in the KEYWORDS box and click the Search button.
  4. Find the result named just "FarApp" and click on the name.
  5. Click Install. It may take a little time but this will install the bundle.
  6. Once installation completes, go to Customization -> Scripting -> Script Deployments
  7. From the Drop down that says 'Scripts' select 'Push Item Updates to FarApp'
  8. Click 'Edit' on the deployment that shows up in the list
  9. Click the 'Parameters' tab and enter your FarApp credentials frist time (i.e. the ones you use to login to app.farapp.com) in the text fields
  10. Click 'Save'
  11. Go to Setup->Company->General Preferences.
  12. Go to the Custom Preferences tab.
  13. In the FarApp section, enter your FarApp credentials second time (i.e. the ones you use to login to app.farapp.com).
  14. If you have user-event scripts in NetSuite that modify an item record as you save the item record (for example, upon save, it auto-computes the prices and updates them), then check the "HAVE ITEM-MODIFYING USER-EVENT SCRIPTS" box. Otherwise, leave it unchecked for improved performance.

Once the above is done, any item and/or inventory changes will be pushed to FarApp in real-time.

Creating Subtabs for the Item Creation Screen

When you create an item in NetSuite, you will need to populate a number of fields with information like the item's description, weight, color, etc. NetSuite organizes these fields within subtabs. FarApp requires several unique fields in order to sync your items from NetSuite to your storefronts automatically. These steps will walk you through creating special subtabs for these fields.

  1. Make sure you are logged into your NetSuite account.
  2. Navigate to "Customization" > "Forms" > "Subtabs".
  3. Navigate to the “Item” tab.
  4. Fill out the following (without the quotes) in the title field: “Marketplace/Cart". Click "Save".
  5. Navigate back to "Customization" > "Forms" > "Subtabs".
  6. Navigate to “Item” tab.
  7. Fill out the following two entries (without the quotes) in the title fields: “Optional” and “Required”. Make the Parent "Marketplace/Cart" for both entries. Save.
  8. Navigate back to "Customization" > "Forms" > "Subtabs".
  9. Navigate back to “Item” tab.
  10. Fill out the following (without the quotes) in the title field: “Amazon". Click "Save".
  11. Navigate back to "Customization" > "Forms" > "Subtabs".
  12. Navigate to “Item” tab.
  13. Fill out the following three entries (without the quotes) in the title fields: “Not Common”, “Optional”, and “Required”. Make the Parent "Amazon" for each entry. Save.
  14. Navigate back to "Customization" > "Forms" > "Subtabs".
  15. Once you are finished, your Custom Subtabs should look like this:Screen_Shot_2017-04-26_at_1.50.56_PM.png
  16. Please note that if you name something incorrectly, once you install and run the FarApp Marketplace/Cart - Item Fields bundle (coming up in the next section), the bundle will provide feedback on what tab or subtab you need to return to and recreate.

Installing the FarApp for SuiteSuccess Bundle on NetSuite

*Please note that if you are installing the FarApp for SuiteSuccess Bundle on NetSuite you need to have completed the steps above for "Creating Subtabs for the Item Creation Screen."

  1. SuiteSuccess is a special NetSuite program that you may or may not be a part of. You can learn more about it here: http://www.netsuite.com/portal/services/suitesuccess.shtml You do not need to be a part of the SuiteSuccess program to use FarApp's special NetSuite bundle for it. FarApp's SuiteSuccess bundle will automatically create the basic item fields that FarApp will require. To begin installing the bundle, login to your NetSuite account.
  2. Navigate to Customization > SuiteBundler > Search & Install Bundles
  3. Enter ‘farapp for suitesuccess’ in the "KEYWORDS" field and Click "Search"
  4. Select “FarApp for SuiteSuccess - Item Fields”
  5. Click "Install"
  6. Click "Install Bundle", then Click "Ok"
  7. This will redirect you to the list of your installed bundles. You will see the first in the list as “Loading”. After allowing some time, click Refresh and confirm you see “FarApp for SuiteSuccess - Item Fields”

Creating the Product Sync Fields Using the FarApp for SuiteSuccess Bundle

  1. Please navigate to Setup > FarApp > FarApp SuiteSuccess Marketplace Fields.Screen_Shot_2017-03-13_at_2.49.29_PM.png
  2. Here, please select the Marketplace/Cart you will be integrating with and then enter in the number of accounts you plan to set up with FarApp for that Marketplace/Cart. You can do this multiple times if you have multiple Marketplaces/Carts that you want to integrate.Screen_Shot_2017-03-13_at_2.49.19_PM.png

Configuring NetSuite to Allow You To View Field ID's and Internal ID's

  1. Go to Setup > Company > Enable Features > SuiteCloud and check the box for Client SuiteScript if it hasn’t already been checked.
  2. Go to Home > Set Preferences > General Tab > Set Defaults and check the box for Show Internal IDs if it hasn’t already been checked.
  3. For additional information on this, please reference this article: https://support.farapp.com/hc/en-us/articles/216635418-NetSuite-Internal-IDs-and-Field-IDs

Comments