Search
Close this search box.

Měsíc: Listopad 2024

Publikováno

Osobní vyúčtování – XLSX exporty

Obecný popis

Exportní výstup Osobního vyúčtování ve formátu XLSX (Microsoft Excel) 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 XLSX 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 osobním vyúčtování 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.
  • Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.
  • Názvy sloupců v exportu v budoucnu měnit nebudeme.
  • Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.
  • Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).

Struktura a popis dat

Název v XLSX exportuPopis poleVzor dat
user_idUnikátní identifikátor uživatele v systému Fidoo30dcca40-9858-4139-9230-bb86d97cf64e
user_firstnameJméno uživateleJan
user_lastnamePříjmení uživateleNovak
employee_numberZaměstnanecké číslo uživateleAX12545
personal_billing_short_idZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
personal_billing_nameNázev osobního vyúčtováníOd 1. 4. 2022
date_fromPočáteční datum vystaveného osobního vyúčtování01.04.2022
date_toZávěrečný datum vystaveného osobního vyúčtování06.01.2023
travel_report_days_countPočet dní2
expense_sum_czkSoučet všech výdajů více měn k vyúčtování v CZK500
private_expense_sum_czkSoučet všech soukromých výdajů více měn k vyúčtování v CZK50
travel_allowance_sum_czkSoučet všech cestovních náhrad více měn k vyúčtování v CZK100
cash_settlement_sum_czkSoučet všech vyrovnání hotovosti více měn k vyúčtování v CZK50
give_money_sum_czkCelkové částka více měn k vyplacení uživateli v CZK200
take_money_sum_czkCelkové částka více měn ke stržení uživateli v CZK300
closing_dateDatum uzavření vyúčtování06.07.2027
closed_by_user_idUnikátní identifikátor uživatele v systému Fidoo, který uzavřel vyúčtování.30dcca40-9858-4139-9230-bb86d97cf64e
closed_by_user_firstnameJméno uživatele, který uzavřel vyúčtování.Jan
closed_by_user_lastnamePříjmení uživatele, který uzavřel vyúčtování.Novak
personal_billing_short_idZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
currencyMěna transakceEUR
private_expense_sumSoučet všech soukromých výdajů více měn k vyúčtování v CZK50
travel_allowance_sumSoučet všech cestovních náhrad více měn k vyúčtování v CZK100
exchange_rate_cashMěnový kurz23.4244
cash_settlement_sumSoučet všech vyrovnání hotovosti k vyúčtování podle měn10
give_money_sumCelkové částka k vyplacení uživateli podle měn50
take_money_sumCelkové částka ke stržení uživateli podle měn20
personal_billing_short_idZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
currencyMěna transakceEUR
begin_period_cashStav na začátku období0
cash_revenueSouhrn příjmů do peněženky0
cash_issueSouhrn vydání z peněženky-10
cash_settlementSouhrn vyrovnání peněženky20
end_period_cashStav na konci období10
personal_billing_short_idZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
travel_report_idUnikátní identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo331a0bd0-0f95-11ea-8d71-362b9e155667
currencyMěna transakceEUR
meal_allowanceNáhrady za stravné v CZK1000
pocket_moneyPeníze na cestu v CZK2500
fuel_compensationNáhrada za palivo v CZK4000

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

Návody na nastavení a exportování – Generický XLSX export Osobní vyúčtování

Publikováno

Uživatelé – XLSX exporty

Obecný popis

Exportní výstup Uživatelů ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Uživatelů z Fidoo ven a pro následné zpracování a další použití mimo Fidoo.  
Univerzální formát XLSX 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 uživatelí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
  • Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.
  • Názvy sloupců v exportu v budoucnu měnit nebudeme.
  • Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.
  • Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).

Struktura a popis dat

Název v XLSX exportuPopis poleVzor dat
first_nameJméno uživatelePetr
last_namePříjmení uživateleJednatel
emailEmailová adresa uživatelepetr.jednatel@test.cz
employee_numberZaměstnanecké číslo uživatele, pokud je vyplněno v profilu uživatele123222
positionPozice uživatele ve své společnostiÚčetní
phoneTelefon uživatele (který slouží pro ověření)420608112233
uses_applicationIdentifikátor, zda uživatel používá aplikaciyes
is_activeIndikace aktivního uživatelePRAVDA
languageJazyk aplikace uživatelecs

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

Návody na nastavení a exportování – Generický XLSX export Uživatelů

Publikováno

Karty – XLSX exporty

Obecný popis

Exportní výstup Karet ve formátu XLSX (Microsoft Excel) 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 XLSX 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

  • Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.

  • Názvy sloupců v exportu v budoucnu měnit nebudeme.

  • Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.

  • Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).

Struktura a popis dat

Název v XLSX exportuPopis poleVzor dat
card_idUnikátní identifikátor každé karty v systému Fidoo04410424-5c86-4bb4-a026-a0c3f7dd7db7
card_numberMaskovaný 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
card_valid_toDatum expirace karty30.11.2024
card_nameZadaný název karty v systému FidooKARTA JARDA
card_stateAktuální stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp.first-ordered
card_typeDle typu karty nabývá hodnot Osobní nebo Týmováshared
card_profileID spojené karetní transakce (platí jen pro platby kartoubusiness
card_users_idUnikátní identifikátory současných uživatelů spojených s kartou – v případě vícero uživatelů jsou odděleny středníkemf136de1b-d6dc-4a6e-8a8a-91713d2e9f93
card_holder_name_surnameJméno a příjmení uživatele kartySam Adams
account_balanceSoučasný účetní zůstatek karty16
available_balanceSoučasný disponibilní zůstatek karty16
blocked_balanceBlokace na kartě0
card_approver_idUnikátní identifikátor schvalovatele karty4099648b-e6b8-4b4b-aa44-3591fe2ec382
card_approver_name_surnameJméno a příjmení schvalovatele kartyJana Bobošíková
load_typeTyp dobíjenímanual
load_frequencyFrekvence dobíjeníweekly
load_on_amountDobíjení na konkrétní částku6
when_the_available_balance_drops_belowLimit, jehož dosažení spouští dobití karty2
maximum_limitMaximální limit čerpání na kartě100
restrictions_of_card_usageOmezení placení kartouatm: true, merchants: true, e-payments: true
delivery_address_streetDodací adresa uliceVáclavská
delivery_address_building_numberDodací adresa číslo domu180
delivery_address_cityDodací adresa městoChrudim
delivery_address_postcodeDodací adresa poštovní směrovací číslo53701
delivery_address_countryDodací adresa zeměcze
order_dateDatum objednání03.12.2021
order_stateStav objednání kartyordered
aliasVolitelný název karty pro snadné hledání v systémuAdamsova karta

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

Návody na nastavení a exportování – Generický XLSX export Karet

Publikováno

Cesťáky – XML exporty

Obecný popis

Exportní výstup Cesťáků-zpráv ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Cesťáků 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 Cesťácích-zprává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
travelReport/idIdentifikátor výdaje v rámci exportu1
reportIdIdentifikátor cesťákuTR-455
reportNameNázev cesťákuCesta do Mordoru
user/firstNameJméno uživatele Sam
user/lastNamePříjmení uživateleKřepelka
user/employeeNumberZaměstnanecké číslo (pokud je vyplněno)1234666
user/jobPozice uživatele ve své společnostiÚčetní
journeyTypeTyp cestyforeign
reportStateStatus cesťákuapprove
journeyStartDateDatum začátku cesty2021-11-22T08:00:00+01:00
journeyEndDateDatum konce cesty2021-11-26T09:00:00+01:00
journeyStartPointMísto začátku cestyPraha, Česko
journeyEndPointMísto konce cestyKatovice, Polsko
allowance/mealAllowanceCzkStravování (orientační výpočet)880
allowance/pocketMoneyCzkKapesné (orientační výpočet)440
allowance/carAllowanceCzkNáhrada za soukromé vozidlo (orientační výpočet)0
allowance/fuelAllowanceCzkNáhrada za palivo (orientační výpočet)0
allowance/allowanceTotalCzkCelkové náhrady (orientační výpočet)1320
domesticAllowance/currency CZK
domesticAllowance/mealAllowance 0
costCenters/costcenterOznačení cost centra na které je cesťák přiřazenAAA
projects/projectOznačení projektu na které je cesťák přiřazenBBB
journeyNotePoznámkatext poznámky
reportCreatedDatum vytvoření cesťáku2021-11-22T13:25:11+01:00
reportAuthorAutor cesťákuSam Křepelka
reportApprovedSchvalovatel cesťákuKarel Schvalovatel
approval/dateDatum posledního schválení2021-12-22T09:25:11+01:00
approval/firstNameJméno posledního schvalovateleKarel
approval/lastNamePříjmení posledního schvalovateleSchvalovatel
approval/employeeNumberZaměstnanecké číslo posledního schvalovatele123666
reportAccountantApprovedDatum schválení účetní2022-05-05T14:52:00.926986
accountantApproval/dateDatum schválení účetní2022-05-05T14:52:00.926986
accountantApproval/firstNameJméno účetníJana
accountantApproval/lastNamePříjmení účetníVypočítavá
accountantApproval/employeeNumberZaměstnanecké číslo účetní (pokud je vyplněno)123888
request/requestIdIdentifikátor žádostiTQ-555
request/requestStateStatus žádostiapprove
export/fromDateVýpis cesťáků od data2021-11-01T00:00:00+01:00
export/toDateVýpis cesťáků do data2021-11-30T23:59:59.999+01:00
export/createdDatum exportu souboru2021-11-29T09:47:14.202+01:00
trip/idIdentifikátor cesty9afba974-5a49-428b-a29c-afd8e760f1b4
trip/startDateDatum začátku jedn. cesty2021-11-23T08:00:00+01:00
trip/endDateDatum konce jedn. cesty2021-11-23T11:00:00+01:00
trip/startPointMísto začátku jedn. cestyPraha,Česko
trip/endPointMísto konce jedn. cestyKatovice, Polsko
trip/travelReportShortIdIdentifikátor cesťákuTR-455
trip/journeyTypeTyp cestyFOREIGN
trip/mealAllowanceCzkStravování (orientační výpočet)880
trip/pocketMoneyCzkKapesné (orientační výpočet)440
trip/carAllowanceCzkNáhrada za soukromé vozidlo (orientační výpočet). Amortizace0
trip/fuelAllowanceCzkNáhrada za palivo (orientační výpočet)0
trip/allowanceTotalCzkCelkové náhrady (orientační výpočet)1320
depositRequestedVýše žádosti peněz na cestu0
depostiTypeTyp zálohycard
depositCurrencyMěna žádaných peněz na cestuCZK
daysCountPočet dní ze zprávy o služební cestě (cesťáku) 2
mealsDaysCountPočet dní s nárokem na náhrady stravného1
trip/parts/part/transportTypeTyp prostředkucompanyVehicle
trip/parts/part/departureČas odjezdu2023-11-28T08:00:00+01:00
trip/parts/part/countryZemě lokaceCZ
trip/parts/part/locationNázev lokace části cesty, může to být začátek, konec nebo cíl cestyPraha,Česko
trip/parts/part/arrivalČas příjezdu2023-11-28T08:00:00+01:00
trip/parts/part/distancePočet ujetých km v rámci konkrétní části cesty200
trip/parts/part/vehicle/idID prostředku40ea0da2-6001-4fd3-831a-22f3eba4b46f
trip/parts/part/vehicle/brandZnačka (výrobce) vozidlaŠkoda
trip/parts/part/vehicle/modelModelové označení vozidlaOctavia
trip/parts/part/vehicle/registrationNumberRegistrační značka vozidla7AA7000
trip/parts/part/vehicle/vinVIN vozidlaTMBGDM9AKP042788
trip/parts/part/vehicle/internalName  
trip/parts/part/vehicle/typeTyp vozidlacar
trip/parts/part/vehicle/stateStav vozidla ve aplikaci Fidooactive
trip/parts/part/vehicle/ownershipVlastnictví vozidla, zda je soukromé nebo firemnícompany
trip/parts/part/vehicle/usageIndikace, zda je vozidlo sdílené (pool), nebo jej může využívat pouze jeden uživatel (individual)individual
trip/parts/part/vehicle/engineVolumeObjem motoru [cm3]2500
trip/parts/part/vehicle/fuelConsumptionSpotřeba (kombinovaná)5
trip/parts/part/vehicle/fuelTypeTyp paliva vozidlanatural-95

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

Návody na nastavení a exportování – Generický XML export Cesťáků

Publikováno

Výdaje – XML exporty

Obecný popis

Exportní výstup Výdajů ve formátu XML (eXtensible Markup Language) je určen pro datový přenos Výdajů  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 výdají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 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í / XMLPopis poleVzor dat
expenseIdIdentifikátor výdaje v systému Fidoo17d15115-4d25-448f-83a3-98be72d95923
shortExpenseIdZkrácený unikátní identifikátor výdaje v rámci firmyEX-1041
expenseNameNázev výdajeNákup materiálu
user/[@firstName]Jméno uživatele Petr
user/[@lastName]Příjmení uživateleJednatel
user/[@employeeNumber]Zaměstnanecké číslo (pokud je vyplněno)1234666
user/[@job]Pozice uživatele ve firměFakturant
user/[@idUser]ID uživatele ve Fidoo17d15115-4d25-448f-83a3-98be72d95923
transactionIdIdentifikátor spojené karetní transakce (platí jen pro platby kartou)3691622
cardTypeDle typu karty nabývá hodnot Osobní nebo Týmováshared
aliasVolitelný název karty pro snadné hledání v systémuAdamsova karta
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******8119
shortTravelReportIdV případě přiřazení výdaje k cesťáku obsahuje unikátní identifikátor daného cesťákuTQ-4
documentIdČíslo dokladu55446677
amountCzkHodnota výdaje v Kč2300
amountOriginalCurrencyHodnota výdaje v původní měně (pokud je jiná než Kč)85
fxRateKurz ČNB cizí měny výdaje v čase výdaje 6,35
currencyPůvodní měna transakce (pokud je jiná než Kč)EUR
taxBaseZáklad pro DPH1817
amountVatVýše DPH483
vatRateSazba DPH0,21
accountingCategories/accountingCategoryCodeÚčetní kategorie – KódACCO1
accountingCategories/accountingCategoryNameÚčetní kategorie – NázevAccommodation
accountAssignmentCodeKód předkontaceAAA
accountDebitHodnota MÁ DÁTI518000
accountCreditHodnota DAL321000
accountVatAssignmentCodeKód DPH dané předkontaceKod
accountVatDebitHodnota DPH pro MÁ DÁTI21
accountVatCreditHodnota DPH pro DAL10
companyExpenseHodnota firemního výdaje (hodnota je v originální měně výdaje)2300
privateExpenseHodnota soukromého výdaje (hodnota je v originální měně výdaje)0
createExpenseDateDatum vzniku výdaje17.08.2020 10:41:00
taxableDateDatum zdanitelného plnění17.08.2020 10:41:00
paymentTypeTyp transakce (např. cash – hotovostní)cash
identificationNumberIČO obchodníka12345678
vatIdDIČCZ12345678
companyNameNázev obchodníkaBaťa
addressAdresa obchodníkaBaťova ulice, Zlín
costCenters/costCenterKód nákladového střediska50001
costCenters/costCenterNameNázev nákladového střediska 
projects/projectKód projektuDO
vatBreakdownČlenění DPHTuzemské do 10000
supplierBankAccountBankovní účet dodavatele 
vsVariabilní symbol 
csKonstantní symbol 
ssSpecifický symbol 
dueDateDatum splatnosti2021-08-05T00:00:00+02:00
receiptPresentPokud je k výdaji připojena účtenka, nabývá hodnoty ANONe
notePoznámkatext v poznámce
merchantCategoryKategorie obchodníkaOblečení
approval/dateDatum schválení17.08.2020 15:19:56
approval/firstNameJméno schvalovateleKarel
approval/lastNamePříjmení schvalovateleSchvalovatel
approval/employeeNumberOsobní číslo zaměstnance1234777
expenseAccountantApproved/dateDatum potvrzení výdaje účetní17.08.2020 15:48:09
expenseAccountantApproved/firstNameJméno účetníJana
expenseAccountantApproved/lastNamePříjmení účetníVypočítavá
expenseAccountantApproved/employeeNumberZaměstnanecké číslo účetní (pokud je vyplněno)1234888
pairingKeyPárovací klíč. V případě, že jde o externí transakci tak se do tohoto pole propíše externí ID (např. KB externí ID)EX-1041/244-16102023 10864035543207
stateStatus výdajeprepared
externalAccountNameNázev externího účtu (Komerční banka)Můj OS účet
externalAccountIbanIBAN externího účtu (Komerční banka)CZ6501000001151655590237
itemDescriptionPoložka – názevBoty
itemAmountCzkPoložka – hodnota výdaje v Kč2100
itemTaxBase * ../fxRatePoložka – základ daně v Kč1617
itemAmountVat * ../fxRatePoložka – hodnota DPH v Kč 
itemAmountOriginalCurrencyPoložka – hodnota výdaje v původní měně (pokud je jiná než Kč)85
itemTaxBasePoložka – základ daně85
itemAmountVatPoložka – výše DPH1617
itemVatRatePoložka – sazba DPH0,21
itemExpenseTypePoložka – druh výdaje (firemní vs soukromí)corporate
itemAccountingCategory/accountingCategoryCodePoložka – účetní kategorie – KódACCO1
itemAccountingCategory/accountingCategoryNamePoložka – účetní kategorie – NázevAccommodation
itemAccountAssignmentCodePoložka – kód předkontaceAAA
itemAccountDebitPoložka – hodnota MÁ DÁTI518000
itemAccountCreditPoložka – hodnota DAL321000
itemAccountVatAssignmentCodePoložka – DPH předkontaceKod
itemAccountVatDebitPoložka – DPH pro MÁ DÁTI21
itemAccountVatCreditPoložka – DPH pro DAL10
itemCostCenter/costCenterPoložka – nákladové středisko50002
itemCostCenter/costCenterNamePoložka – jméno nákladového střediska 
itemProject/projectPoložka – projektDO
itemVatBreakdownPoložka – členění DPHTuzemské do 10000

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

Návody na nastavení a exportování – Generický XML export Výdajů

Publikováno

Cesťáky – XLSX exporty

Obecný popis

Exportní výstup Cesťáků-zpráv ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Cesťáků (volitelně včetně přiložených účtenek) z Fidoo ven a pro následné zpracování a další použití mimo Fidoo. Univerzální formát XLSX 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 Cesťácích 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.
  • Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.
  • Názvy sloupců v exportu v budoucnu měnit nebudeme.
  • Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.
  • Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).

Struktura a popis dat

Název v XLSX exportuPopis poleVzor dat
travel_report_idIdentifikátor cesťákuTR-455
report_nameNázev cesťákuCesta do Mordoru
user_firstnameJméno uživatele Sam
user_lastnamePříjmení uživateleKřepelka
journey_typeTyp cestyforeign
report_stateStatus cesťákuapprove
journey_start_dateDatum začátku cesty2021-11-22T08:00:00+01:00
journey_end_dateDatum konce cesty2021-11-26T09:00:00+01:00
journey_start_pointMísto začátku cestyPraha, Česko
journey_end_pointMísto konce cestyKatovice, Polsko
meal_allowance_czkStravování (orientační výpočet)880
pocket_money_czkKapesné (orientační výpočet)440
car_allowance_czkNáhrada za soukromé vozidlo (orientační výpočet)0
fuel_allowance_czkNáhrada za palivo (orientační výpočet)0
allowance_total_czkCelkové náhrady (orientační výpočet)1320
cost_centersOznačení cost centra na které je cesťák přiřazenAAA
projectsOznačení projektu na které je cesťák přiřazenBBB
journey_notePoznámkatext poznámky
report_createdDatum vytvoření cesťáku2021-11-22T13:25:11+01:00
report_authorAutor cesťákuSam Křepelka
report_approvedSchvalovatel cesťákuKarel Schvalovatel
approval_dateDatum posledního schválení2021-12-22T09:25:11+01:00
approval_first_nameJméno posledního schvalovateleKarel
approval_last_namePříjmení posledního schvalovateleSchvalovatel
approval_employee_numberZaměstnanecké číslo posledního schvalovatele123666
report_accountant_approvedDatum schválení účetní2022-05-05T14:52:00.926986
approval_dateDatum schválení účetní2022-05-05T14:52:00.926986
approval_first_nameJméno účetníJana
approval_last_namePříjmení účetníVypočítavá
approval_employee_numberZaměstnanecké číslo účetní (pokud je vyplněno)123888
request_idIdentifikátor žádostiTQ-555
request_stateStatus žádostiapprove
export_from_dateVýpis cesťáků od data2021-11-01T00:00:00+01:00
export_to_dateVýpis cesťáků do data2021-11-30T23:59:59.999+01:00
export_createdDatum exportu souboru2021-11-29T09:47:14.202+01:00
trip_idIdentifikátor cesty9afba974-5a49-428b-a29c-afd8e760f1b4
journey_start_dateDatum začátku jedn. cesty2021-11-23T08:00:00+01:00
journey_end_dateDatum konce jedn. cesty2021-11-23T11:00:00+01:00
journey_start_pointMísto začátku jedn. cestyPraha,Česko
journey_end_pointMísto konce jedn. cestyKatovice, Polsko
journey_typeTyp cestyFOREIGN
meal_allowance_czkStravování (orientační výpočet)880
pocket_money_czkKapesné (orientační výpočet)440
car_allowance_czkNáhrada za soukromé vozidlo (orientační výpočet). Amortizace0
fuel_allowance_czkNáhrada za palivo (orientační výpočet)0
allowance_total_czkCelkové náhrady (orientační výpočet)1320
deposit_requestedVýše žádosti peněz na cestu0
deposit_typeTyp zálohycard
deposit_currencyMěna žádaných peněz na cestuCZK
days_countPočet dní ze zprávy o služební cestě (cesťáku) 2
meals_days_countPočet dní s nárokem na náhrady stravného1
transport_typeTyp prostředkucompanyVehicle
departureČas odjezdu2023-11-28T08:00:00+01:00
countryZemě lokaceCZ
locationNázev lokace části cesty, může to být začátek, konec nebo cíl cestyPraha,Česko
arrivalČas příjezdu2023-11-28T08:00:00+01:00
distancePočet ujetých km v rámci konkrétní části cesty200
vehicle_brandZnačka (výrobce) vozidlaŠkoda
vehicle_modelModelové označení vozidlaOctavia
vehicle_registration_numberRegistrační značka vozidla7AA7000
vehicle_vinVIN vozidlaTMBGDM9AKP042788
vehicle_typeTyp vozidlacar
vehicle_stateStav vozidla ve aplikaci Fidooactive
vehicle_ownershipVlastnictví vozidla, zda je soukromé nebo firemnícompany
vehicle_usageIndikace, zda je vozidlo sdílené (pool), nebo jej může využívat pouze jeden uživatel (individual)individual
vehicle_engine_volumeObjem motoru [cm3]2500
vehicle_fuel_consumptionSpotřeba (kombinovaná)5
vehicle_fuel_typeTyp paliva vozidlanatural-95

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

Návody na nastavení a exportování – Generický XLSX export Cesťáků

Publikováno

Hotovostní transakce – XLSX exporty

Obecný popis

Exportní výstup Hotovostních transakcí ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Hotovostních transakcí z Fidoo ven a pro následné zpracování a další použití mimo Fidoo. Univerzální formát XLSX dovoluje jak pohodlnou uživatelskou práci, tak automatizované/robotické zpracování vyexportovaných dat.

Hotovostní transakce jsou pouze pohyby v jednotlivých peněženkách, tento import je používán ve specifických případech, kdy někteří klienti prohlásí peněženku konkrétního uživatele za firemní pokladnu a poté k ní tak přistupují.

Obsahově je tento export navržen tak, aby poskytoval maximální možnou šířku informací o hotovostních transakcí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.

  • Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.

  • Názvy sloupců v exportu v budoucnu měnit nebudeme.

  • Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.

  • Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).

Struktura a popis dat

transaction_idIdentifikátor transakce v systému Fidoo5c30dbd2-3756-49d1-88cb-7d12c5933218
short_expense_idZkrácený identifikátor výdaje propojeného s transakcí (unikátní v rámci vaší firmy)EX-2764
user_nameCelé jméno uživatelePetr Jednatel
employee_numberZaměstnanecké číslo (pokud je vyplněno)1234666
wallet_nameNázev hotovostní peněženkyPetr Jednatel CZK
create_transaction_dateČasové razítko vzniku transakce2021-06-17T00:00:00
amount_original_currencyČástka platební operace-487
currencyMěna, ve které bylo placenoCZK
transaction_typeObsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp.expense
company_namePokud je vyplněno, obsahuje text z pole název obchodníka na kartě spárovaného výdajeBaťa
addressPokud je vyplněno, obsahuje text z pole adresa obchodníka na kartě spárovaného výdajeBaťova ulice, Zlín
categoryPokud je vyplněno, obsahuje parametr z pole kategorie obchodníka na kartě spárovaného výdajeother
expense_idUnikátní identifikátor připojeného výdaje v systému Fidoo4a400c70-1ee5-491a-b3db-9828fb36d8e5
amount_privateCelková výše soukromých hotovostních výdajů47

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

Generický formát XLSX – Hotovostní transakce

Návody na nastavení a exportování – Generický XLSX export Hotovostních transakcí

Publikováno

Transakce na Fidoo účtu – XLSX exporty

Obecný popis

Exportní výstup Transakcí na Fidoo účtu ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Transakcí na Fidoo účtu z Fidoo ven a pro následné zpracování a další použití mimo Fidoo. Univerzální formát XLSX 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 transakcích na Fidoo účtu 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.

  • Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.

  • Názvy sloupců v exportu v budoucnu měnit nebudeme.

  • Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.

  • Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).

Struktura a popis dat

Název v XLSX exportuPopis poleVzor dat
transaction_idSystémový identifikátor transakce1ab353df-7c00-47cc-a992-37e3865ec916
transaction_create_dateČasové razítko vytvoření transakce2021-01-13T13:01:00
transaction_typeTyp transakcecard-load
transaction_original_amountPůvodní částka20000.00000
transaction_settled_amountPůvodní měnaCZK
transaction_original_currencyÚčtovaná částka-20000.00
transaction_settlement_dateDatum zaúčtování2021-01-13T13:01:00
card_idSystémové ID platební karty (pouze u transakcí souvisejících s kartami)01131d1f-a118-af09-7516-826a04f5e2d4
card_masked_numberMaskované číslo platební karty549546******2919
card_nameEmbosované jméno na kartěPetr Jednatel
transaction_initiated_user_emailEmail uživatele, který transakci iniciovalkarel.schvalovatel@domena.cz
transaction_initiated_user_nameJméno uživatele, který transakci iniciovalKarel Schvalovatel
transaction_notePoznámka k transakcitext poznámky
user_first_nameJméno držitele kartyPetr
user_last_namePříjmení držitele kartyJednatel
employee_numberZaměstnanecké číslo uživatele, který transakci vyvolal (pokud je vyplněno)123666
card_holder_first_namePozice uživatele ve své společnostiObchodník
card_holder_last_nameIdentifikátordržitele karty v systému Fidooc7583cdb-5f3b-4198-b48f-588afab3530b
card_holder_employee_numberZaměstnanecké číslo uživatele, který je držitelem karty (pokud je vyplněno)114477

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

Návody na nastavení a exportování – Generický XLSX export Transakcí na Fidoo účtu

Publikováno

Karetní transakce – XLSX exporty

Obecný popis

Exportní výstup Karetních transakcí ve formátu XLSX (Microsoft Excel) 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 XLSX 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 karetních transakcí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

  • Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.

  • Názvy sloupců v exportu v budoucnu měnit nebudeme.

  • Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.

  • Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).

Struktura a popis dat

Název v XLSX exportuPopis poleVzor dat
transaction_idIdentifikátor transakce v systému Fidooa58ef2f7-0587-4353-bc42-25f1f6a1363f
card_idIdentifikátor karty v systému Fidoodfbcd0f2-f0f4-48f7-8214-25448eb58e4f
card_nameNázev konkrétní kartyPETR JEDNATEL
card_numberMaskovaný 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
card_typeDle typu karty nabývá hodnot Osobní nebo Týmováshared
card_aliasVolitelný název karty pro snadné hledání v systémuAdamsova karta
short_expense_idZkrácené unikátní ID výdaje propojeného s transakcí (unikátní v rámci vaší firmy)EX-4568
create_transaction_dateČasové razítko vzniku transakce2021-07-16T11:09:19Z
settlement_dateČasové razítko zaúčtování transakce (pokud bylo již zaúčtováno)2021-07-16T11:09:19Z
amount_original_currencyČástka platební operace150
currencyMěna, ve které bylo placenoCZK
transaction_settled_amount_czkČá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
transaction_stateDle aktuální stavu transakce – nejčastěji zaúčtovanáapproved
transaction_typeObsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp.Platba u obchodníka
company_namePokud 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
expense_idIdentifikátor připojeného výdaje v systému Fidooe341ae40-e6b9-4270-90da-4591759b25fc
firstNameJméno uživatele Petr
lastNamePříjmení uživateleJednatel
employee_numberZaměstnanecké číslo uživatele (pokud je vyplněno)1234666
company_name_descriptionPopis obchodníka, místo, země 
notePoznámka 

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

Návody na nastavení a exportování – Generický XLSX export Karetních transakcí

Publikováno

Výdaje – XLSX exporty

Obecný popis

Exportní výstup Výdajů ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Výdajů (volitelně včetně přiložených účtenek) z Fidoo ven a pro následné zpracování a další použití mimo Fidoo. Univerzální formát XLSX 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 výdají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.
  • Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.
  • Názvy sloupců v exportu v budoucnu měnit nebudeme.
  • Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.
  • Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).

Struktura a popis dat

Název v XLSX exportuPopis poleVzor dat
expense_idIdentifikátor výdaje v systému Fidoo17d15115-4d25-448f-83a3-98be72d95923
short_expense_idZkrácený unikátní identifikátor výdaje v rámci firmyEX-1041
expense_nameNázev výdajeNákup materiálu
user_firstnameJméno uživatele Petr
user_lastnamePříjmení uživateleJednatel
employee_numberZaměstnanecké číslo (pokud je vyplněno)1234666
transaction_idIdentifikátor spojené karetní transakce (platí jen pro platby kartou)3691622
card_numberMaskovaný 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
travel_report_idV případě přiřazení výdaje k cesťáku obsahuje unikátní identifikátor daného cesťákuTQ-4
document_idČíslo dokladu55446677
amount_czkHodnota výdaje v Kč2300
amount_original_currencyHodnota výdaje v původní měně (pokud je jiná než Kč)85
currencyPůvodní měna transakce (pokud je jiná než Kč)EUR
tax_baseZáklad pro DPH1817
amount_vatVýše DPH483
vat_rateSazba DPH0,21
accounting_category_codeÚčetní kategorie – KódACCO1
accounting_category_nameÚčetní kategorie – NázevAccommodation
account_assignment_codeKód předkontaceAAA
account_debitHodnota MÁ DÁTI518000
account_creditHodnota DAL321000
account_vat_assignment_codeKód DPH dané předkontaceKod
account_vat_debitHodnota DPH pro MÁ DÁTI21
account_vat_creditHodnota DPH pro DAL10
company_expenseHodnota firemního výdaje (hodnota je v originální měně výdaje)2300
private_expenseHodnota soukromého výdaje (hodnota je v originální měně výdaje)0
create_expense_dateDatum vzniku výdaje17.08.2020 10:41:00
taxable_dateDatum zdanitelného plnění17.08.2020 10:41:00
payment_typeTyp transakce (např. cash – hotovostní)cash
identification_numberIČO obchodníka12345678
vat_idDIČCZ12345678
company_nameNázev obchodníkaBaťa
addressAdresa obchodníkaBaťova ulice, Zlín
cost_centerKód nákladového střediska50001
projectKód projektuDO
vat_breakdownČlenění DPHTuzemské do 10000
supplier_bank_accountBankovní účet dodavatele 
vsVariabilní symbol 
csKonstantní symbol 
ssSpecifický symbol 
due_dateDatum splatnosti2021-08-05T00:00:00+02:00
receiptPokud je k výdaji připojena účtenka, nabývá hodnoty ANONe
notePoznámkatext v poznámce
merchant_categoryKategorie obchodníkaOblečení
approval_dateDatum schválení17.08.2020 15:19:56
approval_first_nameJméno schvalovateleKarel
approval_last_namePříjmení schvalovateleSchvalovatel
approval_employee_numberOsobní číslo zaměstnance1234777
accountant_approval_dateDatum potvrzení výdaje účetní17.08.2020 15:48:09
accountant_approval_first_nameJméno účetníJana
accountant_approval_last_namePříjmení účetníVypočítavá
accountant_approval_employee_numberZaměstnanecké číslo účetní (pokud je vyplněno)1234888
pairing_keyPárovací klíč. V případě, že jde o externí transakci tak se do tohoto pole propíše externí ID (např. KB externí ID)EX-1041/244-16102023 10864035543207
stateStatus výdajeprepared
externalAccountNameNázev externího účtu (Komerční banka)Můj OS účet
externalAccountIbanIBAN externího účtu (Komerční banka)CZ6501000001151655590237
item_descriptionPoložka – názevBoty
item_amount_czkPoložka – hodnota výdaje v Kč2100
item_tax_base_czkPoložka – základ daně v Kč1617
item_amount_vat_czkPoložka – hodnota DPH v Kč 
item_amount_original_currencyPoložka – hodnota výdaje v původní měně (pokud je jiná než Kč)85
item_tax_basePoložka – základ daně85
item_amount_vatPoložka – výše DPH1617
item_vat_ratePoložka – sazba DPH0,21
item_expense_typePoložka – druh výdaje (firemní vs soukromí)corporate
item_accounting_category_codePoložka – účetní kategorie – KódACCO1
item_accounting_category_namePoložka – účetní kategorie – NázevAccommodation
item_account_assignment_codePoložka – kód předkontaceAAA
item_account_debitPoložka – hodnota MÁ DÁTI518000
item_account_creditPoložka – hodnota DAL321000
item_account_vat_assignment_codePoložka – DPH předkontaceKod
item_account_vat_debitPoložka – DPH pro MÁ DÁTI21
item_account_vat_creditPoložka – DPH pro DAL10
item_cost_centerPoložka – nákladové středisko50002
item_projectPoložka – projektDO
item_vat_breakdownPoložka – členění DPHTuzemské do 10000
differencesoučet částky všech výdajů uživatele, které nemají vyplněný kód předkontace20000
totalsoučet částky všech výdajů uživatele25000

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

Návody na nastavení a exportování – Generický XLSX export Výdajů

Mám zájem
Fidoo logo

Expense Management

FX a zahraniční platby

Direct Fidoo

© Direct Fidoo Payments s.r.o. 2023 Powered by Mastercard. Mastercard je registrovanou ochrannou známkou společnosti Mastercard International Incorporated. Fidoo karta je vydávána na základě licence společnosti Mastercard International Inc. Direct Fidoo Payments s.r.o. je platební instituce zapsaná v seznamu poskytovatelů platebních služeb vedeném Českou národní bankou s oprávněním poskytovat platební služby dle § 3 odst. 1 písm. b), c) a e) zákona o platebním styku.