Integración de Hubsoft con IClass

Acerca de IClass

IClass FS es un software de órdenes de servicio en línea para gestionar equipos de campo. Ofrece programación inteligente, gestión de rutas, control de inventario, activos y flotas, formularios personalizados, módulo móvil y paneles con mapas. Atiende varios segmentos, incluidos proveedores de internet y empresas de telecomunicaciones.

Qué hace la integración

La integración tiene dos funciones, que pueden activarse juntas o por separado:

• Envío de eventos: cada acontecimiento de una O.S. en Hubsoft se envía automáticamente a IClass. Los eventos son crear, actualizar, programar, cancelar la programación, cerrar y eliminar, y tú eliges cuáles enviar.
• Programación desde la plataforma: la agenda de IClass se abre dentro de Hubsoft, ya filtrada por ciudad y tipo de O.S. Al confirmar el horario, la O.S. queda programada en Hubsoft con la fecha, el período y el técnico asignado por IClass. La programación se registra en el historial de la O.S.

Cada evento incluye los datos de la O.S. (número, tipo, estado, fechas, técnico y observación), del cliente (nombre, teléfonos, correo electrónico y plan), de la dirección de atención con coordenadas y los datos técnicos del servicio, como usuario, MAC y punto de acceso.

El envío se ejecuta en segundo plano, justo después del acontecimiento en la O.S. Si IClass no está disponible, Hubsoft vuelve a intentarlo, y cada envío queda registrado con la respuesta de la plataforma.

Qué necesitas

• Contrato con IClass y los datos de acceso proporcionados por este: URL y token de envío de eventos; URL y token de programación.
• La relación de equivalencias registrada en IClass: tipos de O.S., técnicos y ciudades, mediante los códigos de Hubsoft. IClass realiza este registro; el proveedor envía la relación de códigos.
• Ciudades con el código IBGE completado en Hubsoft.
• Un usuario técnico activo en Hubsoft, que será el responsable predeterminado de las O.S. programadas desde la plataforma.
• Permiso de acceso a Integraciones para quien realiza la configuración y a Programar O.S. para quien programa.

Cómo activar

1. Envía al soporte de IClass la relación de tipos de O.S., técnicos y ciudades (IBGE) y espera a que registren la relación de equivalencias.
2. En Hubsoft, ve a Configuración > Integraciones > ERP, haz clic en Agregar, asigna un nombre y selecciona el gateway iClass.
3. Activa Envío de eventos, Programación desde la plataforma o ambas opciones.
4. Ingresa la URL y el token. Si utilizas la agenda, ingresa también la URL y el token de programación, además del código del técnico predeterminado.
5. En el grupo Orden de servicio, marca los eventos que IClass debe recibir y guarda. Hubsoft verifica los parámetros obligatorios y que el técnico predeterminado esté activo.

El paso a paso con las pantallas está en la página de IClass en la wiki de Hubsoft.

Limitaciones

• El envío de eventos es unidireccional, de Hubsoft a IClass. Solo la programación devuelve datos: fecha, período y técnico.
• IClass define el formato de los eventos y no se puede editar. Para enviar las O.S. a un sistema propio, utiliza el gateway Otros (Webhook).
• La programación desde la plataforma puede estar activa en una sola integración de ERP a la vez.
• El token de programación tiene una vigencia limitada. Cuando la agenda deje de abrirse, solicita un nuevo token a IClass.
• La acción Probar aún no funciona para IClass. La validación se realiza abriendo la agenda o verificando los eventos de una O.S. de prueba.

Preguntas frecuentes

La agenda de IClass no se abre. ¿Qué debo verificar?

Verifica el código IBGE de la ciudad, que se hayan informado la ciudad y el tipo de O.S., y que el token de programación sea válido. La causa más común es la relación de equivalencias: un tipo de O.S. o una ciudad nueva solo funciona después de asignarlos en IClass.

¿Por qué la O.S. quedó asignada a otro técnico?

Se considera el técnico que la agenda de IClass asignó al horario confirmado. Si todas las O.S. quedan asignadas al técnico predeterminado, probablemente los técnicos no estén asignados en IClass.

¿Cómo sé si un evento llegó a IClass?

Todo envío queda registrado en Hubsoft con la respuesta de IClass. Si tienes alguna duda, contacta al soporte de Hubsoft con el número de la O.S. y la hora aproximada.

Revisado el 10/10/2026.