Requisitos previos
- Una suscripción activa de HCSS HeavyJob o Equipment360.
- Credenciales de API de HCSS, generadas en credentials.hcss.com por tu administrador de HCSS.
- Un usuario administrador de Tread con el permiso Integraciones.
- Scopes:
heavyjob:read,heavyjob:write,dis:read,dis:write,e360:timecards:read,e360:timecards:write.
Cómo funciona
- Credenciales de cliente OAuth — Tread se autentica con HCSS usando un client ID y un secret.
- Obtener obras y códigos de costo — Tread lee las obras y códigos de costo de HeavyJob de forma programada, además de resincronización bajo demanda.
- Emparejar empleados — Los empleados de HCSS se asocian con los conductores de Tread por ID externo.
- Enviar tarjetas de tiempo y horas — Las hojas de tiempo aprobadas se publican como tarjetas de tiempo. El uso de equipos se publica en Equipment360.
- Actualizaciones por webhook — HCSS envía actualizaciones de obras y ubicaciones a Tread casi en tiempo real.
Qué fluye y hacia dónde
| Dato | Dirección | Frecuencia |
|---|---|---|
| Obras | HCSS → Tread | Webhook + resincronización nocturna |
| Códigos de costo | HCSS → Tread | Webhook + resincronización nocturna |
| Ubicaciones (Setups) | HCSS → Tread | Webhook |
| Empleados | HCSS → Tread | Diariamente |
| Tarjetas de tiempo | Tread → HCSS | Al aprobar la hoja de tiempo |
| Horas de equipos | Tread → HCSS | Al aprobar |
Configuración
Genera credenciales de API de HCSS
Tu administrador de HCSS inicia sesión en credentials.hcss.com y crea un cliente para Tread con los scopes listados arriba.
Ingresa el client ID y el secret
Pega las credenciales. Tread prueba la conexión y obtiene las unidades de negocio.
Elige la unidad de negocio
Selecciona la unidad de negocio de HCSS con la que sincronizar. La mayoría de las empresas tienen una.
Empareja empleados con conductores
Abre cada conductor en Tread e ingresa el ID de empleado de HCSS correspondiente en el campo ID externo.
Limitaciones
- HCSS limita la tasa de solicitudes de Tread a 100 por minuto, compartidas en toda la empresa.
- Tread oculta las obras de HCSS marcadas como inactivas o descontinuadas.
- El envío de tarjetas de tiempo requiere que el ID de empleado de HCSS esté configurado en el conductor de Tread.
- Las ediciones de códigos de costo en Tread no regresan a HCSS — los códigos de costo se gestionan en HCSS.
- Tread no sincroniza los módulos de Safety o Docs de HCSS.
Solución de problemas
Falló la autenticación- Confirma que el client ID y el secret estén pegados exactamente — los espacios en blanco al final rompen la llamada al token.
- Verifica que los seis scopes estén otorgados en el cliente de HCSS.
- Verifica el estado de la obra en HCSS — las obras inactivas se ocultan en Tread.
- Inicia una sincronización manual.
- Confirma que la obra pertenezca a la unidad de negocio seleccionada.
- Confirma que el conductor tenga un ID de empleado de HCSS.
- Confirma que la obra y el código de costo existan en HCSS y estén activos.
- Usa Reintentar sincronización en la hoja de tiempo.