magento integration user guide - unleashed...

29
Magento Integration User Guide

Upload: lamnhu

Post on 06-Feb-2018

237 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento Integration User Guide

Page 2: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

2 Magento integration user guide

Table of Contents

INTRODUCTION 4

Getting Help 4

Disclaimer 4

Supported Magento Verisons 5

UNLEASHED SUPPORTS COMMUNITY EDITION 1.3 ONWARDS

AND MAGENTO GO 5

THE INTEGRATION FLOW 6

Information is shared between the two systems by using the Magento API. 6

WHAT PRODUCTS ARE SUPPORTED? 7

Simple Products 7

Configurable Products 7

Bundle Products 8

GETTING STARTED 9

What you’ll need 9

Create Magento API 9

Unleashed configuration 12

Accessing the integration screen 12

Functional descriptions 12

Viewing Logs 15

Configure Magento options 16

Guest Customer 16

Integrate Customer Categories 17

Integrate Product Price 17

Export SOH Quantity 17

Create Missing Products 17

Import Magento products 18

What if my products are already in Unleashed? 18

What if my products are already in Magento? 18

Key fields for product import 18

Performing the Product import 18

Importing configurable products 18

Import Magento stock on hand 19

Page 3: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 3

MAGENTO FIELD 20

MAPPINGS 20

Product mappings 20

Invoicing mappings 20

Customer field mappings 20

MAGENTO TAX OPTIONS IN UNLEASHED 21

Shop tax settings 21

Tax rates 21

Coupons and discounts 21

21

USING THE CONFIGURATION PAGE 22

MAGENTO GO CONFIGURATION 25

USING UNLEASHED WITH MAGENTO 26

How do invoices come into Unleashed? 26

How do you add new products to Unleashed and Magento? 26

How do I make stock unavailable to my store? 26

How do I sell items before I have them in stock? 26

Can I batch complete orders in Unleashed? 27

Can I import historical invoices into Unleashed for go live? 27

How do I make global changes to my customers or products? 27

What is the IP address Unleashed uses to transfer? 27

ACCOUNTING SYSTEMS INTEGRATIONS 28

Page 4: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

4 Magento integration user guide

IntroductionWelcome to Unleashed, the powerful inventory management solution that streamlines sales, purchasing and inventory control.

The combination of Unleashed and Magento provides a powerful ERP sales and stock management solution. It is easy to set up and run and will streamline your business processes from end to end. This level of integration will help reduce cost, remove data entry errors, update your shop with accurate quantities and costs in real time and give you accurate margin and sales reporting.

The emergence of cloud computing gives instant access to enterprise grade solutions to SME’s who otherwise couldn’t invest in the applications or infrastructure to run them on. Magento provides businesses with an easily configurable system “out of the box” and give businesses an online presence and shop front with which to promote their products and services to the world.

Unleashed provides businesses the necessary inventory control, purchasing, manufacturing and stock management functions to tie online sales and promotion with generally accepted accounting principles and supply chain management. If you are a business selling your goods online, then having these two solutions working for you will give your business an ‘out of the box’ integrated ERP supply chain and online sales suite of tools to super charge your business.

I would like to take this opportunity to welcome you to our success story, I hope you enjoy using our software as much as we enjoyed bringing this version to you.

Getting HelpThere are many support avenues available to you. Primary assistance and help manuals can be accessed from our support forum at http://support.unleashedsoftware.com

Email support is available on [email protected]

Phone support, GOTO Meeting and Skype support can also be used as escalation utilities for troubleshooting and installation and training assistance.

DisclaimerMagento can be installed and configured in many different ways and can have many different 3rd party plug-ins installed. It is not possible for Unleashed to test every single combination of every factor that can affect your Magento store.

Accordingly we can not make any guarantee that Unleashed will be able to connect to your Magento store. We recommend using a test copy of your Magento store and a demo of Unleashed to test if integration is possible.

Page 5: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 5

Supported Magento Verisons

Unleashed supports Community Edition 1.3 onwards and Magento GOWe have a policy of updating and maintaining integration with all non-candidate release versions thereafter. Unleashed also integrates with Magento GO.

When there is enough demand for Unleashed on the Magento Enterprise platform we will extend support for this version also. If you use Enterprise please let us know.

Page 6: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

6 Magento integration user guide

Information is shared between the two systems by using the Magento API.The actual configuration of the integration is covered in a later chapter.

The information that can be shared between the two systems is:

MASTERFILES

• Products

• Default sell price

• Average cost

• Customers (guests & accounts)

• Customer categories

• Stock on hand

TRANSACTIONS

• Sales transactions

• Stock on hand changes

The integration flow

Page 7: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 7What products are supported?

Configurable ProductsMagento allows you to have products with different options. For instance, different colours, styles, sizes, flavours etc.

Example would be:

• MASTER1

• MASTER1_CHILD1

• MASTER1_CHILD2

A real life example of this could be flavours:

• PROTEINBAR

• PROTEINBAR_STRAWBERRY

• PROTEINBAR_CHOCOLATE

As you can see from the example on the previous page, you don’t actually purchase the PROTEINBAR, but rather a flavour of PROTEINBAR that is grouped up and displayed in Magento for customers to choose their flavour when purchasing.

The integration of this is handled during the CSV import of your products into Unleashed. When you set these products up in Unleashed they need to be identified as “simple”, “configurable” or “bundle” under the heading “API Product Type”.

If you make changes to your configurable product over time, Unleashed lets you change the products in your group manually in the product masterfile record as well as the CSV imports, giving you ultimate flexibility.

Note: Changes made to product types and configurations in Unleashed do not update Magento.

Magento allows you to have simple and complex products. The simple products are a one to one relationship with the Unleashed products. The complex products require a little more understanding as to how they are integrated with Unleashed.

Supported Magento product types:

• Simple products

• Configurable products

• Bundle products

Simple ProductsSimple products have a 1 to 1 relationship. They are simply a single product with a sell price and a cost. As is standard in all Magento versions, each product can have lots of options and be sold in many different currencies which is all supported in Unleashed.

Page 8: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

8 Magento integration user guide

Bundle ProductsThis is where simple products are bundled together to create a new product and sold as a bundle. Generally the bundle will be sold for a discounted rate from purchasing each of the components separately. i.e. combo deal.

Example would be:

• MASTER1

• MASTER1_CHILD1

• MASTER2_CHILD1

A real life example of this could be a combo of Chocolate PROTEIN BARS and PROTEINSHAKES:

• PROTEINBUNDLE_CHOCOLATE

• PROTEINBAR_CHOCOLATE

• PROTEINSHAKE_CHOCOLATE

To handle this in Unleashed, there is an auto-assembly feature also known as “kitting”.

When you sell the bundle, Unleashed will remove each of the components out of stock and add them to the finished product with the single sell price.

In the above example, that would mean you would sell a PROTEINBUNDLE_ CHOCOLATE that will automatically reduce the stock levels of the respective PROTEINBAR and the PROTEINSHAKE. For more information on how this works you can read more on auto-assembly here.

Page 9: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 9

What you’ll need• Administrator access to the Magento admin panel

• Super User access to Unleashed

Create Magento API1. The first thing to do is to create a role, a user, and an API key from your Magento

Store Admin Panel. To do this, log in to the backend of your webstore.

2. Now create a new role in our Magento store. To do this click System > Web Services > Roles.

Note: In Magento 1.7 it will be under System > Web Services > SOAP/XML – RPC - Roles.

3. In Roles, you will see this screen.

Getting Started

Page 10: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

10 Magento integration user guide

Note: We have found in some community versions that you cannot have any more than 5 separate roles listed. If you have more than 5 you will need to delete some roles, or re-use an existing role that fulfills the API integration requirements.

4. You will have to give this new Role a name. This is simply used to help you identify it, and keep your account organied. We recommend a title such as Unleashed, to show the reason for this role.

5. Once you have named your role, press ‘Save Role’. This will use one of the roles your account is allocated. In the community version of Magento you are allowed five roles before you have to upgrade your account. Next, you must ensure this role has sufficient access to our account for Unleashed integration. To do this click on Role Resources and change Resource Access to All.

6. You will now create a new User to assign to this Role.

7. You can access your Users from System > Web Resources > Users.

Note: In Magento 1.7 it will be under System > Web Services > SOAP/XML – RPC - Users.

Page 11: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 11

8. Click into Users, and you will see this screen.

9. Click on Save User when the new user information has been populated. This will save the new user, and you can assign this User to our created Role.

To do this we click on ‘User Role’ on the left hand side of the User screen. You then tick the box next to the Role we’ve created, to assign this User to the Role.

10. Once this is done, click ‘Save User’ on the top right corner of your screen.

This completes the configuration necessary in your Magento account, now you can configure Unleashed with this information.

Page 12: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

12 Magento integration user guide

Unleashed configurationAccessing the integration screen

1. Select Settings | Integration Configuration.

2. From the Integration Configuration screen, you will be able to setup and configure the integration.

3. Hover your mouse over the Magento icon, a configure button will pop-up. Click Configure to start the integration configuration

4. The Magento Dashboard and Integration Details appear.

5. Fill out the required fields to ensure integration can commence.

6. Once you have entered these details you can click Save at the top right. See for "Functional descriptions" on page 12 more information on fields that require input.

If your credentials are invalid, or Unleashed is not able to connect to your store, and you get an error message. When your credentials and store setup are valid, you receive a success message. You can move on to the next step of the setup.

Functional descriptionsThe following topic demonstrates all of the functional features that you need to know to ensure a successful integration, and contain a description of the fields.

MAGENTO DASHBOARD

The Magento Dashboard provides details of the integration.

It displays:

• Status of the dashboard

• The last check for invoices

• The last invoice transferred

• And the number of invoices transferred (Count)

Page 13: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 13

INTEGRATION DETAILS PAGE AND FIELD DESCRIPTIONS

Field/Function Description

Module Select the relevant version of Magento from the dropdown

Api UserHere you need to enter the API user name that you set up in your Magento store

Api KeyHere you need to enter the API key that you entered into your Magento shop

Store url

Module This is the URL to the front page of your Magento shop. (not the backend). Here you will need to pay special attention to whether or not you have SSL set up for your shop or not. If you have, then you will need to enter https:// in front of your domain name.

Also, if you have redirects set up in your Magento shop (301 or otherwise) then we cannot guarantee you will be able to connect using the API. If you are having trouble connecting, this is the first place we suggest you look and removing all your redirects and trying again.

Integration Warehouse

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, and stock on hand is exported out.

Add Currency

This option is used when you set your Magento store in multiple currencies and have guest accounts turned ‘On’. If your store has this configuration then you will need to add each currency your store sells in so Unleashed can set up guest accounts for each of those currencies.

Page 14: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

14 Magento integration user guide

IMPORT DATA TAB

If errors occur during the importing process for sales, you can use the Re-Import by invoice number function and find missing invoice numbers, then you can reimport invoices.

Field/Function Description

Retry import by invoice numberAllows you to reimport invoices from Magento, to become Sales orders in Unleashed. Use the Date field to target invoices and press Retry.

Find missing invoice numbers from

Enter the missing invoice numbers from a specified date to the end of that date range and press Find, this will help you reimport the missing invoices from Magento.

RESOURCES PAGE AND FIELD DESCRIPTIONS

Field/Function Description

Magento ResourcesProvides you with a link to the most recent Magento Integration Guide.

Download TemplatesProvides you with the ability to download a Product .csv file to use when importing products from Magento.

Page 15: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 15

Viewing LogsThe View Logs (Integration Transfer Log) screen provides a list of every single action that has occurred during the integration process. For example, you can use the log screen to determine any issues that might occur during the integration process. This could include a validation error, or any other possible faults.

You can use the View Log screen to determine what the actual fault is, and then plan to fix accordingly. The logs only keep the last 7 days of activity.

Page 16: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

16 Magento integration user guide

Configure Magento optionsThe integration with Magento is highly configurable. In this section you select how much or how little information you would like to share across the two systems.

Customer ReferenceThe three options are:

1. Sales Order Number

2. Purchase Order Number

3. Sales & Purchase Order Number

Magento allows you to do ‘part invoices which means that your order number and invoice number may have a different number or sequence.

If you would like to have the sales order number show in Unleashed invoices in the ‘Customer Reference’ field, then select Sales Order Number. If you allow customers to put in a purchase order number you will want to use option 2.

Or if you would like to show both sales order number and purchase order number in the Customer reference field, then select option 3. If you select this option there will be a pipe delimiter ‘|’ that separates the two numbers.

Guest CustomerIn Unleashed you have two options:

1. Use Guest Account

2. Create Customer

Magento allows you to have guest customers turned on or off. In Unleashed, you have the option of either creating a new customer account for each guest customer, or to have them all go to a single ‘guest’ account.

There are situations where you would want to ‘create customer’. A practical example of this is if you were needing to link in Unleashed with a CRM system, then you would need to have all the details of your customers.

If you use Guest Accounts, and your Magento store is in multiple currencies, then you MUST set up all the currencies in the Unleashed settings. This set’s up all of your guest accounts in the different currencies. For instance, you can create a customer in Unleashed called: Guest. And when you set your Magento store in multiple currencies and have guest accounts turned ‘On’. If your store has this configuration then you will need to add each

currency your store sells in so Unleashed can set up guest accounts for each of those currencies.

TaxYour 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. Make sure your setting in Unleashed matches your Magento shop or your invoices will come across into Unleashed with the incorrect values.

Page 17: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 17

In Magento this setting is typically found under System > Configuration and then under the Sales section on the left labelled “Tax”.

Integrate Customer CategoriesIf you would like Unleashed to update the main category in Magento then turn this on. You can easily do this by ticking the check box. Because Magento allows you to have nested categories, it is expected that most users will not have this option switched on.

Integrate Product PriceMagento has many pricing options. If you would like Unleashed to update the main price in your Magento store, then switch this option on. You can easily do this by ticking the check box.

An example of when you might like to integrate this is if you are doing a global price update / upload into Unleashed and you would like that update to also update the main sell price in your Magento store. You can switch this option on and off as you see fit.

Export ProductsThis option allows you to export Products as simple products. You can easily enable this option by ticking the check box.

Note: If you have configurable or bundled products, you will not want to enable this.

Export SOH QuantityThis option should almost always be enabled. If you are unsure whether you should enable it then by default ‘enable’.

This option updates all of the stock on hand quantity available inside of 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:

1. Purchase Orders

2. Sales Invoices (and parked invoices for ‘reserving stock’)

3. . Stock Adjustments

4. Production / BOM’s.

5. Credits

6. Stock-takes

7. Supplier Returns

If any of these transactions occur inside Unleashed, your Magento store stock will also be updated.

Create Missing ProductsWhen sales come in from Mangento, but do not exist in Unleashed then when this check box is enabled, it will create it as a simple product on the fly.

Note: This function creates simple products only, if you have another product type, it will not work.

Note: Products must be imported correctly. Unleashed can only use the data that you provide. If incorrect data is provided then future transactions may be incorrect and a substantial effort may be required to reconcile any errors. It is very important to get the correct Average Land Price before importing your products.

Page 18: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

18 Magento integration user guide

Import Magento productsWhat if my products are already in Unleashed?If you have all products setup in Unleashed and no products in Magento you can skip this step.

What if my products are already in Magento?If you have products in Magento that are not in Unleashed you must import all products from your Magento store to complete the integration.

Key fields for product importThere are several important fields in the product CSV. Please take care to enter these items correctly:

• ProductCode - this must match the SKU in Magento. Product Description - this field is required and is your Magento product name.

• Is Api Product - this must be set to “Yes”.

• Api Product Type - this must be set to the Magento product type of “simple”or “configurable” or “bundle”.

Performing the Product importIf you are using Magento GO then you will need to follow the steps below:

1. DOWNLOAD OUR PRODUCT TEMPLATE FILE PRODUCTS.CSV

Start by downloading our product template file. This file already has the correct column headings Unleashed needs to import your product data.

2. COPY YOUR MAGENTO PRODUCTS INTO THE TEMPLATE

Export your data from your Magento store. Using Excel or another spread sheet editor, copy and paste your data from the exported file into the Unleashed template. Make sure the data you copy matches the column headings in the template.

3. MARK THE PRODUCTS AS BELONGING TO YOUR MAGENTO STORE

Locate the last column, “Api Product Type”. Set the value of this column to match the product type from Magento. Supported product types are “simple”, “configurable” and “bundle”.

4. IMPORT THE UPDATED TEMPLATE FILE

Your product list can be uploaded on the Product Import page.

If there were any issues or exceptions with the upload they will be emailed to you.

All products that can be successfully imported will be imported. You can make any amendments you need to the original CSV file and re-import that file.

The only fields that cannot be altered once imported are the mandatory fields such as Product Codes.

Importing configurable productsThe correct format for importing configurable products is:

MASTER PRODUCT

MASTER_CONFIG1

MASTER_CONFIG2

Example:

The important field to note on the import template is the Api Product Type. The first item / row needs to be the MASTER item and have a corresponding ‘configurable’ label in the column. The following items on the list need to be the options for that configurable product and have the Api Product type of ‘simple’.

Page 19: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 19

Import Magento stock on handIf you have all products setup in Unleashed and no products in Magento you can skip this step.

If you have products in Magento that are not in Unleashed you must import all stock on hand quantities from your Magento store to complete the integration.

1. DOWNLOAD OUR STOCK ON HAND TEMPLATE FILE SOH.CSV

Start by downloading our stock on hand template file. This file has the correct column headings Unleashed needs to import your stock on hand data.

2. COPY YOUR STOCK ON HAND INTO THE TEMPLATE

Export your data from your Magento store. Using Excel or another spread sheet editor, copy and paste your data from the exported file into the Unleashed template. Make sure the data you copy matches the column headings in the template.

In the SOH.csv locate the second column, “*Warehouse Code”. Set the value of this column to the warehouse code of your default warehouse (usually this value is “W1”).

You will also need to enter the AverageLandPrice - this must be the correct cost per unit. This should be calculated as (purchase price + additional costs eg freight) / (quantity). If this field is incorrect there is likely to be flow on effects. This field is required.

Page 20: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

20 Magento integration user guide

The following table shows the fields mapped to Unleashed and Magento.

Product mappings

Unleashed Field Magento Field

Product SKU SKU

Product Description Name

Average Land Price Cost

Default Sell Price Price

Invoicing mappings

Unleashed Field Magento Field

Invoice Number Invoice Number

Customer Reference Order Number

Customer Reference PO # - customer ref

Delivery Address Delivery Address

Order Date Invoice Date

Required Date Invoice Date

Line Tax Rate Item Tax Rate

Header Discount Invoice Discount / Coupon

Line Discount Item Discount / Coupon

Price Item Price

Customer field mappings

Unleashed Field Magento Field

Customer Code ID

Customer NameCompany Name if entered or First and last name

Currency

(These must be set up)Currency

Customer Types Customer Category

Magento fieldmappings

Page 21: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 21Magento tax options in Unleashed

Shop tax settingsYou can set your Magneto shop as either:

1. Tax inc pricing;

2. Tax excl pricing.

Unleashed will automatically work out your tax settings and accept your invoices with the correct pricing accordingly.

Tax ratesIf you intend to use different tax rates in Magento other than your standard country tax or no tax then you will also need to set those tax rates up in Unleashed. If you are using Xero as your accounting system you will need to set all the different tax rates up there and import those into Unleashed.

To import the Xero tax rates go to: Settings > Taxes and click “Load From Xero”.

Coupons and discountsYou can set your Magento shop to use discount coupons. These can be set either before or after tax. It is vitally important that you tell Unleashed which option you have set. Failure to do this will mean incorrectly priced invoices where coupons are used.

This setting is set from: Settings > Integrations Configuration.

Page 22: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Using the configuration page

Access to the eCommerce configuration screen is Settings > Integration Configuration.

The dashboard tells you everything you need to know about your Unleashed integration with Magento.

The Status, The last time Unleashed checked for an invoice from Magento, the last invoice that was transferred and the number of invoices transferred.

There are a number of buttons that will appear at the bottom depending on the stage of your integration too. These buttons serve only as a guide to what you may need to do to integrate properly during the integration process and give you functional buttons once integrated.

The refresh button checks for new invoices and imports any new invoice found in your Magento.

The deactivate button temporarily deactivates your Magento connection without disconnecting completely. This is a great feature if you need to pause the integration for any reason.

Dashboard statuses

Not yet integrated• You haven’t entered your details.

• Enter Magento details and click “save”.

Could not connect• Url/user/key is incorrect or shop is not responding.

• Enter the correct details and click “save”.

Page 23: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 23

Products not imported• Import products on the product import page or use the Unleashed extension

to import products from your Magento store. Make sure you have “Yes” in the Column “Is API Product” on the product import template.

• Or click the No Products To Import button.

SOH not imported• Import SOH on the SOH import page.

• Or click the No Stock To Import button.

Manual transfer required• Setup is all OK,but need to manually transfer once to make sure it works before

automatic transfer can start

• Click the transfer button.

Page 24: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

24 Magento integration user guide

Active• All is OK.

• Auto transfer is occurring every 5 mins.

• Click Deactivate button to stop auto transfer.

Deactivated• All is OK.

• Auto transfer is not occurring.

• Click Activate button to start auto transfer.

Page 25: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 25Magento Go configuration

It is mandatory in Magento GO to have Product attribute sets. Once set, these cannot be altered. Therefore, if you are going live with Magento GO from Unleashed, or you are adding new products to your shop you will need to know how to add products with the attribute set correctly.

Let’s assume you are adding a new product range and you need to know how to go about this:

1. You need to create the Product Group in Unleashed (if there is no product group already in the system for the new range).

2. You will need to create a product attribute set in Magento and give the name of the attribute set the exact name of the product group in Unleashed. (This must be exact or it will not work).

3. Import the product range into Unleashed from the CSV import template file making sure you set ‘Is API Product’ to ‘Yes’.

Page 26: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Using Unleashed with Magento

Once you have configured your integration, it is now important to know how to use the two systems together. You will have your own requirements and needs, so the level and complexity is really up to you. Here are some important things you will need to know once you’re up and running.

How do invoices come into Unleashed?Invoices will flow through to Unleashed automatically. If you would like to ‘push’ the invoice through you can press the ‘Transfer’ button on the integrations screen to do this.

The only status of an order that comes into Unleashed is an “Invoiced” status. All other transaction types are ignored. If you would like to pull through a particular invoice then you can use the “Re-import Previous Invoices” feature on the integration page (Settings > Integration Configuration).

How do you add new products to Unleashed and Magento?New products can be created in two different ways.

1. UNLEASHED SENDS PRODUCTS TO MAGENTO

• The Export Products check-box must be ticked in the Integration Configuration page

• All the product types within Unleashed —regardless of product type— will be exported as ‘simple’product types in Magento.

Notes: If you need to create Configurable or Bundles products, this option will not work for you. All simple exported products sent to Magento will be marked as disabled.

2. MANUALLY CREATE PRODUCTS IN BOTH SYSTEMS

• Create in either Unleashed or Magento systems

• Convert into a format that the other system can interpret and export that into the new system.

How do I make stock unavailable to my store?If you have items in stock that you do not want to sell online then you simply need to transfer the items into a warehouse that IS NOT your default warehouse. Unleashed integrates only the stock that is in your default Unleashed warehouse with Magento. This means that by enabling the multi-warehouse features in Unleashed you can now separate your online and offline stock completely.

How do I sell items before I have them in stock?You will need to disable the option inside of your Magento store to make products that have 0 stock on hand unavailable. Unleashed will accept all invoices from Magento however if you do not have the stock available then you will not be able to complete them (until you have purchased in the stock needed). If you have further questions regarding this then please get in touch at [email protected].

Page 27: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Magento integration user guide 27

Can I batch complete orders in Unleashed?Yes. In Unleashed there is a menu called ‘Batch Complete’ you can complete all or any of your transactions easily.

Can I import historical invoices into Unleashed for go live?Sure. By default we integrate from the day your integration is set. This can be done at any-time. For instance, at go live you may want to import all invoices from the start of the month. Or sometimes during operation you make mistakes and need all invoices for a specified period to be re-imported. To re-import invoices simply email the Unleashed support desk with your request to [email protected] to reset your product file ready for re-import.

How do I make global changes to my customers or products?To make global changes to your products, customers or suppliers simply export all your masterfile records to CSV. Make the necessary changes and then import the updated file back into Unleashed. Any field which is not ‘locked’ (such as Code) can be modified and updated.

What is the IP address Unleashed uses to transfer?01 202.89.36.71

02 123.100.96.99

Page 28: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Accounting systems integrations

Unleashed currently supports two scenarios in regards to accounting systems.

1. Integration with Xero (online accounting system)

2. Standalone system (for users of Quickbooks and other accounting applications)

Assistance on how to integrate Unleashed with Xero is available on the support help forum.

When you run Unleashed as standalone you have a report you can access to give you your Stock, Cost of Sales and Revenue amounts to journal in to your Profit and Loss.

These can be accessed from Inventory > Stock Movement.

There are many support avenues available to you. Primary assistance and help manuals can be accessed from our support forum at http://support.unleashedsoftware.com

Page 29: Magento Integration User Guide - Unleashed Softwarepages.unleashedsoftware.com/rs/unleashedsoftware/images/Magento... · 4 Magento integration user guide Introduction Welcome to Unleashed,

Contact us and unleash your inventory today. GENERAL ENQUIRIES

[email protected]

Australia

Suite 4, 31 Chessell StreetSouthbank, VICAustralia 3006

Phone: +61 3 9044 4704ABN: 921 603 89 579

New Zealand

P O Box 33-1352Takapuna, 0740New Zealand

Phone: +64 9 447 1334

www.unleashedsoftware.com