Search
Close this search box.

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 v Exportu / XML Popis pole Vzor dat
personalBillingId
user/firstName Unikátní   identifikátor uživatele v systému Fidoo 30dcca40-9858-4139-9230-bb86d97cf64e
user/lastName Jméno uživatele Jan
user/employeeNumber Příjmení uživatele Novak
user/idUser 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í 2022-04-01
toDate Závěrečný datum   vystaveného osobního vyúčtování 2023-01-06
closingDate Datum uzavření   vyúčtování 2027-07-06
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/idUser Unikátní   identifikátor uživatele v systému Fidoo, který uzavřel vyúčtování 30dcca40-9858-4139-9230-bb86d97cf64e
summary Souhrn podle   companyCurrency CZK
expenseSum Součet všech výdajů   více měn k vyúčtování v CZK 500
cashSettlementSum Součet všech   vyrovnání hotovosti více měn k vyúčtování v CZK 50
privateExpenseSum Součet všech   soukromých výdajů více měn k vyúčtování v CZK 50
travelAllowanceSum Součet všech   cestovních náhrad více měn k vyúčtování v CZK 100
userClearage Vyrovnání hotovostní   peněženky uživatele 100
summaryByCurrencies
summaryByCurrency Souhrn podle currency CZK
privateExpenseSum Součet všech   soukromých výdajů více měn k vyúčtování v CZK 50
travelAllowanceSum Součet všech   cestovních náhrad více měn k vyúčtování v CZK 100
cashSettlementSum Součet všech   vyrovnání hotovosti k vyúčtování podle měn 10
userClearage Vyrovnání hotovostní   peněženky uživatele 10
exchangeRateCash Měnový kurz 23.4244
cashByCurrencies
cash Souhrn podle currency CZK
beginPeriodCash Stav   na začátku období 0
cashRevenue Souhrn   příjmů do peněženky 0
cashIssue Souhrn   vydání z peněženky -10
cashSettlement Souhrn   vyrovnání peněženky 20
endPeriodCash Stav   na konci období 10
travelReportDaysCount Počet dní ze zprávy o   služební cestě (cesťáku) 2
travelReportsByCurrencies Souhrn zpráv o   služební cestě (cesťáků) podle měn

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

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

List (sheet): summary  
   
Název v Exportu   
   
Název interní / XML   
   
Popis pole   
   
Vzor   dat   
   
user_id   
   
user/@idUser   
   
Unikátní identifikátor uživatele v systému Fidoo   
   
30dcca40-9858-4139-9230-bb86d97cf64e   
   
user_firstname   
   
user/@firstName   
   
Jméno uživatele   
   
Jan   
   
user_lastname   
   
user/@lastName   
   
Příjmení uživatele   
   
Novak   
   
employee_number   
   
user/@employeeNumber   
   
Zaměstnanecké číslo uživatele   
   
AX12545   
   
personal_billing_short_id   
   
shortPersonalBillingId   
   
Zkrácený identifikátor osobního vyúčtování v systému Fidoo   
   
PB-459   
   
personal_billing_name   
   
personalBillingName   
   
Název osobního vyúčtování   
   
Od 1.   4. 2022   
   
date_from   
   
fromDate   
   
Počáteční datum vystaveného osobního vyúčtování   
   
2022-04-01   
   
date_to   
   
toDate   
   
Závěrečný datum vystaveného osobního vyúčtování   
   
2023-01-06   
   
expense_sum_czk   
   
summary/expenseSum   
   
Součet všech výdajů více měn k vyúčtování v CZK   
   
500   
   
private_expense_sum_czk   
   
summary/privateExpenseSum   
   
Součet všech soukromých výdajů více měn k vyúčtování v CZK   
   
50   
   
travel_allowance_sum_czk   
   
summary/travelAllowanceSum   
   
Součet všech cestovních náhrad více měn k vyúčtování v CZK   
   
100   
   
cash_settlement_sum_czk   
   
summary/cashSettlementSum   
   
Součet všech vyrovnání hotovosti více měn k vyúčtování v CZK   
   
50   
   
give_money_sum_czk   
   
summary/privateExpenseSum   + summary/travelAllowanceSum + summary/cashSettlementSum   
   
Celkové částka více měn k vyplacení uživateli v CZK   
   
200   
   
take_money_sum_czk   
   
-1*(summary/privateExpenseSum   + summary/travelAllowanceSum + summary/cashSettlementSum)   
   
Celkové částka více měn ke stržení uživateli v CZK   
   
300   
   
closing_date   
   
closingDate   
   
Datum uzavření vyúčtování   
   
2027-07-06   
   
closed_by_user_id   
   
closedByUser/@idUser   
   
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   
   
closedByUser/@firstName   
   
Jméno uživatele, který uzavřel vyúčtování.   
   
Jan   
   
closed_by_user_lastname   
   
closedByUser/@lastName   
   
Příjmení uživatele, který uzavřel vyúčtování.   
   
Novak   
List (sheet): summary by currency  
   
personal_billing_short_id   
   
shortPersonalBillingId   
   
Zkrácený identifikátor osobního vyúčtování v systému Fidoo   
   
PB-459   
   
currency   
   
summaryByCurrency/@currency   
   
Měna transakce   
   
EUR   
   
private_expense_sum   
   
summaryByCurrency/privateExpenseSum   
   
Součet všech soukromých výdajů více měn k vyúčtování v CZK   
   
50   
   
travel_allowance_sum   
   
summaryByCurrency/travelAllowanceSum   
   
Součet všech cestovních náhrad více měn k vyúčtování v CZK   
   
100   
   
exchange_rate_cash   
   
summaryByCurrency/exchangeRateCash   
   
Měnový kurz   
   
23.4244   
   
cash_settlement_sum   
   
summaryByCurrency/cashSettlementSum   
   
Součet všech vyrovnání hotovosti k vyúčtování podle měn   
   
10   
   
give_money_sum   
   
summaryByCurrency/privateExpenseSum +   summaryByCurrency/travelAllowanceSum + summaryByCurrency/cashSettlementSum   
   
Celkové částka k vyplacení uživateli podle měn   
   
50   
   
take_money_sum   
   
-1*(summaryByCurrency/privateExpenseSum +   summaryByCurrency/travelAllowanceSum + summaryByCurrency/cashSettlementSum)   
   
Celkové částka ke stržení uživateli podle měn   
   
20   
List (sheet): cash summary  
   
personal_billing_short_id   
   
shortPersonalBillingId   
   
Zkrácený identifikátor osobního vyúčtování v systému Fidoo   
   
PB-459   
   
currency   
   
cash/@currency   
   
Měna transakce   
   
EUR   
   
begin_period_cash   
   
cash/beginPeriodCash   
   
Stav na začátku období   
   
0   
   
cash_revenue   
   
cash/cashRevenue   
   
Souhrn příjmů do peněženky   
   
0   
   
cash_issue   
   
cash/cashIssue   
   
Souhrn vydání z peněženky   
   
-10   
   
cash_settlement   
   
cash/cashSettlement   
   
Souhrn vyrovnání peněženky   
   
20   
   
end_period_cash   
   
cash/endPeriodCash   
   
Stav na konci období   
   
10   
List (sheet): travel allowance  
   
personal_billing_short_id   
   
shortPersonalBillingId   
   
Zkrácený identifikátor osobního vyúčtování v systému Fidoo   
   
PB-459   
   
travel_report_id   
   
travelReport/travelReportShortId   
   
Unikátní identifikátor zprávy o služební cestě (cesťáku)   v systému Fidoo   
   
331a0bd0-0f95-11ea-8d71-362b9e155667   
   
currency   
   
travelReport/@currency   
   
Měna transakce   
   
EUR   
   
meal_allowance   
   
travelReport/diet   
   
Náhrady za stravné v CZK   
   
1000   
   
pocket_money   
   
travelReport/allowance   
   
Peníze na cestu v CZK   
   
2500   
   
fuel_compensation   
   
travelReport/fuelCompensation   
   
Náhrada za palivo v CZK   
   
4000   
   
private_car_compensation   
   
travelReport/privateCarCompensation   
   
Náhrada za soukrové vozidlo v CZK   
   
3000   

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

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
firstName Jméno Petr
lastName Příjmení Jednatel
employeeNumber Zaměstnanecké číslo   (pokud je vyplněno) 1234666
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

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

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
cardHolder/employeeNumber Zaměstnanecké číslo   držitele karty (pokud je vyplněno) 1234666
cardHolder/idUser Identifikátordržitele   karty v systému Fidoo c7583cdb-5f3b-4198-b48f-588afab3530b

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

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
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   (pokud je vyplněno) 1234666
user/idUser Identifikátor   uživatele v systému Fidoo c7583cdb-5f3b-4198-b48f-588afab3530b
user/companyNameDescription Popis obchodníka,   místo, země WWW.CD.CZ/ESHOP/, PRAHA 1, cze

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

Výdaje – XML exporty

Obecný popis

Exportní výstup Výdajů ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Výdajů  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 výdají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 API (viz Public API).

Struktura a popis dat

Název   interní / XML Popis pole Vzor dat
expenseId Identifikátor výdaje   v systému Fidoo e341ae40-e6b9-4270-90da-4591759b25fc
expenseName Název výdaje Pohoštění pro   zákazníka
state Statut výdaje prepare
shortExpenseId Zkrácený   identifikátor výdaje v rámci firmy EX-2740
firstName Jméno uživatele Petr
lastName Příjemní uživatele Jednatel
employeeNumber Zaměstnanecké číslo   (pokud je vyplněno) 123666
idUser Identifikátor   uživatele v systému Fidoo c7583cdb-5f3b-4199-b48f-588afab3530b
amountCzk Celková částka   transakce v Kč 73738
amountOriginalCurrency Celková částka   transakce v původní měně (pokud je jiná než Kč) 73738
currency Původní měna   transakce (pokud je jiná než Kč) CZK
taxBase Základ pro DPH 73738
amountVat Výše DPH 15484,98
vatRate Sazba DPH 0,21
accountAssignmentCode Kód předkontace AAA
accountCredit Hodnota DAL 35987
accountDebit Hodnota MÁ DÁTI 37751
accountVatAssignmentCode Kód DPH dané   předkontace Kód
accountVatCredit Hodnota DPH pro DAL 10
accountVatDebit Hodnota DPH pro MÁ   DÁTI 21
companyExpense Hodnota firemního   výdaje 73674
privateExpense Hodnota soukromého   výdaje 64
createExpenseDate Datum vzniku výdaje 2020-02-13T12:12:04+01:00
settlementDate Časové razítko   zaúčtování transakce (pokud bylo již zaúčtováno) 2020-02-13T12:12:04+01:00
paymentType Typ transakce (např.   cash – hotovostní) cash
merchantCategory Kategorie obchodníka Elektronika
identificationNumber IČO obchodníka 123456789
vatId DIČ obchodníka CZ123456789
companyName Název obchodníka Cyklopark
address Adresa obchodníka Sametová 789, Kolín
costCenter Označení cost centra,   na které je výdaj přiřazen DOG
project Označení projektu, ke   kterému je výdaj přiřazen FP4
projectName Název projektu, ke   kterému je výdaj přiřazen DO
vatBreakdown Členění DPH Tuzemské do 10000
dueDate Datum splatnosti 2021-08-05T00:00:00+02:00
receiptPresent Indikace, zda je k   výdaji přiřazená účtenka false
receiptLinks Odkaz na účtenku   (pokud je přiřazena) https://websuctenkou.com/download
items/itemDescription Položka – název Elektrokolo
items/itemAmountOriginalCurrency Položka – hodnota   výdaje v původní měně (pokud je jiná než Kč) 4500
items/itemTaxBase Položka – základ daně 73738
items/itemAmountVat Položka – výše DPH 0,21
items/itemVatRate Položka – sazba DPH 0,21
items/itemExpenseType Položka – druh výdaje simple
items/itemAccountAssignmentCode Položka – kód   předkontace AAA
items/itemAccountCredit Položka – hodnota DAL 35987
items/itemAccountDebit Položka – hodnota MÁ   DÁTI 37751
items/itemAccountVatAssignmentCode Položka – DPH   předkontace Kód
items/itemAccountVatCredit Položka – DPH pro DAL 10
items/itemAccountVatDebit Položka – DPH pro MÁ   DÁTI 21
items/itemCostCenter Položka – nákladové   středisko 50002
items/itemProject Položka – projekt DO
note Poznámka test poznámky
cashRegister Název hotovostní   pokladny cashReg
approval/date Datum schválení 2020-02-13T12:13:36.284
approval/firstName Jméno schvalovatele Karel
approval/lastName Příjmení   schvalovatele Schvalovatel
approval/employeeNumber Zaměstnanecké číslo   schvalovatele (pokud je vyplněno) 1234777
expenseAccountantApproved
date Datum schválení   účetní 020-05-05T17:15:48.19
firstName Jméno účetní Jana
lastName Příjmení účetní Vypočítavá
employeeNumber Zaměstnanecké číslo   účetní (pokud je vyplněno) 1234888
pairingKey Párovací klíč EX-2740

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

Cesťáky – XLSX exporty

Obecný popis

Exportní výstup Cesťáků-zpráv ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Cesťáků (volitelně včetně přiložených účtenek) 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 Cesťácích 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   Exportu Název interní /   XML Popis pole Vzor dat
travel_report_id reportId Identifikátor cesťáku TR-455
report_name reportName Název cesťáku Cesta do Mordoru
user_firstname user/[@firstName] Jméno   cestovatele Sam
user_lastname user/[@lastName] Příjemní cestovatele Křepelka
journey_type journeyType Typ cesťáku foreign
report_state reportState Status cesťáku approve
journey_start_date journeyStartDate Datum začátku cesty 11.03.2021 8:00:00
journey_end_date journeyEndDate Datum konce cesty 21.03.2021 21:31:41
journey_start_point journeyStartPoint Místo začátku cesty Praha, Česko
journey_end_point journeyEndPoint Místo konce cesty Katovice, Polsko
meal_allowance_czk allowance/[@mealAllowanceCzk] Stravování   (orientační výpočet) 880
pocket_money_czk allowance/[@pocketMoneyCzk] Kapesné (orientační   výpočet) 440
car_allowance_czk allowance/[@carAllowanceCzk] Náhrada za soukromé   vozidlo (orientační výpočet) 0
fuel_allowance_czk allowance/[@fuelAllowanceCzk] Náhrada za palivo   (orientační výpočet) 0
allowance_total_czk allowance/[@allowanceTotalCzk] Celkové náhrady   (orientační výpočet) 1320
cost_centers costCenters/costCenter Označení cost centra,   na které je cesťák přiřazen AAA
projects projects/project Označení projektu, na   které je cesťák přiřazen BBB
journey_note journeyNote Poznámka text poznámky
days_count daysCount Počet dní 2
report_created reportCreated Datum vytvoření   cesťáku 10.03.2021 11:10:00
report_author reportAuthor Autor cesťáku Sam Křepelka
report_approved reportApproved Schvalovatel cesťáku Karel Schvalovatel
report_accountant_approved reportAccountantApproved Účetní Jana Vypočítavá
request_id request/requestId Identifikátor žádosti TQ-555
request_state request/requestState Status žádosti approve
export_from_date export/[@fromdate] Výpis cesťáků od data 10.03.2021 0:00:01
export_to_date export/[@todate] Výpis cesťáků do data 22.03.2021 23:59:59
export_created export/[@created] Datum exportu souboru 12.03.2021 13:51:51
deposit_requested depositRequested Požadovaná záloha 123
deposit_currency depositCurrency Měna zálohy CZK
deposit_type depositType Typ zálohy card
employee_number user/[@employeeNumber] Zaměstnanecké číslo   (pokud je vyplněno) 123666
approval_date approval/date Datum posledního   schválení 10.03.2021 13:25:50
approval_first_name approval/firstName Jméno posledního   schvalovatele Karel
approval_last_name approval/lastName Příjmení posledního   schvalovatele Schvalovatel
approval_employee_number approval/employeeNumber Zaměstnanecké číslo   posledního schvalovatele 123666
trip_id id Identifikátor   cesty 043be458-7ce1-457e-85fc-95399b201a04
report_id reportId Identifikátor cesťáku TR-415
journey_type journeyType Typ cesťáku DOMESTIC
journey_start_date startDate Datum začátku jedn.   cesty 11.03.2021 8:00:00
journey_end_date endDate Datum konce jedn.   cesty 17.03.2021 17:10:00
journey_start_point startPoint Místo začátku jedn.   cesty Praha, Česko
journey_end_point endPoint Místo konce jedn.   cesty Ostrava, Česko
meal_allowance_czk mealAllowanceCzk Stravování 400
pocket_money_czk pocketMoneyCzk Kapesné 100
car_allowance_czk carAllowanceCzk Náhrada za soukromé   vozidlo 0
fuel_allowance_czk fuelAllowanceCzk Náhrada za palivo 0
allowance_total_czk allowanceTotalCzk Celkové náhrady 500

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

Hotovostní transakce – XLSX exporty

Obecný popis

Exportní výstup Hotovostních transakcí ve formátu XLSX (Microsoft Excel) 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. Univerzální formát XLSX dovoluje jak pohodlnou uživatelskou práci, tak automatizované/robotické zpracování vyexportovaných dat.

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í.

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 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   Exportu Název interní /   XML Popis pole Vzor dat
transaction_id transactionId Identifikátor   transakce 908a7b22-979d-4489-8305-55d61ab5cd6e
expense_id expenseId Identifikátor   připojeného výdaje k transakci 0b968372-58c3-4f64-8b0b-18a4e4a1ba4c
short_expense_id shortExpenseId Zkrácený   identifikátor (unikátní v rámci firmy) EX-1041
user_name user Jméno a příjmení   uživatele zodpovědného za transakci Jan Vozihnoj
wallet_name walletName Název peněženky   obsahující příslušnou transakci Jan Vozihnoj CZK
create_transaction_date createTransactionDate Datum transakce 14.08.2020 13:22:58
amount_original_currency amountOriginalCurrency Částka provedené   transakce 380
currency currency Měna, ve které byla   transakce provedena CZK
amount_private amountPrivate Výše částky z   transakce, která je vedena jako soukromá 20
transaction_type transactionType Může obsahovat   expense (výdaj) nebo balance adjustment (vyrovnání) expense
company_name companyName Pokud je vyplněno,   obsahuje text z pole název obchodníka na kartě spárovaného výdaje Baťa
address 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 category Pokud je vyplněno,   obsahuje parametr z pole kategorie obchodníka na kartě spárovaného   výdaje ostatní
employee_number userDetail/@employeeNumber Zaměstnanecké číslo   (pokud je vyplněno) 123666

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

Transakce na Fidoo účtu – XLSX exporty

Obecný popis

Exportní výstup Transakcí na Fidoo účtu ve formátu XLSX (Microsoft Excel) 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 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 transakcích na Fidoo účtu 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   Exportu Název interní /   XML Popis pole Vzor dat
transaction_id transactionId Identifikátor   transakce v systému Fidoo cd8e4589-b79b-4786-b5e6-989a7d636a46
transaction_create_date transactionCreateDate Datum   vzniku transakce v systému 14.08.2020 15:29:41
transaction_type transactionType Typ   transakce card-load
transaction_original_amount transactionOriginalAmount Částka   transakce 99
transaction_settled_amount transactionSettledAmount Zúčtovaná   transakce v Kč -99
transaction_original_currency transactionOriginalCurrency Měna   původní transakce CZK
transaction_settlement_date transactionSettlementDate Časové   razítko zaúčtování transakce (pokud bylo již zaúčtováno) 14.09.2020 15:29:41
card_id cardId Identifikátor   karty v systému Fidoo (při transakci spojené s kartou) 78bff6b5-d92b-4c45-880b-f09dcab43de8
card_masked_number cardMaskedNumber Maskovaný   PAN karty (platí jen pro platby kartou) 549546******3197
card_name cardName Název   karty PETR JEDNATEL
transaction_initiated_user_email transactionInitiatedUserEmail E-mail   uživatele, který transakci vyvolal fidoo@fidoo.com
transaction_initiated_user_name transactionInitiatedUserName Jméno   a příjmení uživatele, který transakci vyvolal Petr Jednatel
transaction_note transactionNote Poznámka   k transakci text poznámky
employee_number user/@employeeNumber Zaměstnanecké   číslo uživatele, který transakci vyvolal (pokud je vyplněno) 123666
card_holder_employee_number cardHolder/@employeeNumber Zaměstnanecké   číslo uživatele, který je držitelem karty (pokud je vyplněno) 114477

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

Karetní transakce – XLSX exporty

Obecný popis

Exportní výstup Karetních transakcí ve formátu XLSX (Microsoft Excel) 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 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 karetních transakcí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   Exportu Název interní /   XML Popis pole Vzor dat
transaction_id shortTransactionId Identifikátor   transakce v systému Fidoo 3691622
card_id cardId Identifikátor karty   v systému Fidoo d1d42791-3d15-4597-9907-49ddf863548b
card_name cardName Název konkrétní karty PETR JEDNATEL
card_number 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******0722
create_transaction_date createTransactionDate Časové razítko vzniku   transakce 23.03.2021 12:14:17
settlement_date settlementDate Časové razítko   zaúčtování transakce (pokud bylo již zaúčtováno) 23.03.2021 12:14:17
amount_original_currency amountOriginalCurrency Částka platební   operace 199
currency currency Měna, ve které bylo   placeno CZK
transaction_settled_amount_czk transactionSettledAmountCzk Částka která byla   zaúčtovaná (pokud již bylo zaúčtováno) – tato hodnota má opačné znaménko než   pole částka transakce -199
fee fee Obsahuje údaj o výši   poplatku v Kč 0
transaction_state transactionState Dle aktuální stavu   transakce – nejčastěji zaúčtovaná Zúčtovaná
transaction_type transactionType Obsahuje informaci o   povaze platby – např. platba u obchodníka, výběr hotovosti atp. Platba u obchodníka
company_name 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 address Pokud je vyplněno,   obsahuje text z pole adresa obchodníka na kartě spárovaného výdaje PRAHA 1
country country Identifikátor země,   na jejímž území k transakci došlo. cze
category category Pokud je vyplněno,   obsahuje parametr z pole kategorie obchodníka na kartě spárovaného   výdaje Travel
expense_id expenseId Identifikátor   připojeného výdaje v systému Fidoo 380d5afc-86cd-4e54-b709-ff70be188c5d
short_expense_id shortExpenseId Zkrácený   identifikátor výdaje propojeného s transakcí (unikátní v rámci vaší   firmy) EX-2569
employee_number user/@employeeNumber Zaměstnanecké číslo   (pokud je vyplněno) 1234666
firstName user/@firstName Jméno uživatele Petr
lastName user/@lastName Příjmení uživatele Jednatel
company_name_description companyNameDescription Popis obchodníka,   místo, země WWW.CD.CZ/ESHOP/, PRAHA 1, cze

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