Magento - Add New Channel Integration 

Overview
This guide is a walk-through of the steps required to add your Magento account to Linnworks.

Prerequisites

Before integrating Magento with Linnworks you will need the following

  1. A live Magento site
  2. Access to Magento's backend
  3. Have a SOAP/XML Role created in Magento (Explained in the guide)
  4. Have a SOAP/XML user created in Magento (Explained in the guide)
  5. SOAP extension must be installed and enabled within your Magento environment. Details on how to set this up can found using the following link -http://www.php.net/manual/en/soap.setup.php
  6. Your Magento environment needs to be set up with WS-I Compliance. 
    The steps involved in making this update are as follows.
    1. Login to Magento back end
    2. Go to Magento System > Configuration > Services > Magento Core API > General Settings
    3. Tick the option 'WS-I Compliance'
    4. It is also strongly advisable to enable WSDL cache, as this may improve performance significantly
  7. Loopback connection needs to be enabled.
    Loopback connection allows the Magento server to connect back to itself. To enable this option you may need to contact your provider and ask them to enable this option on your behalf.
    If any assistance is required for step 5 - 7 we advise that you contact the Magento developers who either installed or maintain your Magento environment.
  8. If you are using Magento version 1.9 or higher, it is required that the following patches are installed: SUPEE-3762, SUPEE-3941 and SUPEE-1533. Patches can be downloaded here:https://www.magentocommerce.com/download
  9. To allow Linnworks to download orders with the correct monetary values, it is imperative that the following settings are configured correctly on your Magento server
    • All of the following options on Magento must have the same value; either “including tax” or “excluding tax”
      • Catalog Prices
      • Shipping Prices
      • Apply Discount On Prices
    • “Apply Customer Tax” must be set as “After Discount”
    • These Options can be found in “System > Configuration > Tax (Sales) > Calculation Settings” on Magento.
  10. LinnLive extension has to be installed on Magento: Install extension 

Integrating Magento

Quick Guide

  • In Magento go to System and Select the Option SOAP/XML-RPC-Roles 
  • Add a New Role with Linnworks as the Role Name and set Role Resources to All
  • In Magento go to System and Select the Option SOAP/XML-RPC-Users
  • Create a User called Linnworks and create the API key
  • In Linnworks.net, go to Settings and Channel Integration
  • Select Magento from the list of Channels
  • Fill in the site URL, Username and API
  • Choose whether to download listings when wizard completes
  • Click finish

Detailed Guide

  1. In Magento go to System and Select the Option SOAP/XML-RPC-Roles
  • Open up your Magento back end by logging in
  • From this screen, go to Settings then Web Services and select SOAP/XML-RPC-Roles
  1.  
  2. Add a New Role with Linnworks as the Role Name
  • On the Roles screen, click the Add New Role button
  • In Role name type Linnworks
  • Select role resource on the left menu
  • On the drop down menu Resource access, select ALL
  • Enter your Magento Admin password under the Role name tab to save
  1.  
  2.  
  3. In Magento go to System and Select the Option SOAP/XML-RPC-Users
  • In Magento's back end go to Settings then Web Services and select SOAP/XML-RPC-Users
  1.  
  2.  
  3.  
  4. Create a User called Linnworks and create the API key
  • In the Magento Users page there is an Add New User button
  • In User Name field, type in Linnworks
  • Fill in the rest of the fields such as First Name, Last Name, Email, Current Admin Password, Api Key
  • On the drop down box "This account is", set the value to Active
  • On the side menu click User Role and select the Linnworks Role
  • Keep note of the User Name and API Key as you will need this information for Linnworks
  1.  
  2.  
  3.  
  4.  
  5. In Linnworks.net, go to Settings and Channel Integration
    • In Linnworks.net, go to settings and select channel integration
    • Select Magento from the list of channel integrations
  6. Fill in the site URL, Username, API Key, Invoice Prefix and click Next
    • On the channel integration screen for Magento, fill out the following information: Site Url, Username and API key
    • On the site URL, please make sure you include the HTTP:// in the address
    • The API URL is filled in with the default site endpoint. If your endpoint is different, please enter this here
    • The invoice prefix is a character string that you wish to identify magento orders with. If no prefix is supplied then the default magento reference numbers will be used
      • This can only be set during the integration process
      • Having no prefix set may cause issues with order download, particularly in MultiSite installs
  7. Choose whether to download listings when wizard completes
  8. Click Finish

Next Steps

Configure Channel Settings
Inventory Mapping
Location Mapping
Payment Mapping
Shipping Mapping
Listing to Magento