Conexiones Odoo

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 con su titulo y su precio. Su stock se carga en la corrida siguiente.

En los articulos que ya existen solo se actualizan el precio y el stock: si cambias el nombre de un producto en Odoo, el titulo en Mercasist no cambia. Otros datos (imagenes, descripciones, categorias) tampoco 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 espacios al inicio o al final se ignoran).

• 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.
• Si tu Odoo guarda existencias con decimales (por ejemplo 1,5 unidades), Mercasist las redondea hacia abajo (1) para no vender lo que no tienes completo.

Cada cuanto se ejecuta

La sincronizacion corre sola, en dos ritmos segun la hora del dia:

No existe un boton para sincronizar manualmente: si el interruptor de sincronizacion automatica esta apagado, simplemente no se sincroniza nada.

Datos de la conexion

• URL de Odoo — La direccion del servidor de tu instancia (por ejemplo: https://mi-empresa.odoo.com).
• 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.
• Compania — Solo aparece si elegiste una compania con Configurar Compania. Si no se muestra, la conexion lee todas las companias de tu 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.

Configurar Compania

Odoo permite manejar varias companias dentro de una misma base de datos. Cada una puede tener sus propios productos, listas de precios y almacenes. Esta opcion le indica a Mercasist con cual de ellas debe trabajar.

Al abrirla, Mercasist consulta en ese momento las companias a las que tiene acceso tu usuario de Odoo y te las muestra para que elijas una:

• Una compania — la sincronizacion, la lista de productos, las listas de precios y las locaciones solo muestran lo que pertenece a esa compania, mas lo que en Odoo este marcado como compartido entre todas.
• Todas las companias (sin filtro) — es la opcion por defecto: Mercasist lee todo lo que tu usuario de Odoo pueda ver.

Al guardar con "Guardar Compania", el nombre de la compania elegida aparece en la tarjeta de la conexion.

Si tu Odoo tiene una sola compania, o tus productos estan compartidos entre todas, puedes dejarla en Todas las companias. Despues de cambiar la compania, revisa Configurar Precios y Configurar Locaciones: la lista de precios y las locaciones que tenias asignadas deben pertenecer a la nueva compania.

Configurar Locaciones

Define de que ubicaciones de Odoo se toma el stock y a que almacen de Mercasist corresponde cada una. El modal lista las locaciones internas de 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.
• Puedes buscar por nombre, compania o ID de locacion, y filtrar entre Asignadas y Sin asignar. Muy util cuando tu Odoo tiene muchas ubicaciones.
• Si el almacen que necesitas no existe, elige "+ Crear nuevo almacen" en el selector: se crea y queda asignado en el mismo paso.

Modal de configuracion de locaciones con locaciones asignadas a almacenes

Para administrar tus 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:

Conversion de bolivares a dolares

Si tus precios estan en bolivares en Odoo y los registras en dolares en Mercasist, la conversion usa la tasa del dolar cargada en tu propio Odoo. Asi los montos cuadran exactamente con los de tu ERP.

Como proteccion, Mercasist usa la tasa BCV en su lugar cuando la tasa de tu Odoo no es confiable: si no se puede leer, si nunca se cargo, si tiene mas de 7 dias sin actualizarse o si se aleja mas de un 10% de la BCV. Para cualquier otra combinacion de monedas se usa la tasa de Mercasist.

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. Los precios que ves ya aplican tu configuracion de precios y de compania, y las variantes con el mismo SKU aparecen consolidadas en una sola fila, igual que en 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 y borra la conexion de forma definitiva. Para evitar eliminaciones por accidente, se confirma en dos pasos:

Eliminar tambien es la forma de limpiar conexiones duplicadas, por ejemplo si guardaste la misma conexion varias veces. Despues de eliminar, las tareas programadas de esa conexion pueden seguir apareciendo hasta 3 horas, pero ya no hacen ningun cambio.