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 XLSX exportu | Popis pole | Vzor dat |
| transaction_id | Identifikátor transakce v systému Fidoo | 5c30dbd2-3756-49d1-88cb-7d12c5933218 |
| short_expense_id | Zkrácený identifikátor výdaje propojeného s transakcí (unikátní v rámci vaší firmy) | EX-2764 |
| user_name | Celé jméno uživatele | Petr Jednatel |
| employee_number | Zaměstnanecké číslo (pokud je vyplněno) | 1234666 |
| wallet_name | Název hotovostní peněženky | Petr Jednatel CZK |
| create_transaction_date | Časové razítko vzniku transakce | 2021-06-17T00:00:00 |
| amount_original_currency | Částka platební operace | -487 |
| currency | Měna, ve které bylo placeno | CZK |
| transaction_type | Obsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp. | expense |
| company_name | 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 |
| expense_id | Unikátní identifikátor připojeného výdaje v systému Fidoo | 4a400c70-1ee5-491a-b3db-9828fb36d8e5 |
| amount_private | Celková výše soukromých hotovostních výdajů | 47 |