Akeneo Icecat Connector

Akeneo Icecat Connector gives the capability to enrich Akeneo PIM product data with the rich Icecat catalog. It can be used with both an open Icecat free catalog or full Icecat paid catalog.

• This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x and 3.2.x. Download Akeneo from here
• Node and Yarn packages need to be installed.
• Also works with Akeneo Cloud Flexibility Mode which is a PAAS Edition of Akeneo

• EAN attribute will be used to match Icecat products via their web API.
• In this Akeneo PIM attributes must also be mapped to Icecat features.
• Akeneo products will enrich via running a product enrich job.
• In this, you can map icecat common attributes like Ean, Description, Short description, Summary description, Short summary description and Pictures with Akeneo attribute through UI.
• In this, you can also do other Icecat feature mapping to map other Icecat feature attribute with the Akeneo attribute.
• You can also map the Icecat locale with Akeneo locale.

Before installing the module you must require the connector dependencies.

php -d memory_limit=3G ../composer.phar require guzzlehttp/guzzle 6.*
php -d memory_limit=3G ../composer.phar require prewk/xml-string-streamer 0.9.*

Please follow the below steps for installing the Akeneo Backup Management Connector module in your Akeneo PIM platform.

• Unzip the respective extension zip then merge the “src” folder into the Akeneo project root directory.

• Goto app/AppKernel.php then add the following line in function registerProjectBundles().

new Webkul\IcecatConnectorBundle\IcecatConnectorBundle(),

• Goto app/config/routing.yml then add these lines at top of the file

routing webkul_icecat_connector:
resource: "@IcecatConnectorBundle/Resources/config/routing.yml"
prefix: /

• You have to navigate first to Akeneo installation directory (Ex: cd /opt/bitnami/apps/akeneo/htdocs). After SSH, you have to run the command to your Akeneo server by the terminal.

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

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 a web pack is not installed in your system. Run the following command

npm install --save-prod webpack npm install

• 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.

After successfully installing the module in Akeneo, you will see the Icecat connector icon in Akeneo from the bottom left as shown below.

Setup Credential

To set up credential you have to click on the icon on the Icecat Connector.

After that it will redirect you to the new page in which you have to fill details like:

• Icecat username
• Icecat password

After that you have to click on Save to save the credentials.

Icecat Common Attributes Mapping

In this, you have to map you Akeneo attributes with the Icecat attribute so that they can syn properly and while import data from Icecat to Akeneo there will be no error.

You have to map the following attributes:

• EAN attribute
• Description attribute
• Short description attribute
• Short summary description attribute
• Pictures attribute
• Summary description attribute

Icecat Other Attribute Mapping

In this you can add new icecat attribute that is imported from Icecat then you can map that attribute with Akeneo attributes.

Locale Mapping

In this section you can map Akeneo local with Icecat local.

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.

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.

In this SKU will be filled of the product that you want toimport from Icecat to Akeneo.

After that click to Save.Then the product will be created on Akeneo.

In this Icecat Akeneo Connector there are three type of import jobs.

• Features Mapping
• Import Attribute
• Enrich Product

Now to import enrich Akeneo PIM product data with the rich Icecat catalog you have to create an import job for that navigate to Import>>Create Import Profile

After clicking on Create Import Profile it will redirect you to the new page in which you have to fill details like:

• Code
• Lable
• Job
  

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

After that, you can use various filters for deciding which products to import. Therefore you can even import some specific products using their SKU values use commas for more than one SKUs.

Click Save to apply your changes then click Import Now button then wait for the product execution job to get completed.

Once the import process is finished, you can see the product data filled.

This was all about the Akeneo Icecat Connector. I hope you must have the got the idea of our module. Thanks for taking the time in reading this blog. And also, please doesn’t forget to share your feedback and suggestions under the comment box given below.

Moreover, If you have any queries or suggestions, then feel free to add a ticket at our HelpDesk system.