User Guide for Odoo MerchantPro Connector

Odoo MerchantPro Connector is designed to sync products, orders, customers, and inventory with your MerchantPro store.

Odoo MerchantPro Connector uses real-time sync and cron jobs to keep data updated across both systems.

Because routine updates happen automatically, daily tasks become easier to manage. This helps reduce errors, save time, and support smooth multi-channel operations for growing businesses.

Odoo MerchantPro Connector requires Odoo Multichannel Sale. It must be installed first so the core sync functions work properly between MerchantPro store and Odoo.

1. Import products, categories, customers, and orders with a simple import function.
   
2. Sync customer details from MerchantPro to Odoo to keep records accurate and complete.
   
3. Update product stock automatically with real-time sync between both platforms.
   
4. Use automated cron jobs to import products, categories, and orders on a schedule.
   
5. Map MerchantPro categories, attributes, and variations directly with Odoo.
   
6. Sync order statuses like cancel or shipping instantly with real-time updates.
   
7. View clear error logs and activity records to troubleshoot sync issues quickly.
   
8. Apply filters to import only selected MerchantPro data into Odoo.
   
9. Update product prices in Odoo and push them to MerchantPro to keep listings consistent.

1. Once you purchase the App from Webkul store, you will receive a link to download module’s zip file.
2. Extract the file on your system after the download finishes. As a result, you will be able to see a folder named- ‘merchantpro_odoo_connector
3. Copy and paste this folder inside your Odoo Add-Ons path.
4. Now, open Odoo App and click on the Settings menu. Here, click on Activate Developer Mode.
5. Then, open Apps menu and click on ‘Update Modules List.’
6. In the search bar, remove all the filters and search ‘merchantpro_odoo_connector’
7. You will be able to see module in the search results. Click on ‘Install’ to install it.

Connection

After the installation of Odoo MerchantPro connector, log in to your Odoo account. Navigate to the multi-channel app and click the connect button.

Add the channel and select the channel type as MerchantPro. Once you configure the channel type, the MerchantPro channel configuration setting will be enabled.

To retrieve the access token and API path, Log in to your MerchantPro dashboard.

From the MerchantPro dashboard, navigate to Settings and Click on API and Webhooks.

Inside the API & Webhooks section, click on Add API User

After creating the app, MerchantPro will generate the credentials required for integration:

• API Key
• API Secret
• Access Token (if applicable)

Locate your MerchantPro Store URL, as it will be used while configuring the connection inside Odoo.

Go to your Odoo Multichannel module, copy all the API keys, and click on the test connection.

Congratulations, Connection is successful!!

Basic Configuration

Channel basic configuration: The basic configuration of the channel includes the following settings:

Auto-evaluate: When you enable auto-evaluate, it will evaluate the feed of the imported data automatically.

Company: Select the default company for the imported data from MerchantPro to Odoo.

API Record Limit: In the API record limit, you can set the limit of data that will sync between Odoo and MerchantPro.

Channel time zone: Select the timezone to maintain the time zone in order with the channel

Advanced configuration Under the advanced configuration for Odoo Multichannel Sale you can configure color, color index, blog URL, and store URL.

Sale Setting

Channel Sales Order: The Channel Sales Order includes the following settings:

Payment Term: Configure the Payment terms for the payment of sale orders imported from MerchantPro to Odoo.

Sales Team: Configure the sales team for sale orders imported from MerchantPro to Odoo.

Salesperson: Configure the salesperson for sale orders imported from MerchantPro to Odoo.

Campaign: Configure the UTM Campaign for sale orders imported from MerchantPro to Odoo.

Medium: Configure the ordered medium for sale orders imported from MerchantPro to Odoo.

Source: Configure the order Source for the sale order imported from MerchantPro to Odoo.

Tax Type: Configure the Tax Type used in channel order. You can select the tax type as tax type tax included or tax excluded. 

E-Commerce Order Reference Sync: If enabled order will be created with the ecomm sequence at the Odoo end.

Channel Order Default Product

Discount Product: Configure the service product for the Service Product for Order Discount on the imported sale order.

Shipping Product: Configure the service product for the Service Product for Shipping product for the imported sale order.

Real time Sales Order Status Sync

With this setting, you can enable the real-time sync of the order status from Odoo to MerchantPro. You can configure the real-time sync of the cancel and shipment status from Odoo to MerchantPro.

Product Setting

Default Settings

Category: At the ecom end user can apply multiple categories but at the Odoo end only a single category is applied. Set the default category in which imported orders will be stored

Price-list: This price list stores the Original price of the product exported from ecom to Odoo.

Language: the set language in the language option will be applied to objects synced from ecom to Odoo.

Channel Category: while exporting the product from Odoo to MerchantPro, the product will be stored in the configured category.

SKU Pattern: The value configured here will be used as an SKU in case the SKU is not present.

Product avoid duplicity: If Enabled, Product duplicity will be avoided based on Internal Reference (SKU) along with Barcode during import.

Stock Settings:

Auto Stock: If enabled stock will be synced from Odoo to MerchantPro in real time 

Stock Action: Product Quantity will sync According to the selected option Quantity on hand/forecast Field.

You can either select the sync of on-hand quantity or forecasted quantity.

Warehouse: It is the default warehouse that is used for the import of products from MerchantPro to Odoo.

Location: It is the default location where your stock will be stored when imported from MerchantPro to Odoo.

Order State Mapping

Here you can map the order state of MerchantPro with the order state of Odoo. You need to type the same name of the order status in the channel order status.

You can also configure the map’s default state.  Creation of invoice, and shipment( paid and open) 

Cron

We have provided cron features that will import data from MerchantPro to Odoo. Data will be Imported Based on the Created/Updated after a defined date.

Cron Configuration 

To configure the cron, navigate to Miscellaneous >> Global configuration >> Select the cron you want to configure. Here, You will find the order product customer category and feed cron.

NOTE: Data will be imported based on the created/updated or defined date.

Model: It is the module on which the server acts.

Allowed groups: It is the group that executes the server actions.

Scheduler User: This user will be responsible for running the scheduler.

Execute Every: Here you can configure the time interval for the execution of the cron.

Active: Enable if you want to enable the respective cron.

Next Execution Date: The next Planned execution date for this job.

Number of calls: How many times a method is called, a negative number indicates it has no limit.

Priority:  The priority of this job (as an integer 0 is high and 10 is low)

Miscellaneous

GLOBAL SETTINGS 

Next, go to the ‘multi-channel> miscellaneous> global configuration.’ From here, you can configure the import scheduler and enable ‘Avoid Duplicity (Default Code)’ to avoid double imports or exports of unchanged data.

Synchronization History

In the ‘Synchronization History’ option, you can view the entire history of every sync. On clicking anyone, you can see all the details of the history sync.

Data Mapping In Odoo

You can view the mapping of all the imported and exported data, such as products, categories, orders, customers, and shipping methods, in Odoo.

On opening any page from the mapping menu, you can view the list view of every mapping. On clicking any, you can view the details of that particular mapping.

Data Synchronization

Data Import

You can import data from the connection’s operation tab. You can also use the import button on the dynamic dashboard.

Note: Order of importing data: categories >> product >> order.

To import the order, your product must be imported, and similarly, to import the product, your categories should be imported from MerchantPro to Odoo.  

Moreover, you can only import the following data from MerchantPro to Odoo.

Products– You can import products using filters like all, ID, and store ID.

Order– Import using filters like all, ID, Date updated after and Date created after.

Category– Import categories using filters like all, ID, and date updated after.

Customer– Import them using the filters like all, ID, Date updated after and Date created after.

You can import all of this data using the filters mentioned above. Moreover, for data import, you must select the ‘channel instance, object, and filter’ in the import wizard.

Data Export

Navigate to the Odoo MerchantPro connector dashboard and select the export button.

For exporting, choose the ‘channel ID, operation (Export/Update), and object’ in the Export wizard.

Our module provides you with two objects for export/update:

1. You can export/update the category from Odoo to MerchantPro.

2. You can export/update the product template from Odoo to MerchantPro. It includes the product information.

 Feed Evaluation:

When data (Products, Categories, Customers, Orders, Shipping Methods) is imported from MerchantPro, it first lands in Feeds.

These feeds act as a separate section before creating a mapping records in Odoo. You can choose to evaluate them manually or automatically.

Manual Feed Evaluation

1. Go to Multi-Channel >> Feeds.
2. Select feed record(Category / Product / Partner / Order / Shipping) you want to process.

3. Review the details (e.g., product attributes, order data, customer information).

4. Click Evaluate Feed to create corresponding record in Odoo.

5. Once evaluated, feed will move to the mapping list for future synchronizations.

Note: Additionally, if you wish, you can enable developer mode to inspect the feeds in more detail. It provides clearer technical information, making it easier to identify any issues.

Automatic Feed Evaluation

1. While configuring your MerchantPro instance, enable Auto Evaluate Feed in Basic Configuration tab.
   
2. Once enabled, every imported feed will be automatically validated and created in Odoo without manual approval.

Hope you find guide helpful! Please feel free to share your feedback in the comments below.

If you still have any issues/queries, please create a ticket at the UV Desk.

I hope this helps. In case of any further queries, contact us at our support mail.

Thanks for paying attention!!