Setting up limango

limango, a member of the Otto Group, is the number one platform for young families. In addition to its private Shopping Club, limango also operates the online shop which is accessible without registration. Since the market was launched in 2017, end users also take advantage of a broad and permanent product range that is now provided by more than 500 partners.

1. Becoming a limango partner

Join the leading platform for family shopping and click here for more information on the limango marketplace and their partner program and to send your registration request (please note: information is only available in German).

Alternatively, you can also contact our team of partner managers by sending an email to marketplace@limango.de. A partner manager will get in touch with you soon and will work with you to evaluate the potential on limango.de and talk about your next steps.

After registering, you will receive login details from limango. You need these login details to set up limango in PlentyONE.

2. Frequency of data exchange

After installing and setting up the plugin, the automatic processes described in Table 1 become available.

Table 1. Frequency of data exchange
Data Interval

Item export

daily at 7 a.m., 11 a.m., 3 p.m. and 7 p.m.

Stock synchronisation

hourly
Tip: Shorter stock update intervals are not possible due to technical reasons. If necessary, set a stock buffer to prevent overselling.
Note: Only whole numbers can be exported. Stock with decimal numbers (for example 0,5) are invalid.

Price synchronisation

hourly

Order import

Every 15 minutes
Note: Customers make their payments to limango. Nevertheless, all orders are imported with the status [3] Waiting for payment.

Deletion of items

once a day during the night

3. Workflow of a limango order

  • Your products are listed in the limango marketplace. The name of your company is shown with your products.

  • Customers place an order on limango.

  • Customers make their payments to limango.

  • The order is imported into PlentyONE.
    Note: Customers make their payments to limango. Nevertheless, orders are imported with the status [3] Waiting for payment.

  • When you receive the order, you ship the products (drop shipping).

4. Installing the plugin

Note: limango is a closed market. If you want to sell your items on limango, first register for the limango partner program. For further information, see Becoming a limango partner.

In order to set up limango in PlentyONE, you have to install the limango plugin in your PlentyONE system. You will receive the link for installing the plugin after you have registered for the limango partner program.

Important: Install the plugin in the plugin set of the main client.

limango: Adding and installing the plugin

Adding plugin to the system:

  1. Go to Plugins » plentyMarketplace.
    → The marketplace opens in a new tab.

  2. Navigate to the plugin limango.
    Tip: Either use the search function or open the category Plugins » Sales » Marketplaces.

  3. Open the detail view of the plugin.

  4. In the column to the right, click on Go to checkout.
    → The Checkout window opens.

  5. Read and accept the General Terms and Conditions.

  6. Click on Order now.
    → Wait a few minutes before installing the plugin.

Installing plugins:

  1. Go to Plugins » Plugin set overview.

  2. Click on the plugin set of your main client.
    Important: In other words: The plugin set must be linked to the main client.
    → The plugin set opens.

  3. Click on Add plugin.

  4. Select limango from the plugin list.

  5. Click on Install.
    → The plugin is installed.
    → The plugin set is shown.

  6. Switch the plugin to active ().

  7. Save () the plugin set.
    Tip: Problems saving the plugin set? Click on Open details to show additional information.

5. Setting up the market in PlentyONE

Installed the limango plugin? Great. Now, set up the market in PlentyONE.

5.1. Carrying out the basic settings

First, carry out the basic settings in the plugin settings. Keep the login details at hand that you received from limango.

Carrying out the basic settings:

  1. Go to Plugins » Plugin set overview.
    → The list of plugin sets is shown.

  2. Click on the plugin set in which you have installed the limango plugin.
    → The plugin set opens.

  3. Click on the plugin limango.
    → The plugin settings open.

  4. Carry out the settings. Pay attention to the information given in Table 2.

  5. Save () the settings in each section in which you made changes.

Table 2. Setting up limango
Setting Explanation

SFTP credentials

Host

Enter ftp-partner.limango.de.

Port

Enter port 22.

User name;
Password

You will receive these credentials from limango.

Stock export

Stock buffer

By default, the stock of all warehouses for which you entered for the option Warehouse IDs (comma separated) is added up and exported to limango. Enter a whole number to reduce the exported stock quantity by the entered amount.
Note: Stock information is exported to limango once per hour. For technical reasons, shorter stock update intervals are not possible. Use the stock buffer to prevent overselling.

Time of last successful stock export

The timestamp of the last successful stock export

Warehouse IDs (separated by commas)

Enter the ID of the warehouses from which you want to export stock details to limango. Enter several ID separated by commas.
Note: The virtual warehouse has the ID -1. If you enter this ID, the stock of all sales warehouses is added up. This total is exported. Tip: You can find the ID of a warehouse in the menu Setup » Stock » Warehouse » [Open warehouse] » Settings.

Information

Order referrer ID created by plugin

The ID of the order referrer limango that is created automatically when you install the plugin. The ID is filled in automatically.

Status of last price export

  • 1/success = The prices were exported to limango. You can check the last time the export was successful Timestamp of last successful price export.

  • 2/failed = The last price export failed.

Time of last successful price export

The timestamp of the last successful price export.

Order status

Order status for orders without shipping carrier mapping (> 5 - < 7)

Which status is assigned to orders if the shipping service provider in the order is not linked to a shipping service provider in PlentyONE?

The selected status must be:

  • Greater than 5

  • Less than 7

  • Less than the status for Order status for orders with shipping carrier mapping (> 5 - < 7)

After correcting the shipping carrier mapping, move orders with this status into the status for Order status for orders with shipping carrier mapping (> 5 - < 7).

Order status for orders with shipping carrier mapping (> 5 - < 7)

Which status is assigned to orders if the shipping service provider in the order is linked to a shipping service provider in PlentyONE?

The selected status must be:

  • Greater than 5

  • Less than 7

  • Greater than the status for Order status for orders without shipping carrier mapping (> 5 - < 7)

Shipping service provider

DHL;
Hermes;
UPS
etc.

For each shipping service provider that you want to offer for limango orders, enter the PlentyONE ID of the shipping service provider in PlentyONE.
Tip: Go to Setup » Orders » Shipping » Settings » Tab: Shipping service provider to find the ID of your shipping service providers in the column ID.
Note: The shipping costs are defined in your contract with limango. limango then saves it in the limango backend. This is why you enter the ID of the shipping service provider, not the ID of a shipping profile.

Speditionsversand - doorstep;
Speditionsversand - apartment-house;
Speditionsversand - arranged-individually

To offer freight shipping for your products, enter the appropriate PlentyONE shipping profile ID for each of these shipping options.
Tip: Go to Setup » Orders » Shipping » Settings » Tab: Shipping profiles to find the ID of your PlentyONE shipping profiles in the column ID.
Note: The mapping of shipping options is only required for order import. It is not used for the shipping confirmation.

Client selection

Plenty ID

Enter the plenty ID of a client. limango orders are imported for this client.
→ The order documents for this client are used during order processing.
If you do not enter a client, the default client is used for importing orders.
Tip: The plenty ID of your clients is saved in the Setup » Client » [Select client] » Settings » Option: Plenty ID menu.

Image source

Export item images when no variation images are linked

Option activated: If no images are linked to the variations, the first 10 images activated for the referrer limango of the item are exported.
Tip: Use this setting if your variations are not created using an attribute for colours.

5.2. Activating the order referrer

Go to Setup » Orders » Order referrer to activate the order referrer. This ensures that orders are assigned to the correct sales channel.

What is an order referrer?

An order referrer tags an order with the sales channel on which the order was generated. Sales channels can be e.g. your online shop or markets on which you sell your items. Each sales channel has an individual order referrer. Some order referrers are available by default in your PlentyONE system. Further order referrers are added e.g. if you install a new plugin. For further information about the order referrer, see the page Order referrer of the PlentyONE manual.

Activating the order referrer for limango:

  1. Go to Setup » Orders » Order referrer.

  2. Click Search (search).

  3. In the list, navigate to the option limango.

  4. On the right of the referrer’s line, click on Edit (edit).
    → The window Edit referrer opens.

  5. Activate the option Visible in selection (toggle_on).

  6. Click on Save (save).
    → The referrer is active.

5.3. Permitting the payment method in a customer class

The payment method limango is automatically available in your PlentyONE system as soon as an active limango account exists. No separate configurations are needed for this. You just need to permit the payment method in one or more customer classes.

What are customer classes?

Customer classes allow you to divide your customer base according to specific criteria. Examples of use for customer classes are:

  • Create two separate customer classes for end customers (B2C) and business customers (B2B) respectively. Depending on the customer class, customers either see net prices or gross prices in your plentyShop.

  • Give discounts to specific customer classes.

For more information about customer classes, head over to the to the Managing contacts page.

Permitting the payment method in a customer class:

  1. Go to Setup » CRM » Customer classes.

  2. Open the customer class for which you want to permit the payment method.

  3. For the setting Allowed payment methods, activate the option limango.

  4. Save () the settings.

5.4. Defining a sales price

To sell variations on limango, you need a sales price in which the order referrer limango is activated. The price that you save for this sales price is the price that will be shown on limango.

What is a sales price?

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. For example, you can sell your items at a lower price in your webshop than on Amazon. Or you can sell products cheaper to B2B customers than to B2C customers.

Two default sales prices are already configured in your PlentyONE system. However, you can also create new sales prices and edit them individually. In addition to default sales prices, you can also create RRPs, special offers, and set prices.

Defining a sales price for limango:

  1. Go to Setup » Item » Sales prices » [Open sales price].
    Tip: No sales prices? Then create a sales price first.

  2. Open the Settings tab.

  3. Activate the referrer limango.

  4. Save () the settings.

5.5. Activating the referrer in shipping profiles

Now activate limango in the shipping profiles that you want to offer for this market.

Activating referrer limango in the shipping profile:

  1. Go to Setup » Orders » Shipping » Settings.

  2. Click on the Shipping profiles tab.

  3. Click on the shipping profile.
    Tip: No shipping profiles? Learn how to create shipping profiles here.

  4. For the setting Order referrer, activate the option limango.

  5. Save () the settings.
    → The shipping profile is available for orders with the referrer limango.

  6. If desired, activate the referrer in additional shipping profiles.

6. Preparing variations

Now, prepare your variations.

6.1. Setting the variation availability

You need to activate the variations that you want to sell on limango. This is done in the Availability and visibility section of a variation within the Item » Items » [Open item] » [Open variation] menu.

During the first export, variations with the stock 0 will also be exported to limango. Therefore you should only activate the variation availability for those variations that you actually want to export.

  • For one variation

  • Using variation group function

  • Using batch processing

Making a variation available for limango:

  1. Go to Item » Items » [Open item] » [Open variation].
    Tip: To sell all variations of an item on limango, carry out the settings for the item’s main variation. If the inheritance function is active for the variations, then this activates the availability of all variations of the item.

  2. In the Availability and visibility section, activate the option Active.

  3. In the Sales channels section, click Add sales channels (add).
    → The window Add sales channels opens.

  4. In the drop-down list Sales channels, select the option limango.

  5. Click Apply.
    → The sales channel is added.

  6. Save () the settings.
    → The variation is available for limango.

Use the variation group function to edit multiple variations at once. You select the variations that you want to edit.

Making several variations available for limango using the variation group function:

  1. Go to Item » Items.

  2. Set search filters as needed and start the search.

  3. Select () the variations to be edited.

  4. In the toolbar, click on layers » layers Variation group function.
    → The Variation group function window opens.

  5. Select the action Sales channels from the drop-down list Actions.
    → The action is added to the lower part of the window.

  6. In the drop-down list Sales channels, select the option limango.

  7. Select the action Active from the drop-down list Actions.
    → The action is added to the lower part of the window.

  8. Activate the option Active.

  9. Navigate to the area Availability.

  10. Click Execute to apply the settings.

Batch processing allows you to edit several variations at once. You use filters to limit which variations are edited.

Making several variations available for limango using batch processing:

  1. Go to Item » Batch processing.

  2. Click on the tab Variations in the upper left corner.

  3. Use the filters on the left to specify which variations should be processed.

  4. Navigate to the area Market availability.

  5. Activate the checkbox to the left of the option limango.

  6. Activate the checkbox to the right of the option limango.

  7. Navigate to the area Availability.

  8. Activate the checkbox to the left of the option Active.

  9. Activate the checkbox to the right of the option Active.

  10. Click on Apply to apply the settings to the variations.

6.2. Saving mandatory variation information

As a minimum, you need to save the mandatory variation information to export your item data to limango. The following table shows the marketplace data fields that are mandatory for limango and how you save the necessary information in PlentyONE.

Required Setting in PlentyONE/explanation

Product name

Field Name 1, Name 2, or Name 3 and either an attribute for colours or a property for colours

The following rules apply to product names:

  • Enter the item name in German.

  • Product names can have a maximum of 80 character but should be as short as possible.

  • Do not include the manufacturer or any own brands in the product name. This information is shown separately on limango.

  • Sizes, gender information or repetitions are not allowed as part of product names.

  • For some categories, the colour must be part of the product name based on the pattern [Product name] in [colour].
    Example: T-Shirt in Blau

Description

PlentyONE data field Item text + additional product information in a property of the type Text for some categories.

Background: For some categories, limango expects additional product information. Depending on the category, this could for example be technical data or the scope of delivery. There is no default variation input field for this information. As such, we recommend that you save this product information in a property of the type Text. You could name this property Additional product information limango. In the catalogue, map the PlentyONE data field Item text combined with the property for the additional product information to the marketplace data field Description.
Tip: Before your integration starts, limango will provide you with category-specific guidelines. Use these guidelines to make sure your descriptions comply with the legal and market-specific requirements.

The following rules apply to descriptions:

  • The item description can be up to 10,000 characters long. Longer text is truncated after 10,000 characters.

  • limango cannot process HTML tags. As such, HTML tags are removed during the export. As such, check your item texts. If you use a lot of HTML tags, you might want to create a property in which you save item descriptions without HTML tags.

  • For some categories, limango expects additional product information. Depending on the category, this could for example be technical data or the scope of delivery. There is no default variation input field for this information. As such, we recommend that you save this product information in a property of the type Text. You could name this property Additional product information limango.
    Tip: Before your integration starts, limango will provide you with category-specific guidelines. Use these guidelines to make sure your descriptions comply with the legal and market-specific requirements.

Image URL

Important: Images must be in JPG format. Other formats cannot be processed.

Material composition
(Sleeve lining;
Upper 3;
Upper 2;
Upper 1;
Membrane;
Material 3
etc.)

If textile fibres make up at least 80% of the weight of a product, you need to specify the material composition.

Material information is exported to limango using a property of the type Text. Create a separate property for each marketplace data field.

Link the properties to the main variation of the item and save all components of a material mix in this property. If the variations of the same item have different material mixes, deactivate the inheritance function for properties and save the material mixes separately for each variation. However, note that this deactivates the inheritance for all properties for the item. As such, you also need to manually manage all other properties for each variation.

Specify the individual materials in descending order based on the percentage value. As such, the first material is the one with the highest percentage value, the last one that with the lowest percentage value. The sum of all percentages must be 100. You can specify as many materials as you need. Enter the material composition in the following format:

  • {"materialtype1":"percentage","materialtype2":"percentage","materialtype3":"percentage"}
    `Example:_ {"baumwolle":"90","elasthan": "10"}_

The values for material types must be identical to the values that limango allows:

Example: Exporting material information for a blazer to limango

The following example shows you how to save material information for a blazer for the limango export.

Mapping outer fabric and saving material mix for a variation:

  1. Create a property of the type Text with the name obermaterial.

  2. Map the marketplace data field Upper to the PlentyONE property obermaterial.

  3. Link the property obermaterial to the main variation of the item.

  4. Our blazer is made of 65% polyester, 32% rayon and 3% elastane. Enter the following into the text field of the property:

    • {"polyester":"65","viskose":"32","elasthan":"3"}

  5. Save the settings.

Mapping lining and saving material mix for a variation:

  1. Create a property of the type Text with the name futter.

  2. Map the marketplace data field Lining to the PlentyONE property futter.

  3. Link the property futter to the main variation of the item.

  4. The lining of the blazer is made of 100% rayon. Enter the following into the text field of the property:

    • {"viskose": "100"}

  5. Save the settings.

Shoes: Upper shoe materials

For shoes, only the following materials can be specified: Leder (leather), beschichtetes Leder (coated leather), Textil (textile) and sonstiges Material (other material).

  1. Create a property with the following settings:

    • Name: Shoes: Upper shoe materials

    • Section: Item

    • Type: Multi-selection

    • Selection values:

      • other-material

      • leather

      • coated-leather

      • textile

  2. In the menu Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings, link the variation to the property.

  3. Select the property value that suits the variation.

Shoes: Lining shoe materials

For shoes, only the following material values are allowed: Leder (leather), beschichtetes Leder (coated leather), Textil (textile) and sonstiges Material (other material)

  1. Create a property with the following settings:

    • Name: Shoes: Lining shoe materials

    • Section: Item

    • Type: Multi-selection

    • Selection values:

      • other-material

      • leather

      • coated-leather

      • textile

  2. In the menu Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings, link the variation to the property.

  3. Select the property value that suits the variation.

Shoes: Insole shoe materials

For shoes, only the following material values are allowed: Leder (leather), beschichtetes Leder (coated leather), Textil (textile) and sonstiges Material (other material)

  1. Create a property with the following settings:

    • Name: Shoes: Insole shoe materials

    • Section: Item

    • Type: Multi-selection

    • Selection values:

      • other-material

      • leather

      • coated-leather

      • textile

  2. In the menu Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings, link the variation to the property.

  3. Select the property value that suits the variation.

Shoes: Outsole shoe materials

For shoes, only the following material values are allowed: Leder (leather), beschichtetes Leder (coated leather), Textil (textile) and sonstiges Material (other material)

  1. Create a property with the following settings:

    • Name: Shoes: Outsole shoe materials

    • Section: Item

    • Type: Multi-selection

    • Selection values:

      • other-material

      • leather

      • coated-leather

      • textile

  2. In the menu Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings, link the variation to the property.

  3. Select the property value that suits the variation.

RRP

  1. Link a sales price of the price type RRP for the referrer limango to the variations.

  2. Save a price.

Specify the RRP based on the following logic:

  • The RRP cannot be lower than the gross sales price.

Gross sales price

  1. Link the sales price for the referrer limango to the variations.

  2. Save a price.

Category

PlentyONE categories

Brand

  1. Save the manufacturer names in the menu Setup » Item » Manufacturers.

  2. Select the manufacturer name for each variation.

Tip: Contact the limango partner management if you wan to list a new brand.

Gender

  1. Create a property of the type Selection with the following values:

    • Mann

    • Frau (woman)

    • Unisex

  2. Link the properties to a variation and select a value.

limango gender variation

Age group

  1. Create a property with the following settings:

    • Name: Age group

    • Section: Item

    • Type: Selection

    • Selection values:

      • Babys (babies) = Children ≤ 1 year old

      • Kinder (children) = Children > 1 year old

      • Erwachsene (adults)

  2. In the menu Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings, link the variation to the property.

  3. Select the property value that suits the variation.

limango age variation

Colour

The colour is used to create a unique product. As such, the colour must be a unique value, for example the manufacturer colour. To create the item number, the colour is added to the SKU.

If your variations were created without an attribute for colours, you need a property:

  1. Create a property of the type Selection and save the necessary colours as property values.

  2. Link the property to a variation and select one of the values.
    Tip: A property of the type Selection is a good idea if you work with recurring colour names.

or

  1. Create a property of the type Text.

  2. Link the property to a variation and enter the colour as the value.
    Tip: A property of the type Text may be more suitable if your colour range changes frequently. However, this increases the risk of typos.

Size

If your variations were created without an attribute for sizes, you need a property.

Note: Products without a size have the size value onesize on limango. Products without a size are single size products. These are products that are only available in one size. The size is not used to create variations.
Example furniture: A chair is available in several colours but only in one colour. The size value onesize must be exported.

  1. Create a property of the type Selection and save the necessary sizes as property values.
    Tip: Do not forget to save the property value onesize for products that do not have a size.

  2. Link the property to a variation and select one of the values.

Measurements
(Length;
Width;
Height;
Volume;
Diameter;
Weight
etc.)

Only specify measurements for products with no size variations, i.e. for single size products such as furniture.

Background: In the limango shop, the measurements can only be shown at the product level. No measurements are shown at the variation level.

Measurements must be exported to limango with the format [numeric value];[unit]. Due to the limango product structure, the normal PlentyONE data fields for measurements cannot be mapped. Instead, create two properties:

  • One property of the type Decimal number for the numerical value.

  • One property of the type Selection for the unit with the following selection values:

    • ml

    • l

    • mm

    • cm

    • m

    • g

    • kg

Combine these two properties, separated by a semicolon.

Example: Exporting the length to limango
  1. Create a property of the type Decimal number with the name Length.

  2. Create a property of the type Selection with the name Length unit.

  3. Add the units you need to the property Length unit as property values.

  4. Open the limango catalogue.

  5. Map the marketplace data field Length to the PlentyONE property Length.

  6. To the right of this data field, click Add data field ().

  7. Map the property Length unit.
    Tip: If you are sure that you only need one unit for all your variations, you can also export the unit by entering it as an own value. To do so, instead of mapping the property Length unit, map the field Own value and enter the unit in the field that opens.

  8. To the right of the column, click Settings ().

  9. From the drop-down list Separator, select the option Semicolon.

Example: Exporting the volume to limango

Imagine that you want to export the volume of variations to limango. To do so, proceed like this:

  1. Create a property of the type Decimal number with the name Volume.

  2. Create a property of the type Selection with the name Volume unit.

  3. Add the units you need to the property Volume unit as property values.
    Note: Only the units l (for litres) and ml (for millilitres) can be exported.

  4. Open the limango catalogue.

  5. Map the marketplace data field Volume to the PlentyONE property Volume.

  6. To the right of this data field, click Add data field ().

  7. Map the property Volume unit.
    Tip: If you are sure that you only need one unit for all your variations, you can also export the unit by entering it as an own value. To do so, instead of mapping the property Volume unit, map the field Own value and enter the unit in the field that opens.

  8. To the right of the column, click Settings ().

  9. From the drop-down list Separator, select the option Semicolon.

Energy label URL

Lamps and luminaires with light sources not intended to be removed by the end-user must be labelled. As such, a URL of the energy label must be exported for these products.

Recommendation: Create a property of the type Text in which you save the URL to the energy label of a variation.

Energy data sheet URL

You need to provide an energy data sheet for all products that are subject to energy labelling law. As such, a URL of the energy data sheet must be exported for these products.

Recommendation: Create a property of the type Text in which you save the URL to the energy data sheet of a variation.

Taking back old appliances according to ElektroG3

Since 1st of January 2022, new regulations are in force in Germany requiring you to take back old electronic devices. For devices that require you to take back old devices, the value DE must be exported to limango. As such, the value DE means yes. No value means no.

Recommendation:

  1. Create a property of the type Selection with the value DE.

  2. Link the variations for which you offer device take back to this property and select the value DE.

7. Setting up item data export

Item data is exported to limango via a catalogue format. Go to Data » Catalogues to create catalogues.

What is a catalogue?

Catalogues are used to export data from your PlentyONE system. There are two different catalogue formats:

  • Marketplace formats are used to export item data to markets.

  • Standard formats are used to export data from your PlentyONE system into a file.

Catalogues with marketplace formats allow you to tailor your item information exactly to the needs of the market. Because here, you assign a suitable PlentyONE data field to each of the data fields of the market. When your variation data is exported to the market, the market’s data fields are then filled with the correct PlentyONE data.

To export your item data to limango, you need to create a catalogue. Link the limango data fields with the item data saved in PlentyONE in the marketplace format afterwards. After you activate the catalogue, the catalogue data is automatically exported to limango in regular intervals.

7.1. Notes on the limango item data structure

The structure of limango item data differs from the structure in PlentyONE. The limango item data is categorised into three levels:

Level Explanation

Product group

All products of the same model that are available in different colours.
Tip: If a product is only available in a single style, then the product group and the variation are identical.

Product

A colour version of the product. As such, each product group has as many products as there are colours.

Variation

Variation at the size/EAN/SKU level
Important: Each product must have at least one variation.
Tip: If a product is only available in a single size, the size Onesize must be specified.

Use the parent-SKU

Do you sell products in different colours but manage these different colours in separate items? The parent SKU allows you to link these separate items. Parent SKUs can be saved for both items and individual variations. The manual maintenance of SKUs allows you to assign the Parent SKU of entirely different item variations to variations of an item.

  • You can assign the Parent SKU of a variation which belongs to an entirely different item five times to an item with five variations. These variations are listed on limango as variations of the item with the Parent SKU they are assigned to.

  • If one variation has a different Parent SKU than the remaining variations of an item, then two different items are listed on limango. You only have to maintain one item in your PlentyONE system.

7.2. Creating a catalogue

Item data is exported to limango via catalogue using the marketplace format limango. Create a catalogue in the Data » Catalogue menu to export your items to limango. Map the limango data fields to item data saved in PlentyONE in the marketplace format afterwards.

Important: Select the format limango new, not the old format limango.

You can create only one catalogue for limango. limango does not support multiple catalogues.

Creating a catalogue:

  1. Go to Data » Catalogues.

  2. Click on Create catalogue (add).

  3. Enter a name for the catalogue.

  4. In the drop-down list Marketplace, select the option limango.

  5. In the drop-down list Export type, select the option Item.

  6. In the drop-down list Category, select the option limango new.
    Tip: You can only create one catalogue for this sales channel. Thus, the only category you can select is the name of the sales channel.
    Note: Select the category limango new, not the old format limango.
    Note: The category limango new is only shown if the plugin limango is installed.

  7. Save () the settings.
    → The catalogue is created.
    → The catalogue is opened for editing.

Other catalogue settings

Other catalogue settings are optional. Once you carried out the settings described on this page, your catalogue is automatically exported to limango. That means you can ignore the catalogue settings for Format settings, Export settings and Download settings.

The Format settings, Export settings, and Download settings allow you to create a file with the variation data contained in the catalogue. However, this file does not contain information about whether the data export to limango was successful.

You should not change the format in the catalogue’s Format settings. To ensure that the export to the sales channel works, all required settings are already configured when you create a catalogue. If you change the settings, errors might occur during the export.

7.3. Mapping catalogue fields

After you have created a catalogue, map the market’s data fields to item data saved in PlentyONE. This chapter describes how you map data fields and what particularities apply for item exports to limango. In addition, we provide recommendations for suitable mappings. This information is structured like this:

7.3.1. Mapping data fields in the catalogue

Now, map the limango data fields to the item data saved in PlentyONE.

  • The market expects product data that cannot be saved in the PlentyONE item menu? Then create a property for this data. Link this property with your variations. The actual values are saved as property values for this property. Is this your first time working with properties? Then read up on the principles of properties first.

Getting to know the catalogue menu for marketplace formats
catalogue menu colours
Availability Explanation

Navigation

When you open a catalogue, the view Mapping is shown. On the very left is the navigation.

  • Switch to other views of the catalogue.

  • Open the catalogue settings.

  • Use filters that limit the data that is exported.

  • Go back to the list of catalogues.

  • Create a new catalogue.

Toolbar

The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.

Marketplace data field

To the right of the navigation, all data fields available for the market are listed. Mandatory fields are marked with an asterisk (✱).
Tip: Show or hide optional marketplace data fields in the toolbar. To do so, click on the further actions (more_vert).

PlentyONE data fields

On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data fields. In the screenshot above, a few of the fields are already mapped.

Mapping catalogue fields:

  1. Go to Data » Catalogues.

  2. Click on the catalogue.
    → The Mapping tab opens.
    → In the left-hand column, the market’s data fields are listed.
    Tip: Mandatory fields are flagged with an asterisk (*).
    → In the right column, you map the PlentyONE data fields. Any PlentyONE data fields that you already mapped are also shown in this column.

  3. Map suitable PlentyONE data fields to the market data fields.
    For each marketplace data field, you have a number of mapping options. Expand the info boxes below to get more information about each of these mapping options.

    • Simple 1:1 mapping

    • Simple 1:1 mapping with properties

    • Complex 1:1 mapping

    • 1:1 mapping with fallback data fields

    • 1:n mapping

    • Own value mapping

    • Mapping with mathematical calculations

  4. Save () the catalogue.
    → The mappings are saved.

Simple 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. If no suitable setting exists in PlentyONE. you can map a property instead.

As such, simple 1:1 mappings allow you to:

  • I want to fill this marketplace data field with the data from this PlentyONE setting.

  • If the data field is empty for a variation, no value is exported for this variation.

Creating a simple 1:1 mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. Click on Confirm.

Example: Sales price and RRP for Otto Market

This gif shows you how to map the marketplace data fields Sales price and RRP for Otto Market to PlentyONE data fields:

gif catalogue mapping simple en
Simple 1:1 mapping: with properties: 1 marketplace data field, no PlentyONE data field

Reminder: In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. However, what can you do if PlentyONE does not offer a suitable data field? Then it’s the properties' moment to shine. Properties allow you to save any kind of information in your properties.

Creating a property:

  1. Create a property with the necessary values.
    Tip: Find out how to do that here.

Creating a simple 1:1 mapping with properties:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Expand the group Property.
    → The property groups are shown.

  3. Expand the group you need.

  4. Click on the Plus sign on the right of the property you want.

  5. From the drop-down list Language, select the language in which you send the data to the market.

  6. Click on Confirm.
    → The property is mapped to the marketplace data field.

Complex 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

Like with the simple 1:1 mappings, you map a PlentyONE setting or property to a marketplace data field. Complex mappings are necessary whenever a marketplace data field has more than one possible value. Instead of mapping data fields, for complex mappings you map individual values of these data fields. For example, you cannot simply map the PlentyONE data field Shipping profile to the marketplace data field Shipping method. Why? The market cannot know which of your shipping profiles in PlentyONE corresponds to which of their shipping methods.

Do not enter own values for complex mappings. All values that you enter must be saved for the variations, either in a setting or as a property value. This also applies if the value Comparative value is shown. You still need to enter exactly the value of the setting or property that you mapped.

In complex mappings, the value of the market is always exported. Only when you map an own value, the own value that you enter is exported.

You can recognise complex mappings from the field that is shown below the name of the marketplace data field. Click on the field to show the values available for the marketplace data field.

catalogue complex mappings

Examples for complex 1:1 mappings are:

  • Categories

  • Brands

  • Shipping setting

Important: For complex mappings, do not map own values or properties of the type None.

Creating a complex 1:1:n mapping:

  1. Click on the field for the marketplace data field.
    → A list of the available values is shown.

  2. Select the value that you want to map a PlentyONE data field to.
    → The value is mapped.

  3. Next to the marketplace data field, click on + Add data field.
    → To the left, the available PlentyONE data fields are listed in groups.

  4. Click on a group.
    → The PlentyONE data fields of the group are shown.

  5. Click on the PlentyONE data field for which you want to map values.
    Important: Do not map own values or properties of the type None.

  6. Your next steps depend on the PlentyONE data field you selected:

    • Alternative 1: The available values for the PlentyONE data value are shown on the left.

      • Next to the value you want to select, click on the plus.
        → The value is added to the field on the right.

      • Click on Confirm.

    • Alternative 2: The PlentyONE data field is inserted and the field Comparative value is shown.

      • In the field Comparative value, enter a value that is saved in the setting or the property of the mapped PlentyONE data field.

      • Click on Confirm.

    • Alternative 3: The PlentyONE data field is inserted and a drop-down list is shown.

      • Select a value from the drop-down list.

      • Click on Confirm.
        → The value of the marketplace data field is exported, not the value of the PlentyONE data field.
        Exception: Only when you map an own value, the own value that you enter is exported.

Example: Delivery time in days for Otto Market

This gif shows you how to map suitable PlentyONE values to the values of the marketplace data fields Delivery time in days for Otto Market:

gif catalogue mapping complex en
1:1 mapping with fallback data fields: 1 marketplace data field, 1 PlentyONE data field with alternative(s)

In a 1:1 mapping with one or more fallback data fields, you map a PlentyONE data field to the marketplace data field. In addition, you specify one or more fallback data fields. This ensures that the system keeps looking if the first PlentyONE data field is missing or empty.

So this mapping specifies:

  • I want to fill the marketplace data field with the data from the selected PlentyONE setting.

  • If that data field is missing or empty for a variation, the first fallback data field is checked. The value of that fallback data field is exported instead.

  • If the first fallback data field is also missing or empty for the variation, the second fallback data field is checked. If a value is found, the value of the second fallback data field is exported for the variation etc.

Two separate fallback conditions are available:

Null (default)

The fallback data field is used if the data field above is mapped in the catalogue but not linked to the variation.

The condition "Null" is useful when you want to map fallback data fields for the following types of PlentyONE data fields:

  • SKU

  • Barcodes

  • Sales prices

  • Properties

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Empty

The fallback data field is used if the data field above is mapped in the catalogue and linked to the variation, but is empty.

The condition "Empty" is useful when you want to map fallback data fields for the following type of PlentyONE data fields:

  • PlentyONE data fields that are available for variations by default

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Note: Even if you assign one or more fallback data fields, the value of only one of those fields is exported. For each variation, the mapped PlentyONE data fields are checked in the order in which you mapped them. This means that if the first data field does not provide a value for a variation, the first fallback data field is exported etc.

Creating a 1:1 mapping with fallback data fields:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. In the list of PlentyONE data fields, click on the plus icon next to the PlentyONE data field that you want to map.
    → The fallback data field is added with the fallback condition "null".

  5. Alternative 1: To add the fallback data field with the fallback condition "null":

    1. Click on Confirm.
      → The fallback data field is exported if the data field above is not linked to the variation.

  6. Alternative 2: To add the fallback data field with the fallback condition "empty":

    1. To the left of the fallback data field, click on the cog ().
      → The window Data column settings is shown.

    2. For the setting Fallback condition, select the option Empty.

    3. Click on Save.
      → The fallback data field is added with the fallback condition "empty".

    4. Click on Confirm.
      → The fallback data field is exported if the data field above is empty for the variation.

Example: Fallback data field for SKU for Otto Market

This GIF shows you the mapping for the OTTO Market marketplace data field SKU. The PlentyONE data field SKU is mapped to this marketplace data field. The PlentyONE data field Variation ID is mapped as the fallback data field. The fallback condition "null" is applied automatically.

Result: The fallback data field Variation ID is exported if the data field SKU is not linked to the variation.

gif catalogue mapping fallback en
1:n mapping: 1 marketplace data field, several PlentyONE data fields

In a 1:n mapping, you map several PlentyONE data fields to the marketplace data field. You can link these data fields with a separator.

So this mapping specifies:

  • I want to combine these PlentyONE data fields during export so that the marketplace data field is filled with the data of these two or more PlentyONE settings.

Creating a 1:n mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. Click on Confirm.

  5. To the right of the mapped PlentyONE data field, click on Add data field ().
    → To the left, the list of available PlentyONE data fields again are shown in groups.

  6. Map one or several additional PlentyONE data fields to the marketplace data field as described above.

  7. Click on Confirm.

  8. To the very right of the row, click on Settings ().

  9. Select a separator from the drop-down list Separator or add a custom separator.

  10. Click on Save.

  11. Save () the catalogue.
    → The mappings are saved.
    → During the export, the content of the PlentyONE data fields is combined and exported as one field.

Own value mapping: 1 marketplace data field, the same value for all variations

You are sure that you want to export the same value for all variations of a catalogue for a marketplace data field? Then specify an own value. This own value is then exported for all variations.

So this mapping specifies:

  • For this marketplace data field, I want to export the value that I entered in the field Own value for all variations of this catalogue. The value you enter is always exported. The value overwrites the market value also in complex mappings where usually the value of the market is exported. As such, make sure you enter an own value that the market accepts for this marketplace data field.

Creating an own value mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the plus next to Own value at the top of the list.
    → The field for the own value is added to the view.

  3. Enter a value into the input field.
    → This value is exported for all variations.

Example: Diameter information

You want to export diameter information for some of your variations. The diameter is saved in centimetres for all your variations. Instead of creating a property for the unit and linking this property to the variations, you can enter the own value cm.

This is an example of how you can map an own value for the diameter unit:

gif catalogue own value en
Mapping with mathematical calculations: 1 Marketplace data field, the PlentyONE value is recalculated using the formula during export

Mathematical calculations allow you to change numerical values automatically during the export.

  • This function only works for data fields that contain numerical values.

  • This functionality is new and not available for all catalogue formats.

So this mapping specifies:

  • I want the numerical value of a PlentyONE data field to be recalculated during the export. Basic arithmetic operations are available for the formulas.

Recalculating numerical values:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. At the very top of the list, click on the plus icon next to Formula (calculate).
    → The data field Formula is added to the field on the right.

  3. Click into the data field.
    → The window Modify value is shown.

  4. Enter a numerical value or select a PlentyONE data field at the bottom right of the window to add it to the calculation (add).
    Tip: Use the search function. This helps you to find data fields quickly.

  5. Optional: If the symbol more_vert is shown in the data field, select the correct assignment for the data field.
    Tip: A number tells you how many assignments are necessary for the data field.

    1. Click on the icon more_vert.

    2. In the window shown, select the assignments from the drop-down list.

    3. Save the settings.

  6. Enter numbers and mathematical operators with the on-screen calculator or the keyboard.

  7. Save the settings.
    → The entered formula is displayed in the overview.
    → The calculation will be carried out in the next export.

7.3.2. Recommendations for limango data field mapping

To help you with mapping your data fields for the catalogue, we have created a list of recommended data field mappings. Note that these mappings are recommendations only. Depending on how you manage your item data, other mappings may be more appropriate than the recommendation given here.

  • Need more information about the PlentyONE data fields? All data fields are described on the manual page for the standard format Item (new).

7.3.3. NEW: Exporting specific items (optional)

Add filters to only export specific items. You can find the filters in the side navigation of the Data » Catalogues » [Open catalogue] » Filters menu.

For catalogues with marketplace formats, both template filters and user-defined filters are available. Template filters are applied automatically and cannot be deselected. User-defined filters can be set as needed to only export specific items.

Adding a filter:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Select the catalogue.
    → The overview opens.

  3. On the left in the side navigation, click on the Filters (filter_alt) tab.
    → The filter overview opens.

  4. Select a filter from the Select filter drop-down list.

  5. Click on Add filter (add) on the right.
    → The filter is added.
    → Depending on the filter, either a drop-down list or an input field is displayed.

  6. Select a value from the drop-down list.
    Or: Enter the desired value in the field of the filter you added.

  7. Save (save) the settings.
    → The filter is saved.

  8. Add additional filters as necessary.
    → Only records that meet all filter criteria is exported.
    Tip: The number next to the word Filter shows how many filters you have set. The template filters are not included in this number.

Available catalogue filters

For limango, the filters explained in Table 3 are available.

Table 3. Available catalogue filters
User-defined filters

Has a SKU

Add the filter and select the Account ID, Order referrer and Status.
Only variations for which an SKU was saved in the SKU section of the Item » Edit item » [Open item] » [Open variation] » Variation tab: Availability menu are exported.

Item IDs

Enter one or more item IDs. Separate multiple IDs using commas. Only variations with these item IDs are exported.

Variation is active

Add the filter and select Active or Inactive.

  • Active = Only variations which are activated in the Availability section of the Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings menu are exported.

  • Inactive = Only inactive variations are exported.

Visible for at least one market

Add the filter and select one or multiple markets.
Only variations for which one of the selected markets was added in the Markets section of the Item » Edit item » [Open item] » [Open variation] » Variation tab: Availability menu are exported.

Has tags

Add the filter and select one or multiple tags.
Only variations which are linked to all selected tags in the Tags section of the Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings menu are exported.

Linked to at least one property selection value

Add the filter and enter one or multiple values of a selection property.
Note: Enter the IDs of the selection values.
Only variations which are linked to at least one of the selected properties in the Item » Edit item » [Open item] » [Open variation] » Variation tab: Properties menu are exported.

At least one availability

Add the filter and select one or multiple availabilities.
Only variations which are activated for the selected availabilities in the Availability section of the Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings menu are exported.

Has flag 1

Add the filter and select one or multiple flags.
Only variations of items which have the selected flags are exported.

Has flag 2

Add the filter and select one or multiple flags.
Only variations of items which have the selected flags are exported.

Item created at

Add the filter, select a value and enter a date or time span if needed.

  • Today = Only items which were created today are exported.

  • Last = Enter a number to only export items which were created during the last days.

  • Time period = Enter a time span to only export items which were created during this time span.

  • = = Enter a date to only export items which were created on this day.

  • != = Enter a date to only export items which were not created on this day.

  • > = Enter a date to only export items which were created after this day.

  • >= = Enter a date to only export items which were created on and after this day.

  • < = Enter a date to only export items which were created before this day.

  • = Enter a date to only export items which were created before and on this day.

Item updated at

Add the filter, select a value and enter a date or time span if needed.

  • Today = Only items which were updated today are exported.

  • Last = Enter a number to only export items which were updated during the last days.

  • Time period = Enter a time span to only export items which were updated during this time span.

  • = = Enter a date to only export items which were updated on this day.

  • != = Enter a date to only export items which were not updated on this day.

  • > = Enter a date to only export items which were updated after this day.

  • >= = Enter a date to only export items which were updated on and after this day.

  • < = Enter a date to only export items which were updated before this day.

  • = Enter a date to only export items which were updated before and on this day.

Variation created at

Add the filter, select a value and enter a date or time span if needed.

  • Today = Only variations which were created today are exported.

  • Last = Enter a number to only export variations which were created during the last days.

  • Time period = Enter a time span to only export variations which were created during this time span.

  • = = Enter a date to only export variations which were created on this day.

  • != = Enter a date to only export variations which were not created on this day.

  • > = Enter a date to only export variations which were created after this day.

  • >= = Enter a date to only export variations which were created on and after this day.

  • < = Enter a date to only export variations which were created before this day.

  • = Enter a date to only export variations which were created before and on this day.

Variation updated at

Add the filter, select a value and enter a date or time span if needed.

  • Today = Only variations which were updated today are exported.

  • Last = Enter a number to only export variations which were updated during the last days.

  • Time period = Enter a time span to only export variations which were updated during this time span.

  • = = Enter a date to only export variations which were updated on this day.

  • != = Enter a date to only export variations which were not updated on this day.

  • > = Enter a date to only export variations which were updated after this day.

  • >= = Enter a date to only export variations which were updated on and after this day.

  • < = Enter a date to only export variations which were updated before this day.

  • = Enter a date to only export variations which were updated before and on this day.

Belongs to at least one Amazon product category

Add the filter and select one or multiple Amazon product categories.
Only variations which are mapped with the selected Amazon product categories in the Amazon section of the Item » Edit item » [Open item] » Tab: Multi-Channel menu are exported.

Item type

Add the filter and select Default, Set, or Multi-Pack.
Only variations of items with the selected item type are exported.

Variation is main variation

  • Is main variation = Only main variations are exported.

  • Is not main variation = Only variations which are no main variations are exported.

Variation has an image

  • Has an image = Only variations with images are exported.

  • Does not have an image = Only variations without images are exported.

Variation is in categories

Add the filter and select one or multiple categories. Note: Enter the category IDs.
Only variations which are linked to all selected categories in the Item » Edit item » [Open item] » [Open variation] » Variation tab: Categories menu are exported.

Variation is in one of these categories

Add the filter and select one or multiple categories. Note: Enter the category IDs.
Only variations which are linked to one or more of the selected categories in the Item » Edit item » [Open item] » [Open variation] » Variation tab: Categories menu are exported.

Item has manufacturers

Add the filter and select one or multiple manufacturers.
Only variations of items which have one of the selected manufacturers saved in the Basic settings section of the Item » Edit item » [Open item] » Tab: Global menu are exported.

Visible for markets

Add the filter and select one or multiple markets.
Only variations for which all of the selected markets were added in the Markets section of the Item » Edit item » [Open item] » [Open variation] » Variation tab: Availability menu are exported.

Bundle type

Add the filter and select the bundle type.

  • Not part of a bundle = Only variations of items which are neither the main variation nor part of a bundle are exported.

  • Bundle = Only items which are the main variation of a bundle are exported.

  • Part of a bundle = Only items which are part of a bundle are exported.

Visible for a client

Add the filter and select one or multiple clients.
Only variations which are visible for one or more of the selected clients are exported.

Visible for clients

Add the filter and select one or multiple clients.
Only variations which are visible for all of the selected clients are exported.

Linked to property selection values

Add the filter and enter one or multiple values of a selection property.
Note: Enter the IDs of the selection values.
Only variations which are linked to all of the selected properties in the Item » Edit item » [Open item] » [Open variation] » Variation tab: Properties menu are exported.

Has at least one tag

Add the filter and select one or multiple tags.
Only variations which are linked to at least one of the selected tags in the Tags section of the Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings menu are exported.

Variation has child variations

  • Has child variations = Only items with multiple variations are exported.

  • Does not have child variations = Only variations which do not have any variations except for the main variation are exported.

7.4. Providing information on manufacturer and EU-responsible person (GPSR)

The General Product Safety Regulation of the EU (GPSR) requires manufacturers and sellers to ensure the product safety of certain goods and to provide certain information for this purpose. This information includes details about the manufacturer and, in the case of manufacturers without an establishment in the EU, details about the responsible person within the EU. The GPSR regulation ensures that products are safe and comply with consumer protection requirements before being placed on the market.

In this chapter, you will learn how to add information on the manufacturer and the responsible person within the EU in PlentyONE to comply with the GPSR regulation.

If you export your items to limango via catalogues, you can add the information on the manufacturer and the EU-responsible person directly via the data field mappings.

7.5. Previewing item export data (optional)

When you have finished mapping all data fields, you can check the first five products of the export using the preview function.

Creating a preview in the catalogue:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Open the catalogue.

  3. In the toolbar at the top, click on Preview (preview).
    → In the Preview window, a preview of the first 5 products of the export is shown.

  4. Check the data. Was the data mapped as you expected?

  5. Optional: Click on Download data (file_download).
    → You can save a file with the first 5 products on your computer.

7.6. Activating the catalogue

You have set up limango in PlentyONE and created a catalogue for exporting your item data? Then start the export of your item data. To do so, activate the catalogues which should be exported to limango in the Data » Catalogues menu.

Activating the catalogue export to limango:

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the limango catalogue.

  3. In the Active column, move the toggle button to the right ().
    → The catalogue is active.
    → The catalogue data is exported to limango once a day during the night.
    Note: Only variations that were modified within the last 4 hours will be exported to limango.
    Tip: Go to Data » Catalogue export status for information about the status of the export.

7.7. Triggering a complete item export

When you make changes to the mappings in the catalogue, a complete item export is triggered. This export is started when the next regular run is due. In other words, the export is not started when you save your changes.

8. Deleting items on limango

If you do not want to offer a variation on limango any longer, then you can either delete the market availability for limango or deactivate the variation. The variation will then be excluded from the nightly item export to limango and it will be deleted on limango.

Note: Variations will also be excluded from the item export and be deleted on limango if they cannot be validated. To find out why a variation could not be exported, check the validation file in the Data » Log menu.

Deleting items on limango:

Alternative 1:

Deleting the market availability:

  1. Go to Item » Edit item » [Open item] » [Open variation] » Variation tab: Availability.

  2. Delete () the availability Limango.

  3. Save () the settings.

Alternative 2:

Deactivating the variation:

  1. Go to Item » Edit item » [Open item] » [Open variation] » Variation tab: Settings.

  2. In the Availability section, remove the checkmark for the option Active.
    Note: Note that the variation can possibly not be sold on other markets either if it is deactivated.

  3. Save () the settings.

9. Preparing delivery notes for limango

Delivery notes for limango orders also serve as return slips. Delivery notes for limango orders must contain the following information:

  • limango letterhead

  • Your company details

  • Return note required by limango

  • limango customer number

  • limango order number

For limango delivery notes, a DocumentBuilder template is available that already contains the limango logo and the return note required by limango. The customer number and order number are automatically inserted via variables.
Creating document templates with the DocumentBuilder is described in the DocumentBuilder manual section. We only explain how you upload and personalise the DocumentBuilder template here:

9.1. Uploading the DocumentBuilder template

Proceed as described below to upload the DocumentBuilder template for delivery notes to PlentyONE.

Uploading the DocumentBuilder template

  1. Save the DocumentBuilder template for delivery notes to your computer:

  2. Open the Setup » Documents » DocumentBuilder menu.
    → The DocumentBuilder overview opens.

  3. In the top left corner, click file_upload (Import template).

  4. Select the Lieferschein_DE_Limango.tpl template from your computer.

  5. Click Open.
    → The template is imported.

9.2. Personalising the DocumentBuilder template

Before you can use the DocumentBuilder template for delivery notes, you need to add your company data.

Personalising the DocumentBuilder template for delivery notes:

  1. Open the Setup » Documents » DocumentBuilder menu.
    → The DocumentBuilder overview opens.

  2. Click Search (search) to list the existing templates.

  3. Click the Lieferscheine (DE) Limango template.
    → The template opens.

  4. Click Open Editor (edit).
    → The editor opens and the widgets are loaded.

  5. Click the section with Firma Partner,Straße, PLZ Ort below the header.

  6. Click Text (edit).
    → The text editor opens.

  7. Replace the placeholder text "Firma Partner,Straße, PLZ Ort" with the following company data:
    [your company name], [the street and house number of your company], [the postcode and city of your company]

  8. After entering your data, click on the greyed-out area below the input field.
    → The text editor is closed.

  9. Click the section with the heading Lieferschein.

  10. Click Text (edit).
    → The text editor opens.

  11. Replace the placeholder "xxx" with the name of your company.

  12. After entering your data, click on the greyed-out area below the input field.
    → The text editor is closed.

  13. Click the section with the heading Du willst etwas zurücksenden?.

  14. Click Text (edit).
    → The text editor opens.

  15. Replace the two placeholders "xxx" with the name of your company.

  16. After entering your data, click on the greyed-out area below the input field.
    → The text editor is closed.

  17. Click on the Footer section below.
    → The text Load and edit content is displayed.

  18. Click Load and edit content.
    → The content of the footer is displayed.

  19. Click the section Firma Partner, Amtsgericht/HRB, Ust.-IdNr at the bottom left.

  20. Click Text (edit).
    → The text editor opens.

  21. Replace the placeholder text "Firma Partner, Amtsgericht/HRB, Ust.-IdNr" with the following company data:
    [your company name]
    Amtsgericht [your court of first instance]/HRB [your HRB]
    USt.-IdNr. [your VAT no.]

  22. After entering your data, click on the greyed-out area below the input field.
    → The text editor is closed.

  23. Save (save) the DocumentBuilder template.
    _Tip:Before you activate the template for delivery notes, you can display a *preview (visibility) of the template.

limango documentbuilder placeholder
limango documentbuilder footer

10. Automating order processing

Automate the following aspects of limango order processing:

  • Automatically notify limango about cancellations (How?)

  • Automatically inform limango when items have shipped (How?)

  • Return management (How?)

10.1. Automatically sending cancellations

Set up an event procedure to automatically inform limango of cancellations.

Note: An order cannot be cancelled any longer after it was shipped and a shipping confirmation was sent.

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 4.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 4.

  7. Select the setting Active ().

  8. Save () the settings.

Table 4. Event procedure to notify limango of cancellations

Setting

Option

Selection

Event

Order change: Status change

Select a status, for example [8] Cancelled.

Filter

Order > Referrer

limango

Procedure

Plugins > limango: Send order cancellation to limango

10.2. Setting up automatic shipping confirmations

Shipping confirmations for limango must contain a tracking number. In addition, the shipping service provider of the order must be linked to the limango shipping service provider correctly in the plugin settings.

Create two event procedures to automatically confirm the shipping to limango:

  • Event procedure 1: Send shipping confirmation to limango (How?)

  • Event procedure 2: Book outgoing items (How?)

10.2.1. Workflow for automatic order confirmations

The workflow for automated shipping confirmations depends on whether or not the order’s shipping service provider is correctly linked to the limango shipping service provider in the plugin settings.

Case Procedure

Shipping service provider linked

  • A package number is saved for the order.

  • The event procedure Send shipping confirmation to limango checks if the shipping service provider is linked correctly.

  • The procedure Send shipping confirmation to limango is triggered: A shipping confirmation is sent to limango.

  • The order is moved to the status for Order status for orders with shipping carrier mapping (> 5 - < 7).

  • Only procedure 1 of the event procedure Book outgoing items is triggered.
    → The outgoing items are booked.
    No second shipping confirmation is sent to limango.

Shipping service provider linked correctly

  • A package number is saved for the order.

  • The event procedure Send shipping confirmation to limango checks if the shipping service provider is linked correctly.

  • The order is moved to the status for Order status for orders without shipping carrier mapping (> 5 - < 7).

  • You check and correct the mapping for the shipping service provider in the plugin settings.
    Tip: Go to Plugins » Plugin set overview » [Open plugin set] » [Open limango plugin] » Shipping service provider to correct the mapping.

  • You move the order into the status for Order status for orders with shipping carrier mapping (> 5 - < 7).

  • Procedure 1 of the event procedure Book outgoing items is triggered.
    → The outgoing items are booked.

  • Procedure 2 of the event procedure Book outgoing items is triggered.
    → A shipping confirmation is sent to limango.

10.2.2. Automatically sending shipping confirmations to limango

For event procedure 1 for shipping confirmations, set up the event procedure described in Table 5.

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 5.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 5.

  7. Select the setting Active ().

  8. Save () the settings.

Table 5. Event procedure 1 for shipping confirmations
Setting Option Selection

Event

Order change > Package number

Filter 1

Order > Order type

Order
Delivery order

Filter 2

Order > Referrer

limango

Procedure

Plugin

Send shipping confirmation to limango

For event procedure 2 for shipping confirmations, set up the event procedure described in Table 6.

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 6.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 6.

  7. Select the setting Active ().

  8. Save () the settings.

Table 6. Event procedure 2 for shipping confirmations
Setting Option Selection

Event

Order change: Status change

Select the status for Order status for orders with shipping carrier mapping (> 5 - < 7)
Go to Plugins » Plugin set overview » [Open plugin set] » Open limango plugin » Order status to set this status.

Filter 1

Order > Order type

Order
Delivery order

Filter 2

Order > Referrer

limango

Procedure 1

Order

Book outgoing items

Procedure 2

Plugin

Send shipping confirmation to limango

10.2.3. Adding return tracking information

You can add return tracking information, including return shipping service provider and return tracking number, to the shipping confirmation. limango will use this information to track returns and to streamline return processes.

Information on adding return tracking information
  • The return tracking information will only be included in the shipping confirmation if both the return shipping service provider and the return tracking number are saved in your PlentyONE system. If any of this information is missing, then the return tracking information will not be sent.

  • If you already save return tracking information in your PlentyONE system, then you do not have to carry out any additional settings for return tracking information to be included in the limango shipping confirmation.

  • Adding return tracking information to the shipping confirmation is optional. If you do not save return tracking information in your PlentyONE system, shipping confirmations will still be sent to limango as usual.

10.2.3.1. Requirements for adding return tracking information

Depending on whether you send shipping confirmations for orders or for delivery orders, return tracking information will be sent to limango if the following requirements are met:

Alternative 1: Shipping confirmations are sent for orders

  • If the return tracking number is saved at the order itself, then the return tracking number will be included in the shipping confirmation.

  • If no return tracking information is saved at the order, your PlentyONE system will check whether a return order exists for this order. If a return order exists und if this return order contains the return shipping service provider and the return tracking number, then the return tracking information will be sent to limango.

Alternative 2: Shipping confirmations are sent for delivery orders

  • If you work with delivery orders, then return tracking information will be included for the individual order items.

  • Your PlentyONE system first checks whether the delivery order contains return tracking information. If the delivery order does not contain return tracking information, the system checks whether a return order exists for the original order. If a return order exists, then the order items from the return order will be aligned with the order items from the delivery order.

10.3. Setting up return management

Now set up the processing of returns for limango.

10.3.1. Workflow for returns

The delivery note also functions as the return form. The workflow of limango returns is as follows:

  1. Customers return the items to you.

  2. You process the return in PlentyONE.
    Note: A return can only be issued if the order was shipped and a shipping confirmation was sent.

  3. You notify limango when you have received the items.

  4. limango reimburses the customer.
    Note: When you notify limango that the return is completed, limango triggers a credit note and the buyer receives a refund. As such, only notify limango about completing the return after you have received and checked the returned items.

10.3.2. Automatically notify limango about completed returns

Set up an event procedure to automatically inform limango when you have completed processing a return.

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 7.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 7.

  7. Select the setting Active ().

  8. Save () the settings.

Table 7. Event procedure for automatically sending returns to limango
Setting Option Selection

Event

New return

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

limango

Procedure

Plugins > Send return notification to limango
Note: The procedure Send return notification to limango triggers a credit note. This means that customers will receive a refund. Thus, make sure the event procedure is only triggered after you have received and checked the returned items.

11. Shipping costs

The shipping costs are defined in your contract with limango. limango then saves it in the limango backend. As such, you need to contact your limango partner manager if you want to change the shipping costs. As such, there are no settings for the shipping costs in PlentyONE.

12. Freight shipping service

If you want to offer freight shipping for your products, you have to enter the appropriate PlentyONE shipping profile ID for each shipping option in the plugin settings under Shipping carriers. This mapping is required to correctly import orders with freight shipping into your PlentyONE system.
In addition, you have to map the 2-Man Handling service data field in the limango item data catalogue according to the specifications in the recommendations for data field mapping.

13. Troubleshooting and FAQ

Did something go wrong? This chapter provides troubleshooting information. (last updated 30/07/2022)

13.1. Error messages in the catalogue

Select a valid export format.

Problem:

  • You probably copied a limango catalogue with the old format limango and changed the format to the new format limango new. Now, the error message Select a valid export format is shown and you cannot save the catalogue.

Solution:

  1. Open the Settings view.

  2. Navigate to the section Format settings.

  3. For the setting Format, select the option XML.

  4. Save the catalogue.

Background: From plugin version 1.4.3., the new format limango new is used. This format is based on XML and not on CSV like the old format.

13.2. Viewing log entries

The Data » Log menu contains a history of processes that run via the limango interface. Note that integrations and identifiers are only shown in the drop-down lists as filters after the process has run at least once.

For limango, the following filters are recommended:

  • Integration » limango

Filtering and checking log entries
  1. Go to Data » Log.

  2. In the toolbar, click on tune.

  3. Select appropriate filters from the drop-down lists.

  4. Optional: Select filters for dates and/or times to only show entries from a specific period.
    Tip: For information about the filters, refer to the Data log page of the manual.

  5. Click on Search ().
    → The results are shown.

  6. Check all entries for the levels warning and error.
    Tip: Click on the entry to see details.

13.3. Item export: Error messages in the log

When this error occurs, variation data is still exported to limango. Only variations with this error are not exported.

No valid image found

Problem:

  • The variation must be linked with at least one image.

Solution:

limango images linked
Size must be filled in

Problem:

  • The referrer limango is not activated for the images.

Solution:

  • Activate the referrer limango for the images of the variation that you want to export to limango.

limango images activate referrer
Size muss ausgefüllt sein

Problem:

  • No valid size was found for this variation. Most likely, the sizes of the variation do not match the data fields mapped in the catalogue.

Solution:

  1. Open the variation and check the following:

    • What size does the variation have? Is the size defined with an attribute or a property?

  2. Open the catalogue and check the following:

    • Which PlentyONE data field have you mapped to this size for the marketplace data field Size?

    • Is the value of the attribute or property that you mapped also saved for the variation?

Tip: The value onesize must be exported for products without a specific size. Did you do that correctly?

message:„Error 1824: in xml file (Line:467), (Column: 0):Element ‚{http://schema.limango.de}Stock‘: ‚10.25‘ is not a valid value of the atomic type ‚xs:nonNegativeInteger‘ Trigger:„cli: artisan cron:run“

Problem:

The stock can only be specified as whole numbers. However, you probably exported the stock information for the variation as a decimal number.

Solution:

  • Check the variation. Deactivate the referrer limango or specify the stock in whole numbers.

13.4. Check list: Why is my variation not exported?

To export a variation to limango, this variation has to meet the following requirements:

Is the order referrer active?
  1. Go to Setup » Orders » Order referrer.

  2. Is the option limango active?

  3. If necessary, activate this order referrer.

  4. Save () the settings.

Have you activated the variation?
  1. Go to Item » Items » [Open item] » [Open variation].

  2. In the Availability and visibility section, activate the option Active.

  3. Save () the settings.

Is the market availability active?

The variation must be available for the market.

  1. Go to Item » Items » [Open item] » [Open variation].

  2. In the Sales channels section, click Add sales channels.
    → The window Add sales channels opens.

  3. In the drop-down list Sales channels, select the option limango.

  4. Click Apply.
    → The sales channel is added.

  5. Save () the settings.
    → The variation is available for limango.

Does the variation have positive net stock?
  1. Go to Item » Items » [Open item] » [Open variation].

  2. Expand the section Stock ().
    → The net stock per warehouse is shown in the Net stock column.

Are the sales price and price settings correct?

Check the sales price:

  1. Go to Setup » Item » Sales prices.

  2. For the filter Referrer, select limango.

  3. Click on Search ().
    → The sales price that is active for the referrer is shown.

  4. Check the settings of the sales price.

  5. Make any necessary corrections.

Check the price:

  1. Go to Item » Items » [Open item] » [Open variation].
    → The sales prices are shown in the Sales prices section.

  2. Check the following settings:

    • Is the sales price for the referrer linked?

    • Does the price for the referrer have the correct price?

  3. Make any necessary corrections.

Is each mandatory field for limango mapped to a PlentyONE data field?

At the least the mandatory fields for the market have to be mapped to PlentyONE data fields. In the catalogue, mandatory fields are marked with an asterisk.

Are the catalogue filters set correctly?

In the menu Data » Catalogues » [Open catalogue] » Filter, you can set filters to export only specific variations. If any filters are active, only records that meet all the filter criteria are exported. So when the export does not behave as expected it’s worth checking the filter settings.

Important: Template filters are required by the market and set automatically. You cannot remove these template filters.

Checking filters:

  1. Go to Data » Catalogues » [Open catalogue].

  2. On the left in the side navigation, click on the view Filters (filter_alt).
    Tip: The number next to the word Filter shows how many filters have been set. The template filters are not included in this number.
    → The filter overview opens.

  3. Check the logic of the filters.

  4. If necessary, remove one or more filters.

  5. Save (save) the settings.

Was the variation data updated in the last 24 hours?

Problem:

Only variations that were updated in the last 24 ours are exported.

Solution:

  • For one variation: Change the variation. For example, add a new sales channel and save the variation. Then delete the sales channel and save the variation again. By doing this, the time stamp of the variation is updated. The variation is included in the next export.

  • For a lot of variations: For example, use the group function or batch processing to add a new sales channel for all variations with the referrer limango. Then delete the sales channel again. By doing this, the time stamps of the variations is updated. The variations are included in the next export.

Is the catalogue active?

The catalogue that the variation is associated with must be activated.

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the limango catalogue.

  3. In the column Active, activate the toggle ().

Couldn’t find any errors?

You have confirmed that the above settings are correct but the variation is still not exported? Then check the data log.

  1. Go to Data » Log.

  2. Use the following filters:

    • limango
      **

  3. Click on Search ().

  4. Check all entries for the levels warning and error.

  5. Open the logs containing the message Variation invalid.
    → The the variation ID and the reason for the rejection or the missing characteristic are shown.

  6. Correct the variation data.

Check the validation file

If none of the errors listed above applies to your variation, then check the validation file in the log. This file can be downloaded in the Data » Log menu. You will find the file under Validation log. The validation file contains a table which lists variations and the corresponding errors.

  1. Go to Data » Log.

  2. Use the following filters:

    • Integration: Limango

  3. Click on Search ().

  4. Check all entries with the level error.

  5. Open the log entry with the message Validation log.
    → The log entry contains a link to the validation file. Click on the link to open the file.
    → The validation file contains a list of all variations and the corresponding error messages.

  6. Check and correct the variation data.