This extension works with Magento Community Edition and also Magento Enterprise Edition. To know if ERP & Logistics suite is compatible with your Magento version, please check the Compatibility tab.

Magento offers three variations of its product.

As their names have changed over the past few years, here is a recap:

• Magento Open Source: previously Magento Community Edition (CE), is a free and non-hosted e-commerce platform.
• Magento Commerce: previously Magento Enterprise (EE), is the paid version of Magento and offers support services.
• Magento Commerce Cloud: is the paid version of Magento and offers support and hosting services.

A license is valid for an unlimited period of time on one single installation

• If you're using more than one installation, you will have to buy a separate license for each instance.
• if you're running several domains on a same installation, you will need only one license for all of them.

You can pre-register your live domain to your license in advance.

Thanks to this option, you'll be able to get the module ready to use on your domain before it goes live.

To pre-register your production domain: 

1. Go to:
   mY accountLicenses & DOwnloads
2. Click on the Settings icon next to the module you want your domain to pre-register on.
3. Click on the link at the bottom of the page saying:
   Do you want to pre-register your domain in order to be ready to go live?
   
4. Finally, enter your domain name and click on pre-register now .
   
   

One license is valid for an unlimited period of time on one installation only. However, it is possible to extend or transfer your license in 2 cases: 

• If you would like to add your testing environments to your license. 
  In that case, it is possible to extend your license to an unlimited number of domains for free.
  For  mywebsite-staging.com or mywebsite-dev.com
• If you want to transfer your license to another live domain.
  In that case, the Support & Upgrade period for your license must still be active.

To be able to use ERP & Logistics suite on both your production and testing environments, follow the instructions below:

1. Download ERP & Logistics suite.
   (see FAQ: Extensions download)
2. Install ERP & Logistics suite on your environment.
   (see FAQ: Modules installation in Magento or in WooCommerce)
3. Activate the license.
   (see FAQ: Licenses activation in Magento or in WooCommerce)

In order to download ERP & Logistics suite, log into your Wyomind account:

1. Go to:
   my accountLicenses & downloads 
2. Click on the settings icon next to ERP & Logistics suite.
   
   

   A new window opens.

3. Click on the download icon.
   

When purchasing a module from wyomind.com, you benefit from 12 months of upgrade. Within this period you can at any time download the latest version of the module directly from your account.

To upgrade ERP & Logistics suite, follow the steps below:

1. Go to:
   my accountLicenses & Downloads
2. Click on the settings icon next to ERP & Logistics suite.
3. Click on the download icon.
4. Install the new version of ERP & Logistics suite in your Magento admin or your WooCommerce back-office.

You can install ERP & Logistics suite manually.

1. Download ERP & Logistics suite (zip file) on:
   mY ACCOUNTLicenses & Downloads
    
   Refer to the FAQ: Extensions download
2. Once ERP & Logistics suite is downloaded, open the folder and unzip it.
3. Copy the content of the unzipped folder and paste all files and directories in your Magento 2 root directory.
   
4. In your Command Line Interface, execute:
   

   bin/magento setup:upgrade 

   If you are using a production mode, execute also:

   bin/magento setup:static-content:deploy  

   bin/magento setup:di:compile  

You can install ERP & Logistics suite using Composer software in two cases:

• if you purchased ERP & Logistics suite on Magento Marketplace.
• if you purchased ERP & Logistics suite on Wyomind.com AND requested access to our repository:
  repo.wyomind.com

1. Add to your composer configuration our repository:
   

   composer config repositories.wyomind composer https://repo.wyomind.com 

   
   
2. Execute Composer command:
   

   composer require wyomind/

3. Then go in your Command Line Interface and execute:
   

   bin/magento setup:upgrade ​

4. If you are using a production mode, also execute:
   

   bin/magento setup:static-content:deploy  ​

   bin/magento setup:di:compile​

To uninstall ERP & Logistics suite, start with disabling the extension running the following command:

bin/magento module:disable Wyomind_

Then, you have 2 ways to uninstall the extension depending on how the extension has been previously installed: 

• Manual installation
  

  Run the -uninstall.sh file (you can find it in the extension zip folder) from your Magento root directory:

  sh -uninstall.sh

   

• Installation via Composer
  

  Run the below command line:

  composer remove wyomind/

Once the uninstallation is over, refresh your cache and enable the compiler back again (if you use it). 

You can install ERP & Logistics suite via Web Setup Wizard if you purchased it from Magento Marketplace only.

To know how to proceed, all steps are described in the link below: 
http://docs.magento.com/m2/ce/user_guide/system/component-manager.html

Next step is to activate your license:
Extension activation

Once ERP & Logistics suite is installed, you have to activate the license. For previous versions, you can activate the license from your back-office:

1. Go to your Magento admin panel. A message pops up at the top of the page.
   

   
   

   If the message doesn't appear then you must check that:
   
      1. The Adminhtml_Notifications and Wyomind_Core modules are well enabled.
      2. The HTML output of the Adminhtml_Notifications and Wyomind_Core modules are not disabled in:
   storesconfigurationadvanced advanced
      3. The encryption key well exists in app/etc/env.php:
   

   <?php
    return array(
    'backend' => array(
    'frontName' => 'admin'
    ),
    'crypt' => array(
    'key' => '1e8f3c6772b7a6a6689c3c8cefa4ccf0'
    ),
    /* ... */
    )
   ?>​

2. Copy your activation key in:
   StoresConfigurationWyomind Your extension
   
   You can find your activation key in 2 different places:
   -  In the confirmation email that you received after purchasing ERP & Logistics suite.
   -  In your Wyomind account:My account Licenses & downloads
   Select ERP & Logistics suite and click on  .
   
   A new page opens where you'll find your activation key (see below).
   
   
   
3. In your Magento admin go to:
   StoresConfigurationWyomind Your extension
   
   Paste the activation key in the Activation Key field and choose between the automatic (yes) or the manual (no) activation method:
   -  By choosing Yes, the connection to Wyomind license server will be automatic.
   -  By choosing No, you will have to log on to Wyomind license server yourself.
   
   
4. Click on Save config .
5. A message appears at the top of your admin panel. Click on that link: 
   Activate it now!
   
6. Copy and paste the license code in the License code field from your admin or simply click on Activate now! 
   
   
   
7. Finally, refresh your cache, log out and log in back straight after, to complete the installation.

Add another domain to your license

To activate the license on another domain (test, staging...):

1. Once the extension is installed on the new domain, copy your activation key in:
   StoresConfigurationWyomind Your extension
2. After having saved the configuration, a notification appears. Click on Add this domain to my license.

   

3. A transfer request will then be sent to our team within an hour.
   Once the request is taken care of, you will receive a confirmation email.
   If your transfer request is accepted, you can use ERP & Logistics suite on both environments at the same time.

Note that the order in which you activate your license on your domains does not matter. You can start with your staging/dev/local environment or with your live domain, the process will be the same.

Once ERP & Logistics suite is installed, you have to activate the license.

For this, you can use the below command line (change the Activation key with the corresponding value):

bin/magento wyomind:license:activate Wyomind_ <YOUR_ACTIVATION_KEY>

To retrieve the list of all the available modules as well as the licenses status, please use:

bin/magento wyomind:license:status

 Among the different status, you can find: 

• registered = your license is registered
• pending = you need to run the activation command line
• invalidated = the license has been invalidated due to a wrong activation key or a license infringement

To activate several licenses at the same time, use:

bin/magento wyomind:license:activate \
Wyomind_Extension1,Wyomind_Extension2 \
ACTIVATION_KEY_1,ACTIVATION_KEY_2

or:

bin/magento wyomind:license:activate \
Extension1,Extension2 \
ACTIVATION_KEY_1,ACTIVATION_KEY_2

You have the possibility to open the generated CSV file with any spreadsheet application.

While opening your data feed, you need to make sure to select the delimiter options that correspond with your data feed configuration from your Magento 2 admin.

1. In your data feed configuration (from Magento 2), choose how your columns will be separated with:
   tabulation, comma, semi-colon...
2. Generate the data feed.
3. Open the data feed with a spreadsheed application.
4. Choose the same delimiter and enclosure characters as in your data feed configuration.

For example, if you've chosen semi-colon as Fields delimiter, then you'll need to open the file choosing ";" as field delimiter as well as if you've choosen double quotes as the Fields enclosure, then you'll have to make sure that you've selected the same character.

Note that the Excel application won't show this popup when opening the file.

The indexes may need to be updated after importing data.

You can define the post process action in your profile settings from: 
SystemData TransferMass PRODUCT IMPORT & Update

You can decide to run the indexers after the import or not:

• No
  No indexer will run. You will have to reindex manually from the CLI
• Only the required indexers
  Automatically decides which indexers must run
• Only the selected indexers 
  You decide which indexers to run.
  For example:
  catalog_product_pricecataloginventory_stockcatalog_url

You can use regular expression in the File path field. This will make the file name dynamic and all files matching the regular expression will be processed by your profile.

For example:

• filename-.*
  That expression will take into account all files starting with "filename-". You can also use this example to run the profile with files using the following format: filename-YYYY-MM-DD.ext
• orders_update_[0-9].csv
  That expression will take into account all files starting with "orders_update_" followed by a number between 0 and 9 and ending with ".csv".

The profile will then run all the corresponding files one by one.

For your profile to be executed automatically, you need to define the days of the week and the time of execution directly from your profile configuration in:
SystemData TransferERP & Logistics suite

By default, cron tasks can be scheduled each period of 30 minutes. 

If you need a more precise hour, you can change that interval from:
SToresSettingsConfigurationWyomindERP & Logistics suiteSettings
Below is an example with an interval of 20 minutes: 

For a good working of the scheduled tasks, the main cron task in Magento must be properly configured. Check how cron tasks work.

Mass Product Import & Update allows you to replace some values in the output data. 

For example, in your source file, the manufacturer name is Wyomind but you need to have The Wyomind Company. Then you can easily replace it using the replacement rules such as in the below example. 

See more about how to use replacement rules. 

ERP & Logistics suite offers you many possibilities to export your orders. You can set filters according to your needs. In the Filters tab of your profile configuration, you'll find 3 subtabs.

Order status

Select the types of orders you want to export. For example choose to export pending, processing and complete orders.

Customers group

In that tab, you can select the customers group of the orders you want to include in your data feed. For example choose to export orders placed by general and not logged in customers only.

Advanced filters

In that tab, you can create more precise filters. For example, you can choose to export only one specific order by setting a filter:

order > increment_id | = | Id of your order

You can also export orders placed by customers whose lastname ends with 'son':

order > customer_lastname | like | %son

You have the choice between several options:

• =, >, <...
  Equal to, greater than, lower than, greater than or equal to, less than or equal to, different from.
• LIKE / NOT LIKE
  like: starts / ends with the character string / includes the character string.
  Not like: doesn't start / end with the character string / doesn't include the character string.
• IS NULL / IS NOT NULL
  is null: the value is null.
  is not null: the value is not null.
• IN / NOT IN
  in: is in (selection of several options).
  not in: is not in (selection of several options).

You want to import several products into your Magento back-office but in your source file, you're using different attributes and values in a same column.

For example: length and width.

You can use the dynamic attribute with the following syntax:
attribute_code=value

And then map the column with the dynamic attribute. 

You also have the possibility to use PHP scripts to link values coming from different columns.

You can use regular expressions in the advanced filters. For example, with the Advanced Inventory extension, it can be useful to filter the orders and products that have been assigned to a particular store.

Instead of a unique store name, you can use a regular expression that will make the profile dynamic.

For example: 
Order > assigned_to     regexp     (,|^)(1)(,|$)
Product > assigned_to     regexp     (,|^)(1)(,|$)

That expression will take into account all orders and products assigned to a store.

To define the path to products, you must determine the path to the node where the products are stored.

For example, if your XML source file looks like the one below:

<products>
 <item>
  <name><![CDATA[Amazing product]]></name>
  <images>
   <img url="https://www.example.com/path/to/product/image/1.jpg" />
   <img url="https://www.example.com/path/to/product/image/2.jpg" />
  </images>
  <categories>
   <category><![CDATA[Category A]]></category>
   <category><![CDATA[Category B]]></category>
   <category><![CDATA[Category C]]></category>
  </categories>
  <description><![CDATA[Amazing product description]]></description>
 </item>
</products>​

Then, the path that targets the products is:
/products/item

In Orders Export Tool, you can specify FTP settings to upload your file.

From the Magento 2 admin, select a file and go to the Output tab. There you have 3 options to export your profile. If you choose to enable the FTP settings, here is how to configure each field:

• Enable FTP upload
  Select Yes if you want to upload your data feed using FTP.
• Host
  In that field, fill in the host.
  For example:
  wyomind.com
• Login
  is your login to connect to server
• Password
  is your password to connect to server
• Destination director
  is a relative path from the entry directory when you connect to the ftp.
  For example:
  /var/export/ftp
• Use SFTP
  Select Yes if you are using SFTP.
• Use Active mode
  If you are using SFTP, you don't have to care about the passive/active mode.
  For more info about Active and Passive mode, have a look to that documentation.

The file is uploaded each time the feed is generated manually or automatically.

To define the path to products, you must determine the path to the node where the products are stored.

For example, if your JSON source file looks like the one below:

{"Productlist":[{
	"ITEMID":"0123456789",
	"ITEMNAME":"Item Name",
	"ITEMGROUPID":"4500",
	"BRAND":"BRAND",
	"YEAR":"0",
	"ORIGINCOUNTRYREGIONID":"FR",
	"PICTURE":"http://www.domain.com/pub/image.jpg",
	"STATUS":"1",
	"PRODUCTQTY":"0",
	"CURRENT_STOCK":"0",
	}]}

Then, the path that targets the products is:
$.Productlist

With Mass Order Export, you can now define the encoding type of your files and choose to export them using UTF-8 with or without BOM.

BOM stands for Byte Order Mark and are the first 3 bytes of a file.

If there's no BOM, then the encoding type will be implicitly detected according to the file. On the contrary, BOM allow to declare the encoding type very clearly.

When the structure of your XML file is quite complex, the info may be dispatched in deep nodes and sometimes in tag attributes.

Then, you can define your own file structure.

Below is an example of a complex XML file where you need a predefined structure:

<offers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1">
 <offer price="165.07" msrp="189.00" availability="3">
  <name><![CDATA[Amazing product]]></name>
  <images>
   <img url="https://www.example.com/path/to/product/image/1.jpg" />
   <img url="https://www.example.com/path/to/product/image/2.jpg" />
  </images>
  <categories>
   <category><![CDATA[Category A]]></category>
   <category><![CDATA[Category B]]></category>
   <category><![CDATA[Category C]]></category>
  </categories>
  <description><![CDATA[Amazing product description]]></description>
  <attributes>
   <attibute name="sku"><![CDATA[XYZ]]></attibute>
   <attibute name="ean"><![CDATA[123456789]]></attibute>
   <attibute name="tax"><![CDATA[VAT 20%]]></attibute>
  </attributes>
 </offer>
</offers>​

The predefined structure you need to use is:

{ 
 "sku":"attributes/attribute[@name='sku']",
 "ean":"attributes/attribute[@name='ean']",
 "price":"@price",
 "msrp":"@msrp",
 "tax":"attributes/attribute[@name='tax']",
 "name":"name",
 "description":"description",
 "category_1":"categories/category[1]",
 "category_2":"categories/category[2]",
 "category_3":"categories/category[3]",
 "image_1":"images/img[1]/@url",
 "image_2":"images/img[2]/@url"
}

When the structure of your JSON file is quite complex, the info may be dispatched in deep nodes and sometimes in tag attributes.

Then, you can define your own file structure.

Below is an example of JSON file where you need a predefined structure:

{"Productlist":[{
 "ITEMID":"0123456",
 "ITEMNAME":"Product 0123456",
 "BRAND":"Best Brand",
 "BARCODE":"0123456-ABC",
 "CURRENT_STOCK":"0"
}]}

The predefined structure you need to use is:

{
 "ITEMID":"$.ITEMID",
 "ITEMNAME":"$.ITEMNAME",
 "BRAND":"$.BRAND",
 "BARCODE":"$.BARCODE",
 "CURRENT_STOCK":"$.CURRENT_STOCK"
}

ERP & Logistics suite allows you to use files (for example XML or CSV) from your Dropbox.

Here is how to configure your profile for a file stored in your dropbox from the Settings part:

1. In File location, select Dropbox. 
   
   
2. Fill the Path to file field with the file path relative to the root directory of your Dropbox container.
   
   
   

   For example : /import/xml

   
3. Configure your Dropbox app to allow the Full Dropbox.
   

   For example:
   

   

You can use the Mass Product Import & Update extension to import and/or update your data even if you're managing a multi-language Magento 2 store. 

For example, to update the description of your products for your French store view, you can select only the corresponding store view from the Column Mapping section.  

Note that you can add as many mapping row as there are languages. For example:

ERP & Logistics suite provides you with a fully configurable schedule in the Cron Schedule tab of your pattern configuration for each data feed or profile.

So that it works, you need to have one main scheduled task running from your server side and targeting cron.php located in the pub directory of Magento 2 root directory (ideally every hour).

If the management panel from your hosting compagny doesn't provide such a service, you should be able to use a remote service such as: http://www.mywebcron.com

ERP & Logistics suite also provides you with a cron job reporting, so that you can get email reports on each data feed or profile you're generating.

Here is the process to download your file:

• Generate the file.
• Right-click on on the generated link from the grid.
• Choose the "Save as" option.

This issue may be due to a problem during the installation process.

You will be able to fix it by following these steps:

1. Access your database via your control panel (Phpmyadmin for example).
2. From the setup_module table, delete the entry Wyomind_extension.
   Be careful, that entry depends on your extension. For example, if you have the extension called Simple Google Shopping, you should delete Wyomind_SimpleGoogleShopping.
3. Logout from your Magento 2 admin.
4. Log into your Magento 2 admin.

How do cron tasks work?

• The cron.php file (available in the pub directory of your Magento 2 root directory) is regularly launched from your server side (generally every 5 minutes).
• The cron task for ERP & Logistics suite is targeted and evaluates if a data feed or a profile needs to be refreshed (depending on the timestamp stored in the database and on the schedule table for this specific profile).
• If the above condition matches, then the data feed and the profile is re-generated.

Be sure that you have correctly configured a scheduled task from the server side (cpanel) targeting the cron.php file in your magento 2 installation.

The extension includes reporting and debug tools for the scheduled tasks available in:
StoresSettingsConfigurationWyomindERP & Logistics suite

For more information on the configuration of cron tasks in Magento 2, you can check their documentation.

If you are working on Magento 2.0.x, you'll have to rename:
Wyomind\\view\adminhtml\ui_component\sales_order_grid_Mage_2.0.xml

into:
Wyomind\\view\adminhtml\ui_component\sales_order_grid.xml

If your profile doesn't seem to be uploaded via FTP, it can be due to an incorrect configuration or to a problem from your server. Make sure that:

• your server allows the FTP access
• your credentials are entered without mistake
• the host is entered without directory following it

Here is an example of FTP configuration for ERP & Logistics suite on Magento 2:

PHP features are disabled by default in ERP & Logistics suite.

If you're using PHP parameters in your variables or inline script in your patterns (<?php return ... ?>), you'll get an error saying: "PHP features are disabled".

In order to be able to use PHP script in your variables and patterns, you must make some modifications in:
app/code/Wyomind/OrdersExportTool/Helper/Data.php

Replace:

public function execPhp($script, $order = null, $data = array(), $item = null)
{
    return "Php features are disabled. In order to activate them please have a look at : https://www.wyomind.com/magento2/orders-export-tool-magento.html?section=faq";
}

with:

public function execPhp($script, $order = null, $data = array(), $item = null)
{
    return eval($script);
}

You should check that the var/flag and var/tmp folders exist in the Magento root directory. If not, create them with the writing permissions.

Basically, an Asymmetric transaction commit means you're trying to execute a query in which a constraint based on a foreign key fails.

For example, if you're trying to add a related product that doesn't exist to another product, then the constraint will fail and the import will fail as well.

The best way to know which constraint fails is to run the import from the CLI and the SQL error will display.