Únor, 2025 | Fidoo

18. 2. 202524. 2. 2025

Osobní vyúčtování – XML exporty

Obecný popis

Exportní výstup Osobního vyúčtování ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Osobního vyúčtování 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.

Obsahově je tento export navržen tak, aby poskytoval maximální možnou šířku informací o osobním vyúčtování 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 API (viz Public API).

Struktura a popis dat

Název interní / XML	Popis pole	Vzor dat
personalBilling/@id	Identifikátor osobního vyúčtování v rámci exportu	1
personalBilling/personalBillingId	Unikátní identifikátor osobního vyúčtování v systému Fidoo	0c5e6650-df62-4ca1-9420-a79f42b6008b
user/@idUser	Unikátní identifikátor uživatele v systému Fidoo	30dcca40-9858-4139-9230-bb86d97cf64e
user/@firstName	Jméno uživatele	Jan
user/@lastName	Příjmení uživatele	Novak
user/@job	Pozice uživatele ve své firmě	Obchodník
user/@employeeNumber	Zaměstnanecké číslo uživatele	AX12545
shortPersonalBillingId	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
personalBillingName	Název osobního vyúčtování	Od 1. 4. 2022
fromDate	Počáteční datum vystaveného osobního vyúčtování	01.04.2022
toDate	Závěrečný datum vystaveného osobního vyúčtování	06.01.2023
travelReportDaysCount	Počet dní ze zprávy o služební cestě (cesťáku)	2
travelReportMealsDaysCount	Počet dní s nárokem na náhrady stravného	1
summary/expenseSum	Součet všech výdajů více měn k vyúčtování v CZK	500
summary/privateExpenseSum	Součet všech soukromých výdajů více měn k vyúčtování v CZK	50
summary/travelAllowanceSum	Součet všech cestovních náhrad více měn k vyúčtování v CZK	100
summary/cashSettlementSum	Součet všech vyrovnání hotovosti více měn k vyúčtování v CZK	50
summary/userClearage	Souhrnné vyrování se se zaměstnancem	450
closingDate	Datum uzavření vyúčtování	06.07.2027
closedByUser/@idUser	Unikátní identifikátor uživatele v systému Fidoo, který uzavřel vyúčtování.	30dcca40-9858-4139-9230-bb86d97cf64e
closedByUser/@firstName	Jméno uživatele, který uzavřel vyúčtování	Jan
closedByUser/@lastName	Příjmení uživatele, který uzavřel vyúčtování	Novak
closedByUser/@employeeNumber	Zaměstnanecké číslo uživatele, který uzavřel vyúčtování	AX12545
closedByUser/@job	Pozice uživatele, který uzavřel vyúčtování	Obchodník
shortPersonalBillingId	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
summaryByCurrencies/summaryByCurrency/@currency	Měna transakce	EUR
summaryByCurrencies/summaryByCurrency/privateExpenseSum	Součet všech soukromých výdajů více měn k vyúčtování v CZK	50
summaryByCurrencies/summaryByCurrency/travelAllowanceSum	Součet všech cestovních náhrad více měn k vyúčtování v CZK	100
summaryByCurrencies/summaryByCurrency/userClearage	Vyrování se se zaměstnancem podle měn	-50
summaryByCurrencies/summaryByCurrency/exchangeRateCash	Měnový kurz	23.4244
summaryByCurrencies/summaryByCurrency/cashSettlementSum	Součet všech vyrovnání hotovosti k vyúčtování podle měn	10
shortPersonalBillingId	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
cashByCurrencies/cash/@currency	Měna transakce	EUR
cashByCurrencies/cash/beginPeriodCash	Stav na začátku období	0
cashByCurrencies/cash/cashRevenue	Souhrn příjmů do peněženky	0
cashByCurrencies/cash/cashIssue	Souhrn vydání z peněženky	-10
cashByCurrencies/cash/cashSettlement	Souhrn vyrovnání peněženky	20
cashByCurrencies/cash/endPeriodCash	Stav na konci období	10
shortPersonalBillingId	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
travelReportsByCurrencies/travelReport/travelReportShortId	Zkrácený identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo	TR-27
travelReportsByCurrencies/travelReport/@currency	Měna transakce	EUR
travelReportsByCurrencies/travelReport/diet	Náhrady za stravné v CZK	1000
travelReportsByCurrencies/travelReport/allowance	Peníze na cestu v CZK	2500
travelReportsByCurrencies/travelReport/fuelCompensation	Náhrada za palivo v CZK	4000
travelReportsByCurrencies/travelReport/privateCarCompensation	Náhrada za soukromé vozidlo v CZK	1000

Ukázkový exportní soubor ke stažení

Generický formát XML – Osobní vyúčtování

Návody na nastavení a exportování – Generický XML export Osobního vyúčtování

18. 2. 202525. 2. 2025

Osobní vyúčtování – XLSX exporty

Obecný popis

Exportní výstup Osobního vyúčtování ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Osobního vyúčtování 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 osobním vyúčtování 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
user_id	Unikátní identifikátor uživatele v systému Fidoo	30dcca40-9858-4139-9230-bb86d97cf64e
user_firstname	Jméno uživatele	Jan
user_lastname	Příjmení uživatele	Novak
user_position	Pozice uživatele ve své firmě	Obchodník
employee_number	Zaměstnanecké číslo uživatele	AX12545
personal_billing_short_id	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
personal_billing_name	Název osobního vyúčtování	Od 1. 4. 2022
date_from	Počáteční datum vystaveného osobního vyúčtování	01.04.2022
date_to	Závěrečný datum vystaveného osobního vyúčtování	06.01.2023
travel_report_days_count	Počet dní ze zprávy o služební cestě (cesťáku)	2
travel_report_meals_days_count	Počet dní s nárokem na náhrady stravného	1
expense_sum_czk	Součet všech výdajů více měn k vyúčtování v CZK	500
private_expense_sum_czk	Součet všech soukromých výdajů více měn k vyúčtování v CZK	50
travel_allowance_sum_czk	Součet všech cestovních náhrad více měn k vyúčtování v CZK	100
cash_settlement_sum_czk	Součet všech vyrovnání hotovosti více měn k vyúčtování v CZK	50
give_money_sum_czk	Celkové částka více měn k vyplacení uživateli v CZK	200
take_money_sum_czk	Celkové částka více měn ke stržení uživateli v CZK	300
closing_date	Datum uzavření vyúčtování	06.07.2027
closed_by_user_id	Unikátní identifikátor uživatele v systému Fidoo, který uzavřel vyúčtování.	30dcca40-9858-4139-9230-bb86d97cf64e
closed_by_user_firstname	Jméno uživatele, který uzavřel vyúčtování	Jan
closed_by_user_lastname	Příjmení uživatele, který uzavřel vyúčtování	Novak
personal_billing_short_id	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
currency	Měna transakce	EUR
private_expense_sum	Součet všech soukromých výdajů více měn k vyúčtování v CZK	50
travel_allowance_sum	Součet všech cestovních náhrad více měn k vyúčtování v CZK	100
exchange_rate_cash	Měnový kurz	23.4244
cash_settlement_sum	Součet všech vyrovnání hotovosti k vyúčtování podle měn	10
give_money_sum	Celkové částka k vyplacení uživateli podle měn	50
take_money_sum	Celkové částka ke stržení uživateli podle měn	20
personal_billing_short_id	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
currency	Měna transakce	EUR
begin_period_cash	Stav na začátku období	0
cash_revenue	Souhrn příjmů do peněženky	0
cash_issue	Souhrn vydání z peněženky	-10
cash_settlement	Souhrn vyrovnání peněženky	20
end_period_cash	Stav na konci období	10
personal_billing_short_id	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
travel_report_id	Zkrácený identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo	TR-27
currency	Měna transakce	EUR
meal_allowance	Náhrady za stravné v CZK	1000
pocket_money	Peníze na cestu v CZK	2500
fuel_compensation	Náhrada za palivo v CZK	4000
private_car_compensation	Náhrada za soukromé vozidlo v CZK	1000

Ukázkový exportní soubor ke stažení

Genericky format XLSX – Osobni vyuctovani

Návody na nastavení a exportování – Generický XLSX export Osobní vyúčtování

18. 2. 202524. 2. 2025

Uživatelé – XML exporty

Obecný popis

Exportní výstup Uživatelů ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Uživatelů 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 Uživatelích 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
firstName	Jméno uživatele	Petr
lastName	Příjmení uživatele	Jednatel
email	Emailová adresa uživatele	petr.jednatel@test.cz
employeeNumber	Zaměstnanecké číslo uživatele, pokud je vyplněno v profilu uživatele	123222
job	Pozice uživatele ve své společnosti	Účetní
phone	Telefon uživatele (který slouží pro ověření)	+420608100234
usesApplication	Identifikátor, zda uživatel používá aplikaci	true (yes)
userState	Indikace aktivního uživatele	true (active)
language	Jazyk aplikace uživatele	cs
userId	Unikátní identifikátor uživatele ve Fidoo	27d01358-3ea6-4385-8cb3-3d48eaf76df7
activeApplication	Identifikátor, zda má uživatel aktivní aplikaci	yes
usesCard	Identifikátor, zda uživatel používá kartu	yes
department	Oddělení uživatele karty	0
insuranceType	Typ pojištění v rámci produktu	Plus
insuranceCreatedDate	Datum počátku pojištění	2021-10-20
isKycVerified	Identifikátor, zda je uživatel identifikovaný	yes
costCenter	Kód nákladového střediska	NA1
project	Kód projektu	P1
identityDocumentExpiration	Konec platnosti dokladu (zpravidla OP)	2027-11-16

Ukázkový exportní soubor ke stažení

Generický formát XML – Uživatelé

Návody na nastavení a exportování – Generický XML export Uživatelů

18. 2. 202524. 2. 2025

Karty – XML exporty

Obecný popis

Exportní výstup Karet ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Karet z Fidoo ven a pro následné zpracování a další použití mimo Fidoo.
Univerzální formát XML 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 kartách 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
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
cardId	Unikátní identifikátor každé karty v systému Fidoo	04410424-5c86-4bb4-a026-a0c3f7dd7db7
cardNumber	Maskovaný PAN karty – viditelné je prvních 6 čísel a poslední 4 čísla (jde o čísla vytištěné na přední straně karty)	549546******8119
cardValidTo	Datum expirace karty	30.11.2024
cardName	Zadaný název karty v systému Fidoo	KARTA JARDA
cardState	Aktuální stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp.	first-ordered
cardType	Dle typu karty nabývá hodnot Osobní nebo Týmová	shared
cardProfile	ID spojené karetní transakce (platí jen pro platby kartou	business
cardUser/idUser	Unikátní identifikátor aktuálního držitele karty	f136de1b-d6dc-4a6e-8a8a-91713d2e9f93
cardUser/firstName;cardUser/lastName	Jméno a příjmení aktuálního držitele karty	Sam Adams
cardUser/employeeNumber	Zaměstnanecké číslo aktuálního držitele karty (pokud je vyplněno)	1234665
accountBalance	Současný účetní zůstatek karty	16
availableBalance	Současný disponibilní zůstatek karty	16
blockedBalance	Blokace na kartě	0
cardApprover/idUser	Unikátní identifikátor správce karty	4099648b-e6b8-4b4b-aa44-3591fe2ec382
cardApprover/firstName;cardApprover/lastName	Jméno a příjmení správce karty	Jana Bobošíková
cardApprover/employeeNumber	Zaměstnanecké číslo správce karty (pokud je vyplněno)	1234667
loadApprover/idUser	Unikátní identifikátor schvalovatele dobití karty	5d7f1a4b-2507-4764-a6ef-97488028f1b8
loadApprover/firstName;loadApprover/lastName	Jméno a příjmení schvalovatele dobití karty	Karel Schvalovatel
loadType	Typ dobíjení	manual
loadFrequency	Frekvence dobíjení	weekly
loadOnAmount	Dobíjení na konkrétní částku	6
whenTheAvailableBalanceDrops	Limit, jehož dosažení spouští dobití karty	2
maximumLimit	Maximální limit čerpání na kartě	100
restrictionsOfCardUsage	Omezení placení kartou	atm: true, merchants: true, e-payments: true
deliveryAddressStreet	Dodací adresa ulice	Václavská
deliveryAddressBuildingNumber	Dodací adresa číslo domu	180
deliveryAddressCity	Dodací adresa město	Chrudim
deliveryAddressPostcode	Dodací adresa poštovní směrovací číslo	53701
deliveryAddressCountry	Dodací adresa země	cze
orderDate	Datum objednání	03.12.2021
orderState	Stav objednání karty	ordered
alias	Volitelný název karty pro snadné hledání v systému	Adamsova karta

Ukázkový exportní soubor ke stažení

Generický formát XML – Karty

Návody na nastavení a exportování – Generický XML export Karet

18. 2. 202525. 2. 2025

Uživatelé – XLSX exporty

Obecný popis

Exportní výstup Uživatelů ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Uživatelů 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 uživatelích 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
first_name	Jméno uživatele	Petr
last_name	Příjmení uživatele	Jednatel
email	Emailová adresa uživatele	petr.jednatel@test.cz
employee_number	Zaměstnanecké číslo uživatele, pokud je vyplněno v profilu uživatele	123222
position	Pozice uživatele ve své společnosti	Účetní
phone	Telefon uživatele (který slouží pro ověření)	+420608100234
uses_application	Identifikátor, zda uživatel používá aplikaci	true (yes)
is_active	Indikace aktivního uživatele	true (active)
language	Jazyk aplikace uživatele	cs
costCenter	Kód nákladového střediska	NA1
project	Kód projektu	P1
identityDocumentExpiration	Konec platnosti dokladu (zpravidla OP)	2027-11-16

Ukázkový exportní soubor ke stažení

Generický formát XLSX – Uživatelé

Návody na nastavení a exportování – Generický XLSX export Uživatelů

18. 2. 202525. 2. 2025

Karty – XLSX exporty

Obecný popis

Exportní výstup Karet ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Karet 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 kartách 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
card_id	Unikátní identifikátor každé karty v systému Fidoo	04410424-5c86-4bb4-a026-a0c3f7dd7db7
card_number	Maskovaný PAN karty – viditelné je prvních 6 čísel a poslední 4 čísla (jde o čísla vytištěné na přední straně karty)	549546******8119
card_valid_to	Datum expirace karty	30.11.2024
card_name	Zadaný název karty v systému Fidoo	KARTA JARDA
card_state	Aktuální stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp.	first-ordered
card_type	Dle typu karty nabývá hodnot Osobní nebo Týmová	shared
card_profile	ID spojené karetní transakce (platí jen pro platby kartou	business
card_users_id	Unikátní identifikátor aktuálního držitele karty	f136de1b-d6dc-4a6e-8a8a-91713d2e9f93
card_holder_name_surname	Jméno a příjmení aktuálního držitele karty	Sam Adams
account_balance	Současný účetní zůstatek karty	16
available_balance	Současný disponibilní zůstatek karty	16
blocked_balance	Blokace na kartě	0
card_approver_id	Unikátní identifikátor správce karty	4099648b-e6b8-4b4b-aa44-3591fe2ec382
card_approver_name_surname	Jméno a příjmení správce karty	Jana Bobošíková
load_approver_id	Unikátní identifikátor schvalovatele dobití karty	5d7f1a4b-2507-4764-a6ef-97488028f1b8
load_approver_name_surname	Jméno a příjmení schvalovatele dobití karty	Karel Schvalovatel
load_type	Typ dobíjení	manual
load_frequency	Frekvence dobíjení	weekly
load_on_amount	Dobíjení na konkrétní částku	6
when_the_available_balance_drops_below	Limit, jehož dosažení spouští dobití karty	2
maximum_limit	Maximální limit čerpání na kartě	100
restrictions_of_card_usage	Omezení placení kartou	atm: true, merchants: true, e-payments: true
delivery_address_street	Dodací adresa ulice	Václavská
delivery_address_building_number	Dodací adresa číslo domu	180
delivery_address_city	Dodací adresa město	Chrudim
delivery_address_postcode	Dodací adresa poštovní směrovací číslo	53701
delivery_address_country	Dodací adresa země	cze
order_date	Datum objednání	03.12.2021
order_state	Stav objednání karty	ordered
alias	Volitelný název karty pro snadné hledání v systému	Adamsova karta

Ukázkový exportní soubor ke stažení

Genericky format XLSX – Karty

Návody na nastavení a exportování – Generický XLSX export Karet

18. 2. 202524. 2. 2025

Cesťáky – XML exporty

Obecný popis

Exportní výstup Cesťáků-zpráv ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Cesťáků 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 Cesťácích-zprávách 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 místo XLSX formátu. Dalším vhodným způsobem integrace Fidoo na další podnikové systémy je využití Fidoo Public (viz Public API).

Struktura a popis dat

Název interní / XML	Popis pole	Vzor dat
travelReport/id	Identifikátor výdaje v rámci exportu	1
reportId	Identifikátor cesťáku	TR-455
reportName	Název cesťáku	Cesta do Mordoru
user/firstName	Jméno uživatele	Sam
user/lastName	Příjmení uživatele	Křepelka
user/employeeNumber	Zaměstnanecké číslo (pokud je vyplněno)	1234666
user/job	Pozice uživatele ve své společnosti	Účetní
journeyType	Typ cesty	foreign
reportState	Status cesťáku	approve
journeyStartDate	Datum začátku cesty	2021-11-22T08:00:00+01:00
journeyEndDate	Datum konce cesty	2021-11-26T09:00:00+01:00
journeyStartPoint	Místo začátku cesty	Praha, Česko
journeyEndPoint	Místo konce cesty	Katovice, Polsko
allowance/mealAllowanceCzk	Stravování (orientační výpočet)	880
allowance/pocketMoneyCzk	Kapesné (orientační výpočet)	440
allowance/carAllowanceCzk	Náhrada za soukromé vozidlo (orientační výpočet)	0
allowance/fuelAllowanceCzk	Náhrada za palivo (orientační výpočet)	0
allowance/allowanceTotalCzk	Celkové náhrady (orientační výpočet)	1320
domesticAllowance/currency	Měna tuzemského stravného	CZK
domesticAllowance/mealAllowance	Tuzemské stravné	140
costCenters/costcenter	Nákladové středisko, ke kterému je cesťák přiřazen	AAA
projects/project	Projekt, ke kterému je cesťák přiřazen	BBB
journeyNote	Poznámka	text poznámky
reportCreated	Datum vytvoření cesťáku	2021-11-22T13:25:11+01:00
reportAuthor	Cestovatel	Sam Křepelka
reportApproved	Schvalovatel cesťáku	Karel Schvalovatel
approval/date	Datum posledního schválení	2021-12-22T09:25:11+01:00
approval/firstName	Jméno posledního schvalovatele	Karel
approval/lastName	Příjmení posledního schvalovatele	Schvalovatel
approval/employeeNumber	Zaměstnanecké číslo posledního schvalovatele	123666
reportAccountantApproved	Datum schválení účetní	2022-05-05T14:52:00.926986
accountantApproval/date	Datum schválení účetní	2022-05-05T14:52:00.926986
accountantApproval/firstName	Jméno účetní	Jana
accountantApproval/lastName	Příjmení účetní	Vypočítavá
accountantApproval/employeeNumber	Zaměstnanecké číslo účetní (pokud je vyplněno)	123888
request/requestId	Identifikátor žádosti	TQ-555
request/requestState	Status žádosti	approve
export/fromDate	Výpis cesťáků od data	2021-11-01T00:00:00+01:00
export/toDate	Výpis cesťáků do data	2021-11-30T23:59:59.999+01:00
export/created	Datum exportu souboru	2021-11-29T09:47:14.202+01:00
trip/id	Identifikátor cesty	9afba974-5a49-428b-a29c-afd8e760f1b4
trip/startDate	Datum začátku jedn. cesty	2021-11-23T08:00:00+01:00
trip/endDate	Datum konce jedn. cesty	2021-11-23T11:00:00+01:00
trip/startPoint	Místo začátku jedn. cesty	Praha,Česko
trip/endPoint	Místo konce jedn. cesty	Katovice, Polsko
trip/travelReportShortId	Identifikátor cesťáku	TR-455
trip/journeyType	Typ cesty	FOREIGN
trip/mealAllowanceCzk	Stravování (orientační výpočet)	880
trip/pocketMoneyCzk	Kapesné (orientační výpočet)	440
trip/carAllowanceCzk	Náhrada za soukromé vozidlo (orientační výpočet). Amortizace	0
trip/fuelAllowanceCzk	Náhrada za palivo (orientační výpočet)	0
trip/allowanceTotalCzk	Celkové náhrady (orientační výpočet)	1320
depositRequested	Výše žádosti peněz na cestu	0
depostiType	Typ zálohy	card
depositCurrency	Měna žádaných peněz na cestu	CZK
daysCount	Počet dní ze zprávy o služební cestě (cesťáku)	2
mealsDaysCount	Počet dní s nárokem na náhrady stravného	1
trip/parts/part/transportType	Typ prostředku pro část cesty	companyVehicle
trip/parts/part/departure	Doba odjezdu z části cesty	2023-11-28T08:00:00+01:00
trip/parts/part/country	Identifikátor země části cesty (ISO 3166 Alpha-2)	CZ
trip/parts/part/location	Název lokace části cesty (může to být začátek, cíl nebo konec cesty)	Praha, Česko
trip/parts/part/arrival	Doba příjezdu do části cesty	2023-11-28T08:00:00+01:00
trip/parts/part/distance	Počet ujetých km v rámci konkrétní části cesty	200
trip/parts/part/vehicle/id	ID prostředku	40ea0da2-6001-4fd3-831a-22f3eba4b46f
trip/parts/part/vehicle/brand	Značka (výrobce) vozidla	Škoda
trip/parts/part/vehicle/model	Modelové označení vozidla	Octavia
trip/parts/part/vehicle/registrationNumber	Registrační značka vozidla	7AA7000
trip/parts/part/vehicle/vin	VIN vozidla	TMBGDM9AKP042788
trip/parts/part/vehicle/internalName	Interní název vozidla (nepoužívá se)	Samova oktávka
trip/parts/part/vehicle/type	Typ vozidla	car
trip/parts/part/vehicle/state	Stav vozidla ve aplikaci Fidoo	active
trip/parts/part/vehicle/ownership	Vlastnictví vozidla, zda je soukromé nebo firemní	company
trip/parts/part/vehicle/usage	Indikace, zda je vozidlo sdílené (pool), nebo jej může využívat pouze jeden uživatel (individual)	individual
trip/parts/part/vehicle/engineVolume	Objem motoru [cm3]	2500
trip/parts/part/vehicle/fuelConsumption	Spotřeba (kombinovaná)	5
trip/parts/part/vehicle/fuelType	Typ paliva vozidla	natural-95
trip/parts/part/borderCrossings/borderCrossing/date	Doba přechodu státní hranice	2023-11-28T09:30:00+01:00
trip/parts/part/borderCrossings/borderCrossing/countryFrom	Identifikátor země, ze které zaměstnanec vyjíždí (ISO 3166 Alpha-2)	CZ
trip/parts/part/borderCrossings/borderCrossing/countryTo	Identifikátor země, do které zaměstnanec vstupuje (ISO 3166 Alpha-2)	PL

Ukázkový exportní soubor ke stažení

Generický formát XML – Cesťáky

Návody na nastavení a exportování – Generický XML export Cesťáků

18. 2. 202524. 2. 2025

Hotovostní transakce – XML exporty

Obecný popis

Exportní výstup Hotovostních transakcí ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Hotovostních transakcí z Fidoo ven a pro následné zpracování a další použití mimo Fidoo.

Hotovostní transakce jsou pouze pohyby v jednotlivých peněženkách, tento import je používán ve specifických případech, kdy někteří klienti prohlásí peněženku konkrétního uživatele za firemní pokladnu a poté k ní tak přistupují.

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 Hotovostních transakcích 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
transactionId	Identifikátor transakce v systému Fidoo	5c30dbd2-3756-49d1-88cb-7d12c5933218
shortExpenseId	Zkrácený identifikátor výdaje propojeného s transakcí (unikátní v rámci vaší firmy)	EX-2764
user	Celé jméno uživatele	Petr Jednatel
userDetail/firstName	Jméno	Petr
userDetail/lastName	Příjmení	Jednatel
userDetail/employeeNumber	Zaměstnanecké číslo (pokud je vyplněno)	1234666
userDetail/idUser	Identifikátor uživatele v systému Fidoo	c7583cdb-5f3b-4198-b48f-588afab3530b
walletName	Název hotovostní peněženky	Petr Jednatel CZK
createTransactionDate	Časové razítko vzniku transakce	2021-06-17T00:00:00
amountOriginalCurrency	Částka platební operace	-487
currency	Měna, ve které bylo placeno	CZK
transactionType	Obsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp.	expense
companyName	Pokud je vyplněno, obsahuje text z pole název obchodníka na kartě spárovaného výdaje	Baťa
address	Pokud je vyplněno, obsahuje text z pole adresa obchodníka na kartě spárovaného výdaje	Baťova ulice, Zlín
category	Pokud je vyplněno, obsahuje parametr z pole kategorie obchodníka na kartě spárovaného výdaje	other
expenseId	Unikátní identifikátor připojeného výdaje v systému Fidoo	4a400c70-1ee5-491a-b3db-9828fb36d8e5
amountPrivate	Celková výše soukromých hotovostních výdajů	47
ico	IČO společnosti vytvářející export	1234666
receiptLinks/link	Odkaz na účtenku (pokud je přiřazena)	https://api-fidoo.com/doc/download/…

Ukázkový exportní soubor ke stažení

Genericky format XML – Hotovostní transakce

Návody na nastavení a exportování – Generický XML export Hotovostních transakcí

18. 2. 202524. 2. 2025

Transakce na Fidoo účtu – XML exporty

Obecný popis

Exportní výstup Transakcí na Fidoo účtu ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Transakcí na Fidoo účtu 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 transakcích na Fidoo účtu 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
transactionId	Systémový identifikátor transakce	1ab353df-7c00-47cc-a992-37e3865ec916
transactionCreateDate	Časové razítko vytvoření transakce	2021-01-13T13:01:00
transactionType	Typ transakce	card-load
transactionOriginalAmount	Původní částka	20000.00000
transactionOriginalCurrency	Původní měna	CZK
transactionSettledAmount	Účtovaná částka	-20000.00
transactionSettlementDate	Datum zaúčtování	2021-01-13T13:01:00
cardId	Systémové ID platební karty (pouze u transakcí souvisejících s kartami)	01131d1f-a118-af09-7516-826a04f5e2d4
cardMaskedNumber	Maskované číslo platební karty	549546******2919
cardName	Embosované jméno na kartě	Petr Jednatel
transactionInitiatedUserEmail	Email uživatele, který transakci inicioval	karel.schvalovatel@domena.cz
transactionInitiatedUserName	Jméno uživatele, který transakci inicioval	Karel Schvalovatel
transactionNote	Poznámka k transakci	text poznámky
user/@firstName	Jméno uživatele vázaného k transakci	Jana
user/@lastName	Příjmení uživatele vázaného k transakci	Vypočítavá
user/@employeeNumber	Zaměstnanecké číslo uživatele vázaného k transakci (pokud je vyplněno)	123666
user/@job	Pozice uživatele ve své společnosti	Účetní
user/@idUser	Identifikátor uživatele vázaného k transakci v systému Fidoo	c7583cdb-5f3b-4198-b48f-588afab3530b
cardHolder/@firstName	Jméno držitele karty	Petr
cardHolder/@lastName	Příjmení držitele karty	Jednatel
cardHolder/@employeeNumber	Zaměstnanecké číslo uživatele, který je držitelem karty (pokud je vyplněno)	114477
cardHolder/@job	Pozice uživatele ve své společnosti	Obchodník
cardHolder/@idUser	Identifikátor držitele karty v systému Fidoo	c7583cdb-5f3b-4198-b48f-588afab3530b

Ukázkový exportní soubor ke stažení

Generický formát XML – Transakce na Fidoo účtu

Návody na nastavení a exportování – Generický XML export Transakcí na Fidoo účtu

18. 2. 202525. 2. 2025

Karetní transakce – XML exporty

Obecný popis

Exportní výstup Karetních transakcí ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Karetních transakcí 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 karetních transakcích 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 místo XLSX formátu. Dalším vhodným způsobem integrace Fidoo na další podnikové systémy je využití Fidoo Public (viz Public API).

Struktura a popis dat

transactionId	Identifikátor transakce v systému Fidoo	a58ef2f7-0587-4353-bc42-25f1f6a1363f
shortTransactionId	Zkrácený identifikátor transakce v systému Fidoo	1664700
cardId	Identifikátor karty v systému Fidoo	dfbcd0f2-f0f4-48f7-8214-25448eb58e4f
cardName	Název konkrétní karty	PETR JEDNATEL
cardNumber	Maskovaný PAN karty – viditelné je prvních 6 čísel a poslední 4 čísla (jde o čísla vytištěné na přední straně karty)	549546******3602
cardType	Dle typu karty nabývá hodnot Osobní nebo Týmová	shared
cardAlias	Volitelný název karty pro snadné hledání v systému	Adamsova karta
shortExpenseId	Zkrácené unikátní ID výdaje propojeného s transakcí (unikátní v rámci vaší firmy)	EX-4568
createTransactionDate	Časové razítko vzniku transakce	2021-07-16T11:09:19Z
settlementDate	Časové razítko zaúčtování transakce (pokud bylo již zaúčtováno)	2021-07-16T11:09:19Z
amountOriginalCurrency	Částka platební operace	150
currency	Měna, ve které bylo placeno	CZK
transactionSettledAmountCzk	Částka která byla zaúčtovaná (pokud již bylo zaúčtováno) – tato hodnota má opačné znaménko než pole částka transakce	-150.00
fee	Obsahuje údaj o výši poplatku v Kč	0.00
transactionState	Dle aktuální stavu transakce – nejčastěji zaúčtovaná	approved
transactionType	Obsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp.	Platba u obchodníka
companyName	Pokud je vyplněno, obsahuje text z pole název obchodníka na kartě spárovaného výdaje	ČD – České dráhy
address	Pokud je vyplněno, obsahuje text z pole adresa obchodníka na kartě spárovaného výdaje	PRAHA 1
country	Identifikátor země, na jejímž území k transakci došlo.	cze
category	Pokud je vyplněno, obsahuje parametr z pole kategorie obchodníka na kartě spárovaného výdaje	Travel
expenseId	Identifikátor připojeného výdaje v systému Fidoo	e341ae40-e6b9-4270-90da-4591759b25fc
amountPrivate	Výše částky z transakce, která je vedena jako soukromá	0
user/firstName	Jméno uživatele	Petr
user/lastName	Příjmení uživatele	Jednatel
user/employeeNumber	Zaměstnanecké číslo uživatele (pokud je vyplněno)	1234666
user/job	Pozice uživatele ve své společnosti	Obchodník
user/idUser	Identifikátor uživatele v systému Fidoo	c7583cdb-5f3b-4198-b48f-588afab3530b
companyNameDescription	Popis obchodníka, místo, země	www.cd.cz/eshop/ Praha 1 CZE
note	Poznámka	Místenka do vlaku
mcc	Mezinárodní kód kategorie obchodníka	5411

Ukázkový exportní soubor ke stažení

Generický formát XML – Karetní transakce

Návody na nastavení a exportování – Generický XML export Karetních transakcí

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Obecný popis

Principy a pravidla používání exportu

Struktura a popis dat

Ukázkový exportní soubor ke stažení

Expense Management

FX a zahraniční platby

Direct Fidoo