Obecný popis
Exportní výstup Karet ve formátu XML (eXtensible Markup Language) 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 XML 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
Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno používat tento XML formát namísto XLSX formátu. Dalším vhodným způsobem integrace Fidoo na další podnikové systémy je využití Fidoo Public API (viz Public API).
Struktura a popis dat
| Název interní / XML | Popis pole | Vzor dat |
| cardId | Unikátní identifikátor každé karty v systému Fidoo | 04410424-5c86-4bb4-a026-a0c3f7dd7db7 |
| 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******8119 |
| cardValidTo | Datum expirace karty | 30.11.2024 |
| cardName | Zadaný název karty v systému Fidoo | KARTA JARDA |
| cardState | Aktuální stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp. | first-ordered |
| cardType | Dle typu karty nabývá hodnot Osobní nebo Týmová | shared |
| cardProfile | ID spojené karetní transakce (platí jen pro platby kartou | business |
| cardUser/idUser | Unikátní identifikátor aktuálního držitele karty | f136de1b-d6dc-4a6e-8a8a-91713d2e9f93 |
| cardUser/firstName;cardUser/lastName | Jméno a příjmení aktuálního držitele karty | Sam Adams |
| cardUser/employeeNumber | Zaměstnanecké číslo aktuálního držitele karty (pokud je vyplněno) | 1234665 |
| accountBalance | Současný účetní zůstatek karty | 16 |
| availableBalance | Současný disponibilní zůstatek karty | 16 |
| blockedBalance | Blokace na kartě | 0 |
| cardApprover/idUser | Unikátní identifikátor správce karty | 4099648b-e6b8-4b4b-aa44-3591fe2ec382 |
| cardApprover/firstName;cardApprover/lastName | Jméno a příjmení správce karty | Jana Bobošíková |
| cardApprover/employeeNumber | Zaměstnanecké číslo správce karty (pokud je vyplněno) | 1234667 |
| loadApprover/idUser | Unikátní identifikátor schvalovatele dobití karty | 5d7f1a4b-2507-4764-a6ef-97488028f1b8 |
| loadApprover/firstName;loadApprover/lastName | Jméno a příjmení schvalovatele dobití karty | Karel Schvalovatel |
| loadType | Typ dobíjení | manual |
| loadFrequency | Frekvence dobíjení | weekly |
| loadOnAmount | Dobíjení na konkrétní částku | 6 |
| whenTheAvailableBalanceDrops | Limit, jehož dosažení spouští dobití karty | 2 |
| maximumLimit | Maximální limit čerpání na kartě | 100 |
| restrictionsOfCardUsage | Omezení placení kartou | atm: true, merchants: true, e-payments: true |
| deliveryAddressStreet | Dodací adresa ulice | Václavská |
| deliveryAddressBuildingNumber | Dodací adresa číslo domu | 180 |
| deliveryAddressCity | Dodací adresa město | Chrudim |
| deliveryAddressPostcode | Dodací adresa poštovní směrovací číslo | 53701 |
| deliveryAddressCountry | Dodací adresa země | cze |
| orderDate | Datum objednání | 03.12.2021 |
| orderState | Stav objednání karty | ordered |
| alias | Volitelný název karty pro snadné hledání v systému | Adamsova karta |
