This article is only for Magento 1.9. If you use Magento 2, follow the guide HERE instead. We strongly recommend using Magento 2.
This article outlines the steps to install and configure the Magento Link. These instructions are highly technical and should only be performed by your web developer.  

Before following the instructions below, you will need the following:

  • An active Magento account and/or website.
  • The Web Store module for Retailer.
  • An active Magento Link subscription.

Click HERE for more information or contact Tower Systems Support on 03 9524 8000 or support@towersystems.com.au .

The setup process involves 3 areas:

  • Configure Magento  
  • Configure Magento Link in Tower Advantage
  • Configure Web Store Settings in Retailer

Configure Magento Web Store

Download & Install the Tower Advantage Magento Link Plug-in

  1. Click HERE to download the Tower Advantage Magento Link plug-in.
  2. Unzip the  Towersystems_Linkapi.zip  file and move the contents as follows:
    • Towersystems_Linkapi.xml  =  /app/etc/modules
    • (Folder)  Towersystems  =  /app/code/local
  3. Log out and then log back into your Magento Admin Panel.

Configure Magento SOAP/XML Roles

  1. On the top menu bar of the Magento Admin Panel, navigate to  System  ->  Web Services  ->  SOAP/XML-RPC-Roles .
  2. On the top-right, click on  Add New Role .

  3. On the left panel, click on  Role Info :
    • In  Role Name , enter  Magento Link .
    • In  Current Admin Password , type in your Magento password.

  4. On the left panel, click on  Role Resources :
    • In  Resource Access , select  All  from the drop-down box.

  5. Click  Save Role .

Configure Magento SOAP/XML Users

  1. On the top menu bar of the Magento Admin Panel, navigate to  System  ->  Web Services  ->  SOAP/XML-RPC-Users .
  2. On the top-right, click on  Add New User .

  3. On the left panel, click on  User Info :
    • In  User Name , enter  magentolink .
      NOTE:  This can be anything you want but we'll use  magentolink  for the example in this article.
    • Enter the  First Name ,  Last Name  and  Email  to reflect the business.
    • Enter the  Admin  password.
    • Enter the  API Key  and repeat it in  API Key Confirmation .
      NOTE:  The Username and API Key will be used further in the instructions. Take note of them.
    • In  This Account Is , select  Active  from the drop-down box.

  4. On the left panel, click on  User Role :
    • Select  Magento Link .

  5. Click  Save Users .

Enable the Magento WSDL Cache

  1. On the top menu bar of the Magento Admin Panel, navigate to  System  ->  Configuration .
  2. On the left panel, click on  Magento Core API  within the Services section.
    • In  WS-I Compliance , select  No  from the drop-down box.
    • In  Enable WSDL Cache , select  Yes  from the drop-down box.

  3. Click  Save Config .

Enable Magento Cache

  1. On the top menu bar of the Magento Admin Panel, navigate to  System ->   Cache Management .
  2. Make sure the following caches are enabled:
    • Configuration (CONFIG) .
    • Web Services Configuration (CONFIG_API) .
    • Web Services Configuration (CONFIG_API2) .

  1. Click HERE to access the Tower Advantage Link website. Log in with your Tower Advantage username and password.
  2. Click on the Magento Link icon.
    If this icon is missing, click HERE to signup for the link.
  3. On the left, click on Configuration.
  4. Click on the General tab:
    • Expand the Your API Details bar:
    • Expand the Settings bar:
      • In Delete if not exist, select the items that would be removed from your web store if it does not exist in Retailer.
        As a general rule, do not select any of the items so that any changes made on either end are synced together.
        NOTE:  The selected components will use data from Retailer as the "master" and any items that exist on the web store, but not in Retailer, will be deleted during the sync process.
    • Click Save.
  5. Click on the Products tab:
    • Expand the Sync Product Categories bar:
      • In Sync Product Categories, select Yes.
    • Click Save.
  6. Click on the Scheduled Events tab:
    • Expand the Sync Events bar:
      • Click on Create New Event.
        • In Event Name, type in a name for the event eg. Auto Sync.
        • In Frequency, select the interval for each time the event will run.
          We recommend a value of 5-10 minutes.
        • In Select Sync Options, select the options that will be synced.
        • Click Save.
    • Expand the Export Events bar:
      • In Export Sales and Customer Data, select  Enabled  from the drop-down box.
    • Click Save.

Configure Web Store Settings in Retailer

  1. On the top menu bar of Retailer, click on Tasks -> Web Store Import/Export.
  2. Click on Export Options:
    • In Export Method, select Send to Magento from the drop-down box.
    • Enter your Tower Advantage Link username and password in the respective boxes.
    • In Select Folder to Export Files to, enter C:\EDI\WEBSTORE\Out .
      Alternatively, click on the yellow folder icon and navigate to that directory.
    • Click Save.
  3. Within the Stock section on the left panel, click on  Stock Options :
    • Tick Export Web Store Stock Only if you only want items flagged as Web Store stock to be exported.
      NOTE:  This option is enabled through the Stock Screen or Stock Manager.
    • Tick Export Images if you want images to be exported to your web store.
    • Select Export Stock From All Stores to combine quantity on-hand amounts from all stores.
      Alternatively, select Export Stock From Select Stores and click on the particular stores to only combine quantity on-hand amounts from only those stores.
    • Click Save.
  4. Within the Customer section on the left panel, click on Customer Options:
    • Tick Export Web Store Customers Only if you only want customers flagged as Web Store customers to be exported.
      NOTE:  This option is enabled through the Customer Screen.
    • Click Save.
  5. Within the Sales section on the left panel, click on Sales Options:
    • By default, customers who purchase from your web store are imported into Retailer and matched using their e-mail address. If the e-mail address does not exist in Retailer, a new customer is created using the details entered on the website.
      Alternatively, you can tick Add All Web Store Sales to Customer Number and specify a particular customer for all imported sales to be linked to.
    • In Web Sale Payment Type, select the payment type that all web store sales will be recorded as.
      NOTE:  You can add a new payment type by following the instructions HERE.
    • In Web Store Location, select the store where quantity on-hand amounts from sales will be deducted from.
      NOTE:  If you select the WEB STORE location, you will need to perform Inter-store Transfers to maintain accurate quantity on-hand records.
    • In Web Sale Terminal, select the terminal that all web store sales will be recorded as.
      NOTE:  This will be useful for tracking web store sales through Retailer.
  6. Click on Schedule Options:
    • In Frequency to Run Export, select Interval.
    • In Export/Import Interval, set an interval for when the exports and imports occur.
      Again, we recommend a value of 10-15 minutes .
    • In Exports to Perform on This Schedule, tick Export Stock and/or Export Customers.
    • In Imports to Perform on This Schedule, tick Import Customers and/or Import Sales.
    • Click Save.

Once everything has been set, a sync will being processing based on your interval settings.

The initial sync will take a long time (large sets of data may take ~2 hours) but subsequent syncs will be much quicker.

We recommend checking your website after leaving the computer to perform the sync overnight.