Skip to main content

​
Données de suivi du temps WrenchMode dans l’API Fournisseur

Extrayez le temps de conduite et de travail par technicien depuis WrenchMode : le rollup d’analyse, le journal d’événements brut avec ses filtres, et les modèles d’intégration paie.
WrenchMode capture ce que les techniciens font réellement de leur temps : conduire, travailler, mettre en pause. L’API Fournisseur l’expose de deux manières : un rollup d’analyse par technicien pour les rapports, et le journal d’événements brut pour l’audit et la reconstitution par visite. Tous les exemples supposent :

​
Analyse par technicien

GET /v1/supplier/wrench_mode/events/analytics/{fromDate}/{toDate} retourne une ligne par technicien avec son temps de conduite, son temps de travail et son total sur la fenêtre.
Contraintes :
  • Les deux dates sont au format yyyy-MM-dd, et la fenêtre peut couvrir au plus un mois. Divisez les plages plus longues en appels d’un mois.
  • Le rollup couvre l’établissement fournisseur de votre clé d’API. Une clé dont le contact n’est pas rattaché à un établissement fournisseur reçoit 401.

​
Le journal d’événements brut

GET /v1/supplier/wrench_mode/events retourne les événements sous-jacents, restreints à votre fournisseur. Filtres : La pagination standard (offset, limit max 25, sort_by, order) s’applique sauf sous scheduleId. Un piège de formatage : un filtre CSV présent mais vide (par exemple eventTypes=,) est rejeté comme malformé plutôt qu’ignoré.
Le vocabulaire d’événements se divise en événements de trajet (began_trip jusqu’à trip_cancelled, plus drive_note) et événements de travail (started_work, ended_work, et les événements de minuterie location_* qui marquent les pauses et reprises sur place).

​
Choisir entre les deux

  • Analyse pour les tableaux de bord, la paie et les rapports d’utilisation : un chiffre par technicien par période, avec les calculs de pauses déjà faits.
  • Événements bruts pour auditer un total suspect, reconstituer une visite minute par minute, ou alimenter votre propre entrepôt d’analyse.
  • Les questions par visite sont généralement mieux servies par l’expansion d’appel de service GET /v1/supplier/work_order/service_calls/{id}/with_work_logs, qui retourne exactement les événements dans la fenêtre arrivée/départ de la visite plus le trueWorkTimeMillis hors pauses. Voir Appels de service.

​
Modèles éprouvés

Extraction hebdomadaire de la paie. Chaque lundi, appelez l’analyse pour la semaine précédente, joignez sur le courriel du technicien contre votre système de paie, et utilisez le temps de travail plus le temps de conduite comme entrée d’heures payées. Un appel par semaine par établissement vous garde loin sous la limite de débit. Rapport d’utilisation mensuel. Analyse avec des bornes de mois (2026-08-01 à 2026-08-31 reste dans la limite d’un mois); divisez le temps de travail par le temps planifié depuis votre système de gestion d’horaires. Réconciliation du coût de main-d’œuvre sur une facture. Pour chaque appel de service sur le bon de travail facturé, récupérez /with_work_logs, additionnez trueWorkTimeMillis, et comparez aux postes de main-d’œuvre avant que l’acheteur ne voie une contestation.