NetSuite Account Access

Token-Based Authentication

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.

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

 

NetSuite Setup

  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)

 

FarApp Setup

  1. Log in to FarApp at https://app.farapp.com/dashboard and click Edit beside the NetSuite connector (direct link: https://app.farapp.com/storefronts/NetSuite/edit).
  2. Enter your NetSuite account information on this screen. Please note that you can add multiple NetSuite logins on this page. Unless you have a SuiteCloud Plus license, most NetSuite accounts only allow a single concurrent session to NetSuite. If you process a large number of transactions (1,000+/day) or have a lot of SKUs (50,000+), it may benefit you to enter more than one NetSuite login. If you have SuiteCloud Plus, please let us know so that we can configure your account to take advantage of multiple concurrent sessions.
  3. Enter your Account Number that you copied above.
  4. Make sure to check the Active box for any additional logins that you want FarApp to use. If you want to deactivate one of these additional logins so that FarApp doesn’t use the login, you can either uncheck the box in the Login Active column or delete the row.
  5. Enter the email for the user you want to assign to FarApp. This is the email account with which you log into NetSuite. It can be an account dedicated to FarApp (e.g. farapp@yourdomain.com) or it can be one of your existing accounts. FarApp uses web services to communicate with NetSuite. Since web services sessions don’t conflict with interactive sessions, you can be logged into NetSuite at the same time as FarApp. The only benefit to providing FarApp its own credentials is if you want to control permissions separately for FarApp and/or if you want to be able to view the history of changes made by each user in NetSuite. If you do decide to provide FarApp its own unique login, please use your own domain (e.g. farapp@yourdomain.com) and not the “farapp.com” domain.
  6. Enter the password associated with this NetSuite account.
  7. Assign the user the internal ID of the NetSuite role you want to assign to this email. If you are not going to assign a role, please make sure the FarApp user has the permissions listed in the section above.
  8. Once you populate the information above, please click Save Settings. This will save the settings in FarApp and test them to make sure that FarApp can properly log into NetSuite.
  9. If the NetSuite account you are connecting FarApp to is a sandbox account, please go to https://app.farapp.com/dashboard, click on the the gear icon at the top right, select Settings and go to the NetSuite Settings page in the left panel. Flag the first checkbox on that page for The NetSuite account you're connecting is a sandbox account and not a production account.

 

Once you're done, return to the Quick Start Guide Here for the next step!

Comments