Hoppa till huvudinnehåll
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.
Begränsningar:
  • 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.
Körtiden inkluderar körningar till en teknikers hemadress, till exempel hemresan i slutet av dagen eller tillbaka till en verkstad mitt på dagen. Sammanställningen ignorerar fortfarande händelser utan vare sig plats eller hemadress.

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.
Händelsevokabulären delas i resehändelser (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ågeparameter timezone. 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/Stockholm eller UTC. Namnen är skiftlägeskänsliga.
  • fromDate börjar vid dygnets start i zonen. toDate inkluderar 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 ger 400.
Exempel: en tekniker i Chicago avslutar arbetet kl. 23:30 centraltid den 9 oktober. Det är 04:30 UTC den 10 oktober. Utan 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-exkluderade trueWorkTimeMillis. 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.