Akeneo

In this article, you'll learn how to import your product data from Akeneo into Channable.

Before you start

You'll need

• An Akeneo account

• If you want to include images in listings: A third-party application (e.g. TwicPics)

1

Create a new connection in Akeneo

• Log in to your Akeneo account.

• Go to Connect > Connection settings > CREATE.

  
• Create your Channable connection:

  • For Label, call your connection "Channable".

  • For Code, this should automatically be filled in after creating your label. If it isn't, fill in "channable".

  • For Flow type, set it to Data destination.

  • Click Save. You'll be directed to a page with your connection credentials.

  • Make note of your Client ID, Secret, Username and Password, as you will need these in a later step.

  • For Permissions, make sure the Role is set to API and Group is set to API Connections.

  

  Akeneo - Connection-settings.png

2

Create a TwicPics account

To list your products on different channels with images, Channable requires public image URLs. As Akeneo doesn't offer this currently, you'll need to use a third-party application. In this step, we'll use TwicPics (most used by Akeneo users).

Important: You don't need a TwicPics account to import your product data, but if you want to use images in your product listings, this step is mandatory.

1. Follow TwicPic's Akeneo set up guide: https://www.twicpics.com/docs/integrations/akeneo#connect-your-pim-with-akeneo-twicpics-app

2. After creating your account and following the steps, go to Workspaces and click your domain (in Favorite domains).

3. Ensure you have a path where nothing is added and the path is /.

Example: An correct setup where 1) is the domain, 2) is the path, and 3) is the source:

Test Akeneo.png

1. Make note of your twic pics domain, as you'll need it in the next step.

3

Create your Akeneo connection in Channable

1. In Channable, open the project where you want to import your product data.

2. Go to Setup, click + Set up import, and select Akeneo.

3. Fill in the required information:

   • For Label, give your import channel a descriptive name (e.g. "Akeneo")

   • For Akeneo URL, provide your Akeneo webshop URL (can be found in Akeneo Activity dashboard)

   • For Client ID, fill in the Client ID you noted earlier.

   • For Client secret, fill in the Secret you noted earlier.

   • For Username, fill in the Username you noted earlier.

   • For Password, fill in the Password you noted earlier.

   • For TwicPics domain, fill in the domain you noted in the TwicPics step.

4. Click Connect with Akeneo. This takes you to your import settings.

   • For Name, give your Akeneo import a descriptive name (e.g. "Akeneo FR")

   • For Choose language, select the language your product data is in.

5. Click Start import. You'll be redirected to the Edit Mapping page to map your product information.

4

Map your products

This page displays your import fields (fields retrieved from your Akeneo site — e.g. price, description, title), and corresponding project fields (Channable's standardized fields used to streamline channel setups).

Note: Our system will automatically detect and map most import fields to our standardized fields, but it's important to review and adjust these before importing.

Akeneo has rich organization options. Sometimes this means a field (e.g. product descriptions) has multiple variations for different languages or scopes. To make your Akeneo product data work across different channels, we "unnest" these fields — taking all unique combinations and giving them their own field. We use an underscore (_) to connect the different parts.

Example: Description field split to account for different locales and scopes.

Before you continue:

• Compare and adjust mapping:

  • Review your Import fields against Channable's matched Project fields. If a field was matched incorrectly, click on the field to select a different field.

• Check and correct field types:

  • Check that the right field type is assigned to your project fields. If a field has the wrong type, click Edit next to the field, select the correct type in the dropdown, and click Save & Import.

• Exclude fields (optional):

  • To exclude a field from being included in your product data, click the checkbox in the Select column for that field and click Do not import selected fields.

Once you've finished mapping, click Save & Import to start importing your product data. Depending on how much data you're importing, this can take some time.

Note: Check the Status column in Setup to check your import progress. Your product data is fully imported when the Status is Finished.

5

Review your imported items

After your product data has finished importing:

• Go to the Items page to view your imported products.

• Click on an item to see detailed information.

You're good to go! Your items are ready to use to create and optimize Feeds, Marketplaces, Shopping Ads, and more in Channable.