Como sincronizar el dispositivo Zkteco con Tempo

1.0 Propósito

Este documento establece el procedimiento técnico estándar y los parámetros de configuración mandatorios para la correcta puesta en marcha de terminales de control de asistencia ZKTeco. El objetivo es asegurar la integración y sincronización de datos (registros de empleados y marcajes) con la plataforma de gestión de personal Tempo, utilizando el servicio de servidor en la nube Ntime (ntime.rankmi.com) bajo el protocolo ADMS (Advanced Data Management System).

2.0 Ámbito

Este procedimiento aplica a todos los dispositivos de hardware ZKTeco que requieran conectividad directa con la plataforma Ntime para el reporte de eventos de Tiempo y Asistencia (T&A).

3.0 Prerrequisitos Críticos

Antes de iniciar la configuración del hardware, es una condición indispensable verificar lo siguiente:

• Integridad del Maestro de Empleados: La plataforma de origen (Tempo) debe contener la totalidad de la base de datos de trabajadores que serán gestionados por el dispositivo.
• Flujo de Sincronización: La sincronización de usuarios se origina en Tempo y se propaga hacia el dispositivo ZKTeco. El dispositivo no puede enrolar usuarios localmente en este modo.
• Consecuencia de Omisión: Si el maestro de empleados no está completo en Tempo antes de la vinculación, el dispositivo ZKTeco solo recibirá y procesará marcajes de la lista parcial de empleados que haya logrado sincronizar, resultando en pérdida de datos de asistencia.

4.0 Procedimiento de Configuración del Terminal

Siga la siguiente secuencia de pasos en la interfaz del dispositivo ZKTeco para establecer la conectividad ADMS.

4.1. Obtención del Identificador del Dispositivo (ID/SN)

El Número de Serie (SN) o ID del dispositivo es el identificador único (clave primaria) que vincula el hardware físico con la instancia de la plataforma Ntime/Tempo.

1. Método Físico: Inspeccione la etiqueta de especificaciones adherida al reverso del terminal.
2. Método de Software (Recomendado):
   • Acceda al menú del dispositivo.
   • Navegue a la ruta: Menú Principal > Información > Información del equipo.
   • Localice y registre el valor de ID del dispositivo (o SN).

Nota: Este ID debe ser comunicado al administrador de la plataforma Tempo/Ntime para que el dispositivo sea registrado y autorizado en el servidor.

4.2. Configuración de Red (Ethernet)

Se debe verificar que el puerto de comunicación TCP para el servicio ADMS esté correctamente asignado.

1. Navegue a la ruta: Menú Principal > Red > Ethernet.
2. Verifique el siguiente parámetro:
   • Puerto TCP: El valor debe ser 4370.

4.3. Configuración del Servidor en la Nube (ADMS)

Esta sección define el endpoint de destino al cual el dispositivo enviará todos los eventos de asistencia.

1. Navegue a la ruta: Menú Principal > Red > Conf. Srvr. de Nube.
2. Configure los siguientes parámetros de forma exacta:
   • Dirección del Servidor: ntime.rankmi.com
   • Modo de servidor: ADMS
   • Habilitar Nombre de Dominio: Activado (Esto instruye al dispositivo a utilizar el servicio DNS para resolver el FQDN ntime.rankmi.com a su dirección IP correspondiente).

4.4. Definición del Protocolo de Comunicación

Este paso final asegura que el dispositivo opere en el modo PUSH T&A, requerido para la comunicación ADMS.

1. Navegue a la ruta: Menú Principal > Sistema > Tipo de Dispositivo.
2. Configure los siguientes parámetros:
   • Protocolo de Comunicación: Protocolo PUSH
   • Tipo de Dispositivo: push DE T&A

Análisis Técnico: Al seleccionar Protocolo PUSH, el terminal ZKTeco actúa como cliente e inicia activamente la conexión con el servidor (ntime.rankmi.com:4370). Enviará los marcajes (eventos de asistencia) en tiempo real o en intervalos definidos tan pronto como ocurran, eliminando la necesidad de que el servidor sondee (modo 'pull') el dispositivo.

5.0 Resumen de Parámetros de Configuración

6.0 Preguntas Frecuentes (FAQ)

P1: He configurado todo según el documento, pero los marcajes no llegan a Tempo. ¿Qué verifico?

R: Este es un problema común de conectividad. Realice la siguiente lista de verificación:

1. Conexión ADMS: En el menú Conf. Srvr. de Nube, verifique si aparece un ícono de "conectado" (usualmente un globo terráqueo). Si está desconectado, el problema es de red.
2. Firewall: Asegúrese de que la red local donde está conectado el dispositivo tenga permiso para realizar conexiones salientes al puerto TCP 4370.
3. DNS: Verifique que el dispositivo tenga un servidor DNS configurado (usualmente vía DHCP) para poder resolver el dominio ntime.rankmi.com.
4. Registro de ID: Confirme con el administrador de Tempo que el ID/SN del dispositivo (obtenido en el paso 4.1) fue ingresado correctamente en la plataforma. Un ID incorrecto hará que el servidor rechace la conexión.

P2: Los empleados nuevos que ingreso en Tempo no aparecen en el dispositivo ZKTeco. ¿Por qué?

R: El flujo de datos es Tempo -> Ntime -> ZKTeco. Que un empleado no aparezca en el terminal indica una falla en la sincronización descendente. Debe forzar una sincronización desde la plataforma Tempo (generalmente hay una opción de "Sincronizar Dispositivos" o "Enviar Empleados") para que la nueva información sea "empujada" (pushed) al terminal ZKTeco. El dispositivo por sí solo no puede "jalar" (pull) esta información en modo ADMS.

P3: ¿Qué sucede si la opción "Habilitar Nombre de Dominio" falla o la red no tiene DNS?

R: Si la resolución de nombres de dominio (DNS) es un problema en la red, puede optar por una configuración de IP estática.

1. Desde un computador en la misma red, obtenga la dirección IP de ntime.rankmi.com (ej. usando el comando ping ntime.rankmi.com).
2. En el dispositivo ZKTeco (ruta Conf. Srvr. de Nube), ingrese esa dirección IP estática (ej. 190.x.x.x) en el campo Dirección del Servidor.
3. Desactive la opción Habilitar Nombre de Dominio.
   Advertencia: Esta configuración no es recomendada, ya que si la dirección IP del servidor ntime.rankmi.com cambia en el futuro, la conexión fallará y requerirá una reconfiguración manual.

P4: ¿Cuál es la diferencia entre el "Puerto TCP" (4370) y el "Puerto del Servidor" que a veces aparece en la misma pantalla?

R: El Puerto TCP (4370) es el puerto local en el dispositivo que escucha las conexiones entrantes (aunque en modo PUSH se usa menos). El Puerto del Servidor (que también debe ser 4370 si no se especifica lo contrario en la Dirección del Servidor) es el puerto remoto en ntime.rankmi.com al cual el dispositivo se conectará (conexión saliente) para enviar los datos. La configuración de este documento se centra en el puerto local 4370 (Ethernet) y la dirección ntime.rankmi.com (Conf. Srvr. Nube), asumiendo que el puerto remoto 4370 está implícito.