WrenchMode-tidsdata i Supplier API
Hämta per-tekniker körning och arbetstid från WrenchMode: analyssammanställningen, den råa händelseloggen med sina filter och integrationsmönster för lönesystem.WrenchMode fångar vad tekniker faktiskt gör med sin tid: kör, arbetar, pausar. Supplier API exponerar den på två sätt: en per-tekniker analyssammanställning för rapportering, och den råa händelseloggen för granskning och per-besök-rekonstruktion. Alla exempel förutsätter:
Analys per tekniker
GET /v1/supplier/wrench_mode/events/analytics/{fromDate}/{toDate} returnerar en rad per tekniker med deras körtid, arbetstid och totalt över fönstret.
- Båda datumen är
yyyy-MM-dd, och fönstret får spänna högst en månad. Dela längre intervall i månadsstora anrop. - Sammanställningen täcker din API-nyckels leverantörsanläggning. En nyckel vars kontakt inte är kopplad till en leverantörsanläggning får
401.
Den råa händelseloggen
GET /v1/supplier/wrench_mode/events returnerar de underliggande händelserna, tenant-avgränsade till din leverantör. Filter:
Standardpaginering (
offset, limit max 25, sort_by, order) gäller förutom under scheduleId. En formatfälla: ett närvarande men tomt CSV-filter (till exempel eventTypes=,) avvisas som felaktigt istället för att ignoreras.
began_trip genom trip_cancelled, plus drive_note) och arbetshändelser (started_work, ended_work och location_*-tidshändelserna som markerar pauser och återupptaganden på plats).
Att välja mellan dem
- Analys för dashboards, löner och utnyttjanderapporter: en siffra per tekniker per period, pausberäkningen redan gjord.
- Rå händelser för att granska ett misstänkt total, rekonstruera ett besök minut för minut eller mata ditt eget analyslager.
- Per-besök-frågor besvaras oftast bättre av servicebesöks-utökningen
GET /v1/supplier/work_order/service_calls/{id}/with_work_logs, som returnerar exakt de händelser som ligger i besökets in-/utcheckningsfönster plus paus-exkluderadetrueWorkTimeMillis. Se Servicebesök.
Beprövade mönster
Veckovis lönehämtning. Varje måndag, anropa analys för föregående vecka, matcha på teknikere-post mot ditt lönesystem och använd arbete + körtid som betald-timmar-underlag. Ett anrop per vecka per anläggning håller dig långt under hastighetsgränsen. Månadsvis utnyttjanderapport. Analys med månadsgränser (2026-08-01 till 2026-08-31 ligger inom en-månads-taket); dividera arbetstid med schemalagd tid från ditt bemanningssystem.
Arbetskostnadsavstämning på en faktura. För varje servicebesök på den fakturerade arbetsordern, hämta /with_work_logs, summera trueWorkTimeMillis och jämför mot arbetsraderna innan köparen ens ser en tvist.