User Guide for UnoPim Icecat Connector

UnoPim Icecat Connector helps enrich your product catalog using data from the Icecat database.

It lets you import specifications, descriptions, images, and other product details to keep product information accurate and consistent.

You can perform bulk enrichment using Icecat product enrichment tasks.

You can update individual products directly from the edit product page via More → Icecat Retrievalensuring flexibility and efficiency in managing your catalog.

It integrates seamlessly with the Icecat Open Catalog. This connector is designed to work with simple products, ensuring accurate and efficient data enrichment based on unique identifiers such as EAN, brand, or product code.

• For UnoPim installation, make sure your server meets these system requirements.
• This module works with UnoPim version v1.0.0

The UnoPim Icecat Connector simplifies product data enrichment by integrating Icecat data into your UnoPim catalog with structured mapping and flexible import options.

• Product Matching via Identifier: Match products using EAN, Product Code, and Brand for accurate data enrichment.
• Support for Simple Products: Support simple products for focused, reliable enrichment.
• General Attribute Mapping: Map Icecat key fields such as EAN, Product Code, Vendor (Brand), Name, Title, Description, Short Description, Summary Description, Short Summary Description, and Image with UnoPim attributes.
• Bulk Icecat Feature Mapping Import: Import a large number of Icecat feature attributes using Icecat Feature Mapping import work.
• Feature Mapping & Attribute Settings: Select the required feature attributes and assign the UnoPim attribute type to the structure specification data.
• Attribute Import & Mapping: Create attributes via the Icecat Attribute Import job and map them for proper data synchronization.
• Product Enrichment Options: Enrich products in bulk (Icecat Import Enrichment Products import job) or one by one via More → Icecat Retrieval.
• Local Mapping Support: Map Icecat and UnoPim locales to manage multilingual product data. Select Discover as needed during enrichment.

Follow the steps below to install Icecat Connector on UnoPim.

Step 1: Extract the Extension

Unzip the extension package and combine it package folder into project root directory.

Example structure:

/your-unopim-project
└── package/

Step 2: Register Service Provider

Open file: config/app.php

Add the following line below providers arrangement:

Webkul\Icecat\Providers\IcecatServiceProvider::class,

Step 3: Register PSR-4 Auto Loading

Go to project level composer.json and add the following entry below psr-4 part:

This ensures Laravel/PHP can load connector classes automatically.

"Webkul\\Icecat\\": "packages/Webkul/Icecat/src"

Step 4: Run the Setup Command

Run the following command from the project root directory.

1. Autoload Dump Composer

composer dump-autoload

2. Install Icecat Package (installer commands provided by package)

php artisan icecat:install

3. Restart the Queue Worker

php artisan queue:restart

After running the installer, the package will publish the migrations, configuration files, and seeders (if any) required by the connector.

After installing the connector, follow the steps below to configure and use it for product data enrichment.

Set up Credentials

Note: You must first create a profile on the Icecat side, where you must provide all your information, including your username, password and email address.

Step1: Add Icecat Credentials

After installing the connector, follow the steps below to configure and use it for product data enrichment.

• Navigate to Icecat → Credentials
• Click Add Credentials
• Enter your Icecat account details
• Save the credentials

This will create a connection between UnoPim and Icecat.

Step 2: Configure General Attribute Mappings

• Go to Attribute Mapping
• Map Icecat fields with UnoPim attributes like:
  • EAN
  • Product Code
  • Brand
  • Name
  • Information
  • Picture
• Save the Attribute mapping page

This step ensures correct product identification during enrichment.

Step 3: Run the Icecat Feature Mapping Import job

• Navigate to Import Jobs
• Run ice cat Import Feature Mappings work

This will import a large number of Icecat feature attributes (specifications), which will be available in the Feature Mappings section.

Step 4: Configure Feature Mapping & Attribute Types

• Go to Feature Mapping
• Select the required Icecat feature attributes
• Set the appropriate UnoPim attribute type (text, select, text area, etc.)

It defines how specification data will be structured in UnoPim.

• Run ice cat Import Attributes work

This will create UnoPim attributes based on the selected Icecat feature and the assigned type.

Step 6: Map Imported Attributes

• Back to Attribute Mapping
• Map the newly created attribute with the appropriate Icecat feature
• Save configuration

This ensures proper data synchronization.

Step 7: Configure Local Mappings (Optional)

• Navigate to Local Mapping
• Map the Icecat locale with the UnoPim locale

This enables multilingual product data enrichment.

Step 8: Create a Simple Product

• Navigate to Catalog → Products
• Click Create Products
• Choose Simple Products type
• Choose Attribute Family (where all Icecat attributes are set)
• Insert SKUs based on your mapping (for example, Icecat Product Code if mapped as a SKU)
• click save and update required fields like Brand on the Edit page.
• Choose Brand
• Insert EAN (if available)
• Click Keep

Step 9: Enrich Products

For Bulk Icecat catalog Enrichment:

• Go to Import Section
• Run Icecat Imported Enrichment Products Import jobs

For Single Product Enrichment:

• Go to the product edit page
• Click More → Icecat Retrieval

Product data such as descriptions, specifications and images will be taken from Icecat.

Support

This is all about the UnoPim Icecat Connector. I hope you get an idea about our module. Thank you for taking the time to read this blog.

And also, don’t forget to share your feedback and suggestions in the comment box provided below.

Additionally, If you have any questions or suggestions, please add a ticket in our HelpDesk system or contact us at [email protected].