Obecný popis
Exportní výstup Knihy jízd ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Knihy jízd z Fidoo ven a pro následné zpracování a další použití mimo Fidoo.
Univerzální formát XML umožňuje především snadné automatizované/robotické zpracování vyexportovaných dat.
Pro zkušenější uživatele jsou vyexportovatelná data i v tomto formátu lidsky čitelná.
Obsahově je tento export navržen tak, aby poskytoval maximální možnou šířku informací o Knize jízd ve Fidoo.
Typické využití tohoto exportního formátu je pro integrace a importy dat do dalších podnikových systémů.
Principy a pravidla používání exportu
- Export průběžně doplňujeme o nové údaje tak, jak postupně zpracováváme nové klientské požadavky
Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno používat tento XML formát namísto XLSX formátu. Dalším vhodným způsobem integrace Fidoo na další podnikové systémy je využití Fidoo Public API (viz Public API).
Struktura a popis dat
| Název interní / XML | Popis pole | Vzor dat |
| vehicles/vehicle/@registrationNumber | Registrační značka vozidla | 7AA7000 |
| vehicles/vehicle/brand | Značka (výrobce) vozidla | Škoda |
| vehicles/vehicle/model | Modelové označení vozidla | Octavia |
| vehicles/vehicle/fuelType | Typ paliva vozidla | natural-95 |
| vehicles/vehicle/fuelConsumption | Spotřeba (kombinovaná) | 5 |
| vehicles/vehicle/lowEmission | Indikace nízkoemisního vozidla | no |
| vehicles/vehicle/vehiclePrice | Pořizovací cena vozidla | 1200000 |
| vehicles/vehicle/pooledVehicle | Druh vozidla na základě vlastnictví | yes (true) |
| vehicles/vehicle/ownerFirstName | Jméno vlastníka vozidla | Petr |
| vehicles/vehicle/ownerLastName | Příjmení vlastníka vozidla | Jednatel |
| vehicleRecords/vehicleRecord/fleetManagerApproved | Identifikace, zda je jízda potvrzená Fleet managerem | no |
| vehicleRecords/vehicleRecord/startOdometer | Stav tachometru před jízdou [km] | 600 |
| vehicleRecords/vehicleRecord/endOdometer | Stav tachometru po jízdě [km] | 900 |
| vehicleRecords/vehicleRecord/distanceSum/totalDistance | Délka jízd celkem [km] | 300 |
| vehicleRecords/vehicleRecord/distanceSum/companyDistance | Délka služebních jízd [km] | 200 |
| vehicleRecords/vehicleRecord/distanceSum/privateDistance | Délka soukromých jízd [km] | 100 |
| vehicleRecords/vehicleRecord/fuelingsSum/price | Částka za tankování v daném měsíci [CZK]. Součet částek za tankování v daném měsíci | 800 |
| vehicleRecords/vehicleRecord/fuelingsSum/amount | Objem natankovaných pohonných hmot v daném měsíci [litr]. Součet natankovaných litrů z účtenek za tankování v daném měsíci | 20 |
| vehicleRecords/vehicleRecord/fuelingsSum/costsPerLiter | Náklady dle reality na litr pohonné hmoty [CZK] | 40.00 |
| vehicleRecords/vehicleRecord/fuelingsSum/allowancePerLiter | Náklady dle vyhlášky na litr pohonné hmoty [CZK] | 45,8 |
| vehicleRecords/vehicleRecord/calculations/costsRealCompany | Náklady dle reality na kilometr služební cesty [CZK] | 8190 |
| vehicleRecords/vehicleRecord/calculations/costsRealPrivate | Náklady dle reality na kilometr soukromé cesty [CZK] | 455 |
| vehicleRecords/vehicleRecord/calculations/costsAllowanceCompany | Náklady dle vyhlášky na kilometr služební cesty [CZK] | 5770,8 |
| vehicleRecords/vehicleRecord/calculations/costsAllowancePrivate | Náklady dle vyhlášky na kilometr soukromé cesty [CZK] | 320,6 |
| users/user/@firstName | Jméno zaměstnance | Petr |
| users/user/@lastName | Příjmení zaměstnance | Jednatel |
| users/user/@email | E-mail zaměstnance | petr.jednatel@domena.cz |
| users/user/@employeeNumber | Zaměstnanecké číslo zaměstnance (pokud je vyplněno) | 1234666 |
| userRecords/userRecord/@email | E-mail zaměstnance | petr.jednatel@domena.cz |
| userRecords/userRecord/amountToTax | Odpis vozidla (nenízkoemisní 1 % z pořizovací ceny, nízkoemisní 0,5 % z pořizovací ceny) | 600 |
| userRecords/userRecord/distanceSum/totalDistance | Délka jízd celkem [km] | 700 |
| userRecords/userRecord/distanceSum/companyDistance | Délka služebních jízd [km] | 400 |
| userRecords/userRecord/distanceSum/privateDistance | Délka soukromých jízd [km] | 300 |
| userRecords/userRecord/calculations/costsRealPrivate | Součet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle reálných nákladů | 7195,5 |
| userRecords/userRecord/calculations/costsAllowancePrivate | Součet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle vyhlášky | 4944 |
| journeys/journey/@vehicleRegistrationNumber | Registrační značka vozidla | 7AA7000 |
| journeys/journey/@userEmail | E-mail zaměstnance | petr.jednatel@domena.cz |
| journeys/journey/startLocation | Startovací lokace jízdy | Praha |
| journeys/journey/endLocation | Cílová lokace jízdy | Brno |
| journeys/journey/distance | Délka jízdy celkem [km] | 150 |
| journeys/journey/startDateTime | Časová značka začátku jízdy | 01.09.2023 9:00 |
| journeys/journey/endDateTime | Časová značka konce jízdy | 01.09.2023 19:00 |
| journeys/journey/journeyTime | Čas jízdy [hh:mm] | 10:00 |
| journeys/journey/purpose | Účel jízdy | Školení |
| journeys/journey/fuelings/fueling/@date | Časová značka tankování | 2023-09-01T12:00:00+02:00 |
| journeys/journey/fuelings/fueling/@amount | Počet natankovaných litrů [L] | 100 |
| journeys/journey/fuelings/fueling/@price | Celková cena tankování | 2500 |
| journeys/journey/fuelings/fueling/@currency | Měna tankování | CZK |
| journeys/journey/breaks/break/@start | Začátek přestávky | 2023-09-01T11:30:00+02:00 |
| journeys/journey/breaks/break/@end | Konec přestávky | 2023-09-01T11:40:00+02:00 |
| journeys/journey/breaks/break/@totalTime | Délka přestávky [hh:mm] | 0:10 |
| journeys/journey/note | Poznámka k jízdě | Školení techniků |