Conexiones Odoo
Conecta tu instancia de Odoo con Mercasist para sincronizar automaticamente el precio y el stock de tu inventario.
1. Como acceder
Desde el menu lateral izquierdo, haz clic en Inventario para expandir el submenu y luego selecciona Conexiones Odoo. Tambien puedes entrar directamente por la ruta /odoo/ de tu cuenta.
Pantalla principal de Conexiones Odoo con una conexion activa
La pagina muestra el breadcrumb Inventario / Conexiones Odoo y el listado de todas las conexiones configuradas. En la esquina superior derecha esta el boton "+ Nueva Conexion".
2. Permisos para operadores
El dueno de la cuenta siempre tiene acceso a Conexiones Odoo. Los operadores, en cambio, solo lo ven funcionar si les activas el modulo correspondiente.
Como dar el permiso
- En el menu lateral entra a Configuracion → Operadores.
- Ubica al operador en la lista y haz clic en "Asignar permisos".
- En el modal, busca el modulo "Inventario - Conexiones Odoo" y activa su interruptor.
- El cambio se guarda al instante; el operador lo vera al recargar su pantalla.
3. Como funciona la sincronizacion
La sincronizacion es unidireccional: los datos viajan de Odoo hacia Mercasist. Mercasist nunca escribe en tu Odoo, asi que tu ERP sigue siendo la fuente de la verdad.
Que se sincroniza
- Precio — se actualiza el precio del articulo en Mercasist cuando cambia en Odoo.
- Stock — se actualiza la cantidad disponible en cada almacen de Mercasist.
- Articulos nuevos — si un producto de Odoo tiene un SKU que aun no existe en tu inventario, Mercasist lo crea automaticamente.
Otros datos (imagenes, descripciones, categorias) no se traen desde Odoo: se gestionan en Mercasist.
Como se emparejan los productos
La union entre ambos sistemas es el SKU: la referencia interna del producto en Odoo se compara con el campo Modelo (SKU) del articulo de inventario en Mercasist. Deben coincidir exactamente.
- Los productos de Odoo sin SKU (o con el SKU generico
00000) no se sincronizan. - Si en Odoo hay varias variantes con el mismo SKU, Mercasist las consolida en un solo articulo: suma el stock de todas y toma el precio de la variante con mayor existencia.
Cada cuanto se ejecuta
La sincronizacion corre sola, en dos ritmos segun la hora del dia:
| Horario | Frecuencia |
|---|---|
| De 8:00 a 18:59 (horario laboral) | Cada 15 minutos |
| De 19:00 a 7:59 (horario nocturno) | Una vez por hora |
No existe un boton para sincronizar manualmente: si el interruptor de sincronizacion automatica esta apagado, simplemente no se sincroniza nada.
- La conexion debe estar en estado Activo.
- El interruptor de Sincronizacion automatica debe estar encendido.
- Debe existir una configuracion de precios guardada (sin ella la sincronizacion se detiene).
- Debe haber al menos una locacion asignada a un almacen (sin eso no se actualiza el stock).
4. Puesta en marcha paso a paso
Este es el orden recomendado para dejar la integracion funcionando desde cero:
1Crear la conexion
Con la URL, base de datos, usuario y contrasena de tu Odoo. Al guardar, Mercasist prueba las credenciales de inmediato.
2Probar la conexion
Desde el menu de tres puntos, usa Probar Conexion y confirma que el estado quede en Activo.
3Configurar precios
Obligatorio. Define las monedas de origen y destino, el origen del precio y, si lo necesitas, un ajuste porcentual. Mientras no exista esta configuracion, la sincronizacion no se ejecuta.
4Configurar locaciones
Necesario para el stock. Asigna cada locacion de Odoo al almacen de Mercasist que le corresponde. Las locaciones sin asignar se ignoran.
5Activar la sincronizacion automatica
Enciende el interruptor en la tarjeta de la conexion. La primera corrida puede tardar hasta 3 horas en arrancar, porque las tareas programadas se reconstruyen cada 3 horas. A partir de ahi ya corre con la frecuencia normal.
5. Crear una nueva conexion
Haz clic en el boton "+ Nueva Conexion" ubicado en la esquina superior derecha de la pagina. Se abrira un formulario con cuatro campos, todos obligatorios:
Formulario para crear una nueva conexion con Odoo
| Campo | Descripcion | Ejemplo |
|---|---|---|
| URL de Odoo | La URL completa de tu instancia de Odoo, incluyendo el puerto si es necesario. | https://mi-empresa.odoo.com |
| Base de Datos | El nombre de la base de datos en tu instancia de Odoo. | nombre_base_datos |
| Usuario | El usuario o correo electronico para autenticarse en Odoo. | usuario@ejemplo.com |
| Contrasena | La contrasena de acceso a ese usuario de Odoo. | — |
Al hacer clic en "Guardar Conexion", Mercasist intenta autenticarse contra tu Odoo en ese mismo momento:
- Si las credenciales son correctas, la conexion se guarda con estado Activo.
- Si la autenticacion falla, la conexion igual se guarda, pero queda en estado Inactivo para que puedas corregir los datos sin volver a empezar.
192.168.x.x, porque los servidores de Mercasist no pueden alcanzarla). Si tu instancia usa un puerto personalizado, incluyelo en la URL: http://mi-servidor.com:8069.
6. Informacion de una conexion
Cada conexion configurada se muestra como una tarjeta con la siguiente informacion:
Datos de la conexion
- URL de Odoo — La direccion del servidor de tu instancia (por ejemplo:
http://181.208.23.68:8069). - ID — Identificador unico de la conexion en Mercasist. Es util tenerlo a mano si escribes a soporte.
- Base de datos — Nombre de la base de datos configurada en Odoo.
- Usuario — El correo o usuario con el que Mercasist se autentica en Odoo.
Estado de la conexion
El badge de la esquina superior derecha refleja el resultado de la ultima verificacion de credenciales, y se actualiza solo:
- Activo — Mercasist logro autenticarse en tu Odoo.
- Inactivo — el ultimo intento fallo (credenciales incorrectas, servidor caido o URL inalcanzable).
El estado cambia al crear la conexion, al editarla y cada vez que usas Probar Conexion. No se edita a mano.
Sincronizacion automatica
El interruptor de cada tarjeta enciende o apaga la sincronizacion de esa conexion en particular.
- Encendida — Mercasist actualiza precio y stock con la frecuencia descrita arriba.
- Apagada — no se sincroniza nada. Tu inventario en Mercasist queda tal como esta, y lo administras manualmente.
Recuerda que un cambio en este interruptor puede tardar hasta 3 horas en tomar efecto.
7. Opciones de una conexion existente
Cada conexion tiene un menu de opciones accesible haciendo clic en el icono de tres puntos verticales (⋮) ubicado a la derecha del badge de estado.
Menu desplegable con las opciones disponibles para una conexion
Configurar Locaciones
Define de que ubicaciones de Odoo se toma el stock y a que almacen de Mercasist corresponde cada una. El modal lista todas las locaciones disponibles en Odoo con su compania y su ID, y un selector para elegir el almacen destino.
- Las locaciones que dejes en "Sin asignar" se ignoran por completo: su stock no llega a Mercasist.
- Si asignas varias locaciones al mismo almacen, Mercasist suma las existencias de todas ellas.
Modal de configuracion de locaciones con 4 locaciones asignadas a almacenes
Los almacenes disponibles en el selector son los que tengas creados en Mercasist. Para crear o renombrar almacenes, revisa el tutorial de Almacenes.
Configurar Precios
Define de donde sale el precio de cada producto y en que moneda se registra en Mercasist. Esta configuracion es obligatoria: sin ella la sincronizacion no se ejecuta.
Modal de configuracion de precios con seleccion de moneda de origen y destino
El modal tiene cuatro secciones:
| Seccion | Que define |
|---|---|
| Moneda de origen Requerido |
La moneda en la que estan cargados los precios en tu Odoo. Opciones: Bolivar (VES), Dolar (USD) y Euro (EUR). |
| Moneda de destino Requerido |
La moneda en la que se registrara el precio en Mercasist. Si es igual a la de origen no se aplica conversion. |
| Origen del precio Requerido |
Precio por Defecto: usa el precio de venta cargado en cada producto de Odoo. Lista de Precios: usa una tarifa especifica de Odoo, con sus reglas y descuentos; al elegirla debes seleccionar cual de tus listas se aplica. |
| Ajuste de precio Opcional |
Un porcentaje que se aplica sobre el precio final. Positivo para aumentar (ej. 15 suma 15%), negativo para descontar (ej. -10 resta 10%). Dejalo en 0.00 para traer el precio tal cual. |
Lista de Productos
Muestra el catalogo de la instancia de Odoo conectada, con imagen, titulo, SKU, precio (en moneda local y USD) y stock de cada producto. Incluye un buscador por nombre o SKU y el total de productos disponibles.
Es una pantalla de consulta: sirve para verificar que Mercasist esta leyendo correctamente tu catalogo y, sobre todo, para detectar productos sin SKU antes de encender la sincronizacion. Abrirla no modifica tu inventario.
Modal con la lista de productos leidos desde Odoo
Probar Conexion
Verifica en el momento que Mercasist puede autenticarse contra tu Odoo y actualiza el estado de la conexion segun el resultado. Es recomendable usarla despues de crear o editar una conexion, y cada vez que sospeches que la integracion dejo de funcionar.
Al ejecutarla veras la notificacion "Probando conexion..." y luego el resultado: "Conexion exitosa" si todo esta correcto, o un mensaje que describe el problema encontrado.
Notificaciones de prueba de conexion exitosa
Editar Conexion
Abre el formulario de edicion con los datos actuales para modificar la URL, la base de datos, el usuario o la contrasena.
- El campo de contrasena puede dejarse en blanco para conservar la actual sin cambios.
- Al guardar, Mercasist vuelve a probar las credenciales y ajusta el estado: si la prueba falla, la conexion queda Inactivo.
Formulario de edicion con los datos actuales de la conexion
Eliminar
Esta opcion aparece en rojo al final del menu.
Mientras tanto, para dejar de sincronizar con una instancia de Odoo, apaga el interruptor de sincronizacion automatica de esa conexion. Con eso la integracion queda detenida de inmediato. Si necesitas eliminar la conexion definitivamente, escribe a soporte.
8. Solucion de problemas
| Sintoma | Causa probable | Que hacer |
|---|---|---|
| La conexion queda en Inactivo al guardarla | Credenciales incorrectas, base de datos mal escrita o el servidor de Odoo no responde. | Edita la conexion, corrige los datos y usa Probar Conexion. Verifica que la URL sea accesible desde Internet. |
| El stock no se actualiza, pero el precio si | No hay locaciones asignadas a almacenes, o el stock esta en una locacion que quedo "Sin asignar". | Abre Configurar Locaciones y asigna cada locacion con existencias a un almacen. |
| No se sincroniza nada | Falta la configuracion de precios, el interruptor esta apagado o la conexion esta Inactiva. | Revisa los cuatro requisitos de la seccion 3. |
| Algunos productos nunca aparecen | Esos productos no tienen SKU en Odoo. | Asignales una referencia interna en Odoo. Usa Lista de Productos para identificar cuales estan sin SKU. |
| El precio llega distinto al de Odoo | Hay un ajuste porcentual configurado, una conversion de moneda activa, o el precio sale de una lista de precios con reglas propias. | Revisa las cuatro secciones de Configurar Precios. |
| Active la sincronizacion y no pasa nada | Las tareas programadas se reconstruyen cada 3 horas. | Espera hasta 3 horas antes de reportar un problema. |
| Un operador ve "No tienes permiso para acceder a este modulo" | Le falta el modulo de permisos. | Activale "Inventario - Conexiones Odoo" como se explica en la seccion 2. |
9. Resumen
| Accion | Descripcion |
|---|---|
| + Nueva Conexion | Crear una conexion con una instancia de Odoo (se verifica al guardar) |
| Sincronizacion automatica | Encender o apagar la sincronizacion de precio y stock de esa conexion |
| Configurar Locaciones | Asignar cada ubicacion de Odoo a un almacen de Mercasist (necesario para el stock) |
| Configurar Precios | Monedas, origen del precio y ajuste porcentual (obligatorio para sincronizar) |
| Lista de Productos | Consultar el catalogo que Mercasist lee desde Odoo (no modifica el inventario) |
| Probar Conexion | Verificar las credenciales y actualizar el estado de la conexion |
| Editar Conexion | Modificar URL, base de datos, usuario o contrasena |
| Eliminar | Funcion en desarrollo: aun no elimina la conexion |