Implementation

  • Updated

Implementation Overview

In general terms, the entire implementation process whether done as a self-implementation or a managed implementation consists of several stages:

1) Prerequisites
2) Installation
3) Configuration
4) Testing (UAT)
5) GoLive


Prerequisites

Before the installation, configuration and testing can begin, it is important to complete the prerequisites listed below.

  1. Access to Integrator.io iPaaS Account
    You will need to have access to the main integrator.io account. Either create one or ensure you have credentials to access the main integrator.io account. Click here to see details on how to create one if needed.
  2. Administrator Access to NetSuite
    You will need to have Administrator access to NetSuite Production and/or NetSuite Sandbox account. Click here to see details on how to create one if needed. Ensure you have administrator-level access to your NetSuite account. You will need NetSuite Account ID to install the integration app.
  3. Top Level Access to Loop Returns Account
    You will need to have Administrator access to your Loop Returns account. Click here to see details on how to create one if needed.

Installation

Before the configuration, and testing can begin, let’s complete installation with the steps listed below.

Step 1: Preparing NetSuite Account

  1. Login in NetSuite sandbox/production environment using login credentials with Administrator role.
  2. Install NetSuite bundle(s) — Please install the bundles in the same sequence mentioned below.
    • Bundle 1: “Celigo integrator.io” bearing ID: 20038.
    • Bundle 2: “Novamodule Loop Returns Bundle” bearing ID: 386199
      Note: Please click here to find the instruction on how to install the bundle in NetSuite.
  3. After the installation of the bundles, go to Set up → Users/Roles and make sure you see the option Access Tokens. If you do not see that option go to Set up → Company→ Enable Features → Suite Cloud → Manage Authentication→ Token Based Authentication (Please check this checkbox).
  4. Once that is completed, go to Set up → Users/Roles → Manage Roles and click the customize button on role Celigo integrator.io Full Access w/o 2FA [Locked] and rename the role to Novamodule Loop Returns Integration Access.
  5. Please make the below changes to the role.
    – In the case of a subsidiary, select SUBSIDIARY Restrictions to ALL (It’s a Radio button field).
    NetSuite_Subsidiary_Restrictions.png
    – Go to subtab:  Permissions → Lists  & add ‘currency’ and ‘subsidiary’ with ‘FULL’ access, in case they are missing.
    – Go to subtab:  Permissions → Setup & mark all the permissions as ‘FULL’ and save the role record.
  6. Search for Employee and add the role (Novamodule Loop Returns Integration Access) which we created earlier under the Access tab.Employee_Roles.png
  7. Generate Access token & Key with App Name: “Novamodule eTail Connectors” for the Employee we added the Role in Step#6.
    Note: Please click here to find the instruction on how to generate NetSuite tokens. The role/employee used to generate tokens should not be deactivated in NetSuite.
  8. Store the token & secret and use them to establish the connection in integrator.io.

Step 2: Preparing Loop Returns Account

  1. Login to the Loop Returns account using the credential.
  2. Copy the API token available under the Your Account tab. If the API token is not available then submit a support request with the Loop Returns support team.

Loop_Returns_API_Key.png

Step 3: Connection Setup in Integrator.io

  1. Please click here to find the instructions to set up a NetSuite connection on integrator.io.
  2. Please click here for the instructions to set up the Shopify connection on integrator.io

Step 4: App installation in integrator.io

  1. Install “Loop Returns – NetSuite Integration App” in integrator.io from the Celigo Marketplace. Please click here to find out the instruction on how to install the App in integrator.io.
  2. Please click on the pending setup button on the Loop Returns Integration tile and proceed with installing the Integration by setting up connections to both NetSuite and Loop Returns.

Note: In case you don’t have access to the Loop Returns – NetSuite Integration App, please contact us through the support widget.


NetSuite Bundle Installation

Please follow below instructions to install any bundle in NetSuite

  1. Login into NetSuite with login ID/Password using this link
    NetSuite_Login.png

     

    2. Go to Customization → SuiteBundler → Search & Install BundleNetSuite_Search___Install_Bundle.png3. Type Bundle ID that you are looking to install in the KEYWORDS textbox and hit SEARCH button. It would show the Bundle in the lower tabNetSuite_Search___Install_Bundle_20038.png
    4. Click on the Bundle Name i.e. CELIGO INTEGRATOR.IO and then INSTALL button to install it

    Celigo_Integrator-io_Bundle.png


NetSuite Token Generation

Please follow the below instructions to generate NetSuite access token.

1. Goto Setup → User/roles → Access tokens → New

1-1.png

2. If you are unable to find Access tokens then follow the below steps to enable the access tokens in your NetSuite.

a)Goto Setup → Company → enable features → Suite cloud → Token Based authentication → check the checkbox.

2.1.png

2.2.png

2.3.png

b) Now, repeat step 1.

3. Fill in all the required values and click save like below.

Application Name: Novamodule etail Connector
User: Novamodule (the one with Admin access)
Token Name: Give it a meaningful as per the Integration App you are installing

before-tokens.png

4. Make a note of the below generated Token ID and Token Secret.

Note: These Tokens will be used to set up connections of integrator.io with NetSuite.

token-id-and-secret.png


Setup NetSuite Connection in Integrator.io

Please follow the below instructions to set up the NetSuite connection in Integrator.io.

1. Goto Tools & Resources → Connections → New Connection

1-1-1.png

 

2.png

 

2. Fill the details as shown in the below screenshot.

  • Select the Connection as NetSuite → It will open up a connection setup pop-up
  • Select the required NetSuite environment (Sandbox/ Production)
  • Add Token ID & Token Secret that has been already generated from the following instructions.
  • Please enter the proper NetSuite account ID. Please click here to know the steps about how to get the NetSuite account ID.

Capture.png

NOTE: If you are installing the integration in the Sandbox instance, please make sure to select the Environment as Sandbox2.0 and the account ID as 1234_SB instead of 1234-SB.

IO-Sandbox-Connection.png

3. Click Test and if it shows as working fine as below then save and close it else retry it by entering the correct values.

Capture-1.png


Install the Integration App in Integrator.io

Please follow the below instructions to install the Integration App in Integrator.io.

1.  Login into Integrator.io and Go to MarketPlace.

2.  Find the integration app from the list and Install (Note : Once the license is issued, It will display "Install" instead of "Request Demo").

 

3.  Click “install” to install the Integration App with NetSuite Connection & other webstore/ marketplace connection to complete the installation successfully.

(Note : Once the license is issued, It will display "Install" instead of "Request Demo")

4.  In case, you are unable to find the INSTALL option and instead, the CONTACT SALES option is appearing, it means that the license isn’t provisioned in your account. In this case, please contact us using the support widget.

contact-sales.png


Next Steps

Take a look at the Configuration section of the implementation guide on the left-hand side of the screen to configure the integration and test it.