POLEEPO ODOO INTEGRATION | Poleepo Help Center

Premise

What is Odoo

Odoo is a modular, open-source ERP platform that offers tools to manage sales, inventory, accounting, e-commerce, and many other business areas from a single interface. Thanks to its flexible structure, Odoo can be easily integrated with other systems to centralize processes and improve operational efficiency.

What can you do with the Poleepo - Odoo integration?

With the Poleepo and Odoo integration , you can connect the two platforms and centrally manage products, inventory, sales, orders, shipments, invoicing, and much more. This allows you to minimize manual tasks, operational errors, and processing times, keeping the two systems constantly synchronized.

1) This explanatory video summarizes the product flow between Odoo and Poleepo.

What product information does Poleepo handle on Odoo?

Parent entry (only if the template has more than one variant):
- sku: Template ID ( product.template.id).
- title: template name ( product.template.name).
- category_path: category ( product.template.categ_id.name).
- price: template price list ( product.template.list_price).
It is used to synchronize the "parent" of the variant family on Poleepo.
Variant entry (one for each product.productbatch):
- Identifiers:
  - product_id: product.poleepo_ref(empty if new product).
  - sku: product.get_effective_sku()→ poleepo_skuor default_code.
  - Codes: ean, upc, isbn, mpnfrom the respective Odoo fields.
  - parent_sku: Template ID if multiple variants exist.
- Descriptions: title , short_description, long_descriptionfrom product name and template texts.
- Category: category_path from template.
- Dimensions/Weight: weight , width, height, depthfrom product fields (if filled in).
- Prices:
  - price: product.list_price.
  - price_with_tax: calculated with the company's sales taxes ( taxes_id.compute_all).
- VAT: vat_rate from the company's first sales tax.
- Amount: quantity = product.with_company(company).qty_available .
- Images: images = list of signed URLs of Odoo images ( _get_poleepo_image_urls).
- Attributes: attributes = array {name, value}for each variant attribute.

2) This explanatory video summarizes the order flow between Odoo and Poleepo:

Specifically, with the Odoo-Poleepo integration you can:

Publish and sync your catalog;
Synchronize inventory and prices;
Manage the operations of your e-commerce, your marketplaces, your social commerce
Create shipping labels with your couriers;

Import/Export transactions between Odoo and Poleepo

Export operations from Odoo to Poleepo towards sales channels	Import operations from channels in Poleepo to Odoo
Export and update products, variants and product details	Import new orders
Export and update product availability, price and images	Import customer data
Updates on availability, order status, and tracking information	Updates on availability, order status, and tracking information
Create waybills/invoices	Create and import waybills/invoices

What are the benefits for users?

Automate product, order and shipping management
Reduce manual tasks and errors
Centralize sales channels in a single platform
Work in Odoo using the Poleepo integration to manage multi-channel sales efficiently and seamlessly.

Requirements

To activate the integration you need:

An active Poleepo account with API credentials
Installing the Poleepo Module on Odoo

-the odoo module can only be installed on Odoo 18.0 or Odoo.sh

-the module requires Odoo Enterprise Edition

-it is not compatible with Odoo online but with Odoo.sh or On Premise

You can find the requirements in the following image:

Configuration on Poleepo

to generate the API keys needed for communication between the platform and the Odoo management system

Follow the path Settings > API

Click on "Create Key":

In this section you can create login credentials for applications external to Poleepo, in this case Poleepo-Odoo.

Choose the name of the key and the email address of the technical contact that our support can contact in case of need.
Next, choose the permissions you want to give the key: no access , read access , or write access to orders, products, or shipments.
Finally click on save

Two API keys will be generated, one public and one secret, which you must save and safeguard. These credentials will need to be copied and entered into Odoo to enable communication with Poleepo.

Before entering your credentials on Odoo, remember to enable the key you just created using the flag on the right.

Configuration on Odoo

Where can I download the Poleepo Odoo connector app?

You can find and download the Poleepo Odoo app at the following link:

https://apps.odoo.com/apps/modules/18.0/poleepo

Once you download the app from the Odoo store, you will need to generate the credentials from Poleepo and enter them.

You can access the documentation regarding the Poleepo-Odoo integration in the Knowledge section of your Odoo reserved area.

The Poleepo Documentation section explains all the flows and steps to connect Poleepo to Odoo, manage configuration, roles, webhooks, APIs, products, orders, shipments and much more.

Below we report the steps divided into the main flows - administrator manual for technicians and user manual:

Poleepo Connector for Odoo - Introduction to Flows

The Poleepo Connector module enables integration between Odoo and Poleepo , which serves as a centralized connector for marketplaces and e-commerce platforms. The workflows are based on two main mechanisms:

Webhook : Poleepo sends notifications to Odoo when an Order or Shipment changes status.
Cron Job : Odoo Requires consults Poleepo to get updated information on Orders and Shipments.

Main Flows

Product Management and Availability

Odoo periodically sends product batches to be synchronized to Poleepo (new references or updates). This is done via a scheduled action, Product Batches . Batch processing is monitored by a second scheduled action, which updates Odoo with results and any errors.

What product information is exchanged from Poleepo to Odoo?

Parent entry (only if the template has more than one variant):
- sku: Template ID ( product.template.id).
- title: template name ( product.template.name).
- category_path: category ( product.template.categ_id.name).
- price: template price list ( product.template.list_price).
It is used to synchronize the "parent" of the variant family on Poleepo.
Variant entry (one for each product.productbatch):
- Identifiers:
  - product_id: product.poleepo_ref(empty if new product).
  - sku: product.get_effective_sku()→ poleepo_skuor default_code.
  - Codes: ean, upc, isbn, mpnfrom the respective Odoo fields.
  - parent_sku: Template ID if multiple variants exist.
- Descriptions: title , short_description, long_descriptionfrom product name and template texts.
- Category: category_path from template.
- Dimensions/Weight: weight , width, height, depthfrom product fields (if filled in).
- Prices:
  - price: product.list_price.
  - price_with_tax: calculated with the company's sales taxes ( taxes_id.compute_all).
- VAT: vat_rate from the company's first sales tax.
- Amount: quantity = product.with_company(company).qty_available .
- Images: images = list of signed URLs of Odoo images ( _get_poleepo_image_urls).
- Attributes: attributes = array {name, value}for each variant attribute.

Order and Shipping Management

When an order or shipment is created or modified in Poleepo, it sends a notification to Odoo via webhook . Odoo records the notification and places it in an internal queue for processing. A scheduled action then takes care of processing the queue, creating or updating the order in Odoo.

Complete Traceability: Every incoming and outgoing request is tracked in the API Log. The internal queue allows you to guarantee reliability and control over the synchronization process.

A. Administrator Manual — Technical

1. Initial setup

Prerequisite: The first step to activate the connection with Poleepo is to correctly enter the API credentials within the company configuration.

Procedure:

Go to Settings → Businesses
Open the Poleepo Integration tab and configure:
- Poleepo Client ID
- Poleepo Client Secret
- Enable the Poleepo Integration Active flag

2. Role assignment

For a user to have access to all administrative features, they must be assigned the Poleepo Administrator role . This can be done from the Users panel, Access Rights tab.

3. Webhook Configuration

Real-time: Webhooks allow Poleepo to notify Odoo when an order is created or updated, or when a shipment is updated. It's essential to configure them correctly on both systems.

How to Configure Webhook Between Poleepo and Odoo

To connect Poleepo to Odoo via webhook, you need to follow the steps below in precise order:

Log in to the Poleepo administration panel .
From the side menu, go to API → WebHooks and click on New Webhook .
Set a Configuration Name (e.g. ODOO TEST).
Enter the email address of the technical contact .
Assign permissions :
- STATUS_ORDER
- STATUS_SHIPMENT
Copy the Secret Key automatically generated by Poleepo.
Open Odoo and go to Poleepo → Webhook , create a new record.
Give a name without spaces (e.g. poleepo_webhook).
Paste the secret key into the Secret Key field .
Select the same events:
- STATUS_ORDER
- STATUS_SHIPMENT
Save the webhook in Odoo: a complete Webhook URL will be automatically generated .
Go back to Poleepo and paste the URL generated by Odoo into the Configured Url field .
Activate the webhook in Poleepo and click Save .

After this configuration, Poleepo will be able to send real-time notifications to Odoo for order and shipment updates.

4. Types of parcels

Important: Proper parcel management is essential for communication with Poleepo's integrated couriers. Each package type must be described with minimum dimensions and specifications. Furthermore, during warehouse operations, it is essential that the selected package type matches one of those configured.

Log in to Poleepo → Package Types
Fill in the dimensions and parameters required for each neck type supported by Poleepo

Critical: The module relies on a series of scheduled jobs to keep orders, products, and availability up to date. Cron jobs are preconfigured and enabled. However, it's essential to ensure they're enabled to ensure the reliability of the integration workflow.

Access: Go to Settings → Technical Features → Scheduled Actions

5. Main cron list:

Name Cron	Frequency	Description
Poleepo: Process Webhook Queue	Every 1 minute	Processes webhooks received from Poleepo (orders, shipments)
Poleepo: Webhook Queue Cleaning	Manual	Removes processed webhook messages to avoid backlogs
Poleepo: Generate Product Batches	Every 2 minutes	Create product groups to synchronize and send them to Poleepo
Poleepo: Poll Product Batches Must be set with interval ≥ 10 minutes to meet Poleepo limits	Every 10 minutes (or more)	Monitor the status of submitted batches and update Odoo with any errors or successes
Poleepo API Log Cleanup	Daily	Cleans old API logs to optimize databases

Note: The Poleepo endpoint dedicated to batch polling is subject to a maximum rate limit of 5 requests . To avoid temporary hangs or 429 errors, it is recommended to schedule the Poll Product Batches cron job every 10 minutes or more, leaving a small safety margin.

6. Webhook Queue Management

All received webhook messages are saved in the Webhook Queue section . From here you can:

View the full call payload
Check status ( In Attesa, Completato, Fallito)
Manually force a failed call to retry

7. Product Batches

Each mass product synchronization is recorded as a "batch." You can access it from Poleepo → Product Batches and analyze:

Which products were included
The status for each product (draft, error, completed)
Detailed error messages, such as PARENT_NOT_FOUND, to aid debugging

8. API Logs

Traceability: Every call made or received by Poleepo is saved in the API Logs . This is essential for traceability and error resolution.

See HTTP method, endpoint, status code, and response time
Identify any errors (e.g. 500 Internal Server Error)

B. User Manual

The Poleepo integration module allows you to synchronize orders, products, availability, and shipments between Odoo and Poleepo in real time. This manual is intended for end users who use Odoo to sell and manage the logistics of orders from e-commerce sites connected via Poleepo.

Product Management

Odoo distinguishes between two types of products:

Product Template : The base template for the product (e.g., "T-shirt"). It cannot be sold directly, but is used to manage attributes and variants.
Product Product : the actual sellable variants generated by the template (e.g. "Red T-Shirt L").

When you create a product without variants , you can publish it on Poleepo directly in the product sheet, by activating the field in the Poleepo Variant InfoPublished on Poleepo tab .

When you manage products with variants :

Go to the product template
Click on "Variants" to access the list of child products
Select all variants
Open one of the rows and activate the flag Published on Poleepo→ it will be applied to all

Auto-update: Odoo will automatically update the flag Needs Updatewhenever:

The product name is changed
The price is changed
Change the available quantity

What product information is exchanged between Odoo and Poleepo?

Parent entry (only if the template has more than one variant):
- sku: Template ID ( product.template.id).
- title: template name ( product.template.name).
- category_path: category ( product.template.categ_id.name).
- price: template price list ( product.template.list_price).
It is used to synchronize the "parent" of the variant family on Poleepo.
Variant entry (one for each product.productbatch):
- Identifiers:
  - product_id: product.poleepo_ref(empty if new product).
  - sku: product.get_effective_sku()→ poleepo_skuor default_code.
  - Codes: ean, upc, isbn, mpnfrom the respective Odoo fields.
  - parent_sku: Template ID if multiple variants exist.
- Descriptions: title , short_description, long_descriptionfrom product name and template texts.
- Category: category_path from template.
- Dimensions/Weight: weight , width, height, depthfrom product fields (if filled in).
- Prices:
  - price: product.list_price.
  - price_with_tax: calculated with the company's sales taxes ( taxes_id.compute_all).
- VAT: vat_rate from the company's first sales tax.
- Amount: quantity = product.with_company(company).qty_available .
- Images: images = list of signed URLs of Odoo images ( _get_poleepo_image_urls).
- Attributes: attributes = array {name, value}for each variant attribute.

Importing orders from Poleepo

When an order comes from Poleepo, it is automatically created in Odoo as a confirmed sales order .

Orders generated by Poleepo:

They are assigned to the userOdooBot
They are only visible if you remove the "My Quotes" filter
They have a cute little robot icon to recognize them.

In the "Poleepo Info" tab of your order you can find:

The direct link to the order on Poleepo by clicking on the Order ID field
Order status and origin information

Preparing for Shipping

The order automatically generates warehouse operations. It is important that during delivery:

At least one package is created
Please select a valid package type for Poleepo

Warning: If a valid type is not assigned, the waybill generation will fail.

Waybill Creation

When all the products in the order are completely delivered , the button is activated:

Spedisci con Poleepo

By clicking it, the system:

Asks you to select a pickup address
Show available couriers from Poleepo
Send the request to Poleepo to generate the shipping label

The label is saved in the order's chat section and can be printed by the operator.

Send to Courier and Tracking Update

When the courier collects the package, click on:

Consegnato al corriere

Odoo notifies Poleepo of the delivery. In response, Poleepo automatically updates Odoo:

Shipment Status
Tracking with shipping code
The courier used

All details are visible in the Poleepo Info tab of the order.

PUBLICATION OF PRODUCTS ON EBAY

GPSR INFORMATION MANAGEMENT ON POLEEPO

HOW DO I RENEW OR SIGN UP FOR A NEW SUBSCRIPTION ON POLEEPO?

POLEEPO-PASSEPARTOUT MEXAL INTEGRATION