✅ The plugin is compatible from version 2.3 until 2.4.3 of Magento 2 and can be used ONLY with Lengow platform version 3.

> Get the Lengow plugin for Magento 2 here

The latest Magento 2.4.4 version is not compatible with the Lengow plugin. We recommend the use of a previous version of Magento 2.

If you are a V2 Lengow platform user Lengow strongly recommends you to migrate to its V3 platform to use our plugin for Magento 2.  

Contact our Support Team for more info.
Magento 2 changelogs are available here.

1. Plugin install

1/ Install the Lengow plugin in Magento2

Note for Magento 2: It is recommended to enable the cache at "System" > "Cache Management" before installing any extension.

To install the plugin, follow these steps:

Step 1: Open the extension ZIP file and extract it to a directory on your computer (using a tool like WinRar, WinZIP or similar).
Step 2: Upload the extracted folders and files into the root directory of your Magento installation. The root directory of Magento is the folder that contains the directories "app", "bin", "lib" and more. (All folders should match the existing folder structure).
Step 3: Connect via SSH and run the following commands (make sure to run them as the user who owns the Magento files!)
  • php bin/magento module:enable Lengow_Connector
  • php bin/magento maintenance:enable ; php bin/magento setup:upgrade ; php bin/magento setup:static-content:deploy ; php bin/magento maintenance:disable
Step 4: Go to "System" > "Cache Management" and click both the "Flush Magento Cache" as well as the "Flush Cache Storage" button. This is required to activate the extension.

2/ Connect the plugin to your Lengow Account

Click on "Connecter my cms with Lengow" and add your api settings from Lengow account (api token and secret).
You'll find this informations in your general setting section "API".

Connection steps are detailed here!

Once the connection has been done, on the homepage, you will find:

  • an access to products to export to the Lengow platform
  • an access to information on orders imported from Lengow
  • the plugin main settings
  • a Help Center access and contact to our Support Team

Update process is the same as plugin installation process. 

install.png

1.2 Update the plugin version

Prerequisite: Get the new version of the Lengow plugin, zip file. (see info point below).

You do not need to uninstall the old version of the plugin and it is not recommended.

STEP 1: Unzip the new plugin version
  • it will create a folder named "lengow.magento2.{Version}"

STEP 2: Two possible options
1. If you have access to an FTP
  • Drag the lengow.magento2. {Version} folder to the root of your site,
  • Agree to replace all old files
2. If you have access to a terminal (via ssh or other)
  • cp -rf lengow.magento2.{Version}/* {your-magento-root}/
  • Then launch the following commands in your Magento console:
bin / magento setup: upgrade --keep-generated
bin / magento setup: static-content: deploy
bin / magento cache: clean
STEP 3: Check the plugin version
  • Check the version of Lengow plugin has correctly changed by going to any page and looking at the footer.
Download the latest version of the Lengow plugin (zip file) by ;clicking on the pop-up present at the top of any page in your plugin access. If you see this pop-up it means your version is outdated.

If you are unable to access this pop-up, request the latest version of the plugin from our support team.
Note that this procedure is not intended for merchants wishing to migrate from Lengow platform v2 or hybrid version to a Lengow platform v3 where there are additional steps. Contact our Support Team ; if you are in this position.

2. Set up your plugin in Lengow

How to access it? "Lengow" > "Dashboard"

When you use the plugin for the first time, you will need to configure some settings.

settings.png

2.1 Global settings

You will find:

Identification settings

In this block, complete the following fields with your Lengow account credentials
  • Account ID
  • Access Token
  • Secret Token

WARNING: Once saved please do not change your credentials.

All advanced settings
  • Enable authorization by IP
Enable this option if you want your export to be secured by IP. By default, your export is secured by a unique key.
  • Tracker Product ID
Select the product ID you send to channels with Lengow.
global_settings.png

2.2 Export settings

You can:

  • Export selected products only: when this option is enabled, only selected products will be exported to your products catalogue.
  • Select product type to export (configurable, simple, downloadable, grouped and/or virtual).
  • Select status of product to export: limit your export to active products, inactive products or both.
  • Select attributes to export: choose products fields to export. To select several fields, press and hold the "Ctrl" or "Command" keys.
  • Select default shipping country for export.
  • Define default shipping method to calculate shipping cost.
  • Define default shipping cost if no correspondence is found.
  • Merge images with parents products if available: when enabled, parent products images will be merged with child products'. It is limited up to five images.
  • Select the attributes to be exported from the parent products for the child products: The attribute values of the parent products will be directly filled on the child products.
  • Save feed on file: enable this option if your catalogue contains many products (more than 3 000) or if your catalogue takes a long time to be generated. Your catalogue is then saved in a /media/lengow file in your Magento. Note: if you use a file, it is important to enable the scheduled task to keep it updated.
  • Enable Magento cron: launches export every 4 hours. This option is useful when the "Save feed on file" feature is enabled, as it keeps your file updated. This option uses the Magento CRON system.

export_settings.png

2.3 Orders import settings

You can:

  • Synchronise all orders updated since: the maximum period (in days) on which the plugin comes to synchronise the orders. In the case of a cron synchronisation, the time interval is managed automatically by the plugin and is based on the date of the last successful synchronisation.
    For example, if the last synchronisation was an hour ago, the plugin will only retrieve the last hours.
    On the contrary, if the last synchronisation was 3 days ago, the plugin will synchronise on the last 3 days without ever exceeding the maximum number of days you have entered (it is recommended to leave this parameter on 3 days).
  • Customer group: assign customers created during import to a specific customer group.
  • Choose your shipping method: for orders shipped by marketplaces.
  • Receive notifications whenever there are issues regarding order import
  • Import orders shipped by marketplaces and decrement the concerned stocks
  • Import B2B orders without taxes: This option allows you to remove taxes from B2B orders. By default, this option is disabled.
  • Activate the currency conversion of your orders: All orders imported in Magento 2 will be automatically converted into the currency chosen in Lengow.
  • Enable Debug Mode: use Debug Mode to make test orders. You must enable this option ONLY on your preproduction server.
  • Enable Magento cron: Allows the synchronisation process to start every 30 minutes. This keeps your marketplace orders, dispatch and cancellation actions up to date. This option uses Magento's CRON system. Be careful however to activate this option only if the automatic synchronisation of Lengow is not running, otherwise both processes will run at the same time and may cause duplicate orders.

orders_import_settings.png

Manage your products

How do I get there? tab "Lengow" > "Products"

Select products you want to export to Lengow. For each of your Magento shops, choose whether you export all products or a selection of products.

You can change:

  • the number of products exported to the Lengow platform in the Products area.
  • your products values (title, description, price, ...). Click on "Catalog" on the menu on the left.

Changes will be visible in the Lengow platform in the next products catalogue import.

Click on the "Download" icon to download your products catalogue containing your selection of products.

Note: you will find here your Magento active products. If you delete or add a product, this will affect the number of exported products.

Manage your orders

How to access it? "Lengow" tab > "Orders"

In this area, you will find:

  • The number of orders in error and waiting for shipmentwhen there are some.
  • Last synchronisation date with Lengow. You can perform a manual synchronisation by clicking on the "Synchronize Orders" button.
  • An access to change the e-mail address to which error reports are sent.
  • Your imported orders which you can filter (Lengow status, marketplace, order ID, ...)
  • A command to re-import or re-send orders. Click on the dropping down menu near "Actions" and select your option.
Note
  • Orders are only imported only once their status has become "Waiting for shipment".
  • As the import of order in the Lengow plugin causes a decrement of the stock on the product ordered, no import is made at the status "canceled" and "refunded".
  • Once the order is imported, it will no longer be synchronized with the plugin.

Orders management

For each of your orders from Lengow, you will find a new Lengow block with all the order information and the following actions:

  • Re-import the order: recreate a new order and pass the current order through a Lengow technical error, but it's not worth further reducing stock.
  • Resend the action: This allows you to resend the action to change the status of the order to Lengow. (Ideal for correcting an order import error, for example if you have just entered the tracking coli which had been forgotten).
  • Re-synchronise the order: This allows you to remake the matching between Magento's order ID and the order ID in Lengow.

In the plugin, you will find marketplace orders. You can see:

  • if the order has been correctly imported in Magento
  • your orders status (in progress and closed)

If an order is not correctly imported in Magento, it will appear as "Not imported". Mouse over this message to know what is preventing import. Correct the bug and click on "Not imported" to re-import the order.

If you encounter troubles whilst solving problems, contact our Support Team.

Magento 2 - For new Lengow platform users

✅ The plugin is compatible from version 2.3 until 2.4.3 of Magento 2 and can be used ONLY with Lengow platform version 3.

> Get the Lengow plugin for Magento 2 here

The latest Magento 2.4.4 version is not compatible with the Lengow plugin. We recommend the use of a previous version of Magento 2.

If you are a V2 Lengow platform user Lengow strongly recommends you to migrate to its V3 platform to use our plugin for Magento 2.  

Contact our Support Team for more info.
Magento 2 changelogs are available here.

1. Plugin install

1/ Install the Lengow plugin in Magento2

Note for Magento 2: It is recommended to enable the cache at "System" > "Cache Management" before installing any extension.

To install the plugin, follow these steps:

Step 1: Open the extension ZIP file and extract it to a directory on your computer (using a tool like WinRar, WinZIP or similar).
Step 2: Upload the extracted folders and files into the root directory of your Magento installation. The root directory of Magento is the folder that contains the directories "app", "bin", "lib" and more. (All folders should match the existing folder structure).
Step 3: Connect via SSH and run the following commands (make sure to run them as the user who owns the Magento files!)
  • php bin/magento module:enable Lengow_Connector
  • php bin/magento maintenance:enable ; php bin/magento setup:upgrade ; php bin/magento setup:static-content:deploy ; php bin/magento maintenance:disable
Step 4: Go to "System" > "Cache Management" and click both the "Flush Magento Cache" as well as the "Flush Cache Storage" button. This is required to activate the extension.

2/ Connect the plugin to your Lengow Account

Click on "Connecter my cms with Lengow" and add your api settings from Lengow account (api token and secret).
You'll find this informations in your general setting section "API".

Connection steps are detailed here!

Once the connection has been done, on the homepage, you will find:

  • an access to products to export to the Lengow platform
  • an access to information on orders imported from Lengow
  • the plugin main settings
  • a Help Center access and contact to our Support Team

Update process is the same as plugin installation process. 

install.png

1.2 Update the plugin version

Prerequisite: Get the new version of the Lengow plugin, zip file. (see info point below).

You do not need to uninstall the old version of the plugin and it is not recommended.

STEP 1: Unzip the new plugin version
  • it will create a folder named "lengow.magento2.{Version}"

STEP 2: Two possible options
1. If you have access to an FTP
  • Drag the lengow.magento2. {Version} folder to the root of your site,
  • Agree to replace all old files
2. If you have access to a terminal (via ssh or other)
  • cp -rf lengow.magento2.{Version}/* {your-magento-root}/
  • Then launch the following commands in your Magento console:
bin / magento setup: upgrade --keep-generated
bin / magento setup: static-content: deploy
bin / magento cache: clean
STEP 3: Check the plugin version
  • Check the version of Lengow plugin has correctly changed by going to any page and looking at the footer.
Download the latest version of the Lengow plugin (zip file) by ;clicking on the pop-up present at the top of any page in your plugin access. If you see this pop-up it means your version is outdated.

If you are unable to access this pop-up, request the latest version of the plugin from our support team.
Note that this procedure is not intended for merchants wishing to migrate from Lengow platform v2 or hybrid version to a Lengow platform v3 where there are additional steps. Contact our Support Team ; if you are in this position.

2. Set up your plugin in Lengow

How to access it? "Lengow" > "Dashboard"

When you use the plugin for the first time, you will need to configure some settings.

settings.png

2.1 Global settings

You will find:

Identification settings

In this block, complete the following fields with your Lengow account credentials
  • Account ID
  • Access Token
  • Secret Token

WARNING: Once saved please do not change your credentials.

All advanced settings
  • Enable authorization by IP
Enable this option if you want your export to be secured by IP. By default, your export is secured by a unique key.
  • Tracker Product ID
Select the product ID you send to channels with Lengow.
global_settings.png

2.2 Export settings

You can:

  • Export selected products only: when this option is enabled, only selected products will be exported to your products catalogue.
  • Select product type to export (configurable, simple, downloadable, grouped and/or virtual).
  • Select status of product to export: limit your export to active products, inactive products or both.
  • Select attributes to export: choose products fields to export. To select several fields, press and hold the "Ctrl" or "Command" keys.
  • Select default shipping country for export.
  • Define default shipping method to calculate shipping cost.
  • Define default shipping cost if no correspondence is found.
  • Merge images with parents products if available: when enabled, parent products images will be merged with child products'. It is limited up to five images.
  • Select the attributes to be exported from the parent products for the child products: The attribute values of the parent products will be directly filled on the child products.
  • Save feed on file: enable this option if your catalogue contains many products (more than 3 000) or if your catalogue takes a long time to be generated. Your catalogue is then saved in a /media/lengow file in your Magento. Note: if you use a file, it is important to enable the scheduled task to keep it updated.
  • Enable Magento cron: launches export every 4 hours. This option is useful when the "Save feed on file" feature is enabled, as it keeps your file updated. This option uses the Magento CRON system.

export_settings.png

2.3 Orders import settings

You can:

  • Synchronise all orders updated since: the maximum period (in days) on which the plugin comes to synchronise the orders. In the case of a cron synchronisation, the time interval is managed automatically by the plugin and is based on the date of the last successful synchronisation.
    For example, if the last synchronisation was an hour ago, the plugin will only retrieve the last hours.
    On the contrary, if the last synchronisation was 3 days ago, the plugin will synchronise on the last 3 days without ever exceeding the maximum number of days you have entered (it is recommended to leave this parameter on 3 days).
  • Customer group: assign customers created during import to a specific customer group.
  • Choose your shipping method: for orders shipped by marketplaces.
  • Receive notifications whenever there are issues regarding order import
  • Import orders shipped by marketplaces and decrement the concerned stocks
  • Import B2B orders without taxes: This option allows you to remove taxes from B2B orders. By default, this option is disabled.
  • Activate the currency conversion of your orders: All orders imported in Magento 2 will be automatically converted into the currency chosen in Lengow.
  • Enable Debug Mode: use Debug Mode to make test orders. You must enable this option ONLY on your preproduction server.
  • Enable Magento cron: Allows the synchronisation process to start every 30 minutes. This keeps your marketplace orders, dispatch and cancellation actions up to date. This option uses Magento's CRON system. Be careful however to activate this option only if the automatic synchronisation of Lengow is not running, otherwise both processes will run at the same time and may cause duplicate orders.

orders_import_settings.png

Manage your products

How do I get there? tab "Lengow" > "Products"

Select products you want to export to Lengow. For each of your Magento shops, choose whether you export all products or a selection of products.

You can change:

  • the number of products exported to the Lengow platform in the Products area.
  • your products values (title, description, price, ...). Click on "Catalog" on the menu on the left.

Changes will be visible in the Lengow platform in the next products catalogue import.

Click on the "Download" icon to download your products catalogue containing your selection of products.

Note: you will find here your Magento active products. If you delete or add a product, this will affect the number of exported products.

Manage your orders

How to access it? "Lengow" tab > "Orders"

In this area, you will find:

  • The number of orders in error and waiting for shipmentwhen there are some.
  • Last synchronisation date with Lengow. You can perform a manual synchronisation by clicking on the "Synchronize Orders" button.
  • An access to change the e-mail address to which error reports are sent.
  • Your imported orders which you can filter (Lengow status, marketplace, order ID, ...)
  • A command to re-import or re-send orders. Click on the dropping down menu near "Actions" and select your option.
Note
  • Orders are only imported only once their status has become "Waiting for shipment".
  • As the import of order in the Lengow plugin causes a decrement of the stock on the product ordered, no import is made at the status "canceled" and "refunded".
  • Once the order is imported, it will no longer be synchronized with the plugin.

Orders management

For each of your orders from Lengow, you will find a new Lengow block with all the order information and the following actions:

  • Re-import the order: recreate a new order and pass the current order through a Lengow technical error, but it's not worth further reducing stock.
  • Resend the action: This allows you to resend the action to change the status of the order to Lengow. (Ideal for correcting an order import error, for example if you have just entered the tracking coli which had been forgotten).
  • Re-synchronise the order: This allows you to remake the matching between Magento's order ID and the order ID in Lengow.

In the plugin, you will find marketplace orders. You can see:

  • if the order has been correctly imported in Magento
  • your orders status (in progress and closed)

If an order is not correctly imported in Magento, it will appear as "Not imported". Mouse over this message to know what is preventing import. Correct the bug and click on "Not imported" to re-import the order.

If you encounter troubles whilst solving problems, contact our Support Team.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request