Live Demo Buy Now

PrestaShop Akeneo Connector

Version
  • Version PrestaShop 1.6.x.x, ​1.7.x.x​ || Akeneo 2.0.5 or newer

Introduction

PrestaShop Akeneo Connector module allows you to connect your e-commerce store with Akeneo PIM platform. Using this integration, you can manage your products, categories, attributes, features information from Akeneo. PrestaShop Akeneo Connector will enable you to export, update, and manage your entire product catalog from Akeneo Open Source PIM platform.

Please Note – PrestaShop Akeneo Connector is compatible with Community Edition, Enterprise Edition, and Cloud (PaaS/Flexibility) Edition of Akeneo.

Video Tutorials

Check out the following video tutorials below:

Features

  • Create product categories from Akeneo to PrestaShop
  • Export product features to PrestaShop
  • Export attributes with attribute options to PrestaShop
  • Set default currency, locale, and product identifier in module configuration.
  • Supports mapping of multiple locales for language translations.
  • Map Akeneo attributes with PrestaShop product fields.
  • Set any fixed attribute value for all the exported products.
  • Add additional PrestaShop product field code for mapping.
  • Works with standard product, product with combinations, pack of products, virtual product
  • Upload multiple images of a product
  • Filter products for export based on -category, family, completeness, time conditions.
  • Export any specific product(s) using its SKU value in the identifier.
  • Select locale and currency for product export job.
  • Specific export jobs are created for categories, features, attributes, attribute options, products.
  • Also compatible with the latest version of Akeneo 2.2.1

Module Installation

To know how to install PrestaShop Akeneo Connector module in Akeneo, please follow the below steps:

1. Unzip the respective extension zip and then merge “src” folder into akeneo project root directory.

2. Goto app/AppKernel.php and add line

        new Webkul\PrestashopConnectorBundle\PrestashopConnectorBundle(),

in function registerProjectBundles()
3. Goto app/config/routing.yml and add these lines at top of file

prestashop_connector:
    resource: "@PrestashopConnectorBundle/Resources/config/routing.yml"
    prefix:   /        

4. Run this command after ssh to your akeneo server by terminal

    rm -rf ./var/cache/** && php bin/console pim:install:asset --env=prod && php bin/console assets:install web --symlink && yarn run webpack && php bin/console d:s:u --force

Common Issues After Installation

It might happen that even after proper installation, upon opening your Akeneo admin dashboard, you see a loading screen. In that case, do check for the following solution:

  • Webpack Installation: If you get the below error

    It means that webpack is not installed in your system. Run the following command
    npm install --save-prod webpack
  • Module routing.yml is not configured properly. Re-check the routing.yml file as mentioned in the 3rd step of Module Installation
  • Clear your browser cache.

Create API Key

For configuring this module, you need to obtain Webservice Account Key from your PrestaShop store. A webservice key allows the third-party tools to access and modify the data.

Adding a new key

Please login to PrestaShop back office and follow Configure>Advanced Parameters>Webservice. Then, in the Configuration option, select Yes for ‘Enable PrestaShop’s webservice‘.

Then, click ‘Add new webservice key‘ button.

The ‘Add new webservice key’ button takes you to the webservice key creation form:

Key – You can either create your own or choose to use a generated one, for instance by clicking the “Generate!” button. Generated keys are most of the time safer because they are harder to guess.

Key description – A reminder of who that key is for, and what it gives access to.

Status – You can disable a key anytime. This enables you to only temporarily grant access to your data from a certain key.

Permissions – You need to choose only View (GET), Modify (PUT), Add (POST) permissions for following resources and click Save.

The webservice key will be generated, please copy it somewhere, it will be used in next step.

PrestaShop Connector Configuration

After installing the module, you will find the PrestaShop Connector menu option, go to Server Credentials tab and enter the following:

  • Server URL (Your store URL address)
  • Webservice Account Key

Default Configuration

Now, you need to select default locale, currency, and product identifier of your PrestaShop. In Default Product Identifier, you need to choose how Akeneo product’s SKU will be mapped with PrestaShop products. You can either assign it to Reference or UPC Barcode.

Locale Mapping

In case you have multiple locales setup on your PrestaShop website and want to manage translations as well, then you need to map the Akeneo Locale with the PrestaShop Locale ID.

Product Field Mapping

In this section, you need to do the mapping of Akeneo product attributes with PrestaShop product fields. While exporting products you send a lot of information about your products such as- SEO, quantity, shipping, pricing, availability, etc. But first, you need to create the attributes in Akeneo according to PrestaShop product fields requirements.

The following PrestaShop product fields are available by default for mapping:

  • Product Name
  • Reference
  • UPC Barcode
  • Summary and Description
  • SEO – Meta Title and Meta Description
  • Quantities – Quantity and Minimum Quantity For Sale
  • Pricing – Retail Price (tax excl.), Cost Price (tax excl.), Impact on Price
    Product price (tax excl.)
  • Shipping Fees – Additional Shipping Costs
  • Package Dimension – Height, Depth, Width, Weight, Impact on Weight
  • Label When in Stock
  • Label When Out of Stock (and back order allowed),
  • Availability date
  • Available for Order
  • Product Images

Map More Fields

Although there’s a long list of attributes which are sent to the PrestaShop. However, if you still want to export more product information, you need to mention PrestaShop product field code for mapping.

Map Existing Attributes, Categories, Features of PrestaShop with Akeneo

For avoiding duplication of attributes, categories, and features creation in PrestaShop, you must do the mapping of these existing data with Akeneo first. Go to Product Field Mapping>Map Attribute/Category.

Now, here you can see the mapped entries between Akeneo and PrestaShop. Click Create Mapping button for creating a new mapping for a category, attribute, or feature.

Select Mapping Type as – Category, Attribute, or Feature. And then, select Akeneo value and PrestaShop value accordingly and click Save.

Product Creation

There are several ways to create products in Akeneo, you can also import your product data using Excel or CSV files. Or manually create product one by one in Akeneo. If you have already created or imported your products into Akeneo, please skip this section and move on to Export Job section.

Create Standard Product

A standard product is a basic product having no option or combinations. To create a product, go to Products>Create>Product and enter an SKU then select a Family. Please make sure, you select the correct family consisting of all the required product fields for PrestaShop.

After that, you need to provide product information according to the PrestaShop requirements. Enter basic product details such as product name, description, SKU, price, etc.

Mention shipping and packaging information.

Enter available stock quantity, min. qty for purchase, label settings. and availability date.

Provide SEO information with your product and mention meta title and meta description.

Upload multiple images of a product. Make sure you have mentioned the image attributes code in module configuration.

Select Category

Once you have entered all the product information, you need to select a category for this new product. You can also select more than one category for a product.

Export Jobs

In this module you will find the following types of export jobs for exporting catalog information to PrestaShop:

  1. Attribute Export
  2. Attribute Option Export
  3. Category Export
  4. Export All
  5. Product Export
  6. Product Model Export

Export All

In this job, all the attributes, attribute options, categories, products, product models are exported to PrestaShop. Further, you can use various filters for exporting only specific products to PrestaShop. If you have newly setup your PrestaShop from scratch, please use this export job.

To create a new export job profile, go to Exports>Create Export Profile and enter a code, label, and select job type.

In Webkul PrestaShop Connector menu, you will find all the 6 types of jobs for exporting categories, attributes, attribute options, products, and product models. Please note product features are exported using attributes and attribute options job profiles.

Export Categories

For exporting categories, go to Exports>Create Export Profile and enter a code, label, and select job type as Webkul PrestaShop Connector>Export Category.

Check all the information and click Save. 

Then, click Export Now button.

The execution process will run, you can see the progress and error messages here.

All the Akeneo product categories will be created in PrestaShop.

Export Attributes & Features

For exporting attributes, go to Exports>Create Export Profile and enter a code, label, and select job type as Webkul PrestaShop Connector>Export Attribute.

Click Save and then again click Save, after that Export Now button will be visible. Wait for the execution process to get completed.

You can check the exported attributes in PrestaShop. 

All the Akeneo attributes such as text, text area, price, date, number, and non-select type attributes will be seen under Features.

Export Attribute Options

For exporting attribute options, go to Exports>Create Export Profile and enter a code, label, and select job type as Webkul PrestaShop Connector>Export Attribute Option.

Click Save and then again click Save, after that Export Now button will be visible. Wait for the execution process to get completed.

 

Attribute options exported in PrestaShop.

Export Products

Now for exporting your products, you need to go to Exports>Create Export Profile and enter a code, label, and select job type as Webkul PrestaShop Connector>Export Product.

Click Save and then go to the Content section and select your channel and locales.

You can use various filters for deciding which products to export. You can even export some specific products using their SKU values. Use commas for more than one SKUs.

Click Save to apply your changes and then click Export Now button. Wait for the product execution job to get completed.

Once the export process is finished, you can see the new products in PrestaShop back office.

You can make whatever changes you want to do according to your requirements simply editing a product.

Check all the information is correctly mapped or not. All the non-selectable Akeneo attributes will become features in PrestaShop.

In quantities, you can see the quantity level, min. quantity for sale, labels, and availability date.

Shipping and packaging information are also fetched from Akeneo.

In pricing tab, you can see the retail price and cost price information.

In SEO, you can see the meta title and meta description.

See how PrestaShop frontend appears. On the product page, you can see the product name, price including tax, description, multiple images, availability label.

In the product details tab, all the features are visible to the customers.

Import Job

In the new version 1.1.1, Import Job feature has been added to Prestashop Akeneo Connector. Now you can directly import products, categories, attributes and family variants from PrestaShop.

For importing new products, you need to re-visit Product Field Mapping as explained above and map akeneo attributes with those of PrestaShop fields in which product will be imported.

 

 

In the next tab Default Mapping Settings, you need to provide the maximum number of images that can be imported for a particular product. Make sure to map this setting otherwise no images will be imported.

On the Product Field mapping has been done, go to Imports>Create Import Profile.

Now enter a code, label and select Job as PrestaShop Import Product. You can also select import jobs based on category, attributes, products and family variants.

Now, go to Content and select the appropriate channel, locale and currency for importing PrestaShop products to Akeneo.

After that, click Import Now button to execute the import process.

Support

Thank you for reading this documentation. In case you find anything missing or not explained correctly, or you have any customization needs, then please send a mail to support@webkul.com

Current Product Version - 1.1.1

Supported Framework Version - PrestaShop 1.6.x.x, ​1.7.x.x​ || Akeneo 2.0.5 or newer

. . .

Comment

Add Your Comment

Be the first to comment.

css.php

Index