INTEGRACIÓN DE POLEEPO ODOO | Centro de ayuda de Poleepo

Premisa

¿Qué es Odoo?

Odoo es una plataforma ERP modular de código abierto que ofrece herramientas para gestionar ventas, inventario, contabilidad, comercio electrónico y muchas otras áreas de negocio desde una única interfaz. Gracias a su estructura flexible, Odoo se integra fácilmente con otros sistemas para centralizar procesos y mejorar la eficiencia operativa.

¿Qué puedes hacer con la integración de Poleepo - Odoo?

Con la integración de Poleepo y Odoo , puede conectar ambas plataformas y gestionar de forma centralizada productos, inventario, ventas, pedidos, envíos, facturación y mucho más. Esto le permite minimizar las tareas manuales, los errores operativos y los tiempos de procesamiento, manteniendo ambos sistemas sincronizados constantemente.

1) Este vídeo explicativo resume el flujo de producto entre Odoo y Poleepo.

¿Qué información de productos maneja Poleepo en Odoo?

Entrada principal (solo si la plantilla tiene más de una variante):
- sku:ID de plantilla ( product.template.id).
- title:nombre de la plantilla ( product.template.name).
- category_path: categoría ( product.template.categ_id.name).
- price:lista de precios de plantilla ( product.template.list_price).
Se utiliza para sincronizar el "padre" de la familia variante en Poleepo.
Entrada de variante (una para cada product.productlote):
- Identificadores:
  - product_id: product.poleepo_ref(vacío si es producto nuevo).
  - sku: product.get_effective_sku()→ poleepo_skuo default_code.
  - Códigos: ean, upc, isbn, mpnde los respectivos campos de Odoo.
  - parent_sku:ID de plantilla si existen múltiples variantes.
- Descripciones: title , short_description, long_descriptiondel nombre del producto y textos de la plantilla.
- Categoría: category_path de plantilla.
- Dimensiones/Peso: weight , width, height, depthde los campos de producto (si están rellenados).
- Precios:
  - price: product.list_price.
  - price_with_tax:calculado con los impuestos sobre las ventas de la empresa ( taxes_id.compute_all).
- IVA: vat_rate proveniente del primer impuesto sobre las ventas de la empresa.
- Cantidad: quantity = product.with_company(company).qty_available .
- Imágenes: images = lista de URL firmadas de imágenes de Odoo ( _get_poleepo_image_urls).
- Atributos: attributes = matriz {name, value}para cada atributo de variante.

2) Este vídeo explicativo resume el flujo de pedidos entre Odoo y Poleepo:

En concreto, con la integración Odoo-Poleepo podrás:

Publica y sincroniza tu catálogo;
Sincronizar inventario y precios;
Gestiona las operaciones de tu e-commerce, tus marketplaces, tu social commerce
Crea etiquetas de envío con tus mensajeros;

Transacciones de importación/exportación entre Odoo y Poleepo

Operaciones de exportación de Odoo a Poleepo hacia los canales de venta	Operaciones de importación de canales en Poleepo a Odoo
Exportar y actualizar productos, variantes y detalles de productos	Importar nuevos pedidos
Exportar y actualizar disponibilidad, precio e imágenes de productos.	Importar datos de clientes
Actualizaciones sobre disponibilidad, estado del pedido e información de seguimiento.	Actualizaciones sobre disponibilidad, estado del pedido e información de seguimiento.
Crear albaranes/facturas	Crear e importar albaranes/facturas

¿Cuáles son los beneficios para los usuarios?

Automatizar la gestión de productos, pedidos y envíos
Reducir las tareas manuales y los errores
Centraliza los canales de venta en una única plataforma
Trabaje en Odoo utilizando la integración de Poleepo para gestionar las ventas multicanal de forma eficiente y sin problemas.

Requisitos

Para activar la integración necesitas:

Una cuenta activa de Poleepo con credenciales de API
Instalación del módulo Poleepo en Odoo

-El módulo odoo solo se puede instalar en Odoo 18.0 o Odoo.sh

-El módulo requiere Odoo Enterprise Edition

-No es compatible con Odoo online pero sí con Odoo.sh o On Premise

Puedes encontrar los requisitos en la siguiente imagen:

Configuración en Poleepo

para generar las claves API necesarias para la comunicación entre la plataforma y el sistema de gestión Odoo

Siga la ruta Configuración > API

Haga clic en "Crear clave":

En esta sección puedes crear credenciales de inicio de sesión para aplicaciones externas a Poleepo, en este caso Poleepo-Odoo.

Seleccione el nombre de la clave y la dirección de correo electrónico del contacto técnico al que nuestro soporte podrá contactar en caso de necesidad.
A continuación, elija los permisos que desea otorgar a la clave: sin acceso , acceso de lectura o acceso de escritura a pedidos, productos o envíos.
Finalmente haga clic en guardar.

Se generarán dos claves API: una pública y otra secreta, que deberá guardar y proteger. Deberá copiar estas credenciales e ingresarlas en Odoo para habilitar la comunicación con Poleepo.

Antes de ingresar tus credenciales en Odoo, recuerda habilitar la clave que acabas de crear usando la bandera de la derecha.

Configuración en Odoo

¿Dónde puedo descargar la aplicación del conector Poleepo Odoo?

Puede encontrar y descargar la aplicación Poleepo Odoo en el siguiente enlace:

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

Una vez que descargue la aplicación de la tienda Odoo, deberá generar las credenciales de Poleepo e ingresarlas.

Inicie sesión en su cuenta de Odoo y siga los pasos descritos en la documentación.

Puede acceder a la documentación relativa a la integración de Poleepo-Odoo en la sección de Conocimiento de su área reservada de Odoo.

La sección de Documentación de Poleepo explica todos los flujos y pasos para conectar Poleepo a Odoo, administrar la configuración, roles, webhooks, API, productos, pedidos, envíos y mucho más.

A continuación informamos los pasos divididos en los flujos principales - manual del administrador para técnicos y manual del usuario:

Conector Poleepo para Odoo: Introducción a los flujos

El módulo Conector Poleepo permite la integración entre Odoo y Poleepo , que funciona como un conector centralizado para marketplaces y plataformas de comercio electrónico. Los flujos de trabajo se basan en dos mecanismos principales:

Webhook : Poleepo envía notificaciones a Odoo cuando un pedido o envío cambia de estado.
Cron Job : Odoo requiere consultar a Poleepo para obtener información actualizada sobre pedidos y envíos.

Flujos principales

Gestión y disponibilidad de productos

Odoo envía periódicamente lotes de productos para su sincronización con Poleepo (nuevas referencias o actualizaciones). Esto se realiza mediante una acción programada, Lotes de Producto . El procesamiento de lotes se supervisa mediante una segunda acción programada, que actualiza Odoo con los resultados y cualquier error.

¿Qué información de producto se intercambia de Poleepo a Odoo?

Entrada principal (solo si la plantilla tiene más de una variante):
- sku:ID de plantilla ( product.template.id).
- title:nombre de la plantilla ( product.template.name).
- category_path: categoría ( product.template.categ_id.name).
- price:lista de precios de plantilla ( product.template.list_price).
Se utiliza para sincronizar el "padre" de la familia variante en Poleepo.
Entrada de variante (una para cada product.productlote):
- Identificadores:
  - product_id: product.poleepo_ref(vacío si es producto nuevo).
  - sku: product.get_effective_sku()→ poleepo_skuo default_code.
  - Códigos: ean, upc, isbn, mpnde los respectivos campos de Odoo.
  - parent_sku:ID de plantilla si existen múltiples variantes.
- Descripciones: title , short_description, long_descriptiondel nombre del producto y textos de la plantilla.
- Categoría: category_path de plantilla.
- Dimensiones/Peso: weight , width, height, depthde los campos de producto (si están rellenados).
- Precios:
  - price: product.list_price.
  - price_with_tax:calculado con los impuestos sobre las ventas de la empresa ( taxes_id.compute_all).
- IVA: vat_rate proveniente del primer impuesto sobre las ventas de la empresa.
- Cantidad: quantity = product.with_company(company).qty_available .
- Imágenes: images = lista de URL firmadas de imágenes de Odoo ( _get_poleepo_image_urls).
- Atributos: attributes = matriz {name, value}para cada atributo de variante.

Gestión de pedidos y envíos

Cuando se crea o modifica un pedido o envío en Poleepo, se envía una notificación a Odoo mediante un webhook . Odoo registra la notificación y la coloca en una cola interna para su procesamiento. Una acción programada se encarga de procesar la cola, creando o actualizando el pedido en Odoo.

Trazabilidad completa: Cada solicitud entrante y saliente se registra en el registro de la API. La cola interna garantiza la fiabilidad y el control del proceso de sincronización.

A. Manual del administrador — Técnico

1. Configuración inicial

Requisito: El primer paso para activar la conexión con Poleepo es ingresar correctamente las credenciales de la API dentro de la configuración de la empresa.

Procedimiento:

Vaya a Configuración → Empresas
Abra la pestaña Integración de Poleepo y configure:
- Poleepo Client ID
- Poleepo Client Secret
- Habilitar la bandera Integración de Poleepo Activa

2. Asignación de roles

Para que un usuario tenga acceso a todas las funciones administrativas, debe tener asignado el rol de Administrador de Poleepo . Esto se puede hacer desde el panel Usuarios, pestaña Derechos de Acceso.

3. Configuración del webhook

Tiempo real: Los webhooks permiten a Poleepo notificar a Odoo cuando se crea o actualiza un pedido, o cuando se actualiza un envío. Es fundamental configurarlos correctamente en ambos sistemas.

Cómo configurar un webhook entre Poleepo y Odoo

Para conectar Poleepo a Odoo a través de webhook, debe seguir los pasos a continuación en el orden preciso:

Inicie sesión en el panel de administración de Poleepo .
Desde el menú lateral, vaya a API → WebHooks y haga clic en Nuevo Webhook .
Establezca un nombre de configuración (por ejemplo, ODOO TEST).
Introduzca la dirección de correo electrónico del contacto técnico .
Asignar permisos :
- STATUS_ORDER
- STATUS_SHIPMENT
Copia la clave secreta generada automáticamente por Poleepo.
Abra Odoo y vaya a Poleepo → Webhook , cree un nuevo registro.
Proporcione un nombre sin espacios (por ejemplo, poleepo_webhook).
Pegue la clave secreta en el campo Clave secreta .
Seleccione los mismos eventos:
- STATUS_ORDER
- STATUS_SHIPMENT
Guardar el webhook en Odoo: se generará automáticamente una URL de webhook completa .
Regrese a Poleepo y pegue la URL generada por Odoo en el campo URL configurada .
Active el webhook en Poleepo y haga clic en Guardar .

Después de esta configuración, Poleepo podrá enviar notificaciones en tiempo real a Odoo para actualizaciones de pedidos y envíos.

4. Tipos de parcelas

Importante: La correcta gestión de paquetes es esencial para la comunicación con los servicios de mensajería integrados de Poleepo. Cada tipo de paquete debe describirse con sus dimensiones y especificaciones mínimas. Además, durante las operaciones de almacén, es fundamental que el tipo de paquete seleccionado coincida con uno de los configurados.

Iniciar sesión en Poleepo → Tipos de paquetes
Complete las dimensiones y parámetros requeridos para cada tipo de cuello soportado por Poleepo

Crítico: El módulo se basa en una serie de tareas programadas para mantener actualizados los pedidos, los productos y la disponibilidad. Las tareas cron están preconfiguradas y habilitadas. Sin embargo, es fundamental asegurarse de que estén habilitadas para garantizar la fiabilidad del flujo de trabajo de integración.

Acceso: Vaya a Configuración → Características técnicas → Acciones programadas

5. Lista cron principal:

Nombre Cron	Frecuencia	Descripción
Poleepo: Cola de webhooks de proceso	Cada 1 minuto	Procesa los webhooks recibidos de Poleepo (pedidos, envíos)
Poleepo: Limpieza de colas de webhooks	Manual	Elimina los mensajes webhook procesados para evitar retrasos
Poleepo: Generar lotes de productos	Cada 2 minutos	Crea grupos de productos para sincronizarlos y enviarlos a Poleepo
Poleepo: Los lotes de productos de la encuesta deben configurarse con un intervalo ≥ 10 minutos para cumplir con los límites de Poleepo	Cada 10 minutos (o más)	Supervisar el estado de los lotes enviados y actualizar Odoo con cualquier error o éxito
Limpieza del registro de la API de Poleepo	A diario	Limpia los registros de API antiguos para optimizar las bases de datos

Nota: El punto final de Poleepo dedicado al sondeo por lotes tiene un límite máximo de 5 solicitudes . Para evitar bloqueos temporales o errores 429, se recomienda programar la tarea cron " Sondeo de Lotes de Productos" cada 10 minutos o más, dejando un pequeño margen de seguridad.

6. Gestión de colas de webhooks

Todos los mensajes de webhook recibidos se guardan en la sección Cola de Webhooks . Desde aquí puedes:

Ver la carga útil completa de la llamada
Comprobar estado ( In Attesa, Completato, Fallito)
Forzar manualmente una llamada fallida para que se vuelva a intentar

7. Lotes de productos

Cada sincronización masiva de productos se registra como un "lote". Puede acceder a él desde Poleepo → Lotes de productos y analizarlo:

¿Qué productos se incluyeron?
El estado de cada producto (borrador, error, completado)
Mensajes de error detallados, como PARENT_NOT_FOUND, para ayudar a la depuración

8. Registros de API

Trazabilidad: Cada llamada realizada o recibida por Poleepo se guarda en los registros de la API . Esto es esencial para la trazabilidad y la resolución de errores.

Ver método HTTP, punto final, código de estado y tiempo de respuesta
Identifique cualquier error (por ejemplo 500 Internal Server Error)

B. Manual del usuario

El módulo de integración de Poleepo permite sincronizar pedidos, productos, disponibilidad y envíos entre Odoo y Poleepo en tiempo real. Este manual está dirigido a usuarios finales que utilizan Odoo para vender y gestionar la logística de pedidos de sitios de comercio electrónico conectados a través de Poleepo.

Gestión de productos

Odoo distingue entre dos tipos de productos:

Plantilla de producto : La plantilla base del producto (p. ej., "Camiseta"). No se puede vender directamente, pero se utiliza para gestionar atributos y variantes.
Producto Producto : las variantes vendibles reales generadas por la plantilla (por ejemplo, "Camiseta roja L").

Cuando creas un producto sin variantes , puedes publicarlo en Poleepo directamente en la ficha de producto, activando el campo en la Published on Poleepopestaña Información de Variante de Poleepo .

Al gestionar productos con variantes :

Ir a la plantilla del producto
Haga clic en "Variantes" para acceder a la lista de productos secundarios.
Seleccionar todas las variantes
Abra una de las filas y active la bandera Published on Poleepo→ se aplicará a todas

Actualización automática: Odoo actualizará automáticamente la bandera Needs Updatesiempre que:

Se ha cambiado el nombre del producto.
El precio ha cambiado
Cambiar la cantidad disponible

¿Qué información de producto se intercambia entre Odoo y Poleepo?

Entrada principal (solo si la plantilla tiene más de una variante):
- sku:ID de plantilla ( product.template.id).
- title:nombre de la plantilla ( product.template.name).
- category_path: categoría ( product.template.categ_id.name).
- price:lista de precios de plantilla ( product.template.list_price).
Se utiliza para sincronizar el "padre" de la familia variante en Poleepo.
Entrada de variante (una para cada product.productlote):
- Identificadores:
  - product_id: product.poleepo_ref(vacío si es producto nuevo).
  - sku: product.get_effective_sku()→ poleepo_skuo default_code.
  - Códigos: ean, upc, isbn, mpnde los respectivos campos de Odoo.
  - parent_sku:ID de plantilla si existen múltiples variantes.
- Descripciones: title , short_description, long_descriptiondel nombre del producto y textos de la plantilla.
- Categoría: category_path de plantilla.
- Dimensiones/Peso: weight , width, height, depthde los campos de producto (si están rellenados).
- Precios:
  - price: product.list_price.
  - price_with_tax:calculado con los impuestos sobre las ventas de la empresa ( taxes_id.compute_all).
- IVA: vat_rate proveniente del primer impuesto sobre las ventas de la empresa.
- Cantidad: quantity = product.with_company(company).qty_available .
- Imágenes: images = lista de URL firmadas de imágenes de Odoo ( _get_poleepo_image_urls).
- Atributos: attributes = matriz {name, value}para cada atributo de variante.

Importación de pedidos desde Poleepo

Cuando llega un pedido de Poleepo, se crea automáticamente en Odoo como un pedido de venta confirmado .

Pedidos generados por Poleepo:

Se asignan al usuarioOdooBot
Solo son visibles si eliminas el filtro "Mis cotizaciones"
Tienen un pequeño y simpático icono de robot para reconocerlos.

En la pestaña "Información de Poleepo" de su pedido puede encontrar:

El enlace directo al pedido en Poleepo haciendo clic en el campo ID del pedido
Información sobre el estado del pedido y el origen

Preparación para el envío

El pedido genera automáticamente operaciones de almacén. Es importante que durante la entrega:

Se crea al menos un paquete
Seleccione un tipo de cuello válido para Poleepo

Advertencia: Si no se asigna un tipo válido, la generación de la guía de embarque fallará.

Creación de la carta de porte

Cuando todos los productos del pedido se hayan entregado completamente , se activa el botón:

Spedisci con Poleepo

Al hacer clic en él, el sistema:

Le pide que seleccione una dirección de recogida
Mostrar mensajeros disponibles de Poleepo
Envíe la solicitud a Poleepo para generar la etiqueta de envío

La etiqueta se guarda en la sección de chat del pedido y puede ser impresa por el operador.

Enviar a mensajería y actualización de seguimiento

Cuando el mensajero recoja el paquete, haga clic en:

Consegnato al corriere

Odoo notifica a Poleepo sobre la entrega. En respuesta, Poleepo actualiza automáticamente a Odoo:

Estado del envío
Seguimiento con código de envío
El mensajero utilizado

Todos los detalles son visibles en la pestaña Información de Poleepo del pedido.