User Guide for Unopim Odoo Connector

UnoPIM Odoo Connector module enables seamless integration between your Odoo store and the UnoPIM platform.

With this connector, you can efficiently manage your entire product catalog—including categories, products, product models, attributes, and attribute options—directly from UnoPIM.

Please Note:

• The UnoPIM Odoo Connector is compatible with Odoo version 18.
• Currently, only select-type attributes from UnoPIM are supported for export to Odoo.

• Export Capabilities
  • Export categories from UnoPIM to Odoo
  • Export attributes and attribute options
  • Export product models and products
  • Export multiple product images
  • Export variation products (based on select-type attributes)
  • Export specific products using identifiers (SKU, internal reference, or barcode).
  • Export categories directly to Odoo eCommerce categories
  • Export all categories or only those linked to a configured channel
• Mapping & Configuration
  • Map UnoPIM categories to Odoo categories
  • Map standard and custom attributes
  • Define default values for attribute mappings
  • Odoo attribute mapping support
  • More standard attributes can be mapped
• Job Profiles
  • Multiple export job profiles available: Categories, Attributes, and Products
  • Multiple import job profiles available: Categories, Attributes, Product Models, Products
• Advanced Filtering
  • Filter products during export based on:
    • Odoo credentials
    • Channel
    • Locale
    • Code
    • Media inclusion
• Update Support
  • Automatically update exported products with new changes
  • Export variation products based on select-type attributes
• Compatibility
  • Fully compatible with Odoo version 18.x
  • Compatible with the latest UnoPIM version 0.2.0

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

Register the package provider

• Go to config/app.php file and add the following line under ‘providers’:

Webkul\Odoo\Providers\OdooServiceProvider::class

• Go to composer.json file and add the following line under ‘psr-4’:

"Webkul\Odoo\": "packages/Webkul/Odoo/src"

Run the following commands:

composer dump-autoload

• Migrate Tables for the Odoo connector

php artisan migrate

• Publish Assets Odoo connector

php artisan vendor:publish --tag=unopim-odoo-connector

• Install the package for the Odoo client

composer require alazzi-az/odoo-xmlrpc

php artisan optimize:clear

The following Odoo apps must be installed: Sales, eCommerce, Inventory, and Website.

After that, log in to your Unopim panel, then go to Odoo > Credentials > Create Credentials.

Then the following page will appear. Here, you need to enter your Odoo server information:

• URL
• Database Name
• Login Username
• Login Password

Note: We have added validation so that if you enter a duplicate database name when creating credentials, an error will occur.

Here, you need to define the exported products’ locale, currency, and product identifier.

• Odoo Allowed Company ID: In this, you have to select the Company ID for which you want to export the product, or leave it blank if you want to export all the companies.
• Default Locale—Select a locale according to your Odoo store. Such as English (United States) and Spanish (Brazil).
• Currency—Select the default currency of your Odoo store. Such as the US dollar, the Euro, British pound.
• Default Product Identifier—Select how exported products will be identified in the Odoo store. There are two options available here:

1. Internal Reference (default_code)
2. Barcode (barcode)

• Odoo Version—You can select the Odoo version, like 18
• Category Export as eCommerce Categories—Enable this to export categories to the eCommerce category.

Attribute Mapping

When products are exported to Odoo, you can decide which product information should be included in the product database.

But first, you need to do the mapping of Odoo product fields with Unopim attributes.

Fixed Value—In case you want to set any default value for a product field, you can enter it in the Fixed Value. So that all the exported products will have the same product field value.

By default, the following product fields can be mapped between Unopim and Odoo:

• Internal Reference
• Barcode
• Name
• Description for Internal
• Description for Quotations (description_sale)
• Image
• Description for Vendors (description_purchase)
• Weight
• Description for Pickings (description_picking)
• Description of Delivery Orders
• Volume
• Description for Receptions
• Sale Price (list_price)
• Cost (standard_price)
• Routes
• Product Type
• Can be Sales
• Can be Purchased

Map More Standard Fields

In case you want to send more product information, you can add more product fields here and then map them with Unopim attributes.

First, you need to enter an Odoo field code and then click the Add Field button; after that, the new mapping field will appear above.

Category Fields Mappings

Here, you can create a mapping manually for categories.

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

Odoo Export Attribute—Once you select this job, you can export all the Unopim attributes and options to Odoo

You can apply the following filters during attribute export:

• Odoo Credentials: Choose the specific Odoo instance or credentials you’re exporting to.
• Channel: Export attributes associated with a specific sales or eCommerce channel.
• Locales: Select the language/localized data you want to include.
• Display Type: Filter attributes based on how they are displayed (e.g., Radio, Select, Color, Pills, Multi-checkbox).
• Filter by Code: Export only specific attributes using their unique codes.

Category Export— 

Odoo Export Category—Using this job, you can export all the categories to Odoo.

• Odoo Credentials: Choose the specific Odoo instance or credentials you’re exporting to.
• Channel: Export attributes associated with a specific sales or eCommerce channel.
• Locales: Select the language/localized data you want to include.
• Filter by Code: Export only specific attributes using their unique codes.

Product Export— 

Odoo Export Product—If you want to export only products and product models to Odoo, you have to select the Odoo export product job.

Create a product in Unopim (with no variations, such as size or color) in Unopim, like a t-shirt. Go to Products > Create, then select the Product option. 

After entering any unique SKU, select a family from the list.

After that, you need to fill in the product information as required according to the Odoo store.

Now, select a category from the right panel, then click to save.

Please Note – Only the mapped attributes information will be sent to the Odoo store.

Once you have created the products in Odoo, we’ll now export them to the Odoo store. Then go to Exports>Create Export Profile.

Then enter a unique code and label.

After that select Odoo Connector>Export Product, then click Save.

Please Note – Before exporting the product, you need to export the attribute and category from Unopim to Odoo.

Select a channel and locales for exporting products. Then you can even send content for multiple language translations.

You can decide which products you want to export to Odoo. There are various filters available, such as credentials, channel, locals, filter by code, and with media.

Here are some of the filters you can use when exporting products from Unopim:

• Credentials: Choose the specific Odoo credentials or connection you want to use for the export.
• Channel: Select the appropriate channel or store view that matches your Odoo setup.
• Locales: Export product data in specific languages or regional settings.
• Filter by Code: Export only selected products by entering their product codes.
• With Media: Choose whether or not to include product images and other media assets in the export.

If you want to export only some specific products, you can enter their SKU in the Identifier section, separated by a comma.

Once you have saved the information for the export profile, click the Export Now button.

In the execution process, you can check the progress of the export job and view any errors in the log.

As you can see, the product created in Unopim, named ‘LED Lamp,’ has been exported to Odoo. Then you can also view and edit any information as you require, and then publish the product.

After that, check out the Odoo e-commerce storefront view. A customer can see the product name, images, price, buy now details, etc.

For exporting products that have variations, you need to run the Odoo product export job.

In product management systems like Unopim, many products are not just single items—they come in multiple variations such as size, color, or material. These are called product variations or variants.

To export such products from Unopim to Odoo, you need to run a specific process called the Odoo Product Export Job.

This job is responsible for transferring all product data, including variations, from Unopim to your Odoo.

Odoo Import Category—This will import all the Odoo categories to Unopim.

Attribute and Attribute Options—This will import all the attributes and attribute options from Odoo to Unopim.

Product Import—This will import all the products from Odoo to Unopim.

Odoo Product Model:This will import all the products Model from Odoo to Unopim.

After that, go to select the appropriate channel, locale, and currency for importing Odoo products to Unopim.

Filter Options for Importing Product Models from Odoo

When importing product models from Odoo into UnoPIM, the UnoPIM Odoo Connector offers several advanced filter options to help you control and customize what data is imported.

Instead of importing all product models at once, you can narrow the import scope using the following filters:

Available Filters for Product Model Import:

• Credentials: Select which Odoo connection (credentials) you want to pull data from.
• Channel: Import product models associated with a specific sales or eCommerce channel.
• Locale: Choose the language or region for imported product data (e.g., English, Spanish).
• Family: Import only product models that belong to specific families (product groups).
• With Media: Choose whether to import product models along with their images/media files.

These filters give you fine-grained control over your imports, making it easier to manage localized catalogs, multi-channel data, and media-rich content, without overloading your UnoPIM workspace.

Then, click the Import Now button to execute the import process.

That wraps up the User Guide for the UnoPIM Odoo Connector. We hope this documentation helps you get started smoothly and manage your catalog integration with ease.

For any queries or doubts, reach out to us at [email protected]. You can also raise a ticket at our HelpDesk System.