Agente de Sincronización

Sincronización automática de datos de asistencia desde dispositivos biométricos ZKTeco a la nube de AttendUX.

Guía de Uso Agente de Sincronización

Descripción General

El Agente de Sincronización de AttendUX es una aplicación ligera de escritorio para Windows que conecta sus dispositivos biométricos ZKTeco locales con la plataforma en la nube de AttendUX.

Se ejecuta en segundo plano, extrayendo periódicamente registros de asistencia de sus dispositivos ZKTeco y subiéndolos automáticamente a su servidor AttendUX.

Consejo: El Agente de Sincronización solo necesita instalarse en UN computador que esté en la misma red local que sus dispositivos ZKTeco.

Descarga e Instalación

Descargue el instalador del Agente de Sincronización y siga el asistente de configuración:

1

Descargar el Instalador

Descargue la última versión del Agente de Sincronización: Descargar Attendux-Sync-Agent.exe

2

Ejecutar el Instalador

Haga doble clic en el archivo descargado y siga el asistente de instalación. Acepte la configuración predeterminada.

3

Iniciar el Agente

Después de la instalación, el Agente se iniciará automáticamente. Verá su icono en la bandeja del sistema.

AttendUX Sync Agent — Setup

AttendUX Sync Agent

v2.1.0 · Windows Desktop

Installation Complete!
Launch Agent
Close
Captura: Instalador del Agente de Sincronización

Configuración

Configure el Agente con los detalles de su servidor e información del dispositivo:

Campo Descripción Ejemplo
URL del ServidorLa dirección de su servidor AttendUXhttps://suempresa.attendux.com
Código de EmpresaSu identificador único de empresaCOMP-001
Clave APIClave de autenticación desde Configuración → Integracionessk_live_xxx...
Intervalo de SincronizaciónCon qué frecuencia sincronizar datos (en minutos)5
IP del DispositivoDirección IP local del dispositivo ZKTeco192.168.1.201
AttendUX Sync Agent — Config
Configuración
https://company.attendux.com
COMP-001
sk_live_xxxxxxxxxxxxx
192.168.1.201
5 min
Connected · Last sync: 2 min ago
Save & Sync Now
Captura: Configuración del Agente

Cómo Funciona la Sincronización

El proceso de sincronización sigue estos pasos automáticamente:

1

Conectar al Dispositivo

El agente se conecta a su dispositivo ZKTeco a través de la red local mediante TCP/IP.

2

Obtener Nuevos Registros

Recupera todos los nuevos registros de marcación desde la última sincronización.

3

Subir a la Nube

Los registros se envían de forma segura a su servidor AttendUX mediante HTTPS y se asocian automáticamente a los empleados.

Consejo: El Agente mantiene un registro local de todas las operaciones. Consulte la pestaña de Registros si sospecha de registros faltantes.

Ejecutar como Servicio

Para máxima fiabilidad, puede configurar el Agente para ejecutarse como servicio de Windows para que inicie automáticamente al encender el computador.

Abra la configuración del Agente y active "Ejecutar como Servicio de Windows". Esto asegura la sincronización continua incluso sin usuario conectado.

Advertencia: El computador con el Agente debe permanecer encendido y conectado a la misma red que los dispositivos ZKTeco.

Solución de Problemas

Problemas comunes de sincronización y cómo resolverlos:

No se puede conectar al dispositivo

Verifique la IP del dispositivo, asegúrese de que esté encendido y que el computador y dispositivo estén en la misma red. Intente hacer ping a la IP.

No se sincronizan datos

Asegúrese de que la clave API sea correcta y no haya expirado. Verifique que la URL del servidor incluya https://. Confirme que el dispositivo tenga nuevos registros.

Registros duplicados

El agente tiene deduplicación integrada. Si aparecen duplicados, limpie la caché del agente y resincronice. Asegúrese de que solo una instancia esté ejecutándose.