1. Plugin install

Before you install or update the plugin, follow our advice!

Install Lengow extension for Magento through Magento Connect Manager: System tab > Magento Connect > Magento Connect Manager. Upload the archive (see below) and click on "Upload" (if you have already installed the plugin, please uninstall it through Magento Connect Manager before updating it). (image 1)

Once installation is complete, log out and log in again to your Magento back office to load users' rights again. You may also have to clear your caches (System tab > Cache Management).

A new Lengow tab will appear in your back office as well as a new Lengow menu in System > Configuration. (image 2)

Click on the "Lengow" tab to access product management (Manage Products Export), your Lengow orders (Manage Orders), your feeds (Manage Feeds) and plugins logs (Logs).

Once installation is complete, log out and log in again to your Magento back office to load users' rights again. You may also have to clear your caches (System tab > Cache Management).

A new Lengow tab will appear in your back office as well as a new Lengow menu in System > Configuration.

2. Plugin configuration in Magento

In the plugin list on the left, you should see Lengow and the tabs Customer Account, Export Configuration and Manage Orders.

Always save your changes by clicking on "Save config" on the right.

2.1 Customer Account

The Customer Account area is divided into 3 parts:

1. General information

Find here information on your plugin version and find out whether an update is necessary.

2. Lengow API

This plugin is compatible with both Lengow platforms. Please enable the platform(s) on which you have access to. Then provide your credentials for each platform.

Former platform

• Customer ID: enter your client ID, as provided by your Lengow account manager. You can also find it in the Lengow solution > "See your account details" tab > id XXXX
• Group ID: enter your group or your Lengow groups IDs. You can find it in the Lengow solution > "See your account details" > "Group management". If you enter several group IDs, separate them with commas (example: 11095,11099)
• Token API: enter your API Token. To find it, go to the Lengow solution > API/WebServices (at the bottom of the page) > "Authentification" > “Token API” (1) (https://solution.lengow.com/api/)

New platform

• Account ID: enter your account ID. You can find it by clicking on your avatar on the top right corner of the page > "Company settings" > You can see on the top left of the page: "Account ID: XXXX")
• Access token: enter your access token. You can find it by clicking on your avatar on the top right corner of the page > "Company settings" > "Orders" > "Centralise orders" tab > "Access Token".
• Secret: enter your password. You can find it by clicking on your avatar on the top right corner of the page > "Company settings" > "Orders" > "Centralise orders" tab > "Secret".

3. Tracking

Enable the tracking to import your sales from the Lengow platform:

Tracker Product's identifiant: select the product ID you send to channels with Lengow.

Tracker Type: select tracking to enable it.

3. Products catalogue export

The export script is the URL that will be used as your “product catalogue” for the Lengow solution. 

You must use this URL in Lengow to import your products. Different formats are possible: csv, xml, json and yaml.

Configure this URL with the indications available in the sections below before implementing it in Lengow.

In this area, you can configure your products catalogue export settings. It is divided into 4 parts:

3.1 Global settings

• Enabled store (important!): enable the store(s) to export. It is also possible to enable all shops by default.
• Export only selected product: when enabled, only selected products will be exported to your products catalogue.
• Export out of stock products: enable this feature if you want to export your out of stock products. It is recommended to do so if you sell on marketplaces.
• Product type to export: you can select product types to export (configurable, simple, bundle, grouped or virtual).
• Status of product to export: limit your export to active products, inactive products or both.

3.2 Data

• Export default format: choose the format in which you want to export your products catalogue. You can choose between xml, json, csv and yaml. It is recommended to export in csv format for Lengow.
• Images max: maximum number of images per product to export to your catalogue.
• Merge images with parents products if exist: when enabled, parent products images will be merged with child products'. It is limited up to five images.
• Select attributes to export from parent products for child products
  Attributes values from parent products will be filled in automatically for child products.
• Level max for category: indicate the maximum depth of the breadcrumb trail of a product category.
• Stock without products ordering: when enabled, this feature decreases stock for products which are about to be ordered on your website (e.g. products in cart).
• Convert data: when enabled, special characters are replaced with HTML characters. This avoids encoding issues.
• Keep html for the selected fields: selected fields will keep the existing HTML. Otherwise, they will be cleared out.
• Country shipping: default shipping country for export.
• Shipping cost: define default shipping cost if no correspondence is found.
• Shipping method: define shipping method by default to calculate shipping cost.
• Delay of shipping: indicate estimated delivery time in days.

3.3 Performances

• Ip authorised to export: enter here IP addresses which may access your export (your source feed URL).
• 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.
• Active 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.

3.4 Product attributes

• Select attributes to export: choose products fields to export. To select several fields, press and hold the "Ctrl" or "Command" keys.

3.5 Product management and export feed

In the "Lengow" tab > "Product Management" tab, you can view your products and select the ones you want to see.

Tick the concerned products, then select "Change Lengow's publication" near "Actions" and "Submit".

You can also view your export feed (or generate the file containing your catalogue) by clicking on "See the export feed" on the right. This feed will be retrieved by Lengow as your products catalogue. It will be then imported and sent out to your channels.

4.Set up channels orders import

4.1 Set up your import

Configure your orders import settings:

• Enabled store (important!): enable the store(s) to export. It is also possible to enable all shops by default.
• Import orders from x days: define the period on which you want to import orders. If you want import orders which have been placed over the past 5 days, simply enter the value "5". Orders which were already imported are saved in your database (so that orders are not saved several times).
• Use the real date of import's order: when enabled, the date of order will be the same the one on the marketplace. Otherwise, the date of import will be considered.
• Import processing fee from Marketplace: when this feature is enabled, marketplaces fees (commissions) are included in orders. This simplifies your accounting processes.
• Customer group: assign customers created during import to a specific customer group.
• Import with product's title from Lengow: enable this option if you want that your products names remain the same as on the marketplace, instead of keeping the product name which has been matched in Magento. Please check imported SKU to avoid stock issues.
• Split name: enable this option when a customer entered his first name and last name on one same information line.
  • for example, if the information line first name is empty, whilst last name contains "John Smith" and the "Split name" option is not enabled, then customer profile will appear as follows:
    • first name: __ last name: John Smith. "__" are added to fill in empty fields.
  • If the option is enabled:
    • first name: John last name: Smith
• ​Choose your shipping method: for orders shipped by marketplaces
• Use fictitious emails: generates fake e-mails during orders import.
• Activate the currency conversion of your orders
  All orders imported into Magento will be automatically converted into the currency chosen in Lengow.

4.2 Orders management

In the orders management area, you can access Lengow orders. You will get a better overview of your orders information (order ID, marketplace information).

You can perform some actions on orders you selected by clicking on the dropping down menu near "Actions". You can also launch a manual import by clicking on "Manual import".

When you access order details, you can see several useful information:

• in the "Payment Information" area, you will find the marketplace name on which the order has been placed:

• if an order is delivered to a Pick-Up Point, the Pick-Up Point identifier is displayed in the shipping area (near the delivery address). Delivery method which has been chosen on the marketplace appears between square brackets [ ] in the "Shipping & Handling Information" area. (see image 3)

5. CRON Tasks and Magento

Magento integrates a tasks manager. Thanks to this system, the Lengow plugin can suggest scheduled export and import options.

Create a CRON task on your server to use this system: it is recommended to execute the cron.sh or cron.php script (in your Magento root) every 5 minutes. This task aims at creating, scheduling and executing tasks which were defined by plugins and Magento applications.

6. Logs

In the "Lengow" > "Logs" tab, you can access the Lengow extension logs. When you encounter a problem with orders import or your catalogue creation, please read these logs first to understand the issue.

You can permanently delete all logs by clicking on Flush logs.