Přidání, úprava, smazání a výpis jízd a výpis knihy jízd za období. Prostředí, klíč v hlavičce X-Api-Key, stránkování a čtení tabulek popisuje Public API – základy. Dokumentace odpovídá stavu API k 6. 8. 2026.
POST /v2/journey-log/add-journey
Public API klíč musí být vystaven na uživatele Fidoo, který disponuje klíčovou rolí buď Hlavní správce, nebo Účetní v kombinaci s klíčovou rolí Fleet manager. Práva rolí se přenášejí na vystavený API klíč.
Umožňuje přidat novou jízdu za aktivního uživatele pro dostupné vozidlo.
Je vráceno potvrzení o přidání nové jízdy v podobě jeho systémového ID.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
userId (povinné) | Unikátní identifikátor uživatele v systému Fidoo. | d046b326-3d6c-4dc3-852f-3999ac3f0632 |
vehicleId (povinné) | Unikátní identifikátor vozidla v systému Fidoo. | bb1d0d1f-d709-45bf-8eef-f17c390919b7 |
journeyType (povinné) | Typ jízdy. Hodnoty: business = služební jízda; personal = soukromá jízda. | business |
startDate (povinné) | Datum zahájení jízdy. Uvedeno ve formátu ISO 8601. | 2023-11-13T13:28:35.382Z |
startLocation | Místo zahájení jízdy. Možné vyplnit pouze při “journeyType”: business. | Brno |
startOdometer | Stav kilometrovníku (odometeru) při zahájení jízdy. Lze zadat pouze celé kilometry. | 87452 |
endDate | Datum ukončení jízdy. Uvedeno ve formátu ISO 8601. | 2023-11-13T15:28:35.382Z |
endLocation | Místo ukončení jízdy. Možné vyplnit pouze při “journeyType”: business. | Praha |
endOdometer | Stav kilometrovníku (odometeru) při ukončení jízdy. Lze zadat pouze celé kilometry. | 87665 |
purpose | Účel jízdy. Možné vyplnit pouze při “journeyType”: business. Hodnoty: meeting = Jednání; branchVisit = Návštěva pobočky; businessPartnerVisit = Návštěva obchodního partnera; clientVisit = Návštěva klienta; training = Školení; goodsTransportation = Přeprava zboží; consultation = Konzultace; service = Servis; commuteToFromWork = Jízda do/z práce. | service |
fuelings | Tankování. | – |
· date | Datum tankování. Uvedeno ve formátu ISO 8601. | 2023-11-13T14:28:35.382Z |
· amount | Počet natankovaných litrů. Maximální délka: 3 desetinná místa (tisíciny). | 22.461 |
· price | Částka za tankování. Uvedena v měně podle currency. | 754.67 |
· currency | Měna tankování. Uvedena ve formátu ISO 4217. | CZK |
breaks | Přestávky během jízdy. | – |
· start | Počáteční datum přestávky. Uvedeno ve formátu ISO 8601. Možné vyplnit pouze při “journeyType”: business. | 2023-11-13T13:38:35.382Z |
· end | Konečné datum přestávky. Uvedeno ve formátu ISO 8601. Možné vyplnit pouze při “journeyType”: business. | 2023-11-13T13:48:35.382Z |
distance | Délka jízdy. Lze zadat pouze celé kilometry. | 213 |
note | Poznámka k jízdě. | Přejezd do servisu |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
journeyId | Unikátní identifikátor jízdy v systému Fidoo. | a3c6764e-a100-4684-ab3a-6819641eb8e1 |
POST /v2/journey-log/update-journey
Public API klíč musí být vystaven na uživatele Fidoo, který disponuje klíčovou rolí buď Hlavní správce, nebo Účetní v kombinaci s klíčovou rolí Fleet manager. Práva rolí se přenášejí na vystavený API klíč.
Umožňuje upravit existující jízdu za aktivního uživatele pro dostupné vozidlo.
Je vráceno potvrzení o provedení úpravy jízdy.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
journeyId (povinné) | Unikátní identifikátor jízdy v systému Fidoo. | a3c6764e-a100-4684-ab3a-6819641eb8e1 |
userId (povinné) | Unikátní identifikátor uživatele v systému Fidoo. | d046b326-3d6c-4dc3-852f-3999ac3f0632 |
vehicleId (povinné) | Unikátní identifikátor vozidla v systému Fidoo. | bb1d0d1f-d709-45bf-8eef-f17c390919b7 |
journeyType (povinné) | Typ jízdy. Hodnoty: business = služební jízda; personal = soukromá jízda. | business |
startDate (povinné) | Datum zahájení jízdy. Uvedeno ve formátu ISO 8601. | 2023-11-13T13:28:35.382Z |
startLocation | Místo zahájení jízdy. Možné vyplnit pouze při “journeyType”: business. | Brno |
startOdometer | Stav kilometrovníku (odometeru) při zahájení jízdy. Lze zadat pouze celé kilometry. | 87452 |
endDate | Datum ukončení jízdy. Uvedeno ve formátu ISO 8601. | 2023-11-13T15:28:35.382Z |
endLocation | Místo ukončení jízdy. Možné vyplnit pouze při “journeyType”: business. | Praha |
endOdometer | Stav kilometrovníku (odometeru) při ukončení jízdy. Lze zadat pouze celé kilometry. | 87665 |
purpose | Účel jízdy. Možné vyplnit pouze při “journeyType”: business. Hodnoty: meeting = Jednání; branchVisit = Návštěva pobočky; businessPartnerVisit = Návštěva obchodního partnera; clientVisit = Návštěva klienta; training = Školení; goodsTransportation = Přeprava zboží; consultation = Konzultace; service = Servis; commuteToFromWork = Jízda do/z práce. | service |
fuelings | Tankování. | – |
· date | Datum tankování. Uvedeno ve formátu ISO 8601. | 2023-11-13T14:28:35.382Z |
· amount | Počet natankovaných litrů. Maximální délka: 3 desetinná místa (tisíciny). | 22.461 |
· price | Částka za tankování. Uvedena v měně podle currency. | 754.67 |
· currency | Měna tankování. Uvedena ve formátu ISO 4217. | CZK |
breaks | Přestávky během jízdy. | – |
· start | Počáteční datum přestávky. Uvedeno ve formátu ISO 8601. Možné vyplnit pouze při “journeyType”: business. | 2023-11-13T13:38:35.382Z |
· end | Konečné datum přestávky. Uvedeno ve formátu ISO 8601. Možné vyplnit pouze při “journeyType”: business. | 2023-11-13T13:48:35.382Z |
distance | Délka jízdy. Lze zadat pouze celé kilometry. | 213 |
note | Poznámka k jízdě. | Přejezd do servisu |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
info | Informace o provedení operace. | void |
POST /v2/journey-log/delete-journey
Public API klíč musí být vystaven na uživatele Fidoo, který disponuje klíčovou rolí buď Hlavní správce, nebo Účetní v kombinaci s klíčovou rolí Fleet manager. Práva rolí se přenášejí na vystavený API klíč.
Umožňuje smazat existující jízdu pro dostupné vozidlo.
Je vráceno potvrzení o smazání dané jízdy.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
journeyId (povinné) | Unikátní identifikátor jízdy v systému Fidoo. | a3c6764e-a100-4684-ab3a-6819641eb8e1 |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
info | Informace o provedení operace. | void |
POST /v2/journey-log/get-journey
Umožňuje výpis jedné existující jízdy.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
journeyId (povinné) | Unikátní identifikátor jízdy v systému Fidoo. | a3c6764e-a100-4684-ab3a-6819641eb8e1 |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
journeyId | Unikátní identifikátor jízdy v systému Fidoo. | a3c6764e-a100-4684-ab3a-6819641eb8e1 |
vehicleId | Unikátní identifikátor vozidla v systému Fidoo. | bb1d0d1f-d709-45bf-8eef-f17c390919b7 |
user | Výpis detailu uživatele. | – |
· userId | Unikátní identifikátor uživatele v systému Fidoo. | d046b326-3d6c-4dc3-852f-3999ac3f0632 |
· firstName | Jméno uživatele. | Jan |
· lastName | Příjmení uživatele. | Novák |
· employeeNumber | Zaměstnanecké číslo uživatele. | AX12545 |
· deactivated | Indikátor, zda je uživatel deaktivovaný. Hodnoty: true = uživatel je deaktivovaný; false = uživatel není deaktivovaný. | false |
journeyType | Typ jízdy. Hodnoty: business = služební jízda; personal = soukromá jízda. | business |
startDate | Datum zahájení jízdy. Uvedeno ve formátu ISO 8601. | 2023-11-13T13:28:35.382Z |
startLocation | Místo zahájení jízdy. Vráceno pouze při “journeyType”: business. | Brno |
startOdometer | Stav kilometrovníku (odometeru) při zahájení jízdy. Vráceno v celých kilometrech. | 87452 |
endDate | Datum ukončení jízdy. Uvedeno ve formátu ISO 8601. | 2023-11-13T15:28:35.382Z |
endLocation | Místo ukončení jízdy. Vráceno pouze při “journeyType”: business. | Praha |
endOdometer | Stav kilometrovníku (odometeru) při ukončení jízdy. Vráceno v celých kilometrech. | 87665 |
purpose | Účel jízdy. Vráceno pouze při “journeyType”: business. Hodnoty: meeting = Jednání; branchVisit = Návštěva pobočky; businessPartnerVisit = Návštěva obchodního partnera; clientVisit = Návštěva klienta; training = Školení; goodsTransportation = Přeprava zboží; consultation = Konzultace; service = Servis; commuteToFromWork = Jízda do/z práce. | service |
fuelings | Tankování. | – |
· date | Datum tankování. Uvedeno ve formátu ISO 8601. | 2023-11-13T14:28:35.382Z |
· amount | Počet natankovaných litrů. Maximální délka: 3 desetinná místa (tisíciny). | 22.461 |
· price | Částka za tankování. Uvedena v měně podle currency. | 754.67 |
· currency | Měna tankování. Uvedena ve formátu ISO 4217. | CZK |
breaks | Přestávky během jízdy. | – |
· start | Počáteční datum přestávky. Uvedeno ve formátu ISO 8601. Vráceno pouze při “journeyType”: business. | 2023-11-13T13:38:35.382Z |
· end | Konečné datum přestávky. Uvedeno ve formátu ISO 8601. Vráceno pouze při “journeyType”: business. | 2023-11-13T13:48:35.382Z |
distance | Délka jízdy. Vráceno v celých kilometrech. | 213 |
note | Poznámka k jízdě. | Přejezd do servisu |
POST /v2/journey-log/get-journey-log-period
Umožňuje výpis jedné knihy jízd pro dostupné vozidlo za specifikovaný měsíc.
Volané parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
vehicleId (povinné) | Unikátní identifikátor vozidla v systému Fidoo. | bb1d0d1f-d709-45bf-8eef-f17c390919b7 |
startDateTime (povinné) | Datum zahájení knihy jízd. Uvedeno ve formátu ISO 8601. Jedná se vždy o počáteční datum měsíce. | 2023-05-01T00:00:00.000Z |
Vrácené parametry
| Parametr | Popis | Vzor dat |
|---|---|---|
journeyLogPeriod | Výpis podrobností o knize jízd pro filtrovaný měsíc. | – |
· vehicleId | Unikátní identifikátor vozidla v systému Fidoo. | bb1d0d1f-d709-45bf-8eef-f17c390919b7 |
· startDateTime | Datum zahájení Knihy jízd. Uvedeno ve formátu ISO 8601. Jedná se vždy o počáteční datum měsíce. | 2023-05-01T00:00:00.000Z |
· startOdometerReading | Stav kilometrovníku (odometeru) na počátku knihy jízd daného měsíce. Vráceno v celých kilometrech. Stav před první jízdou. Stav po poslední jízdě v předcházejícím měsíci. | 87452 |
· endOdometerReading | Stav kilometrovníku (odometeru) na konci knihy jízd daného měsíce. Vráceno v celých kilometrech. Stav po poslední jízdě. | 87665 |
· state | Stav knihy jízd. Hodnoty: open = Otevřená, editovatelná řidičem a Fleet managerem;; approve = Podepsaná, editovatelná pouze Fleet managerem;; closed = Potvrzená, nelze editovat. | open |
· rejected | Indikátor, zda je kniha jízd zamítnutá. Hodnoty: true = kniha jízd je zamítnutá; false = kniha jízd není zamítnutá. | true |
· note | Důvod zamítnutí knihy jízd. Vráceno pouze při “rejected”: true. | Doplň si povinné pauzy |
previousJourneyLogPeriod | Výpis podrobností o knize jízd, která předcházela filtrovanému měsíci. | – |
· vehicleId | Unikátní identifikátor vozidla v systému Fidoo. | bb1d0d1f-d709-45bf-8eef-f17c390919b7 |
· startDateTime | Datum zahájení Knihy jízd. Uvedeno ve formátu ISO 8601. Jedná se vždy o počáteční datum měsíce. | 2023-04-01T00:00:00.000Z |
· startOdometerReading | Stav kilometrovníku (odometeru) na počátku knihy jízd daného měsíce. Vráceno v celých kilometrech. Stav před první jízdou. | 86468 |
· endOdometerReading | Stav kilometrovníku (odometeru) na konci knihy jízd daného měsíce. Vráceno v celých kilometrech. Stav po poslední jízdě. Stav před první jízdou v nadcházejícím měsíci. | 87452 |
· state | Stav knihy jízd. Hodnoty: open = Otevřená, editovatelná řidičem a Fleet managerem;; approve = Podepsaná, editovatelná pouze Fleet managerem;; closed = Potvrzená, nelze editovat. | open |
· rejected | Indikátor, zda je kniha jízd zamítnutá. Hodnoty: true = kniha jízd je zamítnutá; false = kniha jízd není zamítnutá. | true |
· note | Důvod zamítnutí knihy jízd. Vráceno pouze při “rejected”: true. | Nesedí kilometry |
journeys | Výpis jízd ve filtrovaném měsíci. | – |
· journeyId | Unikátní identifikátor jízdy v systému Fidoo. | a3c6764e-a100-4684-ab3a-6819641eb8e1 |
· vehicleId | Unikátní identifikátor vozidla v systému Fidoo. | bb1d0d1f-d709-45bf-8eef-f17c390919b7 |
· user | Výpis detailu uživatele. | – |
· userId | Unikátní identifikátor uživatele v systému Fidoo. | d046b326-3d6c-4dc3-852f-3999ac3f0632 |
·· firstName | Jméno uživatele. | Jan |
·· lastName | Příjmení uživatele. | Novák |
·· employeeNumber | Zaměstnanecké číslo uživatele. | AX12545 |
·· deactivated | Indikátor, zda je uživatel deaktivovaný. Hodnoty: true = uživatel je deaktivovaný; false = uživatel není deaktivovaný. | false |
· journeyType | Typ jízdy. Hodnoty: business = služební jízda; personal = soukromá jízda. | business |
· startDate | Datum zahájení jízdy. Uvedeno ve formátu ISO 8601. | 2023-11-13T13:28:35.382Z |
· startLocation | Místo zahájení jízdy. Vráceno pouze při “journeyType”: business. | Brno |
· startOdometer | Stav kilometrovníku (odometeru) při zahájení jízdy. Vráceno v celých kilometrech. | 87452 |
· endDate | Datum ukončení jízdy. Uvedeno ve formátu ISO 8601. | 2023-11-13T15:28:35.382Z |
· endLocation | Místo ukončení jízdy. Vráceno pouze při “journeyType”: business. | Praha |
· endOdometer | Stav kilometrovníku (odometeru) při ukončení jízdy. Vráceno v celých kilometrech. | 87665 |
· purpose | Účel jízdy. Vráceno pouze při “journeyType”: business. Hodnoty: meeting = Jednání; branchVisit = Návštěva pobočky; businessPartnerVisit = Návštěva obchodního partnera; clientVisit = Návštěva klienta; training = Školení; goodsTransportation = Přeprava zboží; consultation = Konzultace; service = Servis; commuteToFromWork = Jízda do/z práce. | service |
· fuelings | Tankování. | – |
·· date | Datum tankování. Uvedeno ve formátu ISO 8601. | 2023-11-13T14:28:35.382Z |
·· amount | Počet natankovaných litrů. Maximální délka: 3 desetinná místa (tisíciny). | 22.461 |
·· price | Částka za tankování. Uvedena v měně podle currency. | 754.67 |
·· currency | Měna tankování. Uvedena ve formátu ISO 4217. | CZK |
· breaks | Přestávky během jízdy. | – |
·· start | Počáteční datum přestávky. Uvedeno ve formátu ISO 8601. Vráceno pouze při “journeyType”: business. | 2023-11-13T13:38:35.382Z |
·· end | Konečné datum přestávky. Uvedeno ve formátu ISO 8601. Vráceno pouze při “journeyType”: business. | 2023-11-13T13:48:35.382Z |
· distance | Délka jízdy. Vráceno v celých kilometrech. | 213 |
· note | Poznámka k jízdě. | Přejezd do servisu |
Byl tento článek užitečný?