Activación y configuración¶
Capítulo para el partner Odoo
Esta página está escrita para quien administra la instancia Odoo de la organización. Si no es tu caso, te basta con saber que la activación la hace vuestro partner Odoo con el soporte de AppToMe: vuelve a Qué se sincroniza.
El conector es un módulo Odoo que se instala en la instancia del cliente. No es un servicio alojado por AppToMe: se ejecuta dentro de Odoo, bajo el control de quien administra Odoo.
Requisitos previos¶
- Odoo 18, Community o Enterprise, incluso vanilla.
- Los módulos estándar que el conector necesita se instalan como dependencias: contactos, recursos humanos y asistencias, partes de horas, flota, proyectos, productos y autenticación OAuth.
- Odoo debe ser accesible desde internet en HTTPS, con el proxy inverso configurado correctamente para el reenvío de las cabeceras de protocolo y host — si no, el acceso con cuenta AppToMe no funciona.
- La organización debe estar habilitada para la sincronización del lado de AppToMe.
El conector no requiere módulos específicos para la localización italiana: siguen siendo una elección del cliente, a instalar por separado si hacen falta para las obligaciones fiscales.
Las cinco fases¶
1. Instalar el módulo¶
El módulo se obtiene del repositorio público de AppToMe y se coloca entre los addons de la instancia. Tras reiniciar el servidor, desde la sección Aplicaciones se actualiza la lista, se busca Apptome Connector y se instala.
2. Pedir las credenciales¶
Las credenciales de conexión son específicas de la organización y las entrega el soporte de AppToMe. Incluyen las direcciones de los servicios AppToMe y las claves para el acceso y para la sincronización.
Trátalas como contraseñas
Las credenciales valen para toda la organización. No hay que ponerlas en tickets, chats o repositorios, y en Odoo el acceso a los parámetros del sistema debe limitarse solo a los administradores. Si sospechas que se han expuesto, pide enseguida la rotación al soporte.
3. Configurar el conector¶
Desde Ajustes → Ajustes generales → Apptome se rellenan las direcciones y las claves recibidas, se activa el acceso con cuenta AppToMe y se activa la sincronización de los datos. Al guardar, el conector actualiza por sí solo el proveedor de acceso y las acciones planificadas.
Si una misma instancia Odoo sirve a varias organizaciones, la configuración de la sincronización es por empresa: cada empresa Odoo tiene sus direcciones y sus claves, que deben ser distintas entre sí.
4. Primera alineación¶
Es la fase que requiere atención, y la única en la que hace falta alguien de la organización: solo quien conoce a las personas sabe decir si dos fichas parecidas son la misma persona.
Registros — desde Ajustes → Apptome → Bootstrap desde Apptome el módulo descarga los voluntarios y los compara con los contactos ya presentes en Odoo, usando el NIF, el correo y el nombre completo. Para cada fila se elige:
| Elección | Cuándo usarla |
|---|---|
| Vincular a un partner existente | la persona ya está en Odoo — es el caso más frecuente |
| Crear un partner nuevo | la persona aún no existe en Odoo |
| Saltar | la fila hay que revisarla antes de decidir |
Después se confirma. Las filas saltadas se pueden retomar en un segundo pase.
Todo lo demás — desde Apptome → Sincronizar desde Apptome → Sincronización completa se inicia la carga de capacidades, calendarios, vehículos, licencias, cursos, turnos, actividades, checklists y horas. La carga respeta el orden de dependencia entre los datos, así que hay que lanzarla después de la alineación de los registros: las horas necesitan a las personas ya vinculadas.
En una organización con años de historial la carga completa puede durar mucho: ponla en un momento de bajo uso.
5. Verificar¶
Comprobaciones rápidas que dicen si la activación ha salido bien:
- Contactos → Voluntarios Apptome enumera los voluntarios, sin duplicados;
- la página de acceso de Odoo muestra el botón Acceder con Apptome (se ve estando desconectado);
- Apptome → Formación → Licencias obtenidas muestra las licencias con las caducidades;
- la acción planificada Apptome — Sincronizar contactos (horaria) está activa;
- al certificar las horas de un turno en AppToMe, en pocos minutos aparece la asistencia correspondiente en Odoo.
La última comprobación es la que cuenta: si funciona, funciona la cadena entera.
Habilitar el acceso con cuenta AppToMe¶
El conector no crea usuarios Odoo por sí solo, y es una decisión intencionada: un sistema de gestión no debe llenarse de usuarios porque alguien haya pulsado un botón.
Los voluntarios sincronizados se convierten en contactos, no en usuarios que puedan entrar en Odoo. Quien debe acceder al sistema de gestión hay que habilitarlo uno a uno, vinculando su usuario Odoo con la cuenta AppToMe. Por norma afecta a pocas personas: personal y administración.
Una cuenta no vinculada que intenta acceder recibe un mensaje de invitación caducada. No es una avería: es el rechazo correcto de un acceso no previsto.
Actualizaciones¶
El conector y AppToMe evolucionan juntos. Tras una actualización importante de uno conviene actualizar también el otro: algunos errores de sincronización nacen de versiones desalineadas entre los dos lados.
Mantenimiento ordinario¶
- Mantén activa la acción planificada que devuelve los registros hacia AppToMe.
- Comprueba de vez en cuando la diagnóstica: es ahí donde se ve si algo se ha parado.
- Tras una parada prolongada de Odoo, vuelve a lanzar la sincronización completa (o la de la entrada concreta afectada) para recuperar lo que ha pasado mientras tanto.