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 |
| 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/@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 |
| daysCount | Počet dní | 2 |
| 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/privateExpenseSum + summary/travelAllowanceSum + summary/cashSettlementSum | Celkové částka více měn k vyplacení uživateli v CZK | 200 |
| -1*(summary/privateExpenseSum + summary/travelAllowanceSum + summary/cashSettlementSum) | Celkové částka více měn ke stržení uživateli v CZK | 300 |
| 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 |
| shortPersonalBillingId | Zkrácený identifikátor osobního vyúčtování v systému Fidoo | PB-459 |
| summaryByCurrency/@currency | Měna transakce | EUR |
| summaryByCurrency/privateExpenseSum | Součet všech soukromých výdajů více měn k vyúčtování v CZK | 50 |
| summaryByCurrency/travelAllowanceSum | Součet všech cestovních náhrad více měn k vyúčtování v CZK | 100 |
| summaryByCurrency/exchangeRateCash | Měnový kurz | 23.4244 |
| summaryByCurrency/cashSettlementSum | Součet všech vyrovnání hotovosti k vyúčtování podle měn | 10 |
| summaryByCurrency/privateExpenseSum + summaryByCurrency/travelAllowanceSum + summaryByCurrency/cashSettlementSum | Celkové částka k vyplacení uživateli podle měn | 50 |
| -1*(summaryByCurrency/privateExpenseSum + summaryByCurrency/travelAllowanceSum + summaryByCurrency/cashSettlementSum) | Celkové částka ke stržení uživateli podle měn | 20 |
| shortPersonalBillingId | Zkrácený identifikátor osobního vyúčtování v systému Fidoo | PB-459 |
| cash/@currency | Měna transakce | EUR |
| cash/beginPeriodCash | Stav na začátku období | 0 |
| cash/cashRevenue | Souhrn příjmů do peněženky | 0 |
| cash/cashIssue | Souhrn vydání z peněženky | -10 |
| cash/cashSettlement | Souhrn vyrovnání peněženky | 20 |
| cash/endPeriodCash | Stav na konci období | 10 |
| shortPersonalBillingId | Zkrácený identifikátor osobního vyúčtování v systému Fidoo | PB-459 |
| travelReport/travelReportShortId | Unikátní identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo | 331a0bd0-0f95-11ea-8d71-362b9e155667 |
| travelReport/@currency | Měna transakce | EUR |
| travelReport/diet | Náhrady za stravné v CZK | 1000 |
| travelReport/allowance | Peníze na cestu v CZK | 2500 |
| travelReport/fuelCompensation | Náhrada za palivo v CZK | 4000 |
| expense/expenseId | Identifikátor výdaje v systému Fidoo | 17d15115-4d25-448f-83a3-98be72d95923 |
| expense/expenseName | Název výdaje | Nákup bot |
| expense/state | Status výdaje | accountantApprove |
| expense/shortExpenseId | Zkrácený unikátní identifikátor výdaje v rámci firmy | EX-1041 |
| expense/user/[@firstName] | Jméno uživatele | Petr |
| expense/user/[@lastName] | Příjmení uživatele | Jednatel |
| expense/user/[@employeeNumber] | Zaměstnanecké číslo (pokud je vyplněno) | 1234666 |
| expense/user/[@idUser] | Unikátní identifikátor uživatele v systému Fidoo | 30dcca40-9858-4139-9230-bb86d97cf64e |
| expense/companyAmount | 333 | |
| expense/receiptAmount | 333 | |
| expense/companyAmount/[@currency] | CZK | |
| expense/receiptAmount/[@currency] | CZK | |
| expense/createExpenseDate | Datum vzniku výdaje | 2020-05-03T10:27:16 |
| expense/settlementDate | Datum vypořádání výdaje | 2020-05-03T10:27:16 |
| expense/currency | Původní měna transakce (pokud je jiná než Kč) | EUR |
| expense/taxBase | Základ pro DPH | 1817 |
| expense/amountVat | Výše DPH | 483 |
| expense/vatRate | Sazba DPH | 0,21 |
| expense/accountAssignmentCode | Kód předkontace | AAA |
| expense/accountDebit | Hodnota MÁ DÁTI | 518000 |
| expense/accountCredit | Hodnota DAL | 321000 |
| expense/accountVatAssignmentCode | Kód DPH dané předkontace | Kod |
| expense/accountVatDebit | Hodnota DPH pro MÁ DÁTI | 21 |
| expense/accountVatCredit | Hodnota DPH pro DAL | 10 |
| expense/companyExpense | Hodnota firemního výdaje | 2300 |
| expense/privateExpense | Hodnota soukromého výdaje | 0 |
| expense/exchangeRateToCompanyCurrency | Kurz měny výdaje vzhledem k firemní měně | 1 |
| expense/merchantName | Název obchodníka | Baťa |
| expense/costCenterCode | Kód nákladového střediska | 50001 |
| expense/projectCode | Kód projektu | DO |
| expense/accountingCategory | Účetní kategorie – Název | Accommodation |
| expense/accountingCategory/[@code] | Účetní kategorie – Kód | ACCO1 |
| expense/paymentType | Typ transakce (např. cash – hotovostní) | cash |
| expense/note | Poznámka | text v poznámce |
| expense/pairingKey | Párovací klíč. V případě, že jde o externí transakci tak se do tohoto pole propíše externí ID (např. KB externí ID) | 3000 |
| expense/externalReferenceId | ||
| expense/originalTaxDocumentNumber | ||
| expense/travelReportId | ||
| expense/items/item/name | Položka – název | Boty |
| expense/items/item/costCenterCode | Položka – nákladové středisko | 50002 |
| expense/items/item/projectCode | Položka – projekt | DO |
| expense/items/item/amountOriginalCurrency | Položka – hodnota výdaje v původní měně (pokud je jiná než Kč) | 85 |
| expense/items/item/vatAmount | Položka – výše DPH | 1617 |
| expense/items/item/vatRate | Položka – sazba DPH | 0,21 |
| expense/items/item/vatAccountDebit | Položka – DPH pro MÁ DÁTI | 21 |
| expense/items/item/vatAccountCredit | Položka – DPH pro DAL | 10 |
| expense/items/item/accountDebit | Položka – hodnota MÁ DÁTI | 518000 |
| expense/items/item/accountCredit | Položka – hodnota DAL | 321000 |
| expense/items/item/accountAssignmentCode | Položka – kód předkontace | AAA |
| expense/items/item/accountVatAssignmentCode | Položka – DPH předkontace | Kod |