Descripción
Este producto está en desarrollo continuo
Optimiza la integración entre WooCommerce y Odoo
El conector WooCommerce para Odoo está diseñado para transformar la manera en que gestionas tus ventas en línea. Este producto elimina procesos manuales y automatiza la sincronización de pedidos, clientes y estados del pedido directamente entre WooCommerce y Odoo. Si buscas una solución eficiente para combinar ambas plataformas, este conector es ideal para ti.
Automatización para ahorrar tiempo y esfuerzo
Con este conector, todo se gestiona desde Odoo sin necesidad de realizar tareas repetitivas. La sincronización automática asegura que los pedidos y datos de clientes estén siempre actualizados, evitando errores en procesos administrativos. Esto te permite centrarte en lo que realmente importa: hacer crecer tu negocio.
Fácil instalación y mantenimiento asegurado
Instalar este conector es un proceso rápido y sencillo, pensado para que estés listo para operar en cuestión de minutos. Además, incluye actualizaciones regulares para garantizar que siempre dispongas de las últimas funcionalidades y compatibilidad con las versiones más recientes de WooCommerce y Odoo. Es una herramienta robusta y confiable, diseñada para durar.
Una solución completa para la gestión de tus ventas
Este conector combina lo mejor de dos plataformas poderosas para asegurarte una gestión fluida de tus ventas. Tanto si manejas pedidos grandes como pequeños, el integrar WooCommerce con Odoo permite una experiencia simplificada y profesional. Olvídate del trabajo manual y disfruta de una sincronización sin complicaciones.
Instrucciones:
# Upevo WooCommerce Connector – Guía de Uso
**Tu conexión perfecta entre WooCommerce y Odoo**
—
## Índice
1. [Primeros Pasos](#1-primeros-pasos)
2. [Configuración Inicial](#2-configuración-inicial)
3. [Importar Productos](#3-importar-productos)
4. [Importar Pedidos](#4-importar-pedidos)
5. [Importar Contactos](#5-importar-contactos)
6. [Sincronizar Stock](#6-sincronizar-stock)
7. [Sincronizar Precios](#7-sincronizar-precios)
8. [Mapear Métodos de Envío](#8-mapear-métodos-de-envío)
9. [Mapear Métodos de Pago](#9-mapear-métodos-de-pago)
10. [Mapear Impuestos](#10-mapear-impuestos)
11. [Configurar Webhooks](#11-configurar-webhooks)
12. [Gestionar Colas](#12-gestionar-colas)
13. [Acciones Masivas](#13-acciones-masivas)
14. [Solución de Problemas](#14-solución-de-problemas)
—
## 1. Primeros Pasos
### ¿Qué necesitas?
Antes de empezar, asegúrate de tener:
1. **Credenciales de WooCommerce API**
– Ve a tu WordPress: `WooCommerce > Ajustes > Avanzado > API REST`
– Crea una nueva clave API con permisos de **Lectura/Escritura**
– Guarda el **Consumer Key** y **Consumer Secret**
2. **URL de tu tienda WooCommerce**
– Ejemplo: `https://mitienda.com`
– Debe incluir `https://` si tu tienda usa SSL
3. **Producto de tipo Servicio para envíos** (opcional pero recomendado)
– En Odoo, crea un producto llamado «Gastos de Envío» de tipo Servicio
—
## 2. Configuración Inicial
### Acceder a la configuración
1. Ve a **Ajustes** en Odoo
2. En el menú lateral, busca la sección **WooCommerce**
### Completar credenciales
| Campo | Qué poner | Ejemplo |
|——-|———–|———|
| URL Base WooCommerce | La URL de tu tienda | `https://mitienda.com` |
| Consumer Key | Clave generada en WooCommerce | `ck_xxxx…` |
| Consumer Secret | Secreto generado en WooCommerce | `cs_xxxx…` |
| Verificar SSL | ✅ si tu tienda usa HTTPS | ✅ |
### Probar la conexión
1. Haz clic en **»Probar Conexión»**
2. Si ves «Conexión Exitosa» → ¡Perfecto!
3. Si hay error → Revisa las credenciales
### Configurar opciones adicionales
| Opción | Para qué sirve | Recomendación |
|——–|—————-|—————|
| Lista de Precios | Precios en pedidos importados | Selecciona tu lista principal |
| Estados de Pedidos | Qué pedidos importar | `processing,completed` |
| Límite de Importación | Pedidos por ejecución | 10-50 |
| Producto de Envío | Líneas de gastos de envío | Tu producto «Gastos de Envío» |
| Ubicación de Stock | Dónde actualizar inventario | Tu almacén principal |
### Activar CRONs
Activa los procesos automáticos según necesites:
| CRON | Cuándo activar |
|——|—————-|
| ✅ Cola de productos | Siempre (procesa importaciones) |
| ✅ Cola de órdenes | Siempre (procesa pedidos) |
| ✅ Cola de salida | Siempre (envía cambios a Woo) |
| ⚡ Importación de pedidos | Si quieres importación automática |
| ⚡ Sincronización de stock | Si quieres sync automático |
**Guarda los cambios** con el botón «Guardar».
—
## 3. Importar Productos
### Acceder al wizard
1. Ve a **Inventario** o **Ventas**
2. Menú **WooCommerce > Importar Productos**
### Modos de importación
#### Opción A: Importar UN producto específico
1. Selecciona **»Importar un producto específico»**
2. Introduce el **ID del producto** en WooCommerce
– Lo encuentras en WooCommerce: `Productos > Editar > URL`
– Ejemplo: `post=123` → el ID es `123`
3. Clic en **»Importar»**
> 💡 Puedes importar varios IDs separados por comas: `123,456,789`
#### Opción B: Importar por fechas
1. Selecciona **»Importar desde una fecha»**
2. Elige **Fecha Desde** y **Fecha Hasta**
3. Clic en **»Importar»**
4. Se activará un CRON que importará 50 productos cada 3 minutos
#### Opción C: Importar TODOS
1. Selecciona **»Importar TODOS los productos»**
2. Clic en **»Importar»**
3. Se activará un CRON que importará todos los productos automáticamente
> ⚠️ Para tiendas grandes, esto puede tardar varias horas
### Ver el progreso
1. Ve a **WooCommerce > Cola de Productos**
2. Verás todos los productos pendientes, procesados o con error
### ¿Qué se importa?
| Dato | Se importa |
|——|————|
| Nombre | ✅ |
| SKU | ✅ |
| Precio regular | ✅ |
| Precio de oferta | ✅ |
| Stock | ✅ (si está configurado) |
| Variantes | ✅ |
| Atributos (Talla, Color…) | ✅ |
| Imágenes | ❌ |
| Descripción larga | ❌ |
—
## 4. Importar Pedidos
### Importación manual
1. Ve a **Ventas > WooCommerce > Importar Pedidos**
2. Configura:
– **Fecha Desde**: Desde cuándo importar
– **Estados**: Qué estados traer (ej: `processing,completed`)
– **Límite**: Cuántos pedidos máximo
3. Clic en **»Importar Pedidos»**
### Importar UN pedido específico
1. En el wizard, introduce el **Número de Pedido** WooCommerce
2. Clic en **»Importar»**
### Importación automática
Si activaste el CRON de importación incremental:
– Se ejecuta cada **5 minutos**
– Trae solo pedidos **nuevos** desde la última sincronización
– Evita duplicados automáticamente
### Ver pedidos importados
1. Ve a **WooCommerce > Cola de Pedidos**
2. Estados:
– 🟡 **Pendiente**: Esperando procesamiento
– 🔵 **Procesando**: En proceso
– 🟢 **Procesado**: Pedido creado en Odoo
– 🔴 **Error**: Falló (ver mensaje de error)
### Procesar cola manualmente
1. En la lista de cola, selecciona los pedidos pendientes
2. Clic en **Acción > Procesar Seleccionados**
—
## 5. Importar Contactos
### Importación manual
1. Ve a **WooCommerce > Importar Contactos**
2. Opciones:
– **Importar TODOS**: Trae todos los clientes de WooCommerce
– **Por ID**: Introduce el ID del cliente
– **Por Email**: Busca por email específico
3. Clic en **»Importar»**
### Cola de contactos
Los contactos se procesan automáticamente si el CRON está activo.
—
## 6. Sincronizar Stock
### Desde Odoo hacia WooCommerce
Cuando cambias el stock en Odoo, puedes sincronizarlo a WooCommerce:
#### Opción A: Un producto
1. Abre la ficha del producto
2. Pestaña **WooCommerce**
3. Clic en **»📤 Sincronizar Stock»**
#### Opción B: Varios productos
1. Ve a **Inventario > Productos > Variantes de Producto**
2. Selecciona los productos con el checkbox
3. Clic en **Acción > 📤 Sincronizar Stock a WooCommerce**
### Sincronización automática
Si activaste el CRON de sincronización de stock:
– Se ejecuta cada **15 minutos**
– Procesa **100 productos** por ejecución
– Recorre todo el catálogo progresivamente
### Excluir productos de la sincronización
1. Abre la ficha del producto
2. Pestaña **WooCommerce**
3. Marca ✅ **»No sincronizar stock con Woo»**
### Desde WooCommerce hacia Odoo
Cuando importas productos, el stock se actualiza automáticamente si:
1. Activaste **»Actualizar inventario al importar»** en Ajustes
2. Configuraste la **Ubicación de Stock**
—
## 7. Sincronizar Precios
### Campos de precio WooCommerce
Cada producto tiene dos campos especiales:
– **Precio WooCommerce**: Precio regular
– **Precio Oferta WooCommerce**: Precio rebajado (opcional)
### Sincronizar precios a WooCommerce
#### Opción A: Un producto
1. Abre la ficha del producto
2. Pestaña **WooCommerce**
3. Edita los precios si es necesario
4. Clic en **»💰 Sincronizar Precios»**
#### Opción B: Varios productos
1. Ve a la lista de variantes de producto
2. Selecciona los productos
3. Clic en **Acción > 💰 Sincronizar Precios a WooCommerce**
> 💡 Los precios se ponen en cola y se procesan cada 2 minutos
—
## 8. Mapear Métodos de Envío
Para que los pedidos tengan el método de envío correcto:
### Paso 1: Sincronizar métodos desde WooCommerce
1. Ve a **WooCommerce > Métodos de Envío > Sincronizar**
2. Clic en **»Sincronizar»**
3. Se importarán todos los métodos configurados en WooCommerce
### Paso 2: Crear mapeos
1. Ve a **WooCommerce > Mapeo Métodos Envío**
2. Clic en **»Crear»**
3. Selecciona:
– **Método WooCommerce**: El método importado
– **Carrier Odoo**: El transportista en Odoo
4. Guarda
### Resultado
Cuando se importe un pedido con ese método de envío, automáticamente se asignará el carrier de Odoo correspondiente.
—
## 9. Mapear Métodos de Pago
### Paso 1: Sincronizar métodos desde WooCommerce
1. Ve a **WooCommerce > Métodos de Pago > Sincronizar**
2. Clic en **»Sincronizar»**
3. Se importarán: PayPal, Transferencia, Contra reembolso, etc.
### Paso 2: Crear mapeos
1. Ve a **WooCommerce > Mapeo Métodos Pago**
2. Clic en **»Crear»**
3. Vincula cada método de WooCommerce con uno de Odoo
—
## 10. Mapear Impuestos
### Detección automática
1. Ve a **WooCommerce > Impuestos > Sincronizar**
2. Selecciona **»Automático (Buscar en todas las órdenes)»**
3. Clic en **»Sincronizar»**
4. El sistema detectará los impuestos usados en los pedidos
### Crear mapeos
1. Ve a **WooCommerce > Mapeo Impuestos**
2. Clic en **»Crear»**
3. Vincula:
– **Impuesto WooCommerce**: IVA 21%, IVA 10%, etc.
– **Impuesto Odoo**: El impuesto correspondiente en Odoo
4. Guarda
### Resultado
Los pedidos importados tendrán los impuestos correctamente aplicados.
—
## 11. Configurar Webhooks
Los webhooks permiten que WooCommerce **notifique a Odoo en tiempo real** cuando ocurre algo.
### Configuración inicial
1. Ve a **WooCommerce > Webhooks > Configuración**
2. Verás webhooks predefinidos para:
– Pedido creado
– Producto actualizado
– Cliente creado
### Activar un webhook
1. Selecciona el webhook deseado
2. Clic en **»Registrar en WooCommerce»**
3. Si es exitoso, el estado cambiará a **Activo**
### Requisitos importantes
⚠️ **Tu servidor Odoo debe ser accesible desde Internet**
– La URL de Odoo debe ser pública (no `localhost`)
– El puerto debe estar abierto
– Ejemplo: `https://miodoo.com`
### ¿Qué hacen los webhooks?
| Webhook | Acción |
|———|——–|
| Pedido creado | Agrega pedido a la cola automáticamente |
| Producto actualizado | Actualiza el producto en Odoo |
| Cliente creado | Agrega contacto a la cola |
—
## 12. Gestionar Colas
### Cola de Pedidos
**Ubicación:** WooCommerce > Cola de Pedidos
| Estado | Significado | Acción |
|——–|————-|——–|
| 🟡 Pendiente | Esperando | Se procesará automáticamente |
| 🔵 Procesando | En proceso | Espera |
| 🟢 Procesado | Completado | Ver pedido creado |
| 🔴 Error | Falló | Revisar error y reprocesar |
| ⛔ Fallo Permanente | 3+ intentos | Investigar manualmente |
**Acciones disponibles:**
– Ver pedido original (JSON)
– Procesar manualmente
– Ver pedido creado en Odoo
### Cola de Productos
**Ubicación:** WooCommerce > Cola de Productos
Mismos estados que la cola de pedidos.
### Cola de Salida
**Ubicación:** WooCommerce > Cola de Salida
Esta cola contiene las operaciones pendientes de enviar a WooCommerce:
– Actualizaciones de stock
– Actualizaciones de precio
– Cambios de estado de pedido
**Se procesa automáticamente cada 2 minutos.**
—
## 13. Acciones Masivas
### Desde la lista de productos
1. Ve a **Inventario > Productos > Variantes de Producto**
2. Selecciona varios productos con el checkbox
3. Clic en **»Acción»**
4. Opciones disponibles:
– **📤 Sincronizar Stock a WooCommerce**
– **💰 Sincronizar Precios a WooCommerce**
### Desde un pedido de venta
1. Abre el pedido vinculado a WooCommerce
2. Clic en **»Actualizar Estado en WooCommerce»**
3. El estado se sincronizará según:
– Pedido cancelado → `cancelled`
– Albarán validado → `completed`
– Pedido confirmado → `processing`
### Desde un albarán
1. Abre el albarán de salida
2. Clic en **»Actualizar Estado en WooCommerce»**
3. Si el albarán está validado, marcará el pedido como `completed`
—
## 14. Solución de Problemas
### «Error de conexión con WooCommerce»
**Causas posibles:**
1. URL incorrecta (falta `https://`)
2. Credenciales incorrectas
3. SSL no válido
**Solución:**
– Verifica la URL (prueba en el navegador)
– Regenera las credenciales API en WooCommerce
– Desactiva «Verificar SSL» temporalmente para probar
### «Producto no encontrado en WooCommerce»
**Causa:** El SKU o ID no coincide.
**Solución:**
1. Abre el producto en Odoo
2. Verifica que tenga `woo_product_id` correcto
3. Si es variación, verifica `woo_variation_id`
### «El stock no se actualiza»
**Causas posibles:**
1. El producto está marcado como «No sincronizar»
2. No hay ubicación de stock configurada
3. El CRON de cola de salida está desactivado
**Solución:**
1. Verifica que el producto no tenga ✅ «No sincronizar stock»
2. En Ajustes, configura la Ubicación de Stock
3. Activa el CRON de cola de salida
### «Los pedidos se quedan en error»
**Pasos para diagnosticar:**
1. Ve a la Cola de Pedidos
2. Abre el pedido con error
3. Lee el **Mensaje de Error**
**Errores comunes:**
– «Partner no encontrado» → Falta el email del cliente
– «Producto no existe» → El SKU no coincide con ningún producto
– «Tax mapping not found» → Falta mapear el impuesto
### «El webhook no funciona»
**Verificaciones:**
1. ¿Tu Odoo es accesible públicamente?
2. ¿El webhook está en estado «Activo»?
3. ¿Hay errores en el log de Odoo?
**Prueba manual:**
1. En WooCommerce, ve a los webhooks
2. Busca el webhook registrado
3. Clic en «Entregar» para forzar un envío de prueba
### «Los precios no se actualizan en WooCommerce»
**Verificaciones:**
1. ¿El producto tiene precio regular mayor a 0?
2. ¿La cola de salida se está procesando?
3. ¿Hay errores en la cola de salida?
### Ver logs detallados
Para problemas complejos:
1. Activa el modo debug en Odoo (`?debug=1` en la URL)
2. Revisa los logs del servidor
3. Busca mensajes con `[WOO` para filtrar
—
## Consejos Útiles
### Antes de importación masiva
1. **Haz backup** de tu base de datos Odoo
2. Prueba con **pocos productos** primero
3. Verifica los **mapeos** de impuestos y envíos
### Para mejor rendimiento
1. **No actives todos los CRONs** si no los necesitas
2. Ajusta los **intervalos** según tu volumen
3. Procesa colas **en horarios de bajo tráfico**
### Mantén la sincronización
1. **Mapea todo** antes de importar pedidos
2. **Revisa colas** regularmente
3. **Soluciona errores** antes de que se acumulen
—
## Resumen de Menús
| Menú | Para qué |
|——|———-|
| Ajustes > WooCommerce | Configuración general |
| WooCommerce > Importar Pedidos | Importación manual |
| WooCommerce > Importar Productos | Importación de productos |
| WooCommerce > Importar Contactos | Importación de clientes |
| WooCommerce > Cola de Pedidos | Ver estado de importación |
| WooCommerce > Cola de Productos | Ver productos pendientes |
| WooCommerce > Cola de Salida | Ver operaciones hacia Woo |
| WooCommerce > Métodos de Envío | Sincronizar y mapear |
| WooCommerce > Métodos de Pago | Sincronizar y mapear |
| WooCommerce > Impuestos | Sincronizar y mapear |
| WooCommerce > Webhooks | Configurar notificaciones |
—
## Soporte
¿Necesitas ayuda adicional?
– 📧 **Email:** soporte@upevo.es
– 🌐 **Web:** https://upevo.es
– 📖 **Documentación técnica:** Ver `Readme2.md`
—
**¡Gracias por usar Upevo WooCommerce Connector!** 🚀