Obecný popis
Exportní výstup Osobního vyúčtování ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Osobního vyúčtování 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.
Obsahově je tento export navržen tak, aby poskytoval maximální možnou šířku informací o osobním vyúčtování 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 namísto XLSX formátu. Dalším vhodným způsobem integrace Fidoo na další podnikové systémy je využití Fidoo API (viz Public API).
Struktura a popis dat
| Název interní / XML | Popis pole | Vzor dat |
| personalBilling/@id | Identifikátor osobního vyúčtování v rámci exportu | 1 |
| personalBilling/personalBillingId | Unikátní identifikátor osobního vyúčtování v systému Fidoo | 0c5e6650-df62-4ca1-9420-a79f42b6008b |
| user/@idUser | Unikátní identifikátor uživatele v systému Fidoo | 30dcca40-9858-4139-9230-bb86d97cf64e |
| user/@firstName | Jméno uživatele | Jan |
| user/@lastName | Příjmení uživatele | Novak |
| user/@job | Pozice uživatele ve své firmě | Obchodník |
| user/@employeeNumber | Zaměstnanecké číslo uživatele | AX12545 |
| shortPersonalBillingId | Zkrácený identifikátor osobního vyúčtování v systému Fidoo | PB-459 |
| personalBillingName | Název osobního vyúčtování | Od 1. 4. 2022 |
| fromDate | Počáteční datum vystaveného osobního vyúčtování | 01.04.2022 |
| toDate | Závěrečný datum vystaveného osobního vyúčtování | 06.01.2023 |
| travelReportDaysCount | Počet dní ze zprávy o služební cestě (cesťáku) | 2 |
| travelReportMealsDaysCount | Počet dní s nárokem na náhrady stravného | 1 |
| summary/expenseSum | Součet všech výdajů více měn k vyúčtování v CZK | 500 |
| summary/privateExpenseSum | Součet všech soukromých výdajů více měn k vyúčtování v CZK | 50 |
| summary/travelAllowanceSum | Součet všech cestovních náhrad více měn k vyúčtování v CZK | 100 |
| summary/cashSettlementSum | Součet všech vyrovnání hotovosti více měn k vyúčtování v CZK | 50 |
| summary/userClearage | Souhrnné vyrování se se zaměstnancem | 450 |
| closingDate | Datum uzavření vyúčtování | 06.07.2027 |
| closedByUser/@idUser | Unikátní identifikátor uživatele v systému Fidoo, který uzavřel vyúčtování. | 30dcca40-9858-4139-9230-bb86d97cf64e |
| closedByUser/@firstName | Jméno uživatele, který uzavřel vyúčtování | Jan |
| closedByUser/@lastName | Příjmení uživatele, který uzavřel vyúčtování | Novak |
| closedByUser/@employeeNumber | Zaměstnanecké číslo uživatele, který uzavřel vyúčtování | AX12545 |
| closedByUser/@job | Pozice uživatele, který uzavřel vyúčtování | Obchodník |
| shortPersonalBillingId | Zkrácený identifikátor osobního vyúčtování v systému Fidoo | PB-459 |
| summaryByCurrencies/summaryByCurrency/@currency | Měna transakce | EUR |
| summaryByCurrencies/summaryByCurrency/privateExpenseSum | Součet všech soukromých výdajů více měn k vyúčtování v CZK | 50 |
| summaryByCurrencies/summaryByCurrency/travelAllowanceSum | Součet všech cestovních náhrad více měn k vyúčtování v CZK | 100 |
| summaryByCurrencies/summaryByCurrency/userClearage | Vyrování se se zaměstnancem podle měn | -50 |
| summaryByCurrencies/summaryByCurrency/exchangeRateCash | Měnový kurz | 23.4244 |
| summaryByCurrencies/summaryByCurrency/cashSettlementSum | Součet všech vyrovnání hotovosti k vyúčtování podle měn | 10 |
| shortPersonalBillingId | Zkrácený identifikátor osobního vyúčtování v systému Fidoo | PB-459 |
| cashByCurrencies/cash/@currency | Měna transakce | EUR |
| cashByCurrencies/cash/beginPeriodCash | Stav na začátku období | 0 |
| cashByCurrencies/cash/cashRevenue | Souhrn příjmů do peněženky | 0 |
| cashByCurrencies/cash/cashIssue | Souhrn vydání z peněženky | -10 |
| cashByCurrencies/cash/cashSettlement | Souhrn vyrovnání peněženky | 20 |
| cashByCurrencies/cash/endPeriodCash | Stav na konci období | 10 |
| shortPersonalBillingId | Zkrácený identifikátor osobního vyúčtování v systému Fidoo | PB-459 |
| travelReportsByCurrencies/travelReport/travelReportShortId | Zkrácený identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo | TR-27 |
| travelReportsByCurrencies/travelReport/@currency | Měna transakce | EUR |
| travelReportsByCurrencies/travelReport/diet | Náhrady za stravné v CZK | 1000 |
| travelReportsByCurrencies/travelReport/allowance | Peníze na cestu v CZK | 2500 |
| travelReportsByCurrencies/travelReport/fuelCompensation | Náhrada za palivo v CZK | 4000 |
| travelReportsByCurrencies/travelReport/privateCarCompensation | Náhrada za soukromé vozidlo v CZK | 1000 |