IoT Device Setup

🤖 Explicar con IA

Esta guía cubre la configuración y gestión de integraciones IoT para 4Geeks Perks, permitiendo el seguimiento en tiempo real y el canje automatizado de beneficios a través de dispositivos conectados.

Función Premium

Las integraciones IoT están disponibles exclusivamente en el plan Premium.

Resumen¶

4Geeks Perks soporta varios dispositivos IoT para crear una experiencia de canje de beneficios fluida y sin contacto:

Máquinas Expendedoras: Rastrea el consumo de snacks y bebidas en tiempo real
Estaciones de Café: Monitorea el uso de café y automatiza alertas de reabastecimiento
Mercados de Autoservicio: Minoría desatendida 24/7 con checkout automatizado
Lectores RFID: Habilita autenticación y pago basado en tarjeta en todos los puntos IoT
Casilleros Inteligentes: Entrega segura de paquetes y recogida de beneficios

Dispositivos Soportados¶

Máquinas Expendedoras¶

4Geeks Perks se integra con máquinas expendedoras inteligentes que soportan:

Lectores de tarjetas RFID
Sistemas de pago sin efectivo
Seguimiento de inventario
Monitoreo remoto
Datos de ventas en tiempo real

Marcas Compatibles: - Crane Merchandising Systems - Automatic Products International (API) - Seaga Manufacturing - TCN Vending - Soluciones personalizadas (vía API)

Estaciones de Café¶

Sistemas inteligentes de café y bebidas con:

Autenticación RFID
Seguimiento de uso
Análisis de consumo
Monitoreo automático de suministros
Métricas de calidad

Sistemas Compatibles: - Máquinas profesionales Jura - Sistemas de café Franke - Café expendedor Necta - Máquinas personalizadas habilitadas con IoT

Mercados de Autoservicio¶

Espacios minoristas desatendidos con:

Entrada controlada por RFID
Estantes inteligentes con sensores de peso
Visión por computadora para reconocimiento de productos
Checkout automatizado
Gestión de inventario en tiempo real

Soluciones Soportadas: - Socios tecnológicos de Amazon Just Walk Out - Micro-mercados estándar controlados por RFID - Configuraciones minoristas inteligentes personalizadas

Lectores RFID¶

Lectores RFID independientes para canje de beneficios:

Lectores HID Global
Lectores AWID
Lectores multi-tecnología (RFID + NFC)
Lectores de escritorio USB para uso administrativo

Requisitos Previos¶

Antes de configurar integraciones IoT:

Plan Premium: Asegúrate de que tu cuenta tenga acceso Premium
Infraestructura de Red:
Conexión a internet estable en las ubicaciones de los dispositivos
Conectividad Wi-Fi o Ethernet
Ancho de banda adecuado para transmisión de datos en tiempo real
Fuente de Alimentación: Conexión eléctrica confiable para todos los dispositivos
Espacio Físico: Ubicación apropiada con seguridad adecuada
Aprobación de TI: Coordina con tu departamento de TI para acceso a la red

Configurando la Integración de Máquinas Expendedoras¶

Paso 1: Preparación del Dispositivo¶

Asegúrate de que la máquina expendedora tenga:
Módulo controlador IoT instalado
Conectividad de red configurada
Lector RFID adjunto (si no está integrado)
Firmware actualizado a la última versión
Prueba la funcionalidad básica:
Dispensación de productos
Procesamiento de pagos
Comunicación de red
Lectura de tarjetas RFID

Paso 2: Registrar Dispositivo en 4Geeks Perks¶

Inicia sesión en la Consola de 4Geeks
Navega a Perks > IoT Devices > Add Device
Selecciona el tipo de dispositivo: Vending Machine
Completa los detalles del dispositivo:
Nombre del dispositivo: Nombre descriptivo (ej., “Building A - Floor 2 Vending”)
Ubicación: Ubicación física
Número de serie: Serie del fabricante
Dirección MAC: Identificador de red
Dirección IP: IP actual (si es estática)
Elige el método de integración:
API Directa: Para máquinas expendedoras inteligentes con API nativa
Middleware: Para máquinas que requieren traducción de protocolo
Sincronización manual: Para máquinas básicas con conectividad limitada
Haz clic en Register

Paso 3: Configurar Integración¶

Después del registro, haz clic en Configure en el dispositivo
Configura la conexión API:
Endpoint de API: URL de la API de la máquina expendedora
Autenticación: Clave de API o credenciales OAuth
Intervalo de sondeo: Frecuencia de sincronización de datos (recomendado: 5 minutos)
Asigna productos:
Importa el catálogo de productos de la máquina expendedora
Asigna categorías de beneficios (snacks, bebidas, opciones saludables)
Establece precios y reglas de subsidio
Configura reglas de canje:
Método de pago: Puntos de billetera, tarjeta RFID, o híbrido
Límites diarios: Máximo de transacciones por empleado
Empleados elegibles: Quién puede usar esta máquina
Prueba la conexión:
Haz clic en Test Connection
Verifica que los datos fluyan correctamente
Realiza una transacción de prueba
Haz clic en Save and Activate

Paso 4: Configuración del Empleado¶

Notifica a los empleados sobre el nuevo beneficio de máquina expendedora
Asegúrate de que todos los empleados tengan:
Cuenta activa de 4Geeks Perks
Tarjeta RFID activada
Saldo suficiente en la billetera
Proporciona instrucciones de uso:
Acércate a la máquina expendedora
Toca la tarjeta RFID en el lector
Selecciona el producto
Confirma el canje
Recoge el producto

Configurando la Integración de Estación de Café¶

Paso 1: Preparación de la Máquina¶

Asegúrate de que la máquina de café tenga:
Módulo IoT instalado
Conectividad de red
Lector RFID (integrado o externo)
Líneas de agua y suministros conectadas
Configura los ajustes de la máquina:
Tipos de bebidas disponibles
Tamaños de taza
Preferencias de temperatura
Programa de mantenimiento

Paso 2: Registrar Estación de Café¶

Ve a Perks > IoT Devices > Add Device
Selecciona el tipo de dispositivo: Coffee Station
Completa los detalles:
Nombre del dispositivo: (ej., “Main Break Room Coffee”)
Ubicación: Sala o área específica
Modelo de máquina: Fabricante y modelo
Número de serie: Para seguimiento de garantía
Elige el método de integración:
API Directa: Para máquinas inteligentes
Gateway IoT: Para máquinas con conectividad básica
Haz clic en Register

Paso 3: Configurar Beneficio de Café¶

Haz clic en Configure en el dispositivo registrado
Configura el catálogo de bebidas:
Espresso, americano, cappuccino, etc.
Opciones de té y chocolate caliente
Bebidas frías (si aplica)
Define los precios:
Gratis para todos los empleados
Subsidiado (ej., la empresa paga 80%)
Deducción de puntos de billetera
Límites diarios (ej., 3 bebidas por día)
Configura el seguimiento de uso:
Rastrea consumo por empleado
Monitorea horarios pico de uso
Establece alertas de reabastecimiento
Habilita notificaciones:
Advertencias de suministro bajo
Recordatorios de mantenimiento
Alertas de umbral de uso
Prueba la configuración:
Realiza un canje de prueba
Verifica que el seguimiento funcione
Verifica la entrega de notificaciones
Haz clic en Save and Activate

Configurando Mercado de Autoservicio¶

Paso 1: Infraestructura del Mercado¶

Los mercados de autoservicio requieren una configuración más extensa:

Configuración Física:
Sala segura o área cerrada
Sistema de entrada controlado por RFID
Estantes inteligentes o cámaras de visión por computadora
Estación de checkout (opcional para completamente automatizado)
Stack Tecnológico:
Sistema de control de acceso
Sistema de seguimiento de inventario
Integración de procesamiento de pagos
Cámaras de seguridad

Paso 2: Registrar Mercado¶

Ve a Perks > IoT Devices > Add Device
Selecciona el tipo de dispositivo: Self-Serve Market
Completa los detalles:
Nombre del mercado: (ej., “Building B Micro-Market”)
Ubicación: Dirección completa y sala
Horario de atención: 24/7 o horarios específicos
Capacidad: Máximo de usuarios concurrentes
Configura el control de acceso:
Vincula al sistema de compuerta RFID
Establece el método de autenticación de entrada
Define procedimientos de anulación de emergencia
Haz clic en Register

Paso 3: Configurar Catálogo de Productos¶

Haz clic en Configure en el mercado
Importa el inventario de productos:
Sube CSV con la lista de productos
Escanea códigos de barras para importación automática
Entrada manual para catálogos pequeños
Categoriza productos:
Snacks
Bebidas
Comidas
Cuidado personal
Suministros de oficina
Establece precios y subsidios:
Precio completo
Tarifa descontada
Solo puntos de billetera
Mezcla de métodos de pago
Configura el seguimiento de inventario:
Establece umbrales de reorden
Define información del proveedor
Habilita alertas de reorden automático
Prueba el sistema:
Entra con tarjeta RFID
Selecciona productos
Completa el checkout
Verifica la actualización del inventario
Verifica la deducción de la billetera
Haz clic en Save and Activate

Configuración de Lector RFID¶

Lectores RFID Independientes¶

Para ubicaciones sin dispositivos IoT completos:

Compra un lector RFID compatible
Conecta a la red:
USB a computadora local
Ethernet a la red
Configuración Wi-Fi
Registra en 4Geeks Perks:
Ve a Perks > IoT Devices > Add Device
Selecciona RFID Reader
Ingresa los detalles del dispositivo
Configura el endpoint
Prueba la lectura de tarjetas:
Toca la tarjeta RFID del empleado
Verifica la identificación del empleado
Confirma el acceso a la billetera
Despliega en la ubicación

Configuración del Lector RFID¶

Establece el modo del lector:
Solo autenticación: Verificar identidad
Pago habilitado: Procesar deducciones de billetera
Seguimiento de tiempo: Registrar horas de entrada/salida
Configura la seguridad:
Configuración de cifrado
Alertas de manipulación
Comportamiento del modo offline
Configura notificaciones:
Estado de conexión
Alertas de error
Informes de uso

Monitoreando Dispositivos IoT¶

Panel de Dispositivos¶

Ve a Perks > IoT Devices > Dashboard
Ver todos los dispositivos conectados:
Estado en línea/fuera de línea
Hora de última comunicación
Conteo de transacciones (hoy/mes)
Estado de error
Filtra por:
Tipo de dispositivo
Ubicación
Estado
Edificio

Detalles del Dispositivo¶

Haz clic en cualquier dispositivo para ver: - Estado en tiempo real - Historial de transacciones - Niveles de inventario (si aplica) - Programa de mantenimiento - Registros de errores - Métricas de rendimiento

Alertas y Notificaciones¶

Configura alertas para: - Dispositivo fuera de línea: Notificación inmediata - Inventario bajo: Advertencias basadas en umbrales - Alto uso: Detección de actividad inusual - Mantenimiento pendiente: Recordatorios programados - Error detectado: Alertas de mal funcionamiento del sistema

Configura en Perks > IoT Devices > Alerts

Solución de Problemas¶

Dispositivo Fuera de Línea¶

Verifica las conexiones físicas:
Fuente de alimentación
Cable de red
Estado del router/switch
Verifica la conectividad de red:
Haz ping a la IP del dispositivo
Verifica las reglas del firewall
Confirma la resolución DNS
Reinicia el dispositivo:
Ciclo de encendido
Espera 2 minutos
Verifica si vuelve a estar en línea
Si aún está fuera de línea:
Verifica los registros del dispositivo
Contacta al fabricante del dispositivo
Comunícate con el soporte de 4Geeks

Fallos en Transacciones¶

Verifica la elegibilidad del empleado:
Estado de cuenta activo
Saldo suficiente en la billetera
Beneficio habilitado para el empleado
Verifica el estado del dispositivo:
En línea y respondiendo
Sin estados de error
Transacciones recientes exitosas
Revisa los registros de transacciones:
Ve a Perks > Transactions
Filtra por dispositivo y tiempo
Identifica códigos de error
Soluciones comunes:
Reintenta la transacción
Vuelve a sincronizar los datos del dispositivo
Actualiza el firmware del dispositivo

Discrepancias de Inventario¶

Realiza un conteo físico
Compara con el inventario del sistema
Identifica discrepancias
Ajusta el inventario en el sistema:
Ve a los detalles del dispositivo
Haz clic en Adjust Inventory
Ingresa las cantidades correctas
Agrega una nota de ajuste
Investiga la causa raíz:
Robo o pérdida
Mal funcionamiento del sensor
Errores de sincronización

Mejores Prácticas de Seguridad¶

Seguridad de Red¶

Usa VLAN dedicada para dispositivos IoT
Implementa reglas de firewall que restrinjan la comunicación de dispositivos
Habilita cifrado WPA3 para dispositivos Wi-Fi
Actualiza regularmente el firmware de los dispositivos
Monitorea el tráfico de red en busca de anomalías

Seguridad de Datos¶

Todos los datos transmitidos vía TLS 1.3
Datos de empleados cifrados en reposo
Auditorías de seguridad regulares
Cumplimiento con GDPR y leyes locales de privacidad
Tiempos de espera de sesión automáticos

Seguridad Física¶

Instala dispositivos en áreas monitoreadas
Usa sellos a prueba de manipulación
Implementa controles de acceso para mantenimiento
Inspecciones físicas regulares
Documenta todas las actividades de mantenimiento

Integración API¶

Para soluciones IoT personalizadas, 4Geeks Perks proporciona APIs REST:

Autenticación¶

POST /api/v1/auth/token
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

Registrar Dispositivo¶

POST /api/v1/iot/devices
Authorization: Bearer {token}
Content-Type: application/json

{
  "device_type": "vending_machine",
  "name": "Building A Vending",
  "location": "Floor 2, Break Room",
  "serial_number": "VM-12345",
  "integration_method": "api",
  "api_endpoint": "https://vending-api.example.com"
}

Reportar Transacción¶

POST /api/v1/iot/transactions
Authorization: Bearer {token}
Content-Type: application/json

{
  "device_id": "device_uuid",
  "employee_id": "employee_uuid",
  "product_id": "product_uuid",
  "amount": 150,
  "currency": "points",
  "timestamp": "2026-04-24T10:30:00Z"
}

Consulta la documentación completa de la API

Mantenimiento¶

Tareas de Mantenimiento Regulares¶

Diarias: - Revisa el panel de estado de dispositivos - Verifica alertas de errores - Monitorea las tasas de éxito de transacciones

Semanales: - Revisa los niveles de inventario - Verifica el análisis de uso - Confirma la sincronización de datos

Mensuales: - Inspección física de dispositivos - Verificación de actualizaciones de firmware - Revisión de auditoría de seguridad - Optimización de rendimiento

Trimestrales: - Auditoría completa del sistema - Revisión de seguridad de red - Calibración de dispositivos (si es necesario) - Revisión de rendimiento de proveedores

Actualizaciones de Firmware¶

Verifica actualizaciones en Perks > IoT Devices > Updates
Revisa las notas de la versión
Programa la actualización durante horas de bajo uso
Haz una copia de seguridad de la configuración del dispositivo
Aplica la actualización
Prueba la funcionalidad
Monitorea durante 24 horas

Soporte¶

Documentación: Guías de 4Geeks Perks
Soporte Técnico: iot-support@4geeks.io
Compatibilidad de Dispositivos: Consulta la lista de compatibilidad o contacta ventas
Integración Personalizada: Servicios profesionales disponibles para soluciones personalizadas

Próximos Pasos¶

Aún con dudas? Pregunta en Discord o explore tutoriales