In this documentation, you will discover all the information required for successful inventory management between Plentymarkets and your Shopware 6 shop.
Before initiating the export, we recommend exporting all the data mentioned in the #plentymarkets data export. This ensures that all properties, child variations, categories, etc., will be assigned during the export.
Export of items #
To export items from plentymarkets to Shopware, we utilize the Catalogue, located under Data > Catalogues in plentymarkets. The primary catalog should have “PlentymarketsShopwareCore” as the type, and the format should be the name of your connected Shopware system from the configuration.
Add items to the Catalogue. #
Markets and Client Filters #
A catalog will be generated based on your Shopware configuration, taking into account the selected referers and clients (mandants) for sales channels. This will serve as a filter to determine which variations should be included in the catalogue. You can review the filters on the Catalogue, as illustrated in the image.
To include a variation into the catalogue for export or update, ensure that you have a referrer (configured for your Shopware sales channel) and a client assigned to Markets and Client on your variation. This is how you can control the visibility of the variation in specific sales channels on Shopware.
Timestamps #
For efficiency in the catalogue, we include only items updated since the last export, and the catalogue exports items every 60 minutes. This generally works well when adding properties, changing texts, adding new referrers, etc. However, if you want to update/export a variation and are unsure if the variation has the correct timestamp, you can update the timestamp by following these steps:
- In the Plentymarkets Item view, please select the variations you wish to update and click “Variation group function” button.
- Check the “Update timestamp for market exports” checkbox and click “Execute.”
Following this, the “updated_at” timestamp should be refreshed, and the selected items will be incorporated in the subsequent Catalogue export.
Data mappings #
Within the catalog, you can update a majority of the data. We have made it as user-friendly as possible by naming sections the same as you would see in the Shopware product edit view, ensuring that you find the same fields for data. We have also pre-defined fields with Plentymarkets’ standard values to save you time. However, you can always change values, add alternative values, or modify value combinations as needed.
For a better understanding of how catalogues work in general on Plentymarkets, you can find more information here.
Furthermore, for a clearer comprehension of where information from plentymarkets will be configured in Shopware and its intended purpose, you can refer to the documentation provided by Shopware.
Product Section #
This section corresponds to the “General information” section in the Shopware product. Here, you can map this data.
Active #
This field determines whether your product should be active on Shopware. By default, we recommend using the field from the plentymarkets variation settings:
Title #
This field is responsible for providing the name of your product on Shopware, and it is a required field. In this catalogue, you need to manage values in the language selectedas Shopware shop language. Instructions on managing values in multiple languages will be covered later in this documentation. For the title, we recommend using the standard “Name1” value from plentymarkets as the name on Shopware.
Description #
For this field, please provide the description value for your Shopware product. As the default value, we recommend using the value of “ItemText” from the plentymarkets item configuration.
Product number #
This is a required field, and here you need to provide a value that you would like to use as the identifier for your product number on Shopware. We default to recommending the use of the Variation Number.
Prices section #
In this segment, you can define values for various types of prices. While most of the price-related data is configured automatically, in this catalogue, you’ll need to input values for purchase prices.
Tax rate #
The tax rate is automatically determined based on your tax rate mapping in the Basic Settings configuration assistant and the value set on the variation. Here is the guide on how to map tax rates. The connector automatically retrieves the value from the VAT field in the Cost section of the Variation settings.
Price #
The plugin automatically includes net and gross prices during the export. This cannot be modified in the Catalogue; you must configure your price sales profile appropriately for a accurate price data export.
To configure the sales price profile, navigate to plentymarkets Setup > Item > Sales Prices. Here, you’ll find all available sales price profiles in your plentymarkets shop. Choose the one that will be responsible for price data on Shopware or create a new profile specifically for Shopware. For more information on working with sales price profiles in plentymarkets, refer to this documentation.
In the sales price profile configuration, make sure that nothing is selected for the price type. You also need to activate referrers and mandants responsible for your Shopware sales channel configuration. These are the necessary conditions for smooth price management via the connector. During the Catalogue export, the actual price in Gross and Net will be taken from the Variation and set on Shopware. Therefore, ensure not only to configure the sales price profile but also add this profile to the Variation.
List price #
Similar to the Price, the List Price is set automatically if the configuration is done correctly. You need to set up another sales price profile for the List Price. This time, for “Price Type” select “RRP” Also, don’t forget to add the referrer and client responsible for your Shopware Sales Channel configuration.
After configuring the sales price channel profile, please remember to add and use this sales price profile on your variation. This ensures that both gross and net amounts for the List Price will be set on Shopware during the export of the catalogue for that variation.
Purchase price #
The purchase price is not exported automatically, and you need to set this value in the catalogue. In the catalogue, you will find two fields: Purchase Price (Net) and Purchase Price (Gross).
By default, we recommend using the Net purchase Price” value from the Variation settings in the “Costs” section for the “Purchase price (net)”
For the gross amount of the purchase price, you can assign any value you prefer or simply ignore this field, as it is not mandatory.For the gross amount of the purchase price, you can assign any value you prefer or simply ignore this field, as it is not mandatory.
Cheapest price #
The 30 days lowest price is automatically exported; this data is accessible in plentymarkets, and we will transfer this information to Shopware from your configured sales price profile for the regular price.
Deliverability #
Within this section, you can establish mappings for data related to your stock availabilities, delivery times, and other relevant information.
Stock #
This field manages your stock data. You must select a warehouse from which the stock will be sourced and sent to Shopware. If necessary, you can utilize the Formula feature of the Catalogue to combine stock from multiple warehouses.
Stock Buffer #
The Stock Buffer pertains to additional inventory maintained as a precaution against manufacturing delays or unexpected spikes in demand. Accurately determining the appropriate amount of buffer stock helps minimize carrying costs while ensuring timely fulfillment of customer orders.
In this field, you can input a numerical value representing the desired buffer stock. This amount will be deducted from the actual stock of the variation.
Clearance sale #
This field determines whether the product remains visible on Shopware even when the stock is unavailable. We recommend using the default value, “Available automatically if net stock is positive” from the Variation settings.
Restock time #
In this field, you can specify the number of days required to restock an item.
Delivery time #
Delivery time is set automatically based on the selected value on Variation. Initially, Delivery times need to be exported from Plentymarkets to Shopware. For more information on how to export delivery times, refer to this documentation. Once the export of delivery time is completed, the value will be automatically reflected based on the availability settings of the variation.
Minimum order quantity #
In this field, you can set a value indicating the minimum number of items that can be ordered. By default, we recommend using the value from the “Min. Order Quantity” field in the Variation settings.
Maximum order quantity #
This field is similar to the previous one, just in this field you simply need to specify the maximum allowed number of items per order.By default, we recommend using the value from the “Max. Order Quantity” field in the Variation settings.
Purchase steps #
This configuration dictates the manner in which the quantity of items in the shopping basket will increment. For instance, if the value is set to 2, customers can make purchases in quantities such as 2, 4, 6, 8, 10, and so on.
By default, we utilize the “Interval order quantity” configuration from the Variation settings.
Visibility & structure #
In Shopware 6, this section defines the product’s activation status and specifies the assignment of categories and sales channels to determine its visibility.
Sales Channels #
Sales channels are automatically designated upon the successful export of your variations from plentymarkets to Shopware. The determination of which sales channel should be assigned is controlled by referrers. For more information on how to manage this process, refer here.
Categories #
During the product export process, categories are automatically assigned/unassigned to your Shopware products. We assign the same categories that are already assigned in plentymarkets if they are exported to Shopware first. Instructions on exporting your plentymarkets categories to Shopware can be found here.
Tags #
The connector automatically handles the assignment/unassignment of tags during product export/update. The connector is capable of tracking and managing assigned tags exclusively for those that have been exported. Therefore, it’s important to ensure that tags are exported first. Instructions on exporting tags to your Shopware shop can be found here.
Search keywords #
In Shopware, you have the option to include keywords for each product, enhancing the ease of finding the product through the search bar on your webshop. We recommend using SEO keywords for this purpose, but feel free to input any text value you prefer for search keywords.
Labelling #
In this section, you will discover three fields for specifying the EAN, manufacturer code, and release date.
EAN #
Please enter the EAN/GTIN code for your variation in this field.
Release Date #
You can use the release date to define when a product can be purchased in the shop.
If the time you have set is not yet reached, a corresponding message will be displayed on the product detail page to inform the customer when the product can be purchased. For this purpose, we suggest utilizing the “release date” feature from the Variation settings.
Manufacturer number #
This one is quite straightforward here you need to provide manufacturer number of your product.
By default, we recommend using the value “Variation Number.”
SEO section #
In this catalog section, you can input SEO-related data for plentymarket, which will then be imported into the Shopware SEO tab. Additional information about the purpose of these fields can be found in the Shopware documentation.
Meta title #
Within this field, you can furnish a meta title for Search Engines. By default, we recommend using the value from Name1, as it should be the shortest and most descriptive title for your product.
The meta title should currently not exceed approx. 70 characters, otherwise it could be truncated in the listing of search engines and similar.
Meta Description #
In this field, you can input a description for search engines. The meta description length should ideally be between 130 to 160 characters. If the description exceeds 160 characters, it may get truncated on the search results page. While plentymarkets Item Texts include this field, we recommend using it as the default value.
SEO keywords #
Much like the “search keywords” field, where you can input keywords for internal searches, here you can provide keywords for the product targeted at search engines. By default, we recommend mapping the “Meta Keywords” field from Item Texts.
SEO URL #
In Shopware, within the SEO settings, you have the ability to define the structure for the SEO URLs of the product detail pages. You can utilize a variety of variables for this purpose. Once you’ve created a template in Shopware, you can replicate the same structure in this field and assign SEO URLs to your items accordingly. You can find more information on how to work with SEO URL templates on Shopware here.
Measures & Packaging #
In this catalog section, you can include all relevant information describing your product size, selling unit, etc. You can find more details about these fields on Shopware here.
Width #
In this field, you need to provide the width value of your product in millimeters. As a default, we recommend using the width value from the Dimensions section of variation.
Height #
In this field, please provide the height value of your product in millimeters. We recommend using the “Height” from the “Dimensions” section of the variation.
Length #
In this field, please provide the lenght value of your product in millimeters. We recommend using the “Lenght” from the “Dimensions” section of the variation.
Weight #
Please enter the weight of your product in grams in this field. We suggest using the “Net weight” for this value.
Selling unit #
The selling unit represents the quantity of the product , such as 700 ml, 500 g, or 1 piece. While scale units will be automatically mapped and maintained, for the selling unit in the catalogue, we recommend using the “Content value” from your variation.
Packaging unit and packaging unit plural #
The packing unit refers to how the product is delivered, such as in a carton or bottle, and is displayed in the quantity selection field. If the plural form of the packing unit differs from the singular, it can be specified separately. For example, for the packing unit “bottle,” the plural form would be “bottles,” and this information will be displayed in the quantity selection field when the quantity is greater than one. In the background, we utilize the Unit Name as default value for both fields. However, if you wish to override these values, you can input your own value in these fields.
Basic Unit #
In Shopware, the basic unit is necessary to compute the unit price of a product. The value entered as the base depends on the chosen scale unit. The unit price is calculated as follows: (product price * basic unit) / selling unit. If the selling unit and basic unit share the same value, the unit price is not displayed. Here, you need to provide the value for the Basic Unit, and we recommend using the “Units contained” value from your Variation configuration.
Custom fields #
In Shopware, you have the option to create custom fields, and certain plugins may also add custom fields. This is an excellent method for providing additional information about your inventory, orders, and so on.
For further details on custom fields in Shopware and how to utilize them,you can find here
With our connector, you can directly input values for these custom fields from plentymarkets into the catalogue. Our plentymarkets-Shopware connector plugin is compatible with these types.
- int
- float
- text
- html
- select
Once you save the configuration assistant, custom fields are registered on the Catalogue template. If you’ve added new custom fields on Shopware but can’t see them on the Catalogue, simply finalize your configuration assistant. This action will synchronize the latest values from your Shopware shop and update the Catalogue template.