Cómo probar un terminal ZKTeco sin comprar hardware: sandbox virtual paso a paso

El costo real de "probar con un equipo real"

Si desarrollas un SaaS de nómina, un sistema de condominios o una plataforma de RRHH, en algún momento un cliente te va a preguntar: "¿puedes leer mis terminales ZKTeco?". El camino tradicional se ve así:

• Comprar un terminal de prueba: entre $250 y $900 USD según el modelo.
• Logística de importación en Latinoamérica: semanas de espera y aranceles variables.
• Montar un servidor local o una VPN solo para hacer las primeras pruebas.
• Dedicar tiempo de tu equipo antes de saber si el feature vale la pena.

Es decir: cientos de dólares y semanas de fricción antes de la primera línea de integración. Para un equipo de producto, eso suele significar que el feature nunca sale del backlog.

Qué puedes validar sin tocar hardware

El sandbox de API Connect crea hasta 2 terminales virtuales con las mismas capacidades que un terminal físico conectado a la nube:

• Registro de terminales con número de serie, modelo y fecha de expiración.
• Eventos de acceso en tiempo real: marcaciones otorgadas, denegadas y pulsos de sincronización.
• Reportes de asistencia consultables por rango de fechas, con paginación.
• Usuarios y credenciales: alta de personas con PIN, tarjeta y grupos de acceso.
• Expiración de dispositivos: prueba cómo se comporta tu lógica cuando un terminal vence.

Paso a paso: de cero a tu primer evento

1. Crea tu cuenta (14 días gratis, sin tarjeta)

El registro toma menos de un minuto. Al entrar al dashboard tienes acceso al sandbox, al API y a los reportes durante todo el trial.

2. Crea tu primer terminal virtual

Desde el sandbox del dashboard, crea un terminal virtual. Recibirás su número de serie simulado, que es la llave para todo lo demás.

3. Simula marcaciones desde el navegador

La pantalla de simulación te deja interactuar con el terminal virtual: registrar marcaciones de entrada y salida, y generar eventos de acceso. Cada evento queda en tu historial como si viniera de un equipo físico.

4. Autentica tu software contra la API

Tu backend se autentica con credenciales de tu cuenta y recibe un token para llamar a la API REST:

curl -X POST https://TU-DOMINIO-API/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "tu_usuario", "password": "tu_password"}'

# Respuesta
{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "token_type": "bearer",
  "expires_in": 3600
}

5. Consulta las marcaciones generadas

Con el token, pide el reporte del terminal virtual con el rango de fechas que quieras:

curl -X GET "https://TU-DOMINIO-API/report/TU-SERIAL?from=2026-09-01&to=2026-09-14&page=1&per_page=500" \
  -H "Authorization: Bearer {token}"

La respuesta llega en JSON listo para mapear a tus modelos: marcación, persona, método de verificación y fecha exacta. Si tu software ya importa CSV de marcadores, este paso es la diferencia entre un proceso manual semanal y datos en vivo.

6. (Opcional) Consume los eventos como stream

Si tu arquitectura prefiere reaccionar a eventos en vez de consultar, puedes suscribirte a los eventos del terminal y procesarlos a medida que ocurren:

import { createClient } from 'redis';

const sub = createClient({
  socket: { host: process.env.REDIS_HOST, port: Number(process.env.REDIS_PORT) },
  password: process.env.REDIS_PASSWORD
});

await sub.connect();

await sub.subscribe('punch_TU-SERIAL', (message) => {
  const event = JSON.parse(message);
  console.log('nueva marcación:', event.pin, event.timestamp);
  // aquí dispara tu lógica de negocio
});

Cuándo pasar a producción

El día que el feature queda aprobado, la transición es la parte fácil: los terminales físicos del cliente se registran y apuntan a la nube, y tu software sigue llamando a las mismas URLs. No hay fase de "reescritura" porque sandbox y producción comparten la misma API.

El valor para tu producto, en una frase

Puedes responder "sí, leemos tus terminales ZKTeco" en una demo con datos reales el mismo día que surge la oportunidad comercial — sin comprar nada, sin esperar importaciones y sin montar infraestructura.

Preguntas frecuentes