Antes de comenzar
Antes de iniciar la conexión entre Odoo Online y Yuju, asegúrate de contar con acceso a la cuenta de Odoo que utilizarás para configurar la integración y con los permisos necesarios para gestionar la información que será sincronizada.
Importante: Si el usuario no cuenta con estos permisos, la integración podría no funcionar correctamente.
Paso a paso para conectar con Yuju
A continuación te explicamos cómo completar cada uno de los campos de la tarjeta de conexión.
Usuario
No es necesario crear un usuario nuevo en Odoo; puedes utilizar un usuario existente si lo prefieres.
Permisos requeridos: El usuario que se vaya a conectar debe contar obligatoriamente con permisos de creación y actualización en las siguientes secciones:
Productos
Clientes
Ventas
Facturas
Pagos
Movimientos de almacén
Picking (Albaranes)
API Key
Generar la API Key en Odoo
Paso 1. Acceder a las preferencias del usuario
Ingresa a Odoo con el usuario que utilizarás para la integración y dirígete a “Mis Preferencias”.
Paso 2. Acceder a la sección de API Keys
Dentro de las preferencias del usuario, ingresa a la pestaña “Seguridad” y ubica la sección “API Keys (Claves API)”.
Paso 3. Crear una nueva API Key
Haz clic en “Agregar clave API” (New API Key). Se abrirá una ventana donde deberás completar los siguientes campos:
Nombre su clave / Key Name: Asigna un nombre que permita identificar el propósito de la conexión (por ejemplo:
Yuju).Select a scope (Alcance): Obligatorio. Selecciona el parámetro
RPC. Este parámetro es indispensable para que la clave tenga el alcance adecuado y permita la sincronización entre ambos sistemas.Duración para la validez de la clave: Selecciona el periodo de vigencia deseado (por ejemplo,
1 Weeko la duración según tus políticas internas).
Paso 4. Generar y guardar la API Key
Haz clic en “Generar clave”. Una vez creada, copia y guarda la API Key en un lugar seguro. Por motivos de seguridad, esta clave debe tratarse como una contraseña y no debe compartirse públicamente.
Paso 5. Ingresar la API Key en Yuju
Durante el proceso de conexión de Odoo Online con Yuju, utiliza la clave generada en Odoo en el campo “API Key” o “Contraseña”, según la información solicitada en la pantalla de conexión.
Configurar la renovación automática de la API Key
Las API Keys de Odoo tienen una vigencia limitada. Para evitar que la conexión con Yuju se interrumpa cuando la clave expire, puedes habilitar su actualización automática agregando un parámetro en la configuración del sistema de Odoo.
Recomendación: Habilita esta opción para mantener activa la conexión con Yuju sin necesidad de renovar manualmente la API Key.
Paso 1. Acceder a Odoo como administrador
Ingresa a Odoo utilizando un usuario con permisos de administrador.
Paso 2. Habilitar el modo desarrollador
Activa el “Modo desarrollador” desde la configuración de Odoo.
Paso 3. Acceder a los parámetros del sistema
Dirígete al menú: Ajustes → Técnico → Parámetros del sistema
Paso 4. Crear el parámetro
Agrega un nuevo registro con la siguiente información:
Campo | Valor |
Clave | base.enable_programmatic_api_keys |
Valor | True |
Paso 5. Guardar los cambios
Guarda el nuevo registro para completar la configuración.
URL de la tienda
URL de Odoo (La URL debe comenzar con https:// hasta “.com” o similar.
Ejemplo de URLS correctas:
Ejemplo de URLS incorrectas:
Base de datos
Nombre de la base de datos que crearon en Odoo. Asegúrate de ingresar los datos correctos para completar la conexión.
El nombre de la base de datos lo puedes consultar con el área técnica que instalar Odoo
En caso de no saber el nombre de la base de datos seguir estos pasos:
Activar modo desarrollador en odoo
En la parte superior derecha de la pantalla, debajo del nombre de usuario aparecerá el nombre de la base de datos.
En caso de que el nombre no aparezca completo, dar clic derecho sobre el nombre de la base de datos y seleccionar la opción que dice “inspeccionar”.
Dentro de la ventana que aparece podremos revisar el nombre de la base de datos, ejemplo:
Consideraciones importantes
La API Key es información sensible. No la compartas públicamente ni la envíes por canales no seguros.
Si la API Key expira y la actualización automática no está habilitada, será necesario generar una nueva clave y volver a configurar la conexión.
Los permisos del usuario de Odoo son necesarios para que Yuju pueda operar correctamente sobre la información que corresponda a la integración.
Para cualquier duda y/o aclaración, ponte en contacto con tu KAM asignado o escribiendo a soporte@yuju.io.