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.
- 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 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é.
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 facultatiftimezone. 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/TorontoouUTC. Les noms sont sensibles à la casse. fromDatecommence au début de ce jour dans le fuseau.toDateinclut 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 renvoient400.
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 letrueWorkTimeMillishors 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.