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 XLSX exportu | Popis pole | Vzor dat |
| card_id | Unikátní identifikátor každé karty v systému Fidoo | 04410424-5c86-4bb4-a026-a0c3f7dd7db7 |
| card_number | 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******8119 |
| card_valid_to | Datum expirace karty | 30.11.2024 |
| card_name | Zadaný název karty v systému Fidoo | KARTA JARDA |
| card_state | Aktuální stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp. | first-ordered |
| card_type | Dle typu karty nabývá hodnot Osobní nebo Týmová | shared |
| card_profile | ID spojené karetní transakce (platí jen pro platby kartou | business |
| card_users_id | Unikátní identifikátor aktuálního držitele karty | f136de1b-d6dc-4a6e-8a8a-91713d2e9f93 |
| card_holder_name_surname | Jméno a příjmení aktuálního držitele karty | Sam Adams |
| account_balance | Současný účetní zůstatek karty | 16 |
| available_balance | Současný disponibilní zůstatek karty | 16 |
| blocked_balance | Blokace na kartě | 0 |
| card_approver_id | Unikátní identifikátor správce karty | 4099648b-e6b8-4b4b-aa44-3591fe2ec382 |
| card_approver_name_surname | Jméno a příjmení správce karty | Jana Bobošíková |
| load_approver_id | Unikátní identifikátor schvalovatele dobití karty | 5d7f1a4b-2507-4764-a6ef-97488028f1b8 |
| load_approver_name_surname | Jméno a příjmení schvalovatele dobití karty | Karel Schvalovatel |
| load_type | Typ dobíjení | manual |
| load_frequency | Frekvence dobíjení | weekly |
| load_on_amount | Dobíjení na konkrétní částku | 6 |
| when_the_available_balance_drops_below | Limit, jehož dosažení spouští dobití karty | 2 |
| maximum_limit | Maximální limit čerpání na kartě | 100 |
| restrictions_of_card_usage | Omezení placení kartou | atm: true, merchants: true, e-payments: true |
| delivery_address_street | Dodací adresa ulice | Václavská |
| delivery_address_building_number | Dodací adresa číslo domu | 180 |
| delivery_address_city | Dodací adresa město | Chrudim |
| delivery_address_postcode | Dodací adresa poštovní směrovací číslo | 53701 |
| delivery_address_country | Dodací adresa země | cze |
| order_date | Datum objednání | 03.12.2021 |
| order_state | Stav objednání karty | ordered |
| alias | Volitelný název karty pro snadné hledání v systému | Adamsova karta |