Integration with Shopware
Shopware is a leading eCommerce platform designed to facilitate B2B and B2C processes. Shopware offers extensive customization of online shops and can be further enhanced with the help of plugins and integrations. The integration with SALESmanago makes it possible to relay information between both platforms. The integration plugin is available in 3 languages – English, German, and Polish.
TIP: The plugin is fully compatible with Shopware v. 5.2 and newer. Older versions are partially supported and some features may not work in accordance with the following article.
Scope of integration:
- Monitoring online shops that use Shopware with SALESmanago monitoring code.
- Full support of newsletter sign-up forms:
- creating new contact profiles in SALESmanago,
- monitoring contacts acquired by contact and sign-up forms,
- during each sign-in, the system checks if the contact has a tracking cookie. If no cookie is found, the system sends a request to assign one to the contact. If the contact is not in the database, a contact card is created based on information taken from the Shopware database.
- Synchronizing customer sign-ups and related information with contact cards (data is synced during each sign-up, sign-in and purchase):
- full name,
- street address,
- email address,
- telephone number,
- date of birth,
- company name,
- subscription status (opt-in/opt-out),
- The above data is synced automatically if it changes,
- Contacts added to SALESmanago can be tagged automatically,
- Moreover, every new contact acquired from a contact form is assigned a tag SHOPWARE, and a detail with the version of the platform.
- Relaying external events Purchase and Cart:
- For Cart events, information is provided when items are added and removed from carts.
- Tags can be assigned to contacts when they register, purchase or subscribe to a newsletter.
Integrating Shopware
1. Download the integration plugin.
2. Sign into your Shopware account. Open the Configuration tab and from the list of options choose Plugin Manager.
3. In Plugin Manager go to Installed:
4. Click Upload Plugin. Select the .zip archive with the integration plugin and confirm. The plugin will be uploaded to your Shopware account.
5. The SALESmanago plugin will appear on the list in Plugin Manager.
6. Click Install (a green plus icon on the right). Wait for the plugin to finish installing. When it finishes, a modal with settings will appear. Fill in each field and click Save. Congratulations, your SALESmanago and Shopware accounts are now integrated.
IMPORTANT: You have to fill in at least the first 4 fields – if you leave any of them empty, the plugin will not work properly.
Shopware product specification
Shopware Download
Shopware GitHub Repository
Developer Guides
REST API Guide
The mechanism of relaying external events
In this integration, the method AddExtEvent
is used to relay external event data to the system. It handles several types of events, including CART
(adding a product to a shopping cart) and PURCHASE
(purchasing a product).
1. The plugin sends the IDs of all products that were added to a cart or purchased in the Products field, whenever an event is registered. When a new product is added to a cart, the plugin sends the list of IDs of all products currently in the cart / being purchased.
2. Product IDs should be separated with commas, can include numbers and Roman alphabet characters, and can’t be longer than 32 characters. Product IDs should match the IDs in the XML file.
3. The Value
field contains the total number of products added to carts (CART
events) and products purchased (PURCHASE
.events).
4. In the Location
field, you can enter the name of your shop or the name of the website on which the purchases are made.