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átory současných uživatelů spojených s kartou – v případě vícero uživatelů jsou odděleny středníkem |
f136de1b-d6dc-4a6e-8a8a-91713d2e9f93 |
| cardUser/firstName;cardUser/lastName |
Jméno a příjmení uživatele karty |
Sam Adams |
| accountBalance |
Současný účetní zůstatek karty |
0 |
| availableBalance |
Současný disponibilní zůstatek karty |
0 |
| cardApprover/idUser |
Unikátní identifikátor schvalovatele karty |
4099648b-e6b8-4b4b-aa44-3591fe2ec382 |
| cardApprover/firstName;cardApprover/lastName |
Jméno a příjmení schvalovatele karty |
Jana Bobošíková |
| loadType |
Typ dobíjení |
manual |
| loadFrequency |
Frekvence dobíjení |
weekly |
| loadOnAmount |
Dobíjení na konkrétní částku |
|
| whenTheAvailableBalanceDrops |
Limit, jehož dosažení spouští dobití karty |
|
| maximumLimit |
Maximální limit čerpání na kartě |
|
| restrictionsOfCardUsage |
Omezení placení kartou |
atm: true, merchants: true, e-payments: true |
| deliveryAddressStreet |
Dodací adresa ulice |
Václavská |
| 180 | ||
| deliveryAddressBuildingNumber |
Dodací adresa číslo domu |
|
| 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 |
nou go |