En este artículo

Sincronización con Odoo

Odoo es un sistema de gestión empresarial (ERP) usado por muchas empresas para llevar inventario, facturación, contabilidad, compras y operaciones. Si tu empresa ya usa Odoo como fuente única de verdad de productos e inventario, esta integración permite que tu tienda Vendabo se mantenga sincronizada automáticamente con Odoo:

• Catálogo (productos, categorías, imágenes) viaja de Odoo → Vendabo.
• Inventario por almacén viaja de Odoo → Vendabo.
• Pedidos viajan de Vendabo → Odoo (para que tu equipo los procese desde donde ya trabaja).

El resultado: el equipo administrativo sigue trabajando en Odoo como siempre, y los cambios aparecen reflejados en la tienda online sin intervención manual.

Requisitos previos

1. Módulo de Odoo contratado en tu plan de Vendabo. Si la sección Aplicaciones → Odoo no aparece en el menú lateral, contacta al equipo comercial.
2. Cuenta de Odoo activa (en la nube o auto-hospedada). Versiones soportadas: Odoo 14 a 19+.
3. Usuario en Odoo con acceso de API. Recomendamos crear un usuario dedicado (ej. api@miempresa.com) en lugar de usar uno administrativo personal.
4. Clave de acceso (API Key) generada en Odoo para ese usuario.

Generar tu clave de acceso en Odoo

Antes de configurar Vendabo, necesitas la clave de acceso:

1. Inicia sesión en tu Odoo.
2. Entra a Preferencias → Seguridad (o Preferences → Account Security en inglés).
3. Busca la opción "Claves API" o "API Keys".
4. Crea una nueva clave con un nombre descriptivo (ej. "Vendabo - Sincronización").
5. Copia la clave inmediatamente — Odoo solo la muestra una vez.

Configurar la conexión en Vendabo

1. En el menú lateral entra a Aplicaciones → Odoo.
2. Marca "Habilitar integración con Odoo".
3. En la sección Conexión llena:
   • URL de Odoo: la dirección completa de tu Odoo (ej. https://miempresa.odoo.com).
   • Base de datos: solo si tu instancia tiene varias bases de datos (ej. miempresa). Si no, déjalo vacío.
   • Usuario: el email del usuario de Odoo (ej. api@miempresa.com).
   • Clave de acceso: pega aquí la clave que generaste en el paso anterior.
4. Haz clic en "Guardar".

Si la conexión funciona, verás un aviso verde "Conectado — Odoo versión X" debajo de la sección. Si falla, revisa que los datos sean correctos y que el usuario tenga permisos suficientes en Odoo.

Sincronización de catálogo

Esta sección controla cómo viajan los productos de Odoo hacia tu tienda.

Cómo activarla

1. Marca "Activar sincronización de catálogo".
2. Elige el intervalo de sincronización: cada cuántos minutos Vendabo le pregunta a Odoo si hay cambios. Opciones: 5, 15, 30, 60 o 120 minutos.
3. Guarda.

Qué se sincroniza desde Odoo

• Categorías de productos (se importan como categorías de tu tienda).
• Productos con sus datos básicos (título, descripción, precio, peso, SKU).
• Variantes (talla, color, etc.) si el producto tiene varias en Odoo.
• Imágenes de cada producto.

Los productos nuevos llegan a Vendabo en estado "Borrador" (no visibles al cliente). Tú decides cuáles activar y mostrar públicamente. Esto evita que productos internos o no destinados a la tienda online aparezcan por accidente.

Qué pasa cuando editas un producto en Vendabo

Vendabo respeta las ediciones locales que haces:

• Solo el precio se sobrescribe automáticamente desde Odoo en cada sincronización.
• Título, descripción, estado (activo/borrador), imágenes que editaste en Vendabo se respetan.

Esto te permite tener un Odoo orientado a operaciones internas y una tienda con contenido más comercial (mejores fotos, textos persuasivos), sin que la sincronización destruya tu trabajo.

Recomendación de intervalo

• 15 minutos para la mayoría de tiendas — buen balance entre frescura y carga del sistema.
• 5 minutos si tu inventario cambia muy rápido (ventas masivas, reposiciones constantes).
• 60-120 minutos si tu Odoo es lento o tu catálogo cambia poco (catálogo estable, ventas moderadas).

Sincronización de inventario por almacén

Si en Odoo manejas varios almacenes y en Vendabo tienes varias sucursales, necesitas decirle al sistema cuál corresponde a cuál.

Cargar los almacenes desde Odoo

1. Una vez conectado, baja a la sección "Mapeo de almacenes".
2. Haz clic en "Cargar almacenes de Odoo".
3. Vendabo trae la lista de almacenes que tienes configurados en Odoo.

Asignar cada sucursal a un almacén

Para cada sucursal de Vendabo, elige el almacén de Odoo correspondiente en el desplegable y marca la casilla "Sincronizado" para que el inventario se actualice automáticamente.

Atención: NO mapees dos almacenes de Odoo a la misma sucursal interna — el inventario del segundo sobrescribiría al del primero. Si tienes varios almacenes que alimentan la misma sucursal, consolídalos primero en Odoo.

Sincronización de pedidos

Esta sección controla cuándo viajan los pedidos de Vendabo hacia Odoo.

Cuándo enviar el pedido

Elige el momento en que Vendabo crea el pedido en Odoo:

• Se realice el pedido — apenas el cliente completa la compra (incluye pedidos no pagados aún).
• Se marque como Pagado — cuando el pago se confirma (recomendado para la mayoría).
• Se marque como Preparado — cuando ya preparaste el pedido para envío.
• Manual (botón) — solo cuando tú haces clic en "Enviar a Odoo" desde la pantalla del pedido.

ID de producto de envío

Como Odoo necesita una línea para el costo de envío, debes indicarle qué producto usar:

1. En Odoo, crea un producto llamado "Flete" o "Envío" (tipo Servicio, no inventariable).
2. Anota su ID (lo ves en la URL del producto en Odoo).
3. Pega ese ID en el campo "ID de producto de envío en Odoo" en Vendabo.

Para clientes en República Dominicana (NCF)

Si tu Odoo está configurado para emitir comprobantes fiscales (NCF) y la versión de Odoo está entre 8 y 12, aparecen dos campos adicionales:

• Posición fiscal — Consumidor final: ID en Odoo para facturas tipo B02.
• Posición fiscal — Crédito fiscal: ID en Odoo para facturas tipo B01.

Vendabo decide automáticamente qué posición fiscal usar según el cliente:

• Si el cliente pidió comprobante fiscal con su RNC → Crédito fiscal (B01).
• Si no → Consumidor final (B02).

Para conseguir esos IDs: en Odoo entra a Contabilidad → Configuración → Posiciones fiscales y abre cada una; el ID aparece en la URL.

Mapeo de impuestos

Cada impuesto que tengas en Vendabo (ITBIS, ITBIS reducido, etc.) debe asociarse con su equivalente en Odoo para que se aplique correctamente en los pedidos.

1. Una vez conectado, baja a la sección "Mapeo de impuestos".
2. Haz clic en "Cargar impuestos de Odoo".
3. Para cada impuesto interno, elige el impuesto de Odoo equivalente en el desplegable.

Sin este mapeo, los pedidos podrían llegar a Odoo con los impuestos incorrectos o como exentos.

Notificaciones automáticas desde Odoo (solo Odoo Enterprise 18+)

Si tu Odoo es versión 18 o superior y tienes licencia Enterprise, puedes activar notificaciones instantáneas desde Odoo hacia Vendabo. Esto reemplaza la sincronización periódica con avisos en tiempo real:

1. Marca "Recibir webhooks de Odoo" y guarda.
2. Aparecen dos valores: URL del webhook y Secret (clave secreta).
3. Cópialos.
4. En tu Odoo, crea una Regla de Automatización apuntando a la URL, con el secret como cabecera X-Odoo-Webhook-Secret.

Con esto, cualquier cambio en productos o stock en Odoo se refleja en Vendabo en cuestión de segundos en lugar de esperar al próximo intervalo.

Acciones manuales

Aunque la sincronización es automática, a veces quieres forzar una sincronización ahora mismo (ej. acabas de cargar productos nuevos en Odoo y no quieres esperar el próximo ciclo):

• Sincronizar catálogo ahora — trae los cambios de productos/categorías/imágenes inmediatamente.
• Sincronizar stock ahora — trae los niveles de inventario inmediatamente.

Ambos botones están al final de la pantalla.

Casos típicos

"Mi empresa ya trabaja con Odoo, quiero abrir tienda online"

• Configura Odoo como fuente única del catálogo.
• Activa sincronización de catálogo cada 15 min y de inventario.
• Los productos llegan como borrador — actívalos manualmente en Vendabo a medida que estén listos para venta online (fotos, descripciones, etc.).
• Configura envío de pedidos "Cuando se marque como Pagado".

"Quiero que el equipo de Odoo procese todos los pedidos online sin tener que duplicar trabajo"

• Activa sincronización de pedidos con el momento que prefieras (recomendado: "Pagado").
• Configura el ID de producto de envío para que el flete viaje correctamente.
• Mapea correctamente las posiciones fiscales si emites NCF en RD.

"Soy una tienda con catálogo estable, no necesito sincronización tan frecuente"

• Pon intervalo de catálogo en 60 o 120 minutos.
• Mantén sincronización de inventario activa (es la que más importa para no vender lo que no tienes).

"Edité un producto en Vendabo (mejor foto, mejor texto) y temo que la sincronización lo borre"

• Tranquilo. Vendabo solo sobrescribe el precio desde Odoo. Título, descripción, imágenes y estado se mantienen.
• Si quieres que cierto producto NO se sincronice nunca, ponlo manualmente como "Borrador" o desactívalo — Vendabo lo respeta.

"El catálogo en Odoo tiene productos que no quiero en la tienda online"

• Los productos nuevos llegan como borrador. Si los dejas así, nunca aparecen al cliente.
• Una mejor práctica: en Odoo, marca esos productos como "no publicable en eCommerce" si tu versión lo soporta — Vendabo respeta esa señal.

Tips finales

• Empieza con el intervalo recomendado de 15 minutos. Ajústalo después según veas el comportamiento (productos llegan rápido, sistema no se sobrecarga, etc.).
• Crea un usuario de Odoo dedicado para Vendabo. Es más fácil de auditar, no se ve afectado por cambios de personal, y puedes desactivarlo sin tocar otras integraciones.
• Guarda la clave de acceso en un lugar seguro. Si la pierdes, tienes que generar una nueva en Odoo y actualizar Vendabo.
• Si tu Odoo está temporalmente caído, la integración se reintenta automáticamente. No tienes que hacer nada — cuando Odoo vuelve, la próxima sincronización recupera los cambios perdidos.
• Para auditar qué pasó: la pantalla de Odoo muestra contadores ("X productos sincronizados, Y con errores") y la última hora de sincronización. Si ves muchos errores recurrentes, contacta al equipo técnico para revisar el detalle.
• Si cambias de versión de Odoo (ej. actualizas de 16 a 18), no necesitas reconfigurar nada — la integración detecta la nueva versión y se adapta automáticamente.
• Mantén un usuario alternativo no-Odoo para emergencias. Si Odoo está caído por horas y necesitas crear un producto urgente, lo creas directo en Vendabo. Cuando Odoo vuelva, recuerda crearlo también allá para mantener la consistencia.

Siguiente paso

Con Odoo conectado, el flujo operativo queda integrado. Si necesitas integrar tu tienda con otros sistemas externos (CRM, ERPs personalizados, herramientas de análisis avanzadas), el siguiente artículo cubre la integración por API y webhooks para desarrolladores e integradores externos.