Search
Close this search box.

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

Příprava a nastavení na straně Fidoo

Ve Fidoo aplikaci je potřeba provést následující nastavení.

  1. Přesvědčte se, že máte Generický formát XLSX zapnutý a aktivní. Případně jej zapněte  
    (NastaveníIntegraceXLSX)

Export z Fidoo

Exportovat hotovostní transakce lze nad seznamem hotovostních transakcí (Firemní finance – Hotovost – Transakce). Zde lze vyexportovat libovolnou skupinu hotovostních transakcí dle preferencí nastavených ve filtru.

Export z Fidoo nad seznamem hotovostních transakcí 

  1. Ve Fidoo aplikaci jděte nad jakýkoliv seznam transakcí na kartě
    (Firemní/Týmové/Moje FinanceHotovostTransakce)

     

  2. Vyfiltrujte si období nebo jiné omezující podmínky pro váš export                                                     (Firemní Finance / Týmové finance / Moje finance – Hotovost Transakce)


     

  3. Nad vyfiltrovaným seznamem Hotovostních transakcí  zvolte volbu Export 
    (Firemní Finance / Týmové Finance / Moje FinanceHotovost Transakce).

     

  4. Vyberte Generický formát XLSX a výběr potvrďte zeleným tlačítkem Exportovat
    (Firemní Finance / Týmové Finance / Moje FinanceHotovost Transakce).

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

Příprava a nastavení na straně Fidoo

Ve Fidoo aplikaci je potřeba provést následující nastavení.

  1. Přesvědčte se, že máte Generický formát XLSX zapnutý a aktivní. Případně jej zapněte  
    (NastaveníIntegraceXLSX)


  2. (Volitelně) Vytvořte si seznam Nákladových středisek.
    (Nastavení  Výdaje  Nákladová střediska)


  3. (Volitelně) Vytvořte si seznam Projektů.
    (Nastavení  Projekty).

Export z Fidoo

Exportovat výdaje lze ve Fidoo na dvou místech: 
1. Nad jakýmkoliv seznamem výdajů (např. Firemní finance – Cesťáky – Zprávy).
2. V účetní agendě v části “Export cesťáků”. 

Rozdíl je v tom, že v účetní agendě se při exportu aplikují kontroly zamezující vyexportovat Zprávy duplicitně, zatímco nad běžným seznamem Zpráv kdekoliv v aplikaci se žádné kontroly neaplikují a lze tak vyexportovat libovolnou skupinu Zpráv dle preferencí nastavených ve filtru. 

Export z Fidoo nad seznamem Zpráv

  1. Ve Fidoo aplikaci jděte nad jakýkoliv seznam Zpráv.
    (Firemní Finance / Týmové Finance / Moje FinanceCesťákyZprávy).
  2. Vyfiltrujte si období nebo jiné omezující podmínky pro váš export. 
    (Firemní Finance / Týmové Finance / Moje FinanceCesťákyZprávy)



  3. Nad vyfiltrovaným seznamem Zpráv zvolte volbu “Export”.
    (Firemní Finance / Týmové Finance / Moje FinanceCesťákyZprávy).


  4. Vyberte Generický formát XLSX a potvrďte zeleným tlačítkem „Exportovat“.
    (Firemní Finance / Týmové Finance / Moje FinanceCesťákyZprávy).

     

Export z Fidoo z Účetní agendy

Fidoo zde hlídá všechny provedené exporty v rámci účetní agendy a snaží se předejít duplicitám při exportu. K exportu jsou zde nabízeny pouze  Zprávy, které ještě dříve nebyly exportovány a zároveň už jsou z hlediska schvalovacího procesu ve stavu „Vyúčtovaná“ (tj. jsou součástí uzavřeného osobního vyúčtování).

  1. Ve Fidoo aplikaci jděte do části Účetní agenda a zde zvolte Export cesťáků. 


  2. Zvolte Nový exportPomocí filtru si můžete omezit seznam Zpráv, které budete exportovat. 
    Výchozí hodnoty filtru jsou zde nastaveny tak, aby výběr obsahoval všechny Zprávy, které už jsou připraveny k exportu a ještě před tím nebyly exportovány (doporučujeme neměnit). 
    Zkontrolujte počet Zpráv, které se chystáte vyexportovat a exportní proces započněte zeleným tlačítkem Exportovat. 


  3. Zvolte si název exportního souboru. Budete se moci k němu později opakovaně ve Fidoo vracet.  


  4. Ve vytvořeném exportu zvolte černé tlačítko Stáhnout data. 


  5. Stáhne se vám zazipovaný balík obsahující exportní soubory Zpráv ve všech dostupných / aktivních exportních formátech, které máte k dispozici.

     

             Export cesťáků je hotov.

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

Příprava a nastavení na straně Fidoo

Ve Fidoo aplikaci je potřeba provést následující nastavení.

  1. Přesvědčte se, že máte Generický formát XLS (old) zapnutý a aktivní. Případně jej zapněte  
    (NastaveníIntegraceXLS (old))



Export z Fidoo

Exportovat transakce lze ve Fidoo na dvou místech. 
1. Nad jakýmkoliv seznamem karetních transakcí (např. Firemní FinanceKartyTransakce).
2. V účetní agendě v části Export karetních transakcí.

Rozdíl je v tom, že v účetní agendě se při exportu aplikují kontroly zamezující vyexportovat transakce duplicitně. Nad běžným seznamem transakcí kdekoliv v aplikaci se žádné kontroly neaplikují a lze tak vyexportovat libovolnou skupinu transakcí dle preferencí nastavených ve filtru. 

Export z Fidoo nad seznamem karetních transakcí 

  1. Ve Fidoo aplikaci jděte nad jakýkoliv seznam karetních transakcí
    (Firemní Finance / Týmové / Moje FinanceKartyTransakce)

     

  2. Vyfiltrujte si období nebo jiné omezující podmínky pro váš export                                                     (Firemní Finance / Týmové finance / Moje finance – KartyTransakce)





  3. Nad vyfiltrovaným seznamem Karetních transakcí  zvolte volbu Export 
    (Firemní Finance / Týmové Finance / Moje FinanceKartyTransakce).

     

  4. Vyberte Generický formát XLS (old) a výběr potvrďte zeleným tlačítkem Exportovat
    (Firemní Finance / Týmové Finance / Moje FinanceKartyTransakce).

Export z Fidoo z Účetní agendy

Fidoo zde hlídá všechny provedené exporty v rámci účetní agendy a snaží se předejít duplicitám při exportu. K exportu jsou zde nabízeny pouze transakce zúčtované bankou, které dosud nebyly exportovány.

  1. Ve Fidoo aplikaci jděte do části Účetní agenda a zde zvolte Export karetních transakcí.
  2. Zkontrolujte si období, za které budete provádět export. Výchozí hodnoty jsou zde nastaveny na datum nejstarší a nejnovější transakce, která ještě nebyla vyexportována  (doporučujeme neměnit). Zkontrolujte počet transakcí, které se chystáte vyexportovat a proces exportu započněte zeleným tlačítkem Exportovat.

  3. Zvolte si název exportního souboru. Budete se moci k němu později opakovaně ve Fidoo vracet.

  4. Ve vytvořeném exportu zvolte černé tlačítko Stáhnout data.

  5. Stáhne se Vám zazipovaný balík obsahující exportní soubory karetních transakcí ve všech
    dostupných / aktivních exportních formátech, které máte k dispozici.



    Export karetních transakcí je hotov.

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   Exportu Název interní /   XML Popis pole Vzor dat
expense_id expenseId Identifikátor výdaje   v systému Fidoo 17d15115-4d25-448f-83a3-98be72d95923
short_expense_id shortExpenseId Zkrácený unikátní   identifikátor výdaje v rámci firmy EX-1041
expense_name expenseName Název výdaje Nákup bot
user_firstname user/[@firstName] Jméno uživatele Petr
user_lastname user/[@lastName] Příjmení uživatele Jednatel
employee_number user/[@employeeNumber] Zaměstnanecké číslo   (pokud je vyplněno) 1234666
transaction_id transactionId Identifikátor spojené   karetní transakce (platí jen pro platby kartou) 3691622
card_number cardNumber Identifikátor karty   v systému Fidoo d1d42791-3d15-4597-9907-49ddf863548b
travel_report_id shortTravelReportId V případě přiřazení   výdaje k cesťáku obsahuje unikátní identifikátor daného cesťáku TQ-4
document_id documentId Číslo dokladu 55446677
amount_czk amountCzk Hodnota výdaje v Kč 2300
amount_original_currency amountOriginalCurrency Hodnota výdaje   v původní měně (pokud je jiná než Kč) 85
currency currency Původní měna   transakce (pokud je jiná než Kč) EUR
tax_base taxBase Základ pro DPH 1817
amount_vat amountVat Výše DPH 483
vat_rate vatRate Sazba DPH 0,21
account_assignment_code accountAssignmentCode Kód předkontace AAA
account_debit accountDebit Hodnota MÁ DÁTI 518000
account_credit accountCredit Hodnota DAL 321000
account_vat_assignment_code accountVatAssignmentCode Kód DPH dané   předkontace Kod
account_vat_debit accountVatDebit Hodnota DPH pro MÁ   DÁTI 21
account_vat_credit accountVatCredit Hodnota DPH pro DAL 10
company_expense companyExpense Hodnota firemního   výdaje 2300
private_expense privateExpense Hodnota soukromého   výdaje 0
create_expense_date createExpenseDate Datum vzniku výdaje 17.08.2020 10:41:00
taxable_date taxableDate Datum zdanitelného   plnění 17.08.2020 10:41:00
payment_type paymentType Typ transakce (např.   cash – hotovostní) cash
identification_number identificationNumber IČO obchodníka 12345678
vat_id vatId DIČ CZ12345678
company_name companyName Název obchodníka Baťa
address address Adresa obchodníka Baťova ulice, Zlín
cost_center costCenters/costCenter[1] Kód nákladového   střediska 50001
project projects/project[1] Kód projektu DO
vat_breakdown vatBreakdown Členění DPH Tuzemské do 10000
supplier_bank_account supplierBankAccount Bankovní účet   dodavatele
vs vs Variabilní symbol
cs cs Konstantní symbol
ss ss Specifický symbol
due_date dueDate Datum splatnosti
receipt receiptPresent Pokud je   k výdaji připojena účtenka, nabývá hodnoty ANO Ne
note note Poznámka text v poznámce
merchant_category merchantCategory Kategorie obchodníka Oblečení
approval_date approval/date Datum schválení 17.08.2020 15:19:56
approval_first_name approval/firstName Jméno schvalovatele Karel
approval_last_name approval/lastName Příjmení   schvalovatele Schvalovatel
approval_employee_number approval/employeeNumber Zaměstnanecké číslo   schvalovatele (pokud je vyplněno) 1234777
accountant_approval_date expenseAccountantApproved/date Datum schválení   účetní 17.08.2020 15:48:09
accountant_approval_first_name expenseAccountantApproved/firstName Jméno účetní Jana
accountant_approval_last_name expenseAccountantApproved/lastName Příjmení účetní Vypočítavá
accountant_approval_employee_number expenseAccountantApproved/employeeNumber Zaměstnanecké číslo   účetní (pokud je vyplněno) 1234888
pairing_key pairingKey Párovací klíč EX-1041
state state Status výdaje prepared
item_description items/itemDescription Položka – název Boty
item_amount_czk items/itemAmountCzk Položka – hodnota   výdaje v Kč 2100
item_tax_base items/itemTaxBase Položka – základ daně 1617
item_amount_original_currency items/itemAmountOriginalCurrency Položka – hodnota   výdaje v původní měně (pokud je jiná než Kč) 85
item_amount_vat items/itemAmountVat Položka – výše DPH 483
item_vat_rate items/itemVatRate Položka – sazba DPH 0,21
item_expense_type items/itemExpenseType Položka – druh výdaje   (firemní vs soukromí) corporate
item_account_assignment_code items/itemAccountAssignmentCode Položka – kód   předkontace AAA
item_account_debit items/itemAccountDebit Položka – hodnota MÁ   DÁTI 518000
item_account_credit items/itemAccountCredit Položka – hodnota DAL 321000
item_account_vat_assignment_code items/itemAccountVatAssignmentCode Položka – DPH   předkontace Kod
item_account_vat_debit items/itemAccountVatDebit Položka – DPH pro MÁ   DÁTI 21
item_account_vat_credit items/itemAccountVatCredit Položka – DPH pro DAL 10
item_cost_center items/itemCostCenter/costCenter[1] Položka – nákladové   středisko 50002
item_project items/itemProject/project[1] Položka – projekt DO
item_vat_breakdown items/itemVatBreakdown Položka – členění DPH Tuzemské do 10000

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í

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í

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í

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í

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í