Obecný popis
Exportní výstup Knihy jízd ve formátu XLSX (Microsoft Excel) 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 XLSX dovoluje jak pohodlnou uživatelskou práci, tak automatizované/robotické zpracování vyexportovaných dat.
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 přehledy, reporty, analýzy, investigace, ale i pro import 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
Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.
Názvy sloupců v exportu v budoucnu měnit nebudeme.
Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.
Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).
Struktura a popis dat
| Název v XLSX exportu | Popis pole | Vzor dat |
| vehicle_registration_number | Registrační značka vozidla | 7AA7000 |
| vehicle_brand | Značka (výrobce) vozidla | Škoda |
| vehicle_model | Modelové označení vozidla | Octavia |
| vehicle_fuel_type | Typ paliva vozidla | natural-95 |
| vehicle_fuel_consumption | Spotřeba (kombinovaná) | 5 |
| vehicle_low_emission | Indikace nízkoemisního vozidla | no |
| vehicle_price | Pořizovací cena vozidla | 1200000 |
| pooled_vehicle | Druh vozidla na základě vlastnictví | yes (true) |
| vehicle_owner_first_name | Jméno vlastníka vozidla | Petr |
| vehicle_owner_last_name | Příjmení vlastníka vozidla | Jednatel |
| fleet_manager_approved | Identifikace, zda je jízda potvrzená Fleet managerem | no |
| start_odometer | Stav tachometru před jízdou [km] | 600 |
| end_odometer | Stav tachometru po jízdě [km] | 900 |
| distance_total | Délka jízd celkem [km] | 300 |
| distance_company | Délka služebních jízd [km] | 200 |
| distance_company_percentage | Podíl služebních jízd na jízdách celkem [*100=%] | 0,6667 |
| distance_private | Délka soukromých jízd [km] | 100 |
| distance_private_percentage | Podíl soukromých jízd na jízdách celkem [*100=%] | 0,3333 |
| fuelings_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 |
| fuelings_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 |
| fuelings_cost_per_liter | Náklady dle reality na litr pohonné hmoty [CZK] | 40.00 |
| fuelings_allowance_per_liter | Náklady dle vyhlášky na litr pohonné hmoty [CZK] | 45,8 |
| costs_real_company | Náklady dle reality na kilometr služební cesty [CZK] | 8190 |
| costs_real_private | Náklady dle reality na kilometr soukromé cesty [CZK] | 455 |
| costs_allowance_company | Náklady dle vyhlášky na kilometr služební cesty [CZK] | 5770,8 |
| costs_allowance_private | Náklady dle vyhlášky na kilometr soukromé cesty [CZK] | 320,6 |
| first_name | Jméno zaměstnance | Petr |
| last_name | Příjmení zaměstnance | Jednatel |
| E-mail zaměstnance | petr.jednatel@domena.cz | |
| employee_number | Zaměstnanecké číslo zaměstnance (pokud je vyplněno) | 1234666 |
| E-mail zaměstnance | petr.jednatel@domena.cz | |
| amount_to_tax | Odpis vozidla (nenízkoemisní 1 % z pořizovací ceny, nízkoemisní 0,5 % z pořizovací ceny) | 600 |
| distance | Délka jízd celkem [km] | 700 |
| distance_company | Délka služebních jízd [km] | 400 |
| distance_private | Délka soukromých jízd [km] | 300 |
| costs_real_private | 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 |
| cost_allowance_private | Součet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle vyhlášky | 4944 |
| registration_number | Registrační značka vozidla | 7AA7000 |
| E-mail zaměstnance | petr.jednatel@domena.cz | |
| start_location | Startovací lokace jízdy | Praha |
| end_location | Cílová lokace jízdy | Brno |
| distance | Délka jízdy celkem [km] | 150 |
| start_date_time | Časová značka začátku jízdy | 01.09.2023 9:00 |
| end_date_time | Časová značka konce jízdy | 01.09.2023 19:00 |
| journey_time | Čas jízdy [hh:mm] | 10:00 |
| purpose | Účel jízdy | Školení |
| refueling | Tankování během jízdy (spojeno v jednom řádku) | 01.07.2023 12:00 40 L 1200 CZK |
| break | Přestávky během jízdy (spojeno v jednom řádku, jednotlivé přestávky oddělené pomocí pipe „|“) | 02.07.2023 12:00 – 02.07.2023 13:00 (01:00)| 02.07.2023 21:00 – 02.07.2023 22:00 (01:00)| 03.07.2023 02:00 – 03.07.2023 03:00 (01:00) |
| note | Poznámka k jízdě | Školení techniků |