Search
Close this search box.

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 exportuPopis poleVzor dat
first_nameJméno uživatelePetr
last_namePříjmení uživateleJednatel
emailEmailová adresa uživatelepetr.jednatel@test.cz
employee_numberZaměstnanecké číslo uživatele, pokud je vyplněno v profilu uživatele123222
positionPozice uživatele ve své společnostiÚčetní
phoneTelefon uživatele (který slouží pro ověření)4,20608E+11
uses_applicationIdentifikátor, zda uživatel používá aplikaciyes
is_activeIndikace aktivního uživatelePRAVDA
languageJazyk aplikace uživatelecs

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

Název v exportuPopis poleVzor dat
user_idUnikátní identifikátor uživatele v systému Fidoo30dcca40-9858-4139-9230-bb86d97cf64e
user_firstnameJméno uživateleJan
user_lastnamePříjmení uživateleNovak
employee_numberZaměstnanecké číslo uživateleAX12545
personal_billing_short_idZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
personal_billing_nameNázev osobního vyúčtováníOd 1. 4. 2022
date_fromPočáteční datum vystaveného osobního vyúčtování01.04.2022
date_toZávěrečný datum vystaveného osobního vyúčtování06.01.2023
travel_report_days_countPočet dní2
expense_sum_czkSoučet všech výdajů více měn k vyúčtování v CZK500
private_expense_sum_czkSoučet všech soukromých výdajů více měn k vyúčtování v CZK50
travel_allowance_sum_czkSoučet všech cestovních náhrad více měn k vyúčtování v CZK100
cash_settlement_sum_czkSoučet všech vyrovnání hotovosti více měn k vyúčtování v CZK50
give_money_sum_czkCelkové částka více měn k vyplacení uživateli v CZK200
take_money_sum_czkCelkové částka více měn ke stržení uživateli v CZK300
closing_dateDatum uzavření vyúčtování46574
closed_by_user_idUnikátní identifikátor uživatele v systému Fidoo, který uzavřel vyúčtování.30dcca40-9858-4139-9230-bb86d97cf64e
closed_by_user_firstnameJméno uživatele, který uzavřel vyúčtování.Jan
closed_by_user_lastnamePříjmení uživatele, který uzavřel vyúčtování.Novak
personal_billing_short_idZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
currencyMěna transakceEUR
private_expense_sumSoučet všech soukromých výdajů více měn k vyúčtování v CZK50
travel_allowance_sumSoučet všech cestovních náhrad více měn k vyúčtování v CZK100
exchange_rate_cashMěnový kurz23.4244
cash_settlement_sumSoučet všech vyrovnání hotovosti k vyúčtování podle měn10
give_money_sumCelkové částka k vyplacení uživateli podle měn50
take_money_sumCelkové částka ke stržení uživateli podle měn20
personal_billing_short_idZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
currencyMěna transakceEUR
begin_period_cashStav na začátku období0
cash_revenueSouhrn příjmů do peněženky0
cash_issueSouhrn vydání z peněženky-10
cash_settlementSouhrn vyrovnání peněženky20
end_period_cashStav na konci období10
personal_billing_short_idZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
travel_report_idUnikátní identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo331a0bd0-0f95-11ea-8d71-362b9e155667
currencyMěna transakceEUR
meal_allowanceNáhrady za stravné v CZK1000
pocket_moneyPeníze na cestu v CZK2500
fuel_compensationNáhrada za palivo v CZK4000

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

Výdaje – XLSX exporty

Obecný popis

Exportní výstup Výdajů ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Výdajů (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 výdají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 exportuPopis poleVzor dat
expense_idIdentifikátor výdaje v systému Fidoo17d15115-4d25-448f-83a3-98be72d95923
short_expense_idZkrácený unikátní identifikátor výdaje v rámci firmyEX-1041
expense_nameNázev výdajeNákup bot
user_firstnameJméno uživatele Petr
user_lastnamePříjmení uživateleJednatel
employee_numberZaměstnanecké číslo (pokud je vyplněno)1234666
transaction_idIdentifikátor spojené karetní transakce (platí jen pro platby kartou)3691622
card_numberMaskovaný 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
travel_report_idV případě přiřazení výdaje k cesťáku obsahuje unikátní identifikátor daného cesťákuTQ-4
document_idČíslo dokladu55446677
amount_czkHodnota výdaje v Kč2300
amount_original_currencyHodnota výdaje v původní měně (pokud je jiná než Kč)85
currencyPůvodní měna transakce (pokud je jiná než Kč)EUR
tax_baseZáklad pro DPH1817
amount_vatVýše DPH483
vat_rateSazba DPH0,21
accounting_category_codeÚčetní kategorie – KódACCO1
accounting_category_nameÚčetní kategorie – NázevAccommodation
account_assignment_codeKód předkontaceAAA
account_debitHodnota MÁ DÁTI518000
account_creditHodnota DAL321000
account_vat_assignment_codeKód DPH dané předkontaceKod
account_vat_debitHodnota DPH pro MÁ DÁTI21
account_vat_creditHodnota DPH pro DAL10
company_expenseHodnota firemního výdaje (hodnota je v originální měně výdaje)2300
private_expenseHodnota soukromého výdaje (hodnota je v originální měně výdaje)0
create_expense_dateDatum vzniku výdaje17.08.2020 10:41:00
taxable_dateDatum zdanitelného plnění17.08.2020 10:41:00
payment_typeTyp transakce (např. cash – hotovostní)cash
identification_numberIČO obchodníka12345678
vat_idDIČCZ12345678
company_nameNázev obchodníkaBaťa
addressAdresa obchodníkaBaťova ulice, Zlín
cost_centerKód nákladového střediska50001
projectKód projektuDO
vat_breakdownČlenění DPHTuzemské do 10000
supplier_bank_accountBankovní účet dodavatele0
vsVariabilní symbol0
csKonstantní symbol0
ssSpecifický symbol0
due_dateDatum splatnosti2021-08-05T00:00:00+02:00
receiptPokud je k výdaji připojena účtenka, nabývá hodnoty ANONe
notePoznámkatext v poznámce
merchant_categoryKategorie obchodníkaOblečení
approval_dateDatum schválení17.08.2020 15:19:56
approval_first_nameJméno schvalovateleKarel
approval_last_namePříjmení schvalovateleSchvalovatel
approval_employee_numberZaměstnanecké číslo schvalovatele (pokud je vyplněno)1234777
accountant_approval_dateDatum schválení účetní17.08.2020 15:48:09
accountant_approval_first_nameJméno účetníJana
accountant_approval_last_namePříjmení účetníVypočítavá
accountant_approval_employee_numberZaměstnanecké číslo účetní (pokud je vyplněno)1234888
pairing_keyPárovací klíč. V případě, že jde o externí transakci tak se do tohoto pole propíše externí ID (např. KB externí ID)EX-1041/244-16102023 10864035543207
stateStatus výdajeprepared
externalAccountNameNázev externího účtu (Komerční banka)Můj OS účet
externalAccountIbanIBAN externího účtu (Komerční banka)CZ6501000001151655590237
item_descriptionPoložka – názevBoty
item_amount_czkPoložka – hodnota výdaje v Kč2100
item_tax_base_czkPoložka – základ daně v Kč1617
item_amount_vat_czkPoložka – hodnota DPH v Kč0
item_amount_original_currencyPoložka – hodnota výdaje v původní měně (pokud je jiná než Kč)85
item_tax_basePoložka – základ daně85
item_amount_vatPoložka – výše DPH1617
item_vat_ratePoložka – sazba DPH0,21
item_expense_typePoložka – druh výdaje (firemní vs soukromí)corporate
item_accounting_category_codePoložka – účetní kategorie – KódACCO1
item_accounting_category_namePoložka – účetní kategorie – NázevAccommodation
item_account_assignment_codePoložka – kód předkontaceAAA
item_account_debitPoložka – hodnota MÁ DÁTI518000
item_account_creditPoložka – hodnota DAL321000
item_account_vat_assignment_codePoložka – DPH předkontaceKod
item_account_vat_debitPoložka – DPH pro MÁ DÁTI21
item_account_vat_creditPoložka – DPH pro DAL10
item_cost_centerPoložka – nákladové středisko50002
item_projectPoložka – projektDO
item_vat_breakdownPoložka – členění DPHTuzemské do 10000
differencesoučet částky všech výdajů uživatele, které nemají vyplněný kód předkontace20000
totalsoučet částky všech výdajů uživatele25000

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 exportuPopis poleVzor dat
transaction_idIdentifikátor transakce v systému Fidooa58ef2f7-0587-4353-bc42-25f1f6a1363f
card_idIdentifikátor karty v systému Fidoodfbcd0f2-f0f4-48f7-8214-25448eb58e4f
card_nameNázev konkrétní kartyPETR JEDNATEL
card_numberMaskovaný 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
card_typeDle typu karty nabývá hodnot Osobní nebo Týmováshared
card_aliasVolitelný název karty pro snadné hledání v systémuAdamsova karta
short_expense_idZkrácené unikátní ID výdaje propojeného s transakcí (unikátní v rámci vaší firmy)EX-4568
create_transaction_dateČasové razítko vzniku transakce2021-07-16T11:09:19Z
settlement_dateČasové razítko zaúčtování transakce (pokud bylo již zaúčtováno)2021-07-16T11:09:19Z
amount_original_currencyČástka platební operace150
currencyMěna, ve které bylo placenoCZK
transaction_settled_amount_czkČástka která byla zaúčtovaná (pokud již bylo zaúčtováno) – tato hodnota má opačné znaménko než pole částka transakce-150.00
feeObsahuje údaj o výši poplatku v Kč0.00
transaction_stateDle aktuální stavu transakce – nejčastěji zaúčtovanáapproved
transaction_typeObsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp.Platba u obchodníka
company_namePokud je vyplněno, obsahuje text z pole název obchodníka na kartě spárovaného výdajeČD – České dráhy
addressPokud je vyplněno, obsahuje text z pole adresa obchodníka na kartě spárovaného výdajePRAHA 1
countryIdentifikátor země, na jejímž území k transakci došlo.cze
categoryPokud je vyplněno, obsahuje parametr z pole kategorie obchodníka na kartě spárovaného výdajeTravel
expense_idIdentifikátor připojeného výdaje v systému Fidooe341ae40-e6b9-4270-90da-4591759b25fc
firstNameJméno uživatele Petr
lastNamePříjmení uživateleJednatel
employee_numberZaměstnanecké číslo uživatele (pokud je vyplněno)1234666
company_name_descriptionPopis obchodníka, místo, zeměWWW.CD.CZ/ESHOP/, PRAHA 1, cze
notePoznámkatest poznámky

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 exportuPopis poleVzor dat
transaction_idSystémový identifikátor transakce1ab353df-7c00-47cc-a992-37e3865ec916
transaction_create_dateČasové razítko vytvoření transakce2021-01-13T13:01:00
transaction_typeTyp transakcecard-load
transaction_original_amountPůvodní částka20000.00000
transaction_settled_amountPůvodní měnaCZK
transaction_original_currencyÚčtovaná částka-20000.00
transaction_settlement_dateDatum zaúčtování2021-01-13T13:01:00
card_idSystémové ID platební karty (pouze u transakcí souvisejících s kartami)01131d1f-a118-af09-7516-826a04f5e2d4
card_masked_numberMaskované číslo platební karty549546******2919
card_nameEmbosované jméno na kartěPetr Jednatel
transaction_initiated_user_emailEmail uživatele, který transakci iniciovalkarel.schvalovatel@domena.cz
transaction_initiated_user_nameJméno uživatele, který transakci iniciovalKarel Schvalovatel
transaction_notePoznámka k transakcitext poznámky
user_first_nameJméno držitele kartyPetr
user_last_namePříjmení držitele kartyJednatel
employee_numberZaměstnanecké číslo uživatele, který transakci vyvolal (pokud je vyplněno)123666
card_holder_first_namePozice uživatele ve své společnostiObchodník
card_holder_last_nameIdentifikátordržitele karty v systému Fidooc7583cdb-5f3b-4198-b48f-588afab3530b
card_holder_employee_numberZaměstnanecké číslo uživatele, který je držitelem karty (pokud je vyplněno)114477

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 exportuPopis poleVzor dat
transaction_idIdentifikátor transakce v systému Fidoo5c30dbd2-3756-49d1-88cb-7d12c5933218
short_expense_idZkrácený identifikátor výdaje propojeného s transakcí (unikátní v rámci vaší firmy)EX-2764
user_nameCelé jméno uživatelePetr Jednatel
employee_numberZaměstnanecké číslo (pokud je vyplněno)1234666
wallet_nameNázev hotovostní peněženkyPetr Jednatel CZK
create_transaction_dateČasové razítko vzniku transakce2021-06-17T00:00:00
amount_original_currencyČástka platební operace-487
currencyMěna, ve které bylo placenoCZK
transaction_typeObsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp.expense
company_namePokud je vyplněno, obsahuje text z pole název obchodníka na kartě spárovaného výdajeBaťa
addressPokud je vyplněno, obsahuje text z pole adresa obchodníka na kartě spárovaného výdajeBaťova ulice, Zlín
categoryPokud je vyplněno, obsahuje parametr z pole kategorie obchodníka na kartě spárovaného výdajeother
expense_idUnikátní identifikátor připojeného výdaje v systému Fidoo4a400c70-1ee5-491a-b3db-9828fb36d8e5
amount_privateCelková výše soukromých hotovostních výdajů47

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 exportuPopis poleVzor dat
travel_report_idIdentifikátor cesťákuTR-455
report_nameNázev cesťákuCesta do Mordoru
user_firstnameJméno uživatele Sam
user_lastnamePříjmení uživateleKřepelka
journey_typeTyp cestyforeign
report_stateStatus cesťákuapprove
journey_start_dateDatum začátku cesty2021-11-22T08:00:00+01:00
journey_end_dateDatum konce cesty2021-11-26T09:00:00+01:00
journey_start_pointMísto začátku cestyPraha, Česko
journey_end_pointMísto konce cestyKatovice, Polsko
meal_allowance_czkStravování (orientační výpočet)880
pocket_money_czkKapesné (orientační výpočet)440
car_allowance_czkNáhrada za soukromé vozidlo (orientační výpočet)0
fuel_allowance_czkNáhrada za palivo (orientační výpočet)0
allowance_total_czkCelkové náhrady (orientační výpočet)1320
cost_centersOznačení cost centra na které je cesťák přiřazenAAA
projectsOznačení projektu na které je cesťák přiřazenBBB
journey_notePoznámkatext poznámky
report_createdDatum vytvoření cesťáku2021-11-22T13:25:11+01:00
report_authorAutor cesťákuSam Křepelka
report_approvedSchvalovatel cesťákuKarel Schvalovatel
approval_dateDatum posledního schválení2021-12-22T09:25:11+01:00
approval_first_nameJméno posledního schvalovateleKarel
approval_last_namePříjmení posledního schvalovateleSchvalovatel
approval_employee_numberZaměstnanecké číslo posledního schvalovatele123666
report_accountant_approvedDatum schválení účetní2022-05-05T14:52:00.926986
approval_dateDatum posledního schválení2021-12-22T09:25:11+01:00
approval_first_nameJméno posledního schvalovateleKarel
approval_last_namePříjmení posledního schvalovateleSchvalovatel
approval_employee_numberZaměstnanecké číslo posledního schvalovatele123666
request_idIdentifikátor žádostiTQ-555
request_stateStatus žádostiapprove
export_from_dateVýpis cesťáků od data2021-11-01T00:00:00+01:00
export_to_dateVýpis cesťáků do data2021-11-30T23:59:59.999+01:00
export_createdDatum exportu souboru2021-11-29T09:47:14.202+01:00
trip_idIdentifikátor cesty9afba974-5a49-428b-a29c-afd8e760f1b4
journey_start_dateDatum začátku cesty2021-11-22T08:00:00+01:00
journey_end_dateDatum konce cesty2021-11-26T09:00:00+01:00
journey_start_pointMísto začátku cestyPraha, Česko
journey_end_pointMísto konce cestyKatovice, Polsko
journey_typeTyp cestyforeign
meal_allowance_czkStravování (orientační výpočet)880
pocket_money_czkKapesné (orientační výpočet)440
car_allowance_czkNáhrada za soukromé vozidlo (orientační výpočet)0
fuel_allowance_czkNáhrada za palivo (orientační výpočet)0
allowance_total_czkCelkové náhrady (orientační výpočet)1320
deposit_requestedVýše žádosti peněz na cestu0
deposit_typeTyp zálohycard
deposit_currencyMěna žádaných peněz na cestuCZK
days_countPočet dní ze zprávy o služební cestě (cesťáku) 2
transport_typeTyp prostředkucompanyVehicle
departureČas odjezdu2023-11-28T08:00:00+01:00
countryZemě lokaceCZ
locationNázev lokace části cesty, může to být začátek, konec nebo cíl cestyPraha,Česko
arrivalČas příjezdu2023-11-28T08:00:00+01:00
distancePočet ujetých km v rámci konkrétní části cesty200
vehicle_brandZnačka (výrobce) vozidlaŠkoda
vehicle_modelModelové označení vozidlaOctavia
vehicle_registration_numberRegistrační značka vozidla7AA7000
vehicle_vinVIN vozidlaTMBGDM9AKP042788
vehicle_typeTyp vozidlacar
vehicle_stateStav vozidla ve aplikaci Fidooactive
vehicle_ownershipVlastnictví vozidla, zda je soukromé nebo firemnícompany
vehicle_usageIndikace, zda je vozidlo sdílené (pool), nebo jej může využívat pouze jeden uživatel (individual)individual
vehicle_engine_volumeObjem motoru [cm3]2500
vehicle_fuel_consumptionSpotřeba (kombinovaná)5
vehicle_fuel_typeTyp paliva vozidlanatural-95

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

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 exportuPopis poleVzor dat
card_idUnikátní identifikátor každé karty v systému Fidoo04410424-5c86-4bb4-a026-a0c3f7dd7db7
card_numberMaskovaný 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_toDatum expirace karty30.11.2024
card_nameZadaný název karty v systému FidooKARTA JARDA
card_stateAktuální stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp.first-ordered
card_typeDle typu karty nabývá hodnot Osobní nebo Týmováshared
card_profileID spojené karetní transakce (platí jen pro platby kartoubusiness
card_users_idUnikátní identifikátory současných uživatelů spojených s kartou – v případě vícero uživatelů jsou odděleny středníkemf136de1b-d6dc-4a6e-8a8a-91713d2e9f93
card_holder_name_surnameJméno a příjmení uživatele kartySam Adams
account_balanceSoučasný účetní zůstatek karty16
available_balanceSoučasný disponibilní zůstatek karty16
blocked_balanceBlokace na kartě0
card_approver_idUnikátní identifikátor schvalovatele karty4099648b-e6b8-4b4b-aa44-3591fe2ec382
card_approver_name_surnameJméno a příjmení schvalovatele kartyJana Bobošíková
load_typeTyp dobíjenímanual
load_frequencyFrekvence dobíjeníweekly
load_on_amountDobíjení na konkrétní částku6
when_the_available_balance_drops_belowLimit, jehož dosažení spouští dobití karty2
maximum_limitMaximální limit čerpání na kartě100
restrictions_of_card_usageOmezení placení kartouatm: true, merchants: true, e-payments: true
delivery_address_streetDodací adresa uliceVáclavská
delivery_address_building_numberDodací adresa číslo domu180
delivery_address_cityDodací adresa městoChrudim
delivery_address_postcodeDodací adresa poštovní směrovací číslo53701
delivery_address_countryDodací adresa zeměcze
order_dateDatum objednání03.12.2021 14:34:06
order_stateStav objednání kartyordered
aliasVolitelný název karty pro snadné hledání v systémuAdamsova karta

 

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

Kniha jízd – XLSX exporty

Struktura a popis dat

Výpis vozidel

Název v exportuPopis poleVzor dat
fleet_manager_approvedIdentifikace, zda je jízda potvrzená Fleet manageremno
vehicle_registration_numberRegistrační značka vozidla7AA7000
vehicle_brandZnačka (výrobce) vozidlaŠkoda
vehicle_modelModelové označení vozidlaOctavia
vehicle_fuel_typeTyp paliva vozidlanatural-95
vehicle_fuel_consumptionSpotřeba (kombinovaná)5
vehicle_low_emissionIndikace nízkoemisního vozidlano
vehicle_pricePořizovací cena vozidla1200000
start_odometerStav tachometru před jízdou [km]600
end_odometerStav tachometru po jízdě [km]900
distance_totalDélka jízd celkem [km]300
distance_companyDélka služebních jízd [km]200
distance_company_percentagePodíl služebních jízd na jízdách celkem [*100=%]0,6667
distance_privateDélka soukromých jízd [km]100
distance_private_percentagePodíl soukromých jízd na jízdách celkem [*100=%]0,3333
fuelings_priceČástka za tankování v daném měsíci [CZK]. Součet částek za tankování v daném měsíci800
fuelings_amountObjem natankovaných pohonných hmot v daném měsíci [litr]. Součet natankovaných litrů z účtenek za tankování v daném měsíci20
fuelings_cost_per_literNáklady dle reality na litr pohonné hmoty [CZK]40.00
costs_real_companyNáklady dle reality na kilometr služební cesty [CZK]8190
costs_real_privateNáklady dle reality na kilometr soukromé cesty [CZK]455
fuelings_allowance_per_literNáklady dle vyhlášky na litr pohonné hmoty [CZK]45,8
costs_allowance_companyNáklady dle vyhlášky na kilometr služební cesty [CZK]5770,8
costs_allowance_privateNáklady dle vyhlášky na kilometr soukromé cesty [CZK]320,6
first_nameJméno zaměstnancePetr
last_namePříjmení zaměstnanceJednatel
emailE-mail zaměstnancepetr.jednatel@domena.cz
employee_numberZaměstnanecké číslo zaměstnance (pokud je vyplněno)1234666
amount_to_taxOdpis vozidla (nenízkoemisní 1 % z pořizovací ceny, nízkoemisní 0,5 % z pořizovací ceny)600
distanceDélka jízd celkem [km]700
distance_companyDélka služebních jízd [km]400
distance_privateDélka soukromých jízd [km]300
costs_real_privateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle reálných nákladů7195,5
cost_allowance_privateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle vyhlášky4944
start_locationStartovací lokace jízdyPraha
end_locationCílová lokace jízdyBrno
distanceDélka jízdy celkem [km]150
start_date_timeČasová značka začátku jízdy01.09.2023 9:00
end_date_timeČasová značka konce jízdy01.09.2023 19:00
journey_timeČas jízdy [hh:mm]4:00
purposeÚčel jízdyŠkolení
refuelingTankování během jízdy, spojeno v jednom řádku. Jednotlivá tankování oddělená pomocí pipe “|”0
breakPřestávky během jízdy, spojeno v jednom řádku. Jednotlivé přestávky oddělené pomocí pipe “|”0

Výpis uživatelů

Název v Exportu

Popis pole

Vzor dat

first_nameJméno zaměstnancePetr
last_namePříjmení zaměstnanceJednatel
emailE-mail zaměstnancepetr.jednatel@domena.cz
employee_numberZaměstnanecké číslo zaměstnance (pokud je vyplněno)1234666
amount_to_taxOdpis vozidla (nenízkoemisní 1 % z pořizovací ceny, nízkoemisní 0,5 % z pořizovací ceny)600
distanceDélka jízd celkem [km]700
distance_companyDélka služebních jízd [km]400
distance_privateDélka soukromých jízd [km]300
costs_real_privateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle reálných nákladů7195,5
cost_allowance_privateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle vyhlášky4944

Kniha jízd – XML exporty

Struktura a popis dat

Název interní / XML

Popis pole

Vzor dat

vehiclesPřehled po vozidlech
fleetManagerApprovedIdentifikace, zda je jízda potvrzená Fleet manageremno
vehicleInformace o konkrétním vozu
registrationNumberRegistrační značka vozidla7AA7000
brandZnačka (výrobce) vozidlaŠkoda
modelModelové označení vozidlaOctavia
fuelTypeTyp paliva vozidlanatural-95
fuelConsumptionSpotřeba (kombinovaná)5
lowEmissionIndikace nízkoemisního vozidlano
vehiclePricePořizovací cena vozidla1200000
startOdometerStav tachometru před jízdou [km]600
endOdometerStav tachometru po jízdě [km]900
distanceSum
totalDistanceDélka jízd celkem [km]300
companyDistanceDélka služebních jízd [km]200
privateDistanceDélka soukromých jízd [km]100
fuelingsSumInformace o tankování
priceČástka za tankování v daném měsíci [CZK]800
amountObjem natankovaných pohonných hmot v daném měsíci [litr]20
currencyMěnaCZK
costsPerLiterNáklady dle reality na litr pohonné hmoty [CZK]40.00
allowancePerLiterNáklady dle vyhlášky na litr pohonné hmoty [CZK]45.80
calculationsPodrobnější kalkulace
costsRealCompanyNáklady dle reality na kilometr služební cesty [CZK]8190
costsRealPrivateNáklady dle reality na kilometr soukromé cesty [CZK]455
costsAllowanceCompanyNáklady dle vyhlášky na kilometr služební cesty [CZK]5770,8
costsAllowancePrivateNáklady dle vyhlášky na kilometr soukromé cesty [CZK]320,6
usersPřehled po zaměstnancích
userInformace o konkrétním zaměstnanci
firstNameJméno zaměstnancePetr
lastNamePříjmení zaměstnanceJednatel
emailE-mail zaměstnancepetr.jednatel@domena.cz
employeeNumberZaměstnanecké číslo zaměstnance (pokud je vyplněno)1234666
amountToTaxOdpis vozidla (nenízkoemisní 1 % z pořizovací ceny, nízkoemisní 0,5 % z pořizovací ceny)600
distanceSumInformace o délce jízd
totalDistanceDélka jízd celkem [km]300
companyDistanceDélka služebních jízd [km]200
privateDistanceDélka soukromých jízd [km]100
calculationsPodrobnější kalkulace
costsRealPrivateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle reálných nákladů7195,5
costsAllowancePrivateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle vyhlášky4944

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