The Akeneo Connector allows you to connect your Akeneo PIM to Constructor. It enables you to quickly synchronize your catalog data with Constructor, including your products, variations, categories, and more.

Why use it?

Constructor Connect App accelerates the path to value for joint customers through a ready made product catalog integration. In just a few clicks, connect your Akeneo catalog for ingestion and regular updates to Constructor (categories, products, and variations included).

Supported versions

Currently, we support both Akeneo Enterprise Edition and Growth Edition. You can see the list of all available editions at the Akeneo comparison page.

Since we heavily rely on the App Catalogs feature, you'll need to have Akeneo SaaS or a version that supports this feature.

How it works

The connector uses the Akeneo API to fetch the catalog data from your Akeneo PIM. We also rely on the App Catalogs feature to filter which data should actually be synced to Constructor.

Using the App Catalogs feature, you can have multiple catalog structures in Akeneo and select which products should be synchronized for each one. This means that you can selectively sync data and have much more control over the integration.

By default, we understand that 1 Catalog in Akeneo is synced to 1 Index in Constructor. After installing the app we'll create a default catalog for you, but you can also request new catalogs on demand. This allows you to have multiple indexes automatically updated in Constructor with the filters you select in Akeneo for each specific catalog.

We also sync data from a specific locale and currency by default. If the value we're syncing does not have a specific locale or currency, it will fallback to the normal value. If you happen to have multiple languages or currencies, only the one with the selected locale will be synced.

It's also important to note that the connector is read-only. We'll create catalogs for you but will never update any product information on Akeneo.

Installation

Step 1: Install the Constructor app

In the Akeneo App Store, install the Constructor Connect App.

Note: You'll need to accept the terms and give permissions to the API scopes the app uses.

Step 2: Enable the default catalog

After installing the app, you'll notice that we have created a default catalog for you. In order for us to start syncing data to Constructor, you'll need to manually enable the catalog in your Akeneo panel.

To do this, go to the Connected Apps in your Akeneo Apps page and click MANAGE APP in the Constructor app.

There, you'll find a Catalogs tab with the default catalog:

Click on the default catalog and enable it:

Note: Don't forget to click Save after enabling the catalog.

Step 3: Configure the app

While you are still on the catalog configuration page, it's a great idea to visit the Product Selection tab.

There, you'll be able to customize which products are synced into Constructor for each specific catalog you have in Akeneo.

You'll notice that by default we sync all enabled products. You can change this to filter by any attribute you have in your Akeneo PIM.

Note: Don't forget to click Save after making changes.

You're all set 🎉

That's it. You have successfully installed the Constructor app in your Akeneo PIM and configured your catalog preferences.

We'll handle the remainder of the setup from our side and we will contact you in case we need any information. After that's done, you will be notified and you should also start seeing your Akeneo product data in your Constructor account:

Note: The image preceding is just an example of what you should see in your Constructor account. Use our visual dashboard to validate your product data within the Constructor platform.

Data mapping

By default, data is mapped from Akeneo attributes to the Constructor fields. You can refer to the Akeneo API Docs and Constructor API Docs for more information about the data types.

Akeneo categories

Akeneo Categories map to Constructor groups.

Note: All category hierarchy is preserved.

Additionally, categories are also mapped from Akeneo attributes (if you have any). Here are the valid attribute names:

• category
• category1
• category2
• category3
• category4
• category5

Akeneo products

By default, we support both simple and variation products.

Simple products

For simple products, we map the following fields from an Akeneo Product to Constructor items:

Variation products

For variation products, we first map the Akeneo Product Models to Constructor items:

We then map all variations from Akeneo Products to Constructor variations:

Product metadata

The connector does not map any specific attributes by default. Specific attributes are those which will vary from integration to integration, like color, price, availability or others.

Instead, we provide a powerful template ecosystem via the Connect CLI that allows you to interface with the connector and map the data to ingest those attributes as metadata in any way you need.

Product images

Constructor supports Akeneo images uploaded in third-party services and linked in Akeneo via Asset Families. Images can only be synced from asset links, not media files. Refer to the Akeneo Asset Manager guide for more information.