In this section, you will find all the essential information regarding the configuration of plentymarkets | Shopware 6 connector, covering both the main settings and customizations.
Connecting a shopware shop. #
In the initial step, connect your Shopware 6 shop with plentymarkets, enabling the plugin to fetch essential information and push new data to your Shopware environment. To accomplish this, you first need to generate integration keys on your Shopware store.
Integration key generation #
Within your Shopware admin panel, navigate to Settings > System > Integrations to generate your API access for the plentymarkets Shopware connector.
Enter the integration name (e.g., Plentymarkets) and activate the toggle for Administrator. Copy and save the generated Access Key ID and Secret Access Key, as these values will be required in the following steps.
Assistant to connect a shopware shop #
To establish a connection between your Shopware shop and Plentymarkets, you can use the assistant located on Plentymarkets under Setup > Assistant > {name of the plugin set where the plugin is installed}.
In this assistant, simply click the “+” sign and provide the name of your shop for better identification.
Once this is completed, proceed to the Authorization step of the assistant.
Authorization #
In this step, you need to provide the domain of your Shopware shop, along with the access key ID and secret access key generated in the previous step. Select the path version that corresponds to the current version you are using for your Shopware shop.
Once you have completed this, you can finish the assistant and skip the remaining steps. Save the configuration. Your Shopware shop should now be successfully connected. Proceed with other tasks necessary for configuration.
Navigate to the “Licenses” tab to view the license version and gain an overview of the remaining steps required to successfully connect Shopware.
Basic settings for shop configuration. #
Once Shopware is connected, you can proceed with the configuration assistant to set up the basic configuration for the newly added shops. The Configuration Assistant is located here:
When accessing this assistant, please click the “+” sign and select your added Shopware store for which you intend to create a configuration.
General configuration. #
In this stage, you will find assistance to set up the general configuration
System language #
Here, we will retrieve all active languages from your Shopware shop. You are required to choose the default language, which will be utilized as the primary catalogue for inventory export language and other data that may be multilingual.
Order comments #
Our Shopware connector will generate order notes containing useful information or notifications about any issues encountered. Note creation is restricted to Plentymarkets users. Therefore, in this selection, choose a Plentymarkets user who should be assigned as the author of order notes.
Cancellation States for Orders #
At times, buyers may cancel their orders on Shopware, and this cancellation is promptly reflected in the plentymarkets order imported from Shopware. To provide complete flexibility for each customer through individual workflows, you can specify in this section the status in which the Connector should update the order if it was canceled on Shopware.
There are two scenarios:
- One scenario is when a customer cancels an order after the payment is completed. Therefore, for the input “Above or equal 5.0,” choose the status in which you would like to update the order in case a customer cancels an order in this scenario.
- The second scenario occurs when a customer cancels an order that is not yet paid. According to plentymarkets standards, this order should still be in a status below 5.0. For the input “Below 5.0,” please choose an order status in which the order should be updated in this scenario. We recommend using status 8.0 or 8.1
Moreover, there is an input labeled “Block Order Status Changes.” For this input, you need to select an order status. If, during cancellation, the plugin finds the order in the status you have chosen, it will take no action.
Order filters #
In this section, you can activate and configure order filters. This feature allows you to determine the conditions under which orders should be imported into plentymarkets. By default, all new orders are imported into plentymarkets after creation.
Upon activating the toggle for Order filters, an additional section will become available, allowing you to select specific statuses for both order and delivery. The filters work in combination, so choose what fits your workflow perfectly. Additionally, Payment status filters are also possible, but they will be visible in another step. For example, you can import only paid orders, and so on.
Image configuration #
In this section, you can configure which images should be exported to Shopware. The standard approach is that plentymarkets images have availabilities, where you can select referrers. Therefore, if you want to export specific images, ensure that the referrer responsible for Shopware is added to the image. However, if this filtration is not necessary for you, you can activate the toggle “Filter: no referrers.” If this toggle is on, we will skip the image availabilities check.
In plentymarkets, images can either be assigned to variations or not. By default, we always export only images assigned to variations. However, with the toggle for the filter “Filter: no active variation images,” you can enable the option that, if there are no images assigned to variations, connector can use the images uploaded for the item.
Overwrite Variation Activity #
Plentymarkets and Shopware differ in how products with child variations are visualized. For instance, if the main product is inactive in Shopware, you won’t be able to see any child variations. In Plentymarkets, some customers have a structure where the main variation is inactive, and only child variations are active. To prevent any issues and the need for reconfiguration, we have this section. If the toggle is activated, we will “fake” the main variation activity if at least one of the child variations is active.
Copy Main Variation #
In Plentymarkets, child variations are created based on attributes, which are visible as potential selections of combinations in Shopware. However, some customers also have attributes on the main variation. Due to differences between Plentymarkets and Shopware as systems, attributes from the main variation are not visible as selections on the product in Shopware. To address this, we have this section, which creates a duplicate of the main variation as a child variation on Shopware with the appendix “_COPY,” ensuring that all possible combinations are visible on Shopware.
Please note that this will only work if you are uploading your variation from scratch. If you initially uploaded the variation without activating this toggle and now wish to make the change, you need to remove the product from Shopware, delete SKU references from Plentymarkets, activate the toggle, and reupload the variation.
Cross-selling items export #
With our connector, you can export cross-selling items configured in your Plentymarkets. Items will be grouped on Shopware in the same way as they are in Plentymarkets, into groups such as “Similar,” “Accessory,” “Replacement Part,” and “Item Bundle.” Certainly, all variations configured in cross-selling should be exported to Shopware first. Therefore, in this section, you can enable or disable this feature.
Category layout. #
Our connector exports Plentymarkets categories to the Shopware system. When exporting categories, we can assign a specific layout for your main and sub-level categories. All available layouts will be loaded from your Shopware shop in this selection, so feel free to choose the layout you would like to assign. Keep in mind that this will affect all categories exported through the connector. If you want to have multiple different layouts per main or sub category, you need to do this manually in Shopware. In the configuration, please select “Empty” as the value, so the connector will not overwrite your changes.
Mandants & Referrers #
Within our connector, the management of data to be exported to Shopware or later imported into Plentymarkets is facilitated through referrers and mandants. In this step, you have the option to create a configuration that specifies which sales channel of Shopware is associated with a particular Plentymarkets referrer and mandant. This allows you to control, for example, which items should be listed in specific sales channels of Shopware. Additionally, when importing orders from Shopware, a referrer assigned to the sales channel is set, providing information about the source sales channel from which the order was imported into Plentymarkets.
Here, you can easily click “+” to add a new configuration. In the first column, select the sales channel of your connected Shopware shop. Then, in the second column, choose which Plentymarkets referrer will be responsible for manipulating this sales channel. You can use existing referrers, but we recommend selecting “(Generate by Plugin)” so that the plugin creates a new referrer on your system with the name of your chosen sales channel. Lastly, in the last column, select the client (mandant) responsible for the sales channel.
Establish configurations for all the sales channels you intend to utilize.
Create payment-methods. #
For efficient order management, it’s essential to align the payment methods between Plentymarkets and Shopware. There’s a possibility that you are already using plugins like Paypal or Mollie on both systems, resulting in overlapping payment methods. However, in this step, you can automatically generate a new payment method on your Plentymarkets system based on existing payment methods in Shopware. Simply select the payment method you wish to create and click the “Create” button. If nothing needs to be created, you can proceed to the next step.
Amazon Pay #
In this step, you can also configure the settings required for Amazon Pay. Our plugin is compatible with this payment provider, allowing you to handle everything within your Plentymarkets system through the Amazon Pay plugin. Simply provide your Amazon Pay key here, and later, through the event procedure, you can supply payment references to the original Shopware order. Additional information can be found here.
Payment relationships #
In this step, you need to establish a mapping between Plentymarkets payment methods and Shopware payment methods. Simply click the “+” button to add a new mapping, and choose which payment method from Plentymarkets should correspond to the payment method in Shopware. Additionally, there is a “Clone Payment” toggle: when activated, we will clone the payment and add it to Plentymarkets order, offering full flexibility for various use cases. For instance, if you are using the Paypal plugin on Plentymarkets, the payment on order will be added by the Paypal plugin, eliminating the need to clone the payment with the connector.
Furthermore, if you are utilizing Order filters (for more information, refer to the “Order filters” section), you will also encounter the “Payment filters” selection in this step. This enables you to choose the payment status per payment method to configure order import, such as importing only “Paid” orders, and so on.
Create mappings for all payment methods you intend to use on your Shopware store. Additionally, remember to include any new payment methods that may be introduced in the future.
Shipping relationships #
In this section, you must align shipping profiles in Plentymarkets with those in Shopware. This ensures precise management of shipping costs, delivery times, and other related information. Subsequently, this data will be accurately transferred to Plentymarkets during the import of orders.
To create a new mapping, click the “+” button. In the first column, choose the shipping profile from Plentymarkets, and in the second column, select the corresponding Shopware shipping profile. Establish mappings for all the shipping profiles you intend to utilize on your Shopware shop.
Advanced prices #
Shopware allows for dynamic pricing adjustments through “Advance Prices.” In this section, you can configure which price from Plentymarkets should be utilized within specific rules. Consequently, during the export of products, if a Plentymarkets sales price profile exists, this configuration ensures that the price is provided in the “Advance Prices” section on Shopware.
To set this up, choose the rule to which the Advance price should be applied. Rules can be managed in your Shopware system under Settings > Shop > Rule builder. Once the rule is selected, choose the Plentymarkets sales price profiles for both Sales price and Sales list price.
Customer classes #
When an order is placed by a registered user on Shopware, we automatically create this customer in the Plentymarkets system. To ensure the correct assignment of customer classes, you can map your Shopware customer classes with Plentymarkets customer classes in this step.
Simply click the “+” button to map customer classes between Shopware and Plentymarkets.
Tax Rates #
To ensure accurate VAT on your products and updates, it’s essential to map plentymarkets tax rates with Shopware. Plentymarkets has six tax rate classes, denoted from A to F, while in Shopware, you can create as many as needed under Settings > Shop > Tax.
Click the “+” sign here as well and establish a mapping between plentymarkets and Shopware tax rates.
You can modify tax rates at the Variation level here:
Media Settings #
In the data export process, categories, manufacturers, and products include graphic content. In this section, you can specify the folder where media files should be uploaded. While we recommend using the default folders for products, categories, and manufacturers, you also have the option to create new folders in your Shopware system and map them here.
Cronjobs #
In the “Cronjobs” step, you can access all cronjobs provided by our Plentymarkets | Shopware 6 connector. Here, you have the option to enable or disable specific cronjobs. Additionally, you can manually trigger a cronjob by clicking the “Execute” button.
Important
However, we do not recommend manually triggering cronjobs to avoid potential issues with relations, especially when the button is pressed multiple times in a short period.
Licenses #
In the final step, you will find a brief summary of your current limits as our connector licenses have restrictions on the number of sales channels and clients you can connect and utilize.
And that’s it! Simply complete the assistant, and your configuration will be saved. You can come back at any time to modify mappings or add new ones.