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 | Popis pole | Vzor dat |
| transaction_id | Systémový identifikátor transakce | 1ab353df-7c00-47cc-a992-37e3865ec916 |
| transaction_create_date | Časové razítko vytvoření transakce | 2021-01-13T13:01:00 |
| transaction_type | Typ transakce | card-load |
| transaction_original_amount | Původní částka | 20000.00000 |
| transaction_settled_amount | Původní měna | CZK |
| transaction_original_currency | Účtovaná částka | -20000.00 |
| transaction_settlement_date | Datum zaúčtování | 2021-01-13T13:01:00 |
| card_id | Systémové ID platební karty (pouze u transakcí souvisejících s kartami) | 01131d1f-a118-af09-7516-826a04f5e2d4 |
| card_masked_number | Maskované číslo platební karty | 549546******2919 |
| card_name | Embosované jméno na kartě | Petr Jednatel |
| transaction_initiated_user_email | Email uživatele, který transakci inicioval | karel.schvalovatel@domena.cz |
| transaction_initiated_user_name | Jméno uživatele, který transakci inicioval | Karel Schvalovatel |
| transaction_note | Poznámka k transakci | text poznámky |
| user_first_name | Jméno držitele karty | Petr |
| user_last_name | Příjmení držitele karty | Jednatel |
| employee_number | Zaměstnanecké číslo uživatele, který transakci vyvolal (pokud je vyplněno) | 123666 |
| card_holder_first_name | Pozice uživatele ve své společnosti | Obchodník |
| card_holder_last_name | Identifikátordržitele karty v systému Fidoo | c7583cdb-5f3b-4198-b48f-588afab3530b |
| card_holder_employee_number | Zaměstnanecké číslo uživatele, který je držitelem karty (pokud je vyplněno) | 114477 |