Conectar Odumbo con tu base de Odoo
La cuenta de Odoo de una integración
La Cuenta de Odoo es el registro dentro de Odumbo que guarda las credenciales con las que la plataforma entra a tu base. Sin ese registro confirmado, la integración no tiene a dónde escribir las ventas ni de dónde leer el stock y los precios.
Las credenciales son las mismas para los tres canales: una Cuenta de Odoo confirmada sirve para una integración de Mercado Libre, de Tiendanube o de Shopify, y una misma cuenta puede usarse en varias integraciones.
Odumbo recomienda hacer primero la vinculación utilizando una base de datos de desarrollo o "test" en Odoo. Eso te garantizará un entorno seguro para parametrizar la integración y realizar pruebas antes de conectarlo definitivamente a la base de producción.
Credenciales que necesita Odumbo
Odumbo pide cuatro datos de tu instancia de Odoo.
| Credencial | Qué es | Dónde sale |
|---|---|---|
| Dominio de la base | La URL completa de tu instancia de Odoo | La barra de direcciones del navegador |
| Nombre de la base | El nombre exacto de la base de datos | Debajo de tu nombre de usuario, con el modo de desarrollador activo |
| Nombre de usuario o Email | El correo con el que inicias sesión habitualmente en Odoo | Tu propio dato de acceso |
| API Key (Llave de acceso) | Una clave que reemplaza a la contraseña para la conexión | Tu perfil de Odoo, sección de claves API |
Permisos del usuario de la conexión
El usuario que declaras en Nombre de usuario o Email es el usuario con el que Odumbo entra a tu base, así que tiene que poder hacer todo lo que la integración hace: crear y confirmar ventas, leer stock y leer precios de venta. Estos son los permisos que conviene tener habilitados; algunos pueden no aplicar o no existir en tu base.
| Sección de Ajustes | Permiso |
|---|---|
| Administrador | Administración: Ajustes |
| "Ventas" | Ventas: Administrador |
| Contabilidad | Contabilidad: Facturación |
| "Inventario" | Solicitud de existencias: Usuario de solicitudes de existencias · Inventario: Administrador |
| Technical Settings | Gestión de "Productos" ☑️ · Configurar Límite de Crédito en Partners ☑️ |
Cuando un test de la integración falla, este es el primer lugar donde mirar: la causa habitual es que al usuario de la conexión le falta uno de estos permisos. Después revisa, dentro de la integración, que los parámetros indicados sean los correctos, haciendo clic en cada lupa 🔎.
Obtener las credenciales en tu base de Odoo
Recolecta los cuatro datos antes de tocar Odumbo.
Prerequisitos
- Un usuario de Odoo que pueda activar el modo de desarrollador y crear claves API en su propio perfil.
- La contraseña de ese usuario: Odoo la pide para confirmar tu identidad al generar la clave.
Para obtener las credenciales:
- Abre Odoo en una pestaña paralela del navegador.
- Copia de la barra de direcciones la URL completa de tu instancia: ese es el Dominio de la base.
- Entra al menú de "Ajustes", desplázate hasta el final de la pantalla y haz clic en el enlace "Activar modo de desarrollador".
- Con la página recargada, ubica tu nombre de usuario en la esquina superior derecha: justo debajo aparece, en color amarillo, el Nombre de la base. Si el nombre es muy largo y aparece abreviado, haz clic derecho sobre el nombre de usuario, selecciona "Inspect" o "Inspeccionar" y busca el nombre completo en la estructura HTML del elemento resaltado.
- Haz clic en tu nombre de usuario y selecciona "Mi perfil".
- Abre la pestaña "Seguridad de la cuenta" y, en el apartado "CLAVES API" de la sección inferior, haz clic en "Nueva clave API".
- Ingresa tu contraseña de Odoo cuando el sistema te la pida.
- Escribe un nombre identificativo para la clave (por ejemplo, "Odumbo").
Configuración crítica: en el campo de duración para la validez de la clave, debes cambiar la opción por defecto (1 Day) y seleccionar "Persistent Key" (Clave persistente). De lo contrario, la conexión caducará en 24 horas.
Una vez que hagas clic en "Generar clave", Odoo muestra un código alfanumérico en color rojo. Copia este código inmediatamente, ya que por motivos de seguridad no volverá a mostrarse en pantalla.
Al terminar tienes las cuatro credenciales a mano: dominio, nombre de la base, usuario y API Key.
Crear la cuenta de Odoo en Odumbo
Registra las credenciales en Odumbo y verifica que la conexión funcione.
Prerequisitos
- Las cuatro credenciales del procedimiento anterior.
- Una integración ya creada en Odumbo (por ejemplo, de Tiendanube), con acceso a su panel de configuración.
Para crear la cuenta de Odoo:
- En el panel de tu integración, desplázate hasta el campo "Cuenta de Odoo" y haz clic en "+ Nuevo".
- Completa el formulario con los datos obtenidos: Dominio de la base, Nombre de la base, Nombre de usuario o Email y la API Key / Llave de acceso recién generada.
- Haz clic en el botón "Testear y Confirmar", en la esquina superior izquierda.
- Verifica que el estado del registro pase de "Borrador" a "Confirmados" en la barra de etapas de la derecha.
¡Conexión exitosa! Para finalizar el proceso, haz clic en el enlace superior para regresar a la pantalla principal de tu integración y, en el menú desplegable del campo "Cuenta de Odoo", selecciona la cuenta que acabas de configurar.
Próximos pasos
- Gestionar tu integración: pasar de Sandbox a Producción, activar la sincronización y consultar el historial.