Si algo no cuadra¶
El conector trabaja en silencio: mientras todo funciona no hay nada que mirar. Cuando en cambio un dato no llega, esta página dice cómo darse cuenta y qué mirar antes de llamar a alguien.
La primera comprobación¶
Casi todos los avisos del tipo «en Odoo falta algo» se resuelven con tres preguntas, en este orden:
- ¿El dato existe en AppToMe? Un turno no certificado no produce horas. Una checklist empezada y no concluida no es una checklist rellenada.
- ¿La persona está vinculada? Si el voluntario no aparece entre los Voluntarios Apptome en Odoo, todo lo que le concierne se queda atrás.
- ¿La sincronización está encendida? Si se ha parado, no falta un solo dato: faltan todos los posteriores al momento en que se paró.
Si falta una sola cosa, mira los puntos 1 y 2. Si falta todo a partir de cierta fecha, es el punto 3.
Dónde se mira en Odoo¶
El menú Apptome → Diagnóstica reúne dos listas:
- Registro de eventos entrantes — todo lo que el conector ha recibido, con el resultado. Sirve para responder a la pregunta «¿ha llegado?».
- Eventos muertos/fallidos — lo que no ha conseguido pasar y ha dejado de reintentar. Si esta lista está vacía, la sincronización está sana; si no lo está, hay algo que arreglar.
Los eventos que se han quedado atrás se pueden volver a encolar desde el mismo menú, tras haber eliminado la causa del bloqueo. Volver a encolar sin resolver la causa hace que fallen de nuevo.
Cómo viajan los datos, y qué pasa si Odoo está apagado¶
Saber esto evita los dos movimientos equivocados más comunes: esperar un dato que nunca llegará, y relanzarlo todo por un retraso de diez minutos.
Cada modificación sale por su cuenta. Cuando en AppToMe algo cambia — un turno certificado, una checklist cerrada, un vehículo actualizado — se pone en cola y se envía enseguida: en condiciones normales en Odoo se ve en unos instantes. No hay un «envío nocturno» que esperar.
Si Odoo no responde, el conector reintenta solo. Los intentos se repiten a distancias crecientes, algunas veces; mientras haya intentos restantes el evento solo está fallido, no perdido. Una interrupción breve — un reinicio, un mantenimiento, una red que va y viene — se recupera sin que nadie haga nada.
Agotados los intentos el evento pasa a muerto y se detiene ahí. Es lo que aparece en Eventos muertos/fallidos. Desde ese momento no vuelve a arrancar solo: hay que volver a encolarlo a mano, tras quitar la causa. Es el motivo por el que esa lista vacía es la señal de salud más fiable que tenéis.
Una comprobación periódica recupera a los que se han quedado atrás. Cada pocos minutos los eventos aún pendientes o fallidos se vuelven a poner en cola, en orden de cuándo nacieron: los más viejos primero. Así que tras un bloqueo no hace falta relanzar nada — basta esperar unas cuantas rondas y ver si la cola se vacía.
Relanzar no duplica. Cada evento lleva consigo una marca que Odoo reconoce: si llega dos veces, la segunda se ignora. Volver a encolar, relanzar una sola entrada o rehacer la sincronización completa son operaciones seguras desde el punto de vista de los duplicados.
Las horas tienen una red de seguridad. Un turno puede concluir sin que nadie lo vuelva a tocar: una comprobación diaria repasa los turnos terminados en las últimas 48 horas y emite igualmente sus horas. Si faltan las horas de un turno de ayer, esperad esa ronda antes de comunicarlo; si faltan las de un turno de hace un mes, la causa es otra y está en la tabla de aquí abajo.
Situaciones frecuentes¶
| Síntoma | Causa más probable | Qué hacer |
|---|---|---|
| Las horas de un turno no aparecen en Odoo | el turno no se ha certificado | certifica el turno en AppToMe |
| Las horas de una persona no aparecen, las de los demás sí | la persona no está vinculada entre los dos sistemas | vuelve a lanzar la alineación de los registros y vincúlala |
| No llega nada más a partir de cierta fecha | la sincronización se ha suspendido o las credenciales ya no son válidas | el partner Odoo verifica la configuración y pregunta al soporte si hace falta regenerar las credenciales |
| La misma persona aparece dos veces en Odoo | durante la primera alineación se eligió Crear nuevo en lugar de Vincular | fusiona los dos contactos en Odoo, conservando el vinculado a AppToMe |
| El botón Acceder con Apptome no está | el acceso con cuenta AppToMe no está activo en la configuración | el partner Odoo lo activa desde los ajustes |
| El acceso dice que la invitación ha caducado | tu usuario Odoo no está vinculado a tu cuenta AppToMe | pide la vinculación a quien administra Odoo |
| Faltan los datos antiguos, los nuevos llegan | la carga inicial nunca se completó | el partner Odoo vuelve a lanzar la sincronización completa |
| Errores tras una actualización de uno de los dos sistemas | versiones desalineadas | actualiza también el otro lado |
Cuándo hace falta relanzarlo todo¶
Relanzar la sincronización completa es una operación segura — no duplica lo que ya está — pero puede ser larga. Tiene sentido:
- tras una parada prolongada de Odoo;
- tras haber vinculado muchos registros que se habían quedado atrás;
- tras una actualización que ha alineado las versiones de los dos lados.
También se puede relanzar una sola entrada (solo los turnos, solo las horas, solo las licencias) cuando el problema afecta a un ámbito concreto: es mucho más rápido.
Qué comunicar al soporte¶
Si el problema persiste, escribe al soporte de AppToMe indicando:
- el nombre de la organización;
- qué falta o está mal, con un ejemplo concreto: una persona, una fecha, un turno;
- desde cuándo ocurre;
- si en Apptome → Diagnóstica → Eventos muertos/fallidos hay algo, y cuánto;
- qué se ha probado ya.
Warning
No adjuntes nunca al aviso las claves o las credenciales de conexión, y no las pegues en un chat ni en un ticket. Al soporte le hace falta el nombre de la organización, no sus credenciales.