Dynamic Competitor Pricing para Odoo

Dynamic Competitor Pricing es un módulo avanzado para Odoo (v17, 18 y 19) diseñado para automatizar y optimizar la estrategia de precios de tu e-commerce o inventario mediante el scraping de precios de la competencia.

🚀 Características Principales

• Scraping Automatizado: Extracción periódica de los precios de la competencia (ej. Amazon, Google Shopping, entre otros).
• Reglas de Precio Inteligentes: Posibilidad de ajustar automáticamente el precio de tu producto para igualar a la competencia, ser un porcentaje más barato, o reducir el precio por un importe fijo.
• Protección de Margen (Safety Net): Nunca venderás a pérdida. El sistema frena la bajada de precios si el cálculo sugiere un precio inferior al Coste (standard_price) + el Margen Mínimo Configurado.
• Alertas de Fluctuación Crítica: Genera avisos y actividades To-Do de Odoo automáticamente si un competidor cambia su precio por encima de un umbral establecido (ej. 15%).
• ROI de Estrategia de Ventas: Panel analítico integrado que compara ventas y facturación en el período activo vs. el mismo período anterior sin la regla activa.
• Gestión Masiva (CSV): Asistente integrado para importar miles de URLs de competidores y listado centralizado para exportación directa a Excel.
• Histórico y Auditoría: Gráficos integrados en el dashboard del producto y registro auditable de todos los cambios de precios (Cuándo, cuánto, y por qué).
• Evitación de Bloqueos (Throttling & Proxies): Rotación automática de User-Agents, retrasos aleatorios (throttling) entre peticiones y soporte para añadir Proxies mediante parámetros del sistema.

⚙️ Configuración y Uso

1. Activar precios dinámicos por producto

Ve a Ventas > Productos y abre cualquier producto (Template). Verás una nueva pestaña llamada "Dynamic Competitor Pricing".

• Activa el interruptor Enable Dynamic Pricing.
• Establece tu Minimum Margin (%) (Margen Mínimo sobre coste).
• Selecciona tu Adjustment Rule (Regla de Ajuste: e.g. Lowest competitor - X%).
• Establece el Alert Threshold (%) (Umbral de Alerta, por defecto al 15.0%).

2. Añadir a la Competencia

En la misma pestaña, añade las URLs de la competencia en la sección Competitor URLs. Selecciona la plataforma y pega la URL de su ficha de producto.

3. Automatización (CRON)

El módulo instala automáticamente una acción planificada (CRON) llamada Dynamic Pricing: Update Dynamic Prices. Por defecto, se ejecuta una vez al día de madrugada, extrayendo los precios y ajustando el list_price de todo el catálogo activo.

📊 Visualización de Resultados y Análisis ROI

Cada producto con precios dinámicos activos dispone de herramientas analíticas de última generación:

1. Historial de Precios: Un botón inteligente (Smart Button) "Price Fluctuation" en la parte superior derecha abre un gráfico histórico con todos los saltos de precio aplicados por el sistema.
2. Impacto en Ventas (ROI): En la pestaña "Dynamic Competitor Pricing" se despliega un panel de rendimiento de ventas que cruza datos en tiempo real con el módulo de sale, informándote de las unidades vendidas, ingresos acumulados e incremento porcentual frente al periodo equivalente anterior.

📥 Gestión Masiva de Catálogos (CSV/Excel)

Para inicializar de forma instantánea catálogos de gran envergadura:

1. Dirígete a Ventas > Productos > Import Competitor URLs.
2. Sube un archivo CSV con las columnas sku (referencia interna), platform y url. El asistente se encargará del resto de forma inteligente.
3. Ve a Ventas > Productos > Competitor URLs para ver el catálogo consolidado de enlaces de competidores y usar la herramienta de exportación nativa de Odoo para obtener plantillas o informes detallados.

🔔 Alertas Activas de Competidores

Si un competidor rompe los precios o los sube por encima del porcentaje configurado en Alert Threshold (%):

• Se registra un log destacado de advertencia en el chatter del producto.
• Se crea automáticamente una actividad de Odoo (To-Do) asignada al administrador responsable del producto para que pueda tomar decisiones estratégicas de inmediato.

🛠 Configuración Avanzada Técnica

Para evitar bloqueos de IP (Error 403 / Captchas) y renderizar webs modernas (SPAs):

1. Activa el modo desarrollador en Odoo.
2. Ve a Ajustes > Técnico > Parámetros del Sistema.
3. Añade cualquiera de los siguientes parámetros según tus necesidades:
   • dynamic_pricing.proxy_url: Tu servidor Proxy (ej. http://usuario:contraseña@ip_proxy:puerto).
   • dynamic_pricing.api_provider: scrapingbee o zenrows para delegar el scraping.
   • dynamic_pricing.api_key: Tu clave de API privada para el proveedor elegido.
   • dynamic_pricing.render_js: Escribe True si necesitas que el proveedor renderice el JavaScript (ideal para SPAs y webs React/Vue).

Eficiencia Multi-hilo: El CRON está optimizado con Multi-Threading (ThreadPoolExecutor). Extrae múltiples URLs de un mismo producto en paralelo, acelerando radicalmente la ejecución en catálogos inmensos.

---

Autor: Alberto Ortiz
Licencia: MIT
Categoría: Sales / E-commerce

---

English Version

Dynamic Competitor Pricing for Odoo

Dynamic Competitor Pricing is an advanced module for Odoo (v17, 18 and 19) designed to automate and optimize your e-commerce or inventory pricing strategy by scraping competitor prices.

🚀 Key Features

• Automated Scraping: Periodic extraction of competitor prices (e.g. Amazon, Google Shopping, and others).
• Smart Price Rules: Automatically adjust your product price to match the competition, be a percentage cheaper, or reduce the price by a fixed amount.
• Margin Protection (Safety Net): You will never sell at a loss. The system stops price drops if the calculation suggests a price below Cost (standard_price) + the configured Minimum Margin.
• Critical Fluctuation Alerts: Automatically generates warnings and Odoo To-Do activities when a competitor changes its price above a defined threshold (e.g. 15%).
• Sales Strategy ROI: Integrated analytics panel comparing sales and revenue in the active period vs. the same period before the rule was active.
• Bulk Management (CSV): Built-in wizard to import thousands of competitor URLs and a centralized list for direct export to Excel.
• History and Audit: Charts embedded in the product dashboard and an auditable log of every price change (when, how much, and why).
• Block Avoidance (Throttling & Proxies): Automatic User-Agent rotation, random delays (throttling) between requests and support for Proxies via system parameters.

⚙️ Configuration and Usage

1. Enable dynamic pricing per product

Go to Sales > Products and open any product (Template). You will see a new tab called "Dynamic Competitor Pricing".

• Toggle Enable Dynamic Pricing.
• Set your Minimum Margin (%) (minimum margin over cost).
• Choose your Adjustment Rule (e.g. Lowest competitor - X%).
• Set the Alert Threshold (%) (default 15.0%).

2. Add Competitors

In the same tab, add competitor URLs in the Competitor URLs section. Select the platform and paste the URL of their product page.

3. Automation (CRON)

The module automatically installs a scheduled action (CRON) called Dynamic Pricing: Update Dynamic Prices. By default it runs once a day at night, extracting prices and adjusting the list_price of the entire active catalog.

📊 Results and ROI Analysis

Every product with active dynamic pricing includes state-of-the-art analytics:

1. Price History: A smart button "Price Fluctuation" in the top-right corner opens a historical chart with every price jump applied by the system.
2. Sales Impact (ROI): The "Dynamic Competitor Pricing" tab shows a sales performance panel that crosses real-time data with the sale module, reporting units sold, accumulated revenue and percentage increase vs. the equivalent previous period.

📥 Bulk Catalog Management (CSV/Excel)

To instantly seed large catalogs:

1. Go to Sales > Products > Import Competitor URLs.
2. Upload a CSV file with the columns sku (internal reference), platform and url. The wizard handles the rest.
3. Go to Sales > Products > Competitor URLs to see the consolidated catalog of competitor links and use Odoo's native export tool to obtain templates or detailed reports.

🔔 Active Competitor Alerts

If a competitor undercuts prices or raises them above the percentage configured in Alert Threshold (%):

• A highlighted warning log is recorded in the product chatter.
• An Odoo activity (To-Do) is automatically created and assigned to the product's responsible admin so strategic decisions can be made immediately.

🛠 Advanced Technical Configuration

To avoid IP blocks (Error 403 / Captchas) and render modern websites (SPAs):

1. Enable developer mode in Odoo.
2. Go to Settings > Technical > System Parameters.
3. Add any of the following parameters as needed:
   • dynamic_pricing.proxy_url: Your Proxy server (e.g. http://user:password@proxy_ip:port).
   • dynamic_pricing.api_provider: scrapingbee or zenrows to delegate the scraping.
   • dynamic_pricing.api_key: Your private API key for the chosen provider.
   • dynamic_pricing.render_js: Set to True if the provider must render JavaScript (ideal for SPAs and React/Vue sites).

Multi-threaded Efficiency: The CRON is optimized with Multi-Threading (ThreadPoolExecutor). It extracts multiple URLs of the same product in parallel, radically speeding up execution on huge catalogs.

---

Author: Alberto Ortiz
License: MIT
Category: Sales / E-commerce

Autor: Alberto Ortiz
Licencia: LGPL-3
Categoría: Sales / E-commerce