Before You Begin


Before you configure the Unleashed integration setup, you must complete the following steps in Magento to create the Magento API Key. This is required to connect your Magento store to Unleashed.

You must have administrator access to the Magento Admin Panel.


Create a Role

  1. Log in to your Magento Admin Panel. Ensure that you have entered the Magento Admin Panel URL correctly. For example: http://magento.test.com/index.php/admin
  2. Depending on the Magento version, go to System | Web Services | Roles OR System | Web Services | SOAP/XML -RPC-Roles.
  3. Click Add New Role.
  4. In the Role Name field, specify a name to identify the role, for example: Unleashed_role.
  5. Click Role Resources and from the Resource Access drop-down list, select All.
  6. Click Save Role.

Create User and Assign Role

  1. Depending on the Magento version, go to System | Web Services | Users OR System | Web Services | SOAP/XML -RPC-Users.
  2. Click Add New User.
  3. In the User Name field, specify the user name. Note this as you will require it when you setup the configuration in Unleashed.
  4. Complete the First Name, Last Name, and Email fields.
  5. In the API Key field, specify a value for the API Key. Note this as you will require it when you setup the configuration in Unleashed.
  6. Confirm the API Key.
  7. Click User Role and select the role.
  8. Click Save User.

Recommended Settings

  1. Go to System | Configuration | Services | Magento Core API.
  2. In the General Settings area, select the following options:
    1. WS-I Compliance = No
    2. Enable WSDL Cache = No


Unleashed Integration


You must have super user access to Unleashed.

  1. Go to Integration | Integration Store
  2. Click Magento. 
  3. Click Install App to install the Magento app and setup the required configuration.


Overview tab


This tab provides the basic overview and links to resources. 


Configuration tab


You can configure the following options.

Connect your Magento store to Unleashed

  1. Choose your Magento version: Select the relevant Magento version from the drop-down list. If you do not see the required Magento version in the list, contact support@unleashedsoftware.com.
  2. Enter your Magento Store URL
    •  This is the URL to the front page of your Magento shop (for example: http://magento.<companyname>).
    • DO NOT enter the Magento Admin Panel URL.
    • If you have SSL, ensure you include https://.
    • Ensure that the URL does not have any redirects before you connect. 
  3. API User: Enter the user name that you set up in your Magento store.
  4. API Key: Enter the API key that you set up in your Magento store.
  5. Click Save Configuration.

Let's get the connection set

You can configure the following options.

Field Options Description

Customer Reference

  • Sales Order Number
  • Purchase Order Number
  • Sales & Purchase Order Number
  • Select the required option to be displayed in the Customer Reference field on Unleashed invoices. If you select the third option, there will be a pipe delimiter ‘|’ that separates the two numbers.
  • Sales invoices from Magento are imported into Unleashed as Parked sales orders. You must manually complete the orders.

Guest Customer

Use Guest Account
All guest customers from Magento will be imported into Unleashed to a common guest customer account.
Note: If your Magento store is setup to sell in multiple currencies, then you MUST add all the currencies in Unleashed, so Unleashed can set up guest accounts for each currency. For more information, see Currency Rates.
Create Customer
A new customer record will be created for for each guest customer.

Tax

  • Before Discount
  • After Discount
  • Your Magento store can be configured to allow for coupons / discounts. These discounts can be applied before or after tax as per your settings in Magento.
  • You must have the same setting in Unleashed and Magento, otherwise the invoices will be imported into Unleashed with the incorrect values.
  • In Magento, go to System | Configuration | Sales | Tax. In the Calculation Settings area, from the Apply Customer Tax drop-down list, select the required option (screenshot).

Integration Warehouse

The warehouses will be displayed in the drop-down list. This option is used when you have Warehouses already set up in Unleashed. When you select your preferred Warehouse for the Magento integration, the Sales are then imported into the configured warehouse in Unleashed, and your stock on hand is exported to Magento.
Export products  
  • Enable this option to export simple products from Unleashed to Magento.
  • If you have configurable or bundle products, it is recommended to disable this option as Unleashed will export ALL products as simple products to Magento. 
Export SOH quantity  
  • It is recommended to enable this option. The Available quantity of a product and not the physical stock on hand quantity is exported.
  • This option updates the stock on hand quantity in Magento. This is important if you have stock levels that you need to increase and decrease as sales are made. Every time stock quantity is updated in Unleashed it will also update your Magento store. The transactions inside Unleashed that affect stock are:
    • Purchase Orders
    • Sales Invoices (and parked invoices for ‘reserving stock’)
    • Stock Adjustments
    • Production / BOM’s
    • Credits
    • Stock-takes
    • Supplier Returns
Include quantities for auto-assembled products: Available only if the Export SOH quantity option is selected. If enabled, the Available Quantity will also include the quantity for auto-assembled products.
Update customer categories   Enable this option if you want your customer types to be exported to Magento as customer categories.
Update product price   Enable this option if you want to sync the default sell price in Unleashed to the Price field in Magento
Create missing products   When sales are imported into Unleashed from Magento, and a product on that order does not already exist in Unleashed, it will be created as a simple product.
Multiple currency   If your Magento store is setup to sell in multiple currencies, then you MUST add all the currencies in Unleashed, so Unleashed can set up guest accounts for each currency. For more information, see Currency Rates.

 

Manage your Data tab



After you have finished setting up your Magento configuration, you can manage the data sync from Magento to Unleashed with the following options. 

Option Description
Sync all data Transfers all SOH changes, products, and previous invoices (as Parked sales orders), from Magento to Unleashed.
Transfer previous invoices from
Select the date from which you want to transfer previous invoices from Magento into Unleashed as Parked sales orders. The subsequent invoices will be synced from the selected date.
Transfer SOH changes from
Select the date from which you want to transfer SOH changes. The subsequent SOH will be synced from the selected date. 
Find missing invoice numbers to import
Enter the missing invoice numbers in the From/To fields, and click Find. If there are any missing invoices, they will be displayed in the Import by invoice number field. 
Import by invoice number
  • The missing invoices are displayed in this field when you use the Find missing invoice numbers to import option.
  • To import the missing invoices into Unleashed, click Import.
OR
  • Enter the invoice number and click Import.

 

Connection Log tab

Use the Connection Log to analyse and fix errors. The logs record only the last 7 days of activity. The following filters can be used:

  • ERROR
  • INFO
  • ALL  

Troubleshooting

Error Message Description Resolution
Failed to load external entity Unable to connect to your Magento store and the server is unable to access your file. To fix this, refer to the following Help files:
or
Could not load the Guest Customer for Invoice
The Guest customer record does not exist.  You must create the GUEST customer again.

 

If you need more information or assistance, contact support@unleashedsoftware.com.

Exporting the Integration Transfer Log

Click Export to export logs to a CSV, XLSand/or XLSV file.