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. - Datumen är UTC-dygn om du inte skickar
timezone(se Tidszoner). OpenWrench kontrollerar en-månads-taket på datumen som de skickas, innan den tillämpar zonen. - 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). Resehändelser kan peka på en hemadress i stället för en plats.
En hemresa är en resehändelse (began_trip, trip_paused, trip_resumed, trip_cancelled, drive_note eller arrived) som har homeAddressId satt och saknar locationId, workOrderId och serviceCallId. Arbetshändelser har aldrig homeAddressId. Därför kan locationId vara null på resehändelser.
Tidszoner
Båda WrenchMode-rutterna accepterar en valfri frågeparametertimezone. Den anger zonen som fromDate och toDate läses i, så att ett dygn motsvarar teknikernas lokala dygn i stället för ett UTC-dygn.
- Skicka ett IANA-zonnamn, till exempel
America/Chicago,Europe/StockholmellerUTC. Namnen är skiftlägeskänsliga. fromDatebörjar vid dygnets start i zonen.toDateinkluderar hela det dygnet i zonen.- OpenWrench använder zonens verkliga dygnsgränser. Ett dygn med sommartidsomställning är 23 eller 25 timmar långt.
- Utan
timezoneär datumen UTC-dygn. - Fasta förskjutningar (
-05:00,GMT-5,Z,Etc/GMT+5), förkortningar (CST) och okända namn ger400.
timezone hamnar händelsen den 10 oktober. Med timezone=America/Chicago hamnar den den 9 oktober:
Att välja mellan dem
- Analys för dashboards, löner och utnyttjanderapporter: en siffra per tekniker per period, pausberäkningen redan gjord.
- Råa händelser för att granska en misstänkt totalsumma, 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å teknikernas e-postadress mot ditt lönesystem och använd arbete + körtid som betald-timmar-underlag. Hemresan räknas in i den totala körtiden, även om den inte faktureras på någon arbetsorder. 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.