This documentation contains all the information about how our Shopware connector can manage orders data between Shopware 6 and Plentymarkets.
Import orders #
With our connector, you have two options for importing orders from your Shopware 6 to Plentymarkets:
- Orders are pushed immediately after they are placed on Shopware by merchant.
To achieve this, you must have the plugin installed on your Shopware 6 store. Further information on how to install and set up this plugin can be found here.
- Via a cronjob that runs every 15 minutes.
We utilize this method as a backup and to ensure that our order data remains up-to-date.
The import of orders depends on your configuration. The orders import feature must be enabled in the configuration. Additionally, you can determine order filters under which conditions orders should be imported, as by default all new orders are imported.
Payments methods #
During order import, the appropriate payment method will be automatically assigned based on your payment method mappings. Instructions on how to map payment methods between Plentymarkets and Shopware 6 can be found here.
Shipping Profiles #
During order import, the shipping profile will also be configured based on your mapped shipping profiles in Plentymarkets and Shopware 6. This ensures flexibility and automation in your shipment management. Instructions on how to map shipping profiles in the configuration assistant can be found here.
Order Items #
During order import, we validate SKU references to ensure that the correct variation is allocated to OrderItems. If a reference is not found, the variation is added to the order with the type “TYPE_UNASSIGNED_VARIATION“.
Our connector accommodates various types of Order Items to facilitate comprehensive information exchange between Shopware 6 and Plentymarkets, including Coupon codes. These order items will be added with a type TYPE_PROMOTIONAL_COUPON.
If you use multiple tax rates for your products, remember to map them in the configuration for accurate VAT and prices. Instructions on how to map shipping rates can be found here.
Order notes #
During order imports, all merchant comments entered during the checkout on Shopware 6 will be transferred to Order notes on Plentymarkets. This ensures that any important inquiries regarding the order are not overlooked.
Order notes are generated under the name of the selected user, so please ensure that the user is selected and has permissions to create order notes on orders. Where to select an user you can find here
External order ID #
To ensure that you can easily find related orders between Shopware 6 and Plentymarkets, our connector stores the Shopware order ID in the External Order ID field on Plentymarkets.
Referrer #
During order import, the referrer will be assigned to the order based on your configuration in the assistant. This allows you to identify the sales channel from which the order originates in Shopware. Instructions on how to map your Shopware sales channels with Plentymarkets referrers can be found here
Client (Mandant) #
Since our connector is compatible with multiple shops in Shopware 6 and multiple sales channels, we will also set up the Client (Mandant) during order import. This field is configured based on your Client (Mandant) configuration in the assistant. You can find more information on this here.
Language #
Since different sales channels can have different languages set in Shopware 6, our connector will set the language used during the order import as the order language. This enables you to maintain processes required for emails, documents, etc., in the preferred customer language.
Custom fields #
Shopware 6 allows for custom fields on orders to store useful information about the order. By default, our connector does not transfer this data. However, please feel free to reach out to our team. We can implement a custom solution where the custom fields of Shopware 6 are provided as order properties on Plentymarkets orders.
Customer data Management #
Contacts #
If the customer on Shopware placed the order as a registered user, we will create a corresponding Contact on Plentymarkets with identical details. The data will be synchronized after any updates on Shopware, and the connector will automatically assign the Customer Class according to your configuration.
Companies #
If you are dealing with B2B customers and the company information is provided in the customer address on Shopware, the company will be created in Plentymarkets under CRM > Companies. For further details on Companies in Plentymarkets, you can refer to their manual here.
Addresses #
During order import, billing and delivery addresses will be generated in Plentymarkets and associated with the order. If the order was from a registered customer, the address will also be linked with the created contact in Plentymarkets.
We consistently monitor any alterations in the order on Shopware and promptly update vital information such as payment details and addresses back to Plentymarkets. This guarantees that our records stay up-to-date and precise throughout the entire order processing cycle.