Skip to main content

Install the Magento 2 - NetSuite integration app

Gogula R Bhavana
  • Updated

Contents

The Magento 2 -NetSuite integration app helps online retailers combine the powerful Magento 2 online marketplace platform with the proven back-office features of NetSuite and keep the orders, customers, fulfillments, pricing & inventory levels in sync.

Before you install the integration app

Before you install the Magento 2 - NetSuite integration app, perform the following:

  1. Perform the steps mentioned in the Prerequisites and Pre-installation tasks articles.
  2. Install the integrator.io and Magento 2 bundles in NetSuite.
    1. Install integrator.io bundle in NetSuite.
    2. Install Magento 2 Bundle in NetSuite.

Install integrator.io bundle in NetSuite

  1. Login to your NetSuite account.
  2. Go to Customization > SuiteBundler > Search & Install Bundles.
    Search_Bundle_Navigation.png
  3. On the "Search & Install Bundles" page, in the Keywords field, enter Celigo integrator.io (bundle name) or 20038 (bundle ID).
  4. Click Search.
    Search_Bundle.jpg
  5. Click Celigo.integrator.io.
  6. On the "Bundle Details" page, click Install.
    Install_Bundle.jpg
  7. On the permission window, read through and click OK.
    Permission_window.jpg
    Your bundle will now be installed and you can find the same in the Search & Installed Bundles page (Customization > SuiteBundler > Search & Install Bundles > List).

Install Magento 2 bundle in NetSuite

  1. In NetSuite, go to Customization > SuiteBundler > Search & Install Bundles.
  2. On the "Search & Install Bundles" page, in the Keywords field, enter Celigo Magento 2 Connector (bundle name) or 119234 (bundle ID).
    Magento_2_Bundle.png
  3. Click Search.
  4. Click Celigo Magento 2 Connector.
  5. On the "Bundle Details" page, click Install.
  6. On the permission window, read through and click OK.
    Your bundle will now be installed and you can find the same in the Search & Installed Bundles page (Customization > SuiteBundler > Search & Install Bundles > List).

Configure your NetSuite account

Enable Token-Based authentication in your NetSuite account

  1. Log in to your NetSuite account as an Administrator.
  2. Go to Setup > Company > Enable Features.
  3. On the "Enable Features" page, click SuiteCloud.
  4. In the Manage Authentication section, check the TOKEN-BASED AUTHENTICATION checkbox.
  5. Click Save.

Create a custom role in NetSuite

  1. In NetSuite, go to Setup > Users/Roles > Manage Roles.
  2. On the "Manage Roles" page, next to the "Celigo eTail SmartConnectors" role, click Customize.
  3. On the "Role" page, in the Name field, enter a different name to clone the role.
  4. In the "Permissions" tab, configure the permissions as per your business needs as needed.
  5. Click Save.

Select NetSuite user and assign a role

Select the NetSuite user account that will be used to connect your Magento 2 SmartConnector. 

  1. In NetSuite, go to Setup > Users/Roles > Manage Users.
  2. On the "Manage Users" page, click on the appropriate user to connect your Magento 2 integration app.
  3. On the selected Employee page, click Edit.
  4. Go to Access tab > Roles sub-tab.
  5. Select the role that was created in the "Create a custom role in NetSuite" step.
  6. Click Save.

Generate NetSuite access tokens

  1. In NetSuite, go to Setup > Users/Roles > Access Tokens > New.
    blobid8.png
  2.  In the APPLICATION NAME drop-down box, select eTail Connectors (Token-Based Auth).
  3. In the USER drop-down list box, select the user name that you have edited in the previous step.
  4. In the ROLE drop-down list box, select the role that was assigned to the user.
  5. The TOKEN NAME populates automatically. Modify the name as needed.
  6. Click Save.
  7. Token ID & Token Secret will be displayed. Save the tokens in a place where you can copy it into your Celigo connection as described in the next section.

Install Magento 2 - NetSuite Integration App

Prerequisite: Be sure that you have a valid subscription license to install the integration app.

Important: If you're installing the Magento 2 - NetSuite Integration App on the Magento 2.4.1 version and above, you have to configure your Magento 2 connection using the Magento Two-Factor Authentication (2FA) to access the Magento Admin UI from all devices. For more information, refer to Authorize your Integration App connection to support Magento two-factor authentication.

  1. Login to your integrator.io account.
  2. In the left pane, click Marketplace.
  3. On the Marketplace page, click Magento 2.
  4. Click Install.
    Note: If you see Contact Sales, instead of the Install, contact your Account Executive to check the status of your integration app license.
  5. On the "My Integrations" page, you can now find the Magento 2 - NetSuite integration app. On the tile, click Continue setup.
  6. Configure your connections:
    1. For NetSuite connection, refer here.
    2. As you have already installed the integrator.io bundle, click Install.
      1. Log in to NetSuite using your NetSuite credentials.
      2. Click Verify Now link.
    3. For Magento 2 connection, refer here.
    4. As you have already installed the Magento 2 bundle, click Install.
    5. For Integrator Bundle, the Installed status will come automatically. This is because you installed the integrator.io bundle.
      Note: If you're seeing the Click to Install link, click the link and this will open the NetSuite login page. Log in to NetSuite using your NetSuite credentials and the Click to Install will automatically convert to the Verify Now link. Now click Verify Now.
    6. For Magento 2 Bundle, click Verify Now. This is because you installed the Magento 2 bundle.
      Note: If you're seeing the Click to Install link, click the link and this will open the NetSuite login page. Log in to NetSuite using your NetSuite credentials and the Click to Install will automatically convert to the Verify Now link. Now click Verify Now.
    7. For Magento Extension, Install Magento 2 Extension.

Install the Magento 2 extension

To install Magento 2 Extension in your Magento instance:

  1. Purchase the free Celigo "NetSuite Connector" (Magento 2 extension) from the Magento Marketplace. You will receive a zip file.
  2. Upload the zip file on your Magento server using the below instructions:
    Note: Refer to the Magento extension install instructions here.
    1. Ensure you have the FTP Access and ssh or command access for your Magento server FTP.
    2. Log into the FTP of your Magento server and navigate to the "Magento" directory.
    3. Go to the "app" folder and check if there is any "code" folder. If not, create a folder named "code".
    4. Go inside the "code" folder and create a new folder named "Celigo". Then, go inside the "Celigo" folder and similarly, create a folder named "Magento2NetSuiteConnector".
    5. Unzip the above zip file here.
    6. Then open the ssh/command prompt on your Magento server, and go to the Magento install directory and run the following commands
      1. php bin/magento setup: mode developer
      2. php bin/magento module:enable Celigo_Magento2NetSuiteConnector
      3. php bin/magento setup: upgrade
      4. php bin/magento cache: clean
      5. php bin/magento setup: mode production

Note: Whenever you refresh your sandbox environment in NetSuite, it is recommended to uninstall the integration app and re-install it back.

Related articles

Comments

5 comments

Date Votes
  • Michael Rosenberg

    The Magento extension install instructions are incorrect according to our dev. Here are the correct steps:
    bin/magento deploy:mode:set developer
    bin/magento module:enable Celigo_Magento2NetSuiteConnector
    bin/magento setup:upgrade
    bin/magento cache:clean
    bin/magento deploy:mode:set production

    3
  • Gogula R Bhavana Prebuilt Docs Team Lead Community manager

    @Michael Rosenberg

    Thank you for letting us know. We have added a link in the note that explains the correct "Magento extension install instructions."

    -1
  • Lareen Strong

    Thank you Michael Rosenberg. Pretty hard to do for a novice when the instruction are incorrect.

     

    1
  • Chris Banyard

    These instructions are lacking any substance or accuracy and do very little to help anyone figure this installation out. 

    1
  • Gogula R Bhavana Prebuilt Docs Team Lead Community manager

    Thank you Chris Banyard for letting us know!

    I will reply back soon once the article is reviewed and updated.

    0

Please sign in to leave a comment.