Únor, 2025 | Fidoo

18. 2. 202518. 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
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/@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
daysCount	Počet dní	2
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/privateExpenseSum + summary/travelAllowanceSum + summary/cashSettlementSum	Celkové částka více měn k vyplacení uživateli v CZK	200
-1*(summary/privateExpenseSum + summary/travelAllowanceSum + summary/cashSettlementSum)	Celkové částka více měn ke stržení uživateli v CZK	300
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
shortPersonalBillingId	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
summaryByCurrency/@currency	Měna transakce	EUR
summaryByCurrency/privateExpenseSum	Součet všech soukromých výdajů více měn k vyúčtování v CZK	50
summaryByCurrency/travelAllowanceSum	Součet všech cestovních náhrad více měn k vyúčtování v CZK	100
summaryByCurrency/exchangeRateCash	Měnový kurz	23.4244
summaryByCurrency/cashSettlementSum	Součet všech vyrovnání hotovosti k vyúčtování podle měn	10
summaryByCurrency/privateExpenseSum + summaryByCurrency/travelAllowanceSum + summaryByCurrency/cashSettlementSum	Celkové částka k vyplacení uživateli podle měn	50
-1*(summaryByCurrency/privateExpenseSum + summaryByCurrency/travelAllowanceSum + summaryByCurrency/cashSettlementSum)	Celkové částka ke stržení uživateli podle měn	20
shortPersonalBillingId	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
cash/@currency	Měna transakce	EUR
cash/beginPeriodCash	Stav na začátku období	0
cash/cashRevenue	Souhrn příjmů do peněženky	0
cash/cashIssue	Souhrn vydání z peněženky	-10
cash/cashSettlement	Souhrn vyrovnání peněženky	20
cash/endPeriodCash	Stav na konci období	10
shortPersonalBillingId	Zkrácený identifikátor osobního vyúčtování v systému Fidoo	PB-459
travelReport/travelReportShortId	Unikátní identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo	331a0bd0-0f95-11ea-8d71-362b9e155667
travelReport/@currency	Měna transakce	EUR
travelReport/diet	Náhrady za stravné v CZK	1000
travelReport/allowance	Peníze na cestu v CZK	2500
travelReport/fuelCompensation	Náhrada za palivo v CZK	4000
expense/expenseId	Identifikátor výdaje v systému Fidoo	17d15115-4d25-448f-83a3-98be72d95923
expense/expenseName	Název výdaje	Nákup bot
expense/state	Status výdaje	accountantApprove
expense/shortExpenseId	Zkrácený unikátní identifikátor výdaje v rámci firmy	EX-1041
expense/user/[@firstName]	Jméno uživatele	Petr
expense/user/[@lastName]	Příjmení uživatele	Jednatel
expense/user/[@employeeNumber]	Zaměstnanecké číslo (pokud je vyplněno)	1234666
expense/user/[@idUser]	Unikátní identifikátor uživatele v systému Fidoo	30dcca40-9858-4139-9230-bb86d97cf64e
expense/companyAmount		333
expense/receiptAmount		333
expense/companyAmount/[@currency]		CZK
expense/receiptAmount/[@currency]		CZK
expense/createExpenseDate	Datum vzniku výdaje	2020-05-03T10:27:16
expense/settlementDate	Datum vypořádání výdaje	2020-05-03T10:27:16
expense/currency	Původní měna transakce (pokud je jiná než Kč)	EUR
expense/taxBase	Základ pro DPH	1817
expense/amountVat	Výše DPH	483
expense/vatRate	Sazba DPH	0,21
expense/accountAssignmentCode	Kód předkontace	AAA
expense/accountDebit	Hodnota MÁ DÁTI	518000
expense/accountCredit	Hodnota DAL	321000
expense/accountVatAssignmentCode	Kód DPH dané předkontace	Kod
expense/accountVatDebit	Hodnota DPH pro MÁ DÁTI	21
expense/accountVatCredit	Hodnota DPH pro DAL	10
expense/companyExpense	Hodnota firemního výdaje	2300
expense/privateExpense	Hodnota soukromého výdaje	0
expense/exchangeRateToCompanyCurrency	Kurz měny výdaje vzhledem k firemní měně	1
expense/merchantName	Název obchodníka	Baťa
expense/costCenterCode	Kód nákladového střediska	50001
expense/projectCode	Kód projektu	DO
expense/accountingCategory	Účetní kategorie – Název	Accommodation
expense/accountingCategory/[@code]	Účetní kategorie – Kód	ACCO1
expense/paymentType	Typ transakce (např. cash – hotovostní)	cash
expense/note	Poznámka	text v poznámce
expense/pairingKey	Párovací klíč. V případě, že jde o externí transakci tak se do tohoto pole propíše externí ID (např. KB externí ID)	3000
expense/externalReferenceId
expense/originalTaxDocumentNumber
expense/travelReportId
expense/items/item/name	Položka – název	Boty
expense/items/item/costCenterCode	Položka – nákladové středisko	50002
expense/items/item/projectCode	Položka – projekt	DO
expense/items/item/amountOriginalCurrency	Položka – hodnota výdaje v původní měně (pokud je jiná než Kč)	85
expense/items/item/vatAmount	Položka – výše DPH	1617
expense/items/item/vatRate	Položka – sazba DPH	0,21
expense/items/item/vatAccountDebit	Položka – DPH pro MÁ DÁTI	21
expense/items/item/vatAccountCredit	Položka – DPH pro DAL	10
expense/items/item/accountDebit	Položka – hodnota MÁ DÁTI	518000
expense/items/item/accountCredit	Položka – hodnota DAL	321000
expense/items/item/accountAssignmentCode	Položka – kód předkontace	AAA
expense/items/item/accountVatAssignmentCode	Položka – DPH předkontace	Kod

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. 202518. 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
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í	2
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	Unikátní identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo	331a0bd0-0f95-11ea-8d71-362b9e155667
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

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. 202518. 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í)	420608112233
usesApplication	Identifikátor, zda uživatel používá aplikaci	yes
userState	Indikace aktivního uživatele	PRAVDA
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í	20.10.2021
isKycVerified	Nabývá hodnot ověřený/neověřený/ uživatel v závislosti na jeho stavu.	yes

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. 202518. 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átory současných uživatelů spojených s kartou – v případě vícero uživatelů jsou odděleny středníkem	f136de1b-d6dc-4a6e-8a8a-91713d2e9f93
cardUser/firstName;cardUser/lastName	Jméno a příjmení uživatele karty	Sam Adams
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 schvalovatele karty	4099648b-e6b8-4b4b-aa44-3591fe2ec382
cardApprover/firstName;cardApprover/lastName	Jméno a příjmení schvalovatele karty	Jana Bobošíková
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. 202518. 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í)	420608112233
uses_application	Identifikátor, zda uživatel používá aplikaci	yes
is_active	Indikace aktivního uživatele	PRAVDA
language	Jazyk aplikace uživatele	cs

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. 202518. 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átory současných uživatelů spojených s kartou – v případě vícero uživatelů jsou odděleny středníkem	f136de1b-d6dc-4a6e-8a8a-91713d2e9f93
card_holder_name_surname	Jméno a příjmení uživatele 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 schvalovatele karty	4099648b-e6b8-4b4b-aa44-3591fe2ec382
card_approver_name_surname	Jméno a příjmení schvalovatele karty	Jana Bobošíková
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. 202518. 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		CZK
domesticAllowance/mealAllowance		0
costCenters/costcenter	Označení cost centra na které je cesťák přiřazen	AAA
projects/project	Označení projektu na které 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	Autor cesťáku	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	companyVehicle
trip/parts/part/departure	Čas odjezdu	2023-11-28T08:00:00+01:00
trip/parts/part/country	Země lokace	CZ
trip/parts/part/location	Název lokace části cesty, může to být začátek, konec nebo cíl cesty	Praha,Česko
trip/parts/part/arrival	Čas příjezdu	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
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

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. 202518. 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. 202518. 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
cardHolder/firstName	Jméno držitele karty	Petr
cardHolder/lastName	Příjmení držitele karty	Jednatel
user/@employeeNumber	Zaměstnanecké číslo uživatele, který transakci vyvolal (pokud je vyplněno)	123666
cardHolder/job	Pozice uživatele ve své společnosti	Obchodník
cardHolder/idUser	Identifikátordržitele karty v systému Fidoo	c7583cdb-5f3b-4198-b48f-588afab3530b
cardHolder/@employeeNumber	Zaměstnanecké číslo uživatele, který je držitelem karty (pokud je vyplněno)	114477

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. 202518. 2. 2025

Transakce na kartách – 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

Název interní / XML	Popis pole	Vzor 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
alias	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ě
note	Poznámka

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