Skip to main content

​
Datos de seguimiento de tiempo de WrenchMode en la Supplier API

Extrae tiempos de conducción y trabajo por técnico desde WrenchMode: el resumen analítico, el registro bruto de eventos con sus filtros y patrones de integración con nómina.
WrenchMode captura qué hacen realmente los técnicos con su tiempo: conducir, trabajar, pausar. La Supplier API lo expone de dos maneras: un resumen analítico por técnico para reportería, y el registro bruto de eventos para auditoría y reconstrucción por visita. Todos los ejemplos asumen:

​
Analítica por técnico

GET /v1/supplier/wrench_mode/events/analytics/{fromDate}/{toDate} devuelve una fila por técnico con su tiempo de conducción, tiempo de trabajo y total en la ventana.
Restricciones:
  • Ambas fechas son yyyy-MM-dd, y la ventana puede abarcar como máximo un mes. Divide rangos más largos en llamadas del tamaño de un mes.
  • El resumen cubre la instalación de proveedor de tu clave de API. Una clave cuyo contacto no esté adjunto a una facility de proveedor obtiene 401.

​
El registro bruto de eventos

GET /v1/supplier/wrench_mode/events devuelve los eventos subyacentes, limitados por inquilino a tu proveedor. Filtros: Aplica la paginación estándar (offset, limit máx. 25, sort_by, order) excepto bajo scheduleId. Una trampa de formato: un filtro CSV presente pero vacío (por ejemplo eventTypes=,) se rechaza como mal formado en lugar de ignorarse.
El vocabulario de eventos se divide en eventos de viaje (began_trip hasta trip_cancelled, más drive_note) y eventos de trabajo (started_work, ended_work y los eventos de temporizador location_* que marcan pausas y reanudaciones en sitio).

​
Cuándo elegir cada uno

  • Analítica para tableros, nómina y reportes de utilización: un número por técnico por período, con la matemática de pausas ya hecha.
  • Eventos brutos para auditar un total sospechoso, reconstruir una visita minuto a minuto o alimentar tu propio warehouse analítico.
  • Las preguntas por visita suelen atenderse mejor con la expansión de llamada de servicio GET /v1/supplier/work_order/service_calls/{id}/with_work_logs, que devuelve exactamente los eventos en la ventana de check-in/check-out de la visita más trueWorkTimeMillis sin pausas. Ver Llamadas de servicio.

​
Patrones aplicados

Extracción semanal de nómina. Cada lunes, llama a analítica para la semana anterior, cruza por correo del técnico contra tu sistema de nómina y usa el tiempo de trabajo + conducción como la entrada de horas pagadas. Una llamada por semana por facility te mantiene muy por debajo del límite de tasa. Reporte mensual de utilización. Analítica con límites de mes (2026-08-01 a 2026-08-31 está dentro del tope de un mes); divide el tiempo de trabajo entre el tiempo programado desde tu sistema de rostering. Conciliación de costo de labor en una factura. Para cada llamada de servicio en la orden de trabajo facturada, obtén /with_work_logs, suma trueWorkTimeMillis y compara contra las líneas de labor antes de que el comprador vea una disputa.