Search
Close this search box.
Úvod Podpora Expense management Účetní Exporty a integrace XML exporty Transakce na kartách – XML exporty

Transakce na kartách – XML exporty

Obecný popis

Exportní výstup Karetních transakcí ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Karetních transakcí z Fidoo ven a pro následné zpracování a další použití mimo Fidoo.

Univerzální formát XML umožňuje především snadné automatizované/robotické zpracování vyexportovaných dat.

Pro zkušenější uživatele jsou vyexportovatelná data i v tomto formátu lidsky čitelná.

Obsahově je tento export navržen tak, aby poskytoval maximální možnou šířku informací o karetních transakcích ve Fidoo.

Typické využití tohoto exportního formátu je pro integrace a importy 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 místo XLSX formátu. Dalším vhodným způsobem integrace Fidoo na další podnikové systémy je využití Fidoo Public (viz Public API).

Struktura a popis dat

Název interní / XMLPopis poleVzor dat
transactionIdIdentifikátor transakce v systému Fidooa58ef2f7-0587-4353-bc42-25f1f6a1363f
shortTransactionIdZkrácený identifikátor transakce v systému Fidoo1664700
cardIdIdentifikátor karty v systému Fidoodfbcd0f2-f0f4-48f7-8214-25448eb58e4f
cardNameNázev konkrétní kartyPETR JEDNATEL
cardNumberMaskovaný PAN karty – viditelné je prvních 6 čísel a poslední 4 čísla (jde o čísla vytištěné na přední straně karty)549546******3602
cardTypeDle typu karty nabývá hodnot Osobní nebo Týmováshared
aliasVolitelný název karty pro snadné hledání v systémuAdamsova karta
shortExpenseIdZkrácené unikátní ID výdaje propojeného s transakcí (unikátní v rámci vaší firmy)EX-4568
createTransactionDateČasové razítko vzniku transakce2021-07-16T11:09:19Z
settlementDateČasové razítko zaúčtování transakce (pokud bylo již zaúčtováno)2021-07-16T11:09:19Z
amountOriginalCurrencyČástka platební operace150
currencyMěna, ve které bylo placenoCZK
transactionSettledAmountCzkČástka která byla zaúčtovaná (pokud již bylo zaúčtováno) – tato hodnota má opačné znaménko než pole částka transakce-150.00
feeObsahuje údaj o výši poplatku v Kč0.00
transactionStateDle aktuální stavu transakce – nejčastěji zaúčtovanáapproved
transactionTypeObsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp.Platba u obchodníka
companyNamePokud je vyplněno, obsahuje text z pole název obchodníka na kartě spárovaného výdajeČD – České dráhy
addressPokud je vyplněno, obsahuje text z pole adresa obchodníka na kartě spárovaného výdajePRAHA 1
countryIdentifikátor země, na jejímž území k transakci došlo.cze
categoryPokud je vyplněno, obsahuje parametr z pole kategorie obchodníka na kartě spárovaného výdajeTravel
expenseIdIdentifikátor připojeného výdaje v systému Fidooe341ae40-e6b9-4270-90da-4591759b25fc
amountPrivateVýše částky z transakce, která je vedena jako soukromá0
user/firstNameJméno uživatele Petr
user/lastNamePříjmení uživateleJednatel
user/employeeNumberZaměstnanecké číslo uživatele (pokud je vyplněno)1234666
user/jobPozice uživatele ve své společnostiObchodník
user/idUserIdentifikátor uživatele v systému Fidooc7583cdb-5f3b-4198-b48f-588afab3530b
companyNameDescriptionPopis obchodníka, místo, země 
notePoznámka 

Ukázkový exportní soubor ke stažení