Base de conocimiento para el personal y supervisores de Asistencia Alcaraván (v1.1.2). Encuentra soluciones a incidencias de geocercas, red institucional y gestión de terminales.
Mostrando todas las guías de soporte
Diagnóstico Rápido de Incidencias
Guía de causa raíz y pasos de acción inmediata para las fallas más comunes en la app móvil.
Seguridad Zero-Trusthardware_id
Cambio de Teléfono o Reinstalación
"Dispositivo pendiente de aprobación" o "Token inválido"
Causa Raíz: La app enlaza un único identificador físico de hardware (device_token) a tu ficha de empleado en Odoo. Si cambias de teléfono o reinstalas la app, el nuevo terminal genera un token distinto que queda bloqueado preventivamente.
Pasos de Solución:
El usuario no puede desbloquearlo individualmente desde el teléfono.
Notifica a la Dirección de Talento Humano o a tu Administrador de TI.
El supervisor accede a la app (pestaña Empleados) o al ERP Odoo y pulsa Desvincular Dispositivo (unlink_device).
Abre nuevamente tu app e inicia sesión: tu nuevo terminal quedará vinculado de inmediato.
Geolocalizacióngeofence
Indicador de Zona en Rojo ("Fuera de Zona")
"Ubicación no válida para la sede asignada"
Causa Raíz: GPS inactivo, permiso de Ubicación Precisa desactivado en los ajustes del sistema, o distancia física mayor al radio de tolerancia definido para tu sede (ej. Sede El Castrero).
En Android: Ajustes > Ubicación > activa Precisión de la ubicación de Google.
Asegúrate de estar físicamente dentro del campus o perímetro institucional.
Si estás en comisión externa, tramita tu marcaje por Salida Excepcional.
Conectividadssid
Red Corporativa Wi-Fi No Detectada
"Conéctese a la red corporativa de su sede"
Causa Raíz: Navegación por datos móviles 4G/LTE, conexión a una red de invitados, o falta del permiso de localización en iOS/Android (ambos sistemas operativos bloquean la lectura del nombre SSID si no hay permiso de ubicación activo).
Pasos de Solución:
Conéctate a la red Wi-Fi autorizada de la sede Alcaraván CIT.
Confirma que la app tenga permiso de ubicación concedido (exigido por Apple y Google).
Desactiva y vuelve a activar el Wi-Fi en tu dispositivo para refrescar la lectura del SSID.
Autenticación Locallocal_auth
Fallo o Cancelación en la Biometría
"Autenticación biométrica fallida o cancelada por el usuario"
Causa Raíz: Sensor de huella o cámara Face ID sucios, falta de biometría registrada en el sistema operativo del teléfono, o toque accidental fuera del diálogo nativo.
Pasos de Solución:
Limpia el sensor de huella o el sensor Face ID de tu teléfono.
La app ofrece autenticar con el código PIN / contraseña de bloqueo del teléfono como alternativa nativa inmediata.
Configura tus datos biométricos en los Ajustes de Seguridad del dispositivo.
Contingenciaoffline_sync
Marcaje Sin Internet (Modo Fuera de Línea)
"Entrada guardada localmente para sincronización posterior"
Causa Raíz: Pérdida transitoria del enlace de internet o interrupción de energía en la sede al momento de registrar tu llegada laboral.
Reglas de Sincronización Laboral:
La app registra la Entrada (Check-In) localmente con sello de tiempo criptográfico.
Ventana Estricta: Tienes un máximo de 12 horas para conectarte a internet y que el registro se audite y sincronice con Odoo.
Importante: La Finalización de Jornada (Check-Out) siempre requiere conexión a internet.
Protocolo Odoocircuit_breaker
Códigos de Error de Servidor y Red
Mensajes modales con código de protocolo
Causa Raíz: Latencia excesiva en el enlace, indisponibilidad del servidor Odoo o disparo del Circuit Breaker preventivo tras múltiples intentos continuos.
Acción por Código:
NETWORK_ERROR: Comprueba tu conexión a datos o Wi-Fi.
TIMEOUT: Servidor ocupado. Espera 60 segundos antes de reintentar.
RPC_ERROR: Mantenimiento técnico en Odoo. Notifica a TI.
Código de Error
Mensaje en la App
Causa Técnica
Acción Recomendada
NETWORK_ERROR
"Error de conexión con el servidor"
Sin salida a internet o DNS corporativo no responde.
Verificar conectividad a internet o reconectar a la red Wi-Fi institucional.
TIMEOUT
"La solicitud ha excedido el tiempo límite"
Respuesta de Odoo retrasada más allá del umbral programado.
Esperar 60 segundos para enfriamiento de peticiones y reintentar.
RPC_ERROR
"Error interno del servidor Odoo"
Excepción no controlada en el controlador Odoo 13.
El hardware ID del terminal no coincide con el registrado en Odoo.
Solicitar a RRHH la desvinculación del dispositivo en Odoo (unlink_device).
Preguntas Frecuentes y Procedimientos Operativos
Instrucciones de uso diario para colaboradores y supervisores de Alcaraván CIT.
Acceso, Cuentas y Dispositivos
Las cuentas no se crean de forma autónoma. Son asignadas directamente por la Dirección de Talento Humano en el ERP Odoo corporativo. Tu usuario es tu correo institucional de Alcaraván (ej. tunombre@alcaravan.com.ve) y tu clave inicial es tu número de Cédula de Identidad (solo números, sin puntos ni letras).
No. La plataforma es de uso exclusivamente interno para los trabajadores y contratistas de Alcaraván CIT. No existe formulario público de registro en apego a las políticas de seguridad laboral e identidad institucional.
No. Por normativas de auditoría laboral y prevención de suplantación, cada colaborador está enlazado a un único identificador físico de teléfono. Si intentas iniciar sesión en otro teléfono, el sistema te dirigirá a la pantalla de espera hasta que RRHH desvincule el anterior.
Jornada Laboral, Marcajes y Privacidad
1. Al llegar a tu sede, conéctate a la red Wi-Fi institucional.
2. Abre la app y confirma que los indicadores de Zona y Red muestren el check verde.
3. Presiona el botón amarillo central "ENTRADA" y confirma la lectura con tu huella dactilar o Face ID.
4. El cronómetro iniciará en estado "EN CURSO".
5. Al concluir tu jornada de trabajo, presiona "FINALIZAR JORNADA" para registrar tu salida.
Una Salida Excepcional se utiliza si debes retirarte antes del fin de tu jornada por causas justificadas (permiso médico, comisión institucional externa o diligencia autorizada). Al presionar el botón secundario en la app, seleccionas el motivo oficial precargado desde Odoo y redactas una nota justificativa para tu supervisor.
No, de ninguna manera. La app cumple estrictos estándares de privacidad laboral. Las coordenadas GPS solo se consultan en el segundo puntual en que presionas el botón de Entrada o Salida, con el único objetivo de corroborar que te encuentras en el perímetro de la sede de trabajo. No existe rastreo en segundo plano ni geolocalización fuera de la jornada.
Módulo de Administración y Recursos Humanos
Los colaboradores que poseen el rol admin en Odoo son redirigidos automáticamente al panel de administración (/(admin)) al iniciar sesión. Desde allí consultan telemetría en tiempo real, personal en sede, llegadas tardías y distribución horaria.
1. En la app móvil de Administrador, ve a la pestaña "Empleados".
2. Busca al colaborador por su nombre o número de cédula.
3. Abre su detalle y presiona el botón "Desvincular Dispositivo".
4. El sistema ejecuta POST /api/v1/admin/employees/unlink_device en Odoo, limpiando el device_token anterior.
5. El colaborador ya puede iniciar sesión en su nuevo equipo sin bloqueos.
Desde la pestaña "Zonas" de la consola de administración, los supervisores pueden crear nuevas sedes o ajustar parámetros existentes: nombre de la sede, coordenadas geográficas de referencia (latitud y longitud), radio de tolerancia en metros y el nombre de la red Wi-Fi autorizada (SSID).
Cumplimiento Normativo Apple App Store (Directrices 1.5 y 5.1.1(v))
Acreditación de soporte activo y ciclo de vida de cuentas para el identificador de paquete com.alcaravan.asistenciaap.
Esta página representa la Support URL oficial registrada en App Store Connect en cumplimiento con la Guideline 1.5 (Support URL). Los evaluadores de Apple y colaboradores pueden consultar las vías de contacto y las políticas de retención laboral a continuación.
Declaración de Ciclo de Vida de Cuentas (Guideline 5.1.1(v)):
Español: Esta aplicación es una herramienta empresarial de uso interno exclusivo para el personal de Alcaraván Sistemas Tecnológicos. Las cuentas de usuario son creadas, administradas y desactivadas centralizadamente por la Dirección de Talento Humano en el ERP Odoo, en conformidad con la legislación laboral venezolana. La app no admite auto-registro ni cuentas públicas comerciales. En virtud de ello, la funcionalidad de supresión de cuenta dentro de la app no aplica para cuentas laborales gestionadas por la organización. Para modificaciones de datos o terminación de acceso, el colaborador debe dirigirse a Talento Humano.
English (For Apple App Review Team): This application is an internal enterprise attendance tool designed exclusively for staff and contractors of Alcaraván Sistemas Tecnológicos. All user accounts are pre-provisioned and managed by the organization's HR department through our corporate Odoo ERP backend. The app does not support in-app account creation, nor is there a public registration flow. Therefore, Guideline 5.1.1(v) regarding user account deletion within the app does not apply as accounts are governed by corporate employment contracts and labor regulations. For employee data updates or account termination, staff must contact the HR department directly.
Canales Oficiales Alcaraván CIT
Sede Principal Institucional:
Alcaraván Sistemas Tecnológicos
Sector El Castrero, Carretera vía El Castrero
San Juan de los Morros, Estado Guárico, Venezuela.
Coordenadas: 9°53'19.8"N 67°23'38.4"W
