Shopware 6
We directly support Shopware 6 as a source system for products, categories and CMS content.
Setup
In order for the integration to work, you need to enter valid credentials of a Shopware 6 Integration.
Create a new integration user
Create a new integration user
Step 1: Create a new frontstack_sync
role in your Shopware 6 instance.
-
Go to
System
>Users & Permissions
>Roles
and click onCreate Role
. -
Enter
frontstack_sync
as the role name. -
Scroll down to the
Permissions
section and add the following permissions withread
access (first column):- Product
- Category
- Saleschannel
- Currency
- Language
- Media
- Manufacturers
- Properties
- Shopping Experiences
- Landing Pages
- Delivery times
- Essential Characteristics
- Scale Units
- Tags
- Tax
-
In the
Detailed Privileges
section, add the following permissions withread
access:media_translation
product_cross_selling_translation
delivery_time_translation
product_feature_set_translation
product_manufacturer_translation
property_group_translation
property_group_option_translation
product_translation
unit_translation
Step 2: Create a new Integration and assign the frontstack_sync
role to it.
- Go to
Settings
>System
>Integrations
and click onAdd Integration
. - Enter a name for the new integration - for example
frontstack-shopware-6
. - Assign the
frontstack_sync
role to the new integration. - Note
Access Key ID
and theSecret Access Key
- you will need it in the next step. - Save the integration.
During the setup of the integration, you will need the Access Key ID
(e.g. SWIAMG...
) and the Secret Access Key
(e.g. dXhZQ2...
) as well as the Host URL
(e.g. https://shopware.test
) to connect to your Shopware 6 instance.
Associations
We fetch associations for each supported entity. See the following sections on which associations are available by default. Please contact us, if you require additional associations.
Products
categoriesRo
cover
media
crossSellings
crossSellingAssignedProducts
deliveryTime
featureSet
manufacturer
media
prices
media
options
group
properties
group
tags
unit
visibilities
Categories
media
tags
Translations
We take care to resolve all translations to your configured integration translations.
You should use the base fields, e.g. name
and not translated.name
to access any translatable data in subsequent steps (e.g. Storage Mapping).
Specific data
For some feeds, we augment Shopware’s native data with additional fields. Those are listed in the following section.
Products
For products, we take care to pre-filter prices to only contain those of your region’s selected currency. You can omit filtering by currency yourself and just iterate the prices or use the first available price.
We also add currencyPrecision
and currencyCode
to every price element, so you can easily map those to the price composite.