Guide for Akeneo Shopware 6 App

Akeneo Shopware 6 App allows a user to connect their Akeneo PIM with Shopware store(s).

The app facilitates the connection of multiple shopware instances with Akeneo according to plan subscription.

Using it, the import and export of product data and its attributes is done between Akeneo and Shopware 6 and the other way around.

The app can handle large amounts of product and catalogue data transfer accurately.

Additionally, if you’re looking to connect your Akeneo with Magento 2, then you can look at Akeneo Magento 2 App.

• Export Categories from Akeneo to Shopware 6.
• Export Attributes and their options from Akeneo to Shopware 6.
• Import Manufacturer, Tax, Sales Channel, Scale Unit, and Delivery Time values from Shopware6 to Akeneo.
• Export Products from Akeneo to Shopware 6 store.
• Simple and configurable types of products are supported by the app.
• Import Categories, Attributes, Attribute Options, Products, and Product Models from Shopware 6 to Akeneo.
• Transfer Product Models from Akeneo to Shopware 6.
• Filter data for export based on Category, Family, Completeness, Identifier (SKU), Language, and Currency for Product Export.
• Export products with Level 2 variants.
• Credentials must be chosen according to the Shopware version.
• Transfer Dynamic Groups from Akeneo to Shopware6.
• Through the UI, users can select product listings for variants.
• The Akeneo Shopware 6 App is compatible with the latest version of Akeneo.
• Export Product Images.
• Export custom attribute values from Akeneo to Shopware6.
• Users can export product models of the metric type.
• Users can export attributes of the metric type.
• Multi-Credentials Configuration is available as per subscribed plan.
• Tags can be exported from Akeneo to Shopware6.
• Customizable Attribute Mapping is available with default values.

After searching for the Akeneo Shopware 6 App in the Akeneo app store, you have to tap the connect button,

Next, tap on the Connect button and on the page that appears, tap on the Allow and Next buttons to proceed further,

Afterwards, check and agree to the app’s privacy policy and terms and conditions,, and tap the Allow and Next button,

Thereafter, provide the access permissions to the category trees, including – Catgeory, Locale, Attribute Group, and others, and then tap the Next button after that.

Note: These app permissions appear in the case of Akeneo EE edition users only.

Now, confirm the access and tap the Confirm button.

After the permissions section, the app will be connected, and on the app page, you can see the notification for a 7-day trial period.

Now, the user can see the Akeno Shopware 6 app connected, and tap on Open App to open it.

Akeneo App Flow Management:

To manage the Akeneo Shopware 6 App, tap the Manage App button. Here, for the flow type, you need to select the Other type.

Note: You must select the Data Source flow type in the Growth, Flexibility, and Serenity editions.

Please check the below image to get to know the sequence to search Akeneo Apps.

After the app is connected and when opened, the user is redirected to the Plans page where they’ll have to purchase a plan as per requirement,

Now, the user will click on Buy Now to purchase a new plan. Then, they are redirected to PayPal to complete the transaction.

After successful payment, user is redirected to the Plans page where the selected plan is now in Activated state.

After installation, you need to add an extension in your shopware6 instance to export the images from Akeneo to Shopware6.

1 – For that, you have to go to the Shopware6 backend and then navigate to Extensions >> My Extensions.

2 – For installing the extension, the user can click on the Upload extension button. The user can upload the extension zip.

3 – After uploading the extension zip, after that, the user can see the extension in the list.

4 – Now the user can click on the install icon to install the Shopware 6 Akeneo Connector extension. 

5 – After the installation of the extension, the user can click to activate the extension.

he admin can easily generate API keys from the Admin backend. For this, the admin will navigate to Setting>>System>>Integration as per the below image.

After that click on Add Integration to create new API keys.

Then after clicking on Add Integration you have to fill in the API key name.

Copy the API Key then click to Save Integration.

After successful connection, the user needs to enter the Shopware 6 store credentials into the app.

The user will navigate to Credentials>Create Credential and then enter the details as per the image below,

Enter the following details,

• URL: Enter Shopware URL
• Access Key ID: Enter Shopware Access Key ID
• Secret Access Key: Enter Shopware secret access key
• Shopware Version: Select the shopware version from dropdown menu.

Once the credentials have been added correctly, it will be visible under the Credentials section. It will be displayed as below,

Now, after adding, the user can tap on the switch icon to change the status of the credential.

Additionally, they can tap the edit icon to edit the credential to perform the Locale Mapping, Currency Mapping and Select Media Folder as provided below,

After the credential has been setup, the user has to proceed for the Attribute Mapping.

Here, they can map the product fields between Akeneo and Shopware 6 store.

The following columns are listed here,

• Fields in Shopware
• Common Fields
• Variant Fields in Akeneo
• Default Fields

A user will fill out the Common Field i.e the Product and Product model default attributes and the Variant Fields in Akeneo i.e Product Variant default attributes as per requirement.

Map More Standard Attributes

If your products have lots of information, you can enter Shopware6 standard attribute code ID and then click Add Field. The Shopware6 App module supports various attributes of Shopware6 products.

Note- Please make sure to use the same attribute code of Shopware6 in Akeneo.

Custom Fields Mapping

You can also add a Shopware Custom attribute code, enter the Shopware attribute code ID then click Add Field.

Other Mapping

Attributes to be used as Cover Images – These attributes will be used as the cover image of the product.

Attributes to be used as Images – These attributes will be visible as Shopware6 product gallery images.

Family and Attribute to be used as Tags – Select the family and attribute from Akeneo to be used as Tags.

Attributes to be used as Images(For variants) – The selected image attributes will be used as the variant image of the product.

Attribute To be used as Properties Values(For Export) – The select type, multi-select and metric type attribute of Akeneo properties value(color, material, brand, etc) will be exported to Shopware6.

Display in listing attributes – All select type attributes are will be exported to Shopware6 from Akeneo.

Shopware Backend 

You must select a rule mapping in the rule section.

The tier price requires rule mapping, which should be a simple select type.

In the Other Settings section, the below configurations are listed,

Mapping for export boolean Tags

In this, you have to select

• Yes/No
• True/False

Export Metric Unit:

In this, you can select yes or no to export metric tags unit with metric value or not.

Export Metric Value (Properties)

Select the metric value property to be exported.

Shopware Backend –

Exported Metric Unit.

Simple and configurable types of products are supported by the app.

You can also create a product in Akeneo. Therefore, navigate to Products. Then click the  Create button.

Now, you need to choose your action – as Product or Product Model as per the below image. You can select-

• Product – if you want to create simple products. else choose Product model to create a product with variants.

Enter the SKU, choose a family, then click the Save button as per the below image.

Product Family – This is a set of attributes that will be the same for all products belonging to a family.

The product family represents product type, imposes product information structure, and defines the list of attributes for a product that it belongs to.

Add Product Details

Now you need to provide information about the product.

After that, enter the details like color, cost, and country of manufacturer, and upload the product image.

Select Attribute

In order to add product information, select the attribute options you require. Therefore, you can also create new options for the attribute.

The following Attributes from Akeneo are supported for export:

• Text
• Text Area
• Number
• Date
• Yes/No
• Select
• Price
• Metric
• Image

Multi-Lingual Information

Once you will be done with attributes then Add information for other languages and store views.

Select Category

After entering all the product information. Then you can also select Categories for the created product.

There are 7 types of export jobs in Akeneo Shopware 6 App –

• Export All to Shopware6
• Attribute Export to Shopware6
• Attribute Options Export to Shopware6
• Category Export to Shopware6
• Dynamics Group to Shopware6
• Product Export to Shopware6
• Product Model Export to Shopware6

Note For Dynamics Group Export –

To export Associate products you need to export the main product and their associate product separately to Shopware from Akeneo once all the products will be export to Shopware.

In the second step, you need to run the job Dynamics Group to Shopware so that the products form in a group.

After that, in the third step export the main product then the product exports as the associated product from Akeneo to Shopware

Export Process

In the Job field, you need to select the Attribute Export to Shopware 6. Then click Save.

Note -: Before exporting products from Akeneo to Shopware you need to export attribute, attribute option, and category.

Filter The Data:

You can export the filtered data. Therefore, navigate to the Content section.

You can filter the data as per-

• Channel – This selects the relevant channel of products to export.
• Locales – Depending as per your choice choose multiple locales.
• Currency – Select the default currency which you want to export.
• Attributes – select the product attributes that you want to export. You can either select all attributes else click the edit button to select the attributes.

After that click the Save button.

Export Now:

After creating the export profile, click on the Export Now button.

As seen in the above image, attribute exports successfully to the Shopware 6 store.

So that is all for the Akeneo Shopware 6 App. If you require any further assistance, please reach out to us through support@webkul.com or you can create a ticket as well.