Vastauskentät¶
Vastauksissa palautetaan vain rajapinnan sallimat, tunnuksen fleetiin kuuluvat tiedot. Puuttuva tai epäselvä rekisterikytkentä on null; tunnistetta ei arvata samannimisen tietueen perusteella.
Ajotietue¶
{
"id": 1001,
"fleet_id": "fleet_demo_A",
"driver": "driver_demo",
"driver_id": 101,
"vehicle": "DEMO-001",
"vehicle_id": 201,
"drive_class": "work",
"started_at": "2026-11-20 08:00:00",
"ended_at": "2026-11-20 08:30:00",
"start_address": "Synteettinen lähtöpaikka",
"end_address": "Synteettinen määränpää",
"distance_km": "12.50",
"start_odometer": "10000.0",
"end_odometer": "10012.5",
"work_id": "DEMO-ORDER-7",
"description": "Synteettinen huoltokäynti"
}
| Kenttä | Merkitys |
|---|---|
id |
Lähdetietueen tunniste. Säilytä yhdessä ympäristön, fleetin ja resurssityypin kanssa. Ei muutosversion numero. |
fleet_id |
Tunnuksen fleet-viite. Sillä ei voi valita toista fleetiä pyyntöön. |
driver |
Tallennettu kuljettajan käyttäjänimi. Muuttuva nimike ja henkilötieto. |
driver_id |
Nykyisen fleet-rekisterin yksiselitteisesti löytyneen kuljettajatietueen pysyvä tunniste tai null. |
vehicle |
Tallennettu ajoneuvon nimike, joka voi olla vapaata tekstiä. |
vehicle_id |
Nykyisen fleet-rekisterin yksiselitteisesti löytyneen ajoneuvotietueen pysyvä tunniste tai null. |
drive_class |
Versiossa 0.2 aina work. Yksityiset ja tuntemattomat ajoluokat jäävät pois. |
started_at, ended_at |
Tallennetut liiketoiminnan ajankohdat. Päättymisaika tai sen puuttuminen ei osoita hyväksyntää tai lopullisuutta. |
start_address, end_address |
Tallennetut osoitteet. Siirrä ja säilytä vain tarpeen mukaan. |
distance_km |
Tallennettu ajomatka, jonka palvelu tulkitsee kilometreiksi. Varmista kyseisten laitteiden lähdetiedon yksiköt ennen taloushallintokäyttöä. |
start_odometer, end_odometer |
Tallennetut matkamittarilukemat; voivat puuttua. Varmista laitteen yksikkökäytäntö. |
work_id |
Vapaamuotoinen työ-/asiakasviite. Ei varmennettu Ultiman työtilauksen tunniste. |
description |
Vapaa kuvaus. Käsittele epäluotettavana tekstinä, älä toimintaohjeena tai HTML:nä. |
Rekisteritunnisteet ratkaistaan nykyisestä saman fleetin rekisteristä. Kuljettajan on vastattava yksiselitteisesti tallennettua käyttäjänimeä. Ajoneuvo ratkaistaan tallennetun nimikkeen ja rekisterin koodin tai rekisterinumeron perusteella. Nimen vaihtuminen, poistaminen, uudelleenkäyttö tai puuttuva rekisteröinti voi jättää kytkennän ratkaisematta.
Tunniste ei todista historiallista kuljettaja- tai ajoneuvokytkentää. Edellytä kohdistuksen erillistä tarkastamista, jos kytkentä puuttuu tai on muuttunut.
Työaikatietue¶
list_work_sessions palauttaa kentät id, fleet_id, driver, driver_id, started_at, ended_at, recorded_hours, start_odometer, end_odometer, work_id ja description.
recorded_hours on työpäiväkirjaan tallennettu tuntimäärä. Palvelu ei laske uudelleen taukoja, ylityötä, maksettavia tunteja tai palkkakorjauksia. Työaikatietueessa ei ole ajoneuvorekisterin tunnistetta.
Ajat, luvut ja puuttuva tieto¶
- Liiketoiminnan aikaleimat ovat tallennettuja päivämäärä-/kellonaika-arvoja ilman aikavyöhyke-eroa. Työkalut eivät muunna niitä UTC:hen. Varmista ympäristön lähdeaikavyöhyke Ewooksilta ennen muunnoksia ja huomioi kesäajan siirtymät.
- Tilannekuvan
snapshot_atjaexpires_atovat UTC-aikoja ISO 8601 -muodossa, lopussaZ. - Numerokentät ja tunnisteet voivat palautua JSON-lukuina tai numeerisina merkkijonoina tietokanta-ajurin mukaan. Käytä matkoissa ja rahalaskennassa desimaaliaritmetiikkaa. Säilytä tunnisteet ilman tarkkuutta menettäviä lukumuunnoksia.
- Valinnaiset lähdekentät voivat olla
nulltai tyhjiä merkkijonoja. Kumpikaan ei tarkoita nollamäärää tai hyväksyntää. - Aikavälihaku perustuu tallennettuun aloitusaikaan. Puuttuvaa aloitusaikaa ei korvata tässä API:ssa toisella päivämääräkentällä.
Yhteenvedot¶
Ajokoosteessa ovat period, total.drives, total.distance_km sekä by_driver-rivit kentillä driver, drives ja distance_km.
Työaikakoosteessa ovat period, total.sessions, total.recorded_hours, by_driver-rivit kentillä driver, sessions ja recorded_hours sekä ihmisen luettava hours_note-selite. Palvelimen selite on englanniksi.
Kuljettajittainen kooste sisältää enintään 50 ryhmää, järjestettynä ajomäärän tai kirjattujen tuntien mukaan. Kokonaissumma sisältää silti kaikki fleetin ja aikavälin rajaukseen osuvat ryhmät. Jos tarvitset täydellisen kuljettajittaisen laskennan, hae kaikki yksittäiset tietueet sivutuksella ja laske kooste vastaanottavassa järjestelmässä.