Passer au contenu principal
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.
  • Les dates sont des jours UTC, sauf si vous passez timezone (voir Fuseaux horaires). OpenWrench vérifie la limite d’un mois sur les dates telles que fournies, avant d’appliquer le fuseau.
  • 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 temps de conduite inclut les trajets vers l’adresse de domicile d’un technicien, comme le retour à la maison en fin de journée ou le retour à un atelier en milieu de journée. Le rollup ignore toujours les événements sans emplacement ni adresse de domicile.

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). Les événements de trajet peuvent pointer vers une adresse de domicile au lieu d’un emplacement. Un trajet vers le domicile est un événement de trajet (began_trip, trip_paused, trip_resumed, trip_cancelled, drive_note ou arrived) dont homeAddressId est défini et qui n’a ni locationId, ni workOrderId, ni serviceCallId. Les événements de travail ne portent jamais homeAddressId. C’est pourquoi locationId peut être null sur les événements de trajet.

Fuseaux horaires

Les deux routes WrenchMode acceptent un paramètre de requête facultatif timezone. Il définit le fuseau dans lequel fromDate et toDate sont lus, pour qu’un jour corresponde au jour local de vos techniciens plutôt qu’à un jour UTC.
  • Passez un nom de fuseau IANA, comme America/Chicago, America/Toronto ou UTC. Les noms sont sensibles à la casse.
  • fromDate commence au début de ce jour dans le fuseau. toDate inclut ce jour entier dans le fuseau.
  • OpenWrench utilise les limites de jour réelles du fuseau. Un jour de changement d’heure dure 23 ou 25 heures.
  • Sans timezone, les dates sont des jours UTC.
  • Les décalages fixes (-05:00, GMT-5, Z, Etc/GMT+5), les abréviations (CST) et les noms inconnus renvoient 400.
Par exemple, un technicien à Chicago termine son travail à 23 h 30, heure du Centre, le 9 octobre. Cela correspond à 4 h 30 UTC le 10 octobre. Sans timezone, l’événement tombe le 10 octobre. Avec timezone=America/Chicago, il tombe le 9 octobre :

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. Le trajet de retour à la maison compte dans le total du temps de conduite, même s’il n’est facturé à aucun bon de travail. 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.