Search
Close this search box.

Rok: 2024

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ů

Publikováno

Kniha jízd – XLSX exporty

Struktura a popis dat

Výpis vozidel

Název v XLSX exportuPopis poleVzor dat
fleet_manager_approvedIdentifikace, zda je jízda potvrzená Fleet manageremno
vehicle_registration_numberRegistrační značka vozidla7AA7000
vehicle_brandZnačka (výrobce) vozidlaŠkoda
vehicle_modelModelové označení vozidlaOctavia
vehicle_fuel_typeTyp paliva vozidlanatural-95
vehicle_fuel_consumptionSpotřeba (kombinovaná)5
vehicle_low_emissionIndikace nízkoemisního vozidlano
vehicle_pricePořizovací cena vozidla1200000
start_odometerStav tachometru před jízdou [km]600
end_odometerStav tachometru po jízdě [km]900
distance_totalDélka jízd celkem [km]300
distance_companyDélka služebních jízd [km]200
distance_company_percentagePodíl služebních jízd na jízdách celkem [*100=%]0,6667
distance_privateDélka soukromých jízd [km]100
distance_private_percentagePodíl soukromých jízd na jízdách celkem [*100=%]0,3333
fuelings_priceČástka za tankování v daném měsíci [CZK]. Součet částek za tankování v daném měsíci800
fuelings_amountObjem natankovaných pohonných hmot v daném měsíci [litr]. Součet natankovaných litrů z účtenek za tankování v daném měsíci20
fuelings_cost_per_literNáklady dle reality na litr pohonné hmoty [CZK]40.00
costs_real_companyNáklady dle reality na kilometr služební cesty [CZK]8190
costs_real_privateNáklady dle reality na kilometr soukromé cesty [CZK]455
fuelings_allowance_per_literNáklady dle vyhlášky na litr pohonné hmoty [CZK]45,8
costs_allowance_companyNáklady dle vyhlášky na kilometr služební cesty [CZK]5770,8
costs_allowance_privateNáklady dle vyhlášky na kilometr soukromé cesty [CZK]320,6

Výpis uživatelů

first_nameJméno zaměstnancePetr
last_namePříjmení zaměstnanceJednatel
emailE-mail zaměstnancepetr.jednatel@domena.cz
employee_numberZaměstnanecké číslo zaměstnance (pokud je vyplněno)1234666
amount_to_taxOdpis vozidla (nenízkoemisní 1 % z pořizovací ceny, nízkoemisní 0,5 % z pořizovací ceny)600
distanceDélka jízd celkem [km]700
distance_companyDélka služebních jízd [km]400
distance_privateDélka soukromých jízd [km]300
costs_real_privateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle reálných nákladů7195,5
cost_allowance_privateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle vyhlášky4944

Výpis jízd

Název v XLSX exportuPopis poleVzor dat
start_locationStartovací lokace jízdyPraha
end_locationCílová lokace jízdyBrno
distanceDélka jízdy celkem [km]150
start_date_timeČasová značka začátku jízdy01.09.2023
end_date_timeČasová značka konce jízdy01.09.2023
journey_timeČas jízdy [hh:mm]4:00
purposeÚčel jízdyŠkolení
refuelingTankování během jízdy, spojeno v jednom řádku. Jednotlivá tankování oddělená pomocí pipe „|“ 
breakPřestávky během jízdy, spojeno v jednom řádku. Jednotlivé přestávky oddělené pomocí pipe „|“ 

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

Publikováno

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

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í / XMLPopis poleVzor dat
user/@idUserUnikátní identifikátor uživatele v systému Fidoo30dcca40-9858-4139-9230-bb86d97cf64e
user/@firstNameJméno uživateleJan
user/@lastNamePříjmení uživateleNovak
user/@employeeNumberZaměstnanecké číslo uživateleAX12545
shortPersonalBillingIdZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
personalBillingNameNázev osobního vyúčtováníOd 1. 4. 2022
fromDatePočáteční datum vystaveného osobního vyúčtování01.04.2022
toDateZávěrečný datum vystaveného osobního vyúčtování06.01.2023
daysCountPočet dní2
summary/expenseSumSoučet všech výdajů více měn k vyúčtování v CZK500
summary/privateExpenseSumSoučet všech soukromých výdajů více měn k vyúčtování v CZK50
summary/travelAllowanceSumSoučet všech cestovních náhrad více měn k vyúčtování v CZK100
summary/cashSettlementSumSoučet všech vyrovnání hotovosti více měn k vyúčtování v CZK50
summary/privateExpenseSum + summary/travelAllowanceSum + summary/cashSettlementSumCelkové částka více měn k vyplacení uživateli v CZK200
-1*(summary/privateExpenseSum + summary/travelAllowanceSum + summary/cashSettlementSum)Celkové částka více měn ke stržení uživateli v CZK300
closingDateDatum uzavření vyúčtování06.07.2027
closedByUser/@idUserUnikátní identifikátor uživatele v systému Fidoo, který uzavřel vyúčtování.30dcca40-9858-4139-9230-bb86d97cf64e
closedByUser/@firstNameJméno uživatele, který uzavřel vyúčtování.Jan
closedByUser/@lastNamePříjmení uživatele, který uzavřel vyúčtování.Novak
shortPersonalBillingIdZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
summaryByCurrency/@currencyMěna transakceEUR
summaryByCurrency/privateExpenseSumSoučet všech soukromých výdajů více měn k vyúčtování v CZK50
summaryByCurrency/travelAllowanceSumSoučet všech cestovních náhrad více měn k vyúčtování v CZK100
summaryByCurrency/exchangeRateCashMěnový kurz23.4244
summaryByCurrency/cashSettlementSumSoučet všech vyrovnání hotovosti k vyúčtování podle měn10
summaryByCurrency/privateExpenseSum + summaryByCurrency/travelAllowanceSum + summaryByCurrency/cashSettlementSumCelkové částka k vyplacení uživateli podle měn50
-1*(summaryByCurrency/privateExpenseSum + summaryByCurrency/travelAllowanceSum + summaryByCurrency/cashSettlementSum)Celkové částka ke stržení uživateli podle měn20
shortPersonalBillingIdZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
cash/@currencyMěna transakceEUR
cash/beginPeriodCashStav na začátku období0
cash/cashRevenueSouhrn příjmů do peněženky0
cash/cashIssueSouhrn vydání z peněženky-10
cash/cashSettlementSouhrn vyrovnání peněženky20
cash/endPeriodCashStav na konci období10
shortPersonalBillingIdZkrácený identifikátor osobního vyúčtování v systému FidooPB-459
travelReport/travelReportShortIdUnikátní identifikátor zprávy o služební cestě (cesťáku) v systému Fidoo331a0bd0-0f95-11ea-8d71-362b9e155667
travelReport/@currencyMěna transakceEUR
travelReport/dietNáhrady za stravné v CZK1000
travelReport/allowancePeníze na cestu v CZK2500
travelReport/fuelCompensationNáhrada za palivo v CZK4000
expense/expenseIdIdentifikátor výdaje v systému Fidoo17d15115-4d25-448f-83a3-98be72d95923
expense/expenseNameNázev výdajeNákup bot
expense/stateStatus výdajeaccountantApprove
expense/shortExpenseIdZkrácený unikátní identifikátor výdaje v rámci firmyEX-1041
expense/user/[@firstName]Jméno uživatele Petr
expense/user/[@lastName]Příjmení uživateleJednatel
expense/user/[@employeeNumber]Zaměstnanecké číslo (pokud je vyplněno)1234666
expense/user/[@idUser]Unikátní identifikátor uživatele v systému Fidoo30dcca40-9858-4139-9230-bb86d97cf64e
expense/companyAmount 333
expense/receiptAmount 333
expense/companyAmount/[@currency] CZK
expense/receiptAmount/[@currency] CZK
expense/createExpenseDateDatum vzniku výdaje2020-05-03T10:27:16
expense/settlementDateDatum vypořádání výdaje2020-05-03T10:27:16
expense/currencyPůvodní měna transakce (pokud je jiná než Kč)EUR
expense/taxBaseZáklad pro DPH1817
expense/amountVatVýše DPH483
expense/vatRateSazba DPH0,21
expense/accountAssignmentCodeKód předkontaceAAA
expense/accountDebitHodnota MÁ DÁTI518000
expense/accountCreditHodnota DAL321000
expense/accountVatAssignmentCodeKód DPH dané předkontaceKod
expense/accountVatDebitHodnota DPH pro MÁ DÁTI21
expense/accountVatCreditHodnota DPH pro DAL10
expense/companyExpenseHodnota firemního výdaje2300
expense/privateExpenseHodnota soukromého výdaje0
expense/exchangeRateToCompanyCurrencyKurz měny výdaje vzhledem k firemní měně1
expense/merchantNameNázev obchodníkaBaťa
expense/costCenterCodeKód nákladového střediska50001
expense/projectCodeKód projektuDO
expense/accountingCategoryÚčetní kategorie – NázevAccommodation
expense/accountingCategory/[@code]Účetní kategorie – KódACCO1
expense/paymentTypeTyp transakce (např. cash – hotovostní)cash
expense/notePoznámkatext v poznámce
expense/pairingKeyPá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/namePoložka – názevBoty
expense/items/item/costCenterCodePoložka – nákladové středisko50002
expense/items/item/projectCodePoložka – projektDO
expense/items/item/amountOriginalCurrencyPoložka – hodnota výdaje v původní měně (pokud je jiná než Kč)85
expense/items/item/vatAmountPoložka – výše DPH1617
expense/items/item/vatRatePoložka – sazba DPH0,21
expense/items/item/vatAccountDebitPoložka – DPH pro MÁ DÁTI21
expense/items/item/vatAccountCreditPoložka – DPH pro DAL10
expense/items/item/accountDebitPoložka – hodnota MÁ DÁTI518000
expense/items/item/accountCreditPoložka – hodnota DAL321000
expense/items/item/accountAssignmentCodePoložka – kód předkontaceAAA
expense/items/item/accountVatAssignmentCodePoložka – DPH předkontaceKod

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

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

Publikováno

Uživatelé – XML exporty

Obecný popis

Exportní výstup Uživatelů ve formátu XML (eXtensible Markup Language) 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 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 Uživatelí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 Public API (viz Public API).

Struktura a popis dat

Název interní / XMLPopis poleVzor dat
firstNameJméno uživatelePetr
lastNamePříjmení uživateleJednatel
emailEmailová adresa uživatelepetr.jednatel@test.cz
employeeNumberZaměstnanecké číslo uživatele, pokud je vyplněno v profilu uživatele123222
jobPozice uživatele ve své společnostiÚčetní
phoneTelefon uživatele (který slouží pro ověření)420608112233
usesApplicationIdentifikátor, zda uživatel používá aplikaciyes
userStateIndikace aktivního uživatelePRAVDA
languageJazyk aplikace uživatelecs
userIdUnikátní identifikátor uživatele ve Fidoo27d01358-3ea6-4385-8cb3-3d48eaf76df7
activeApplicationIdentifikátor, zda má uživatel aktivní aplikaciyes
usesCardIdentifikátor, zda uživatel používá kartuyes
departmentOddělení uživatele karty0
insuranceTypeTyp pojištění v rámci produktuPlus
insuranceCreatedDateDatum počátku pojištění20.10.2021
isKycVerifiedNabývá hodnot ověřený/neověřený/ uživatel v závislosti na jeho stavu.yes

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

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

Publikováno

Karty – XML exporty

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í / XMLPopis poleVzor dat
cardIdUnikátní identifikátor každé karty v systému Fidoo04410424-5c86-4bb4-a026-a0c3f7dd7db7
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
cardValidToDatum expirace karty30.11.2024
cardNameZadaný název karty v systému FidooKARTA JARDA
cardStateAktuální stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp.first-ordered
cardTypeDle typu karty nabývá hodnot Osobní nebo Týmováshared
cardProfileID spojené karetní transakce (platí jen pro platby kartoubusiness
cardUser/idUserUniká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
cardUser/firstName;cardUser/lastNameJméno a příjmení uživatele kartySam Adams
accountBalanceSoučasný účetní zůstatek karty16
availableBalanceSoučasný disponibilní zůstatek karty16
blockedBalanceBlokace na kartě0
cardApprover/idUserUnikátní identifikátor schvalovatele karty4099648b-e6b8-4b4b-aa44-3591fe2ec382
cardApprover/firstName;cardApprover/lastNameJméno a příjmení schvalovatele kartyJana Bobošíková
loadTypeTyp dobíjenímanual
loadFrequencyFrekvence dobíjeníweekly
loadOnAmountDobíjení na konkrétní částku6
whenTheAvailableBalanceDropsLimit, jehož dosažení spouští dobití karty2
maximumLimitMaximální limit čerpání na kartě100
restrictionsOfCardUsageOmezení placení kartouatm: true, merchants: true, e-payments: true
deliveryAddressStreetDodací adresa uliceVáclavská
deliveryAddressBuildingNumberDodací adresa číslo domu180
deliveryAddressCityDodací adresa městoChrudim
deliveryAddressPostcodeDodací adresa poštovní směrovací číslo53701
deliveryAddressCountryDodací adresa zeměcze
orderDateDatum objednání03.12.2021
orderStateStav 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ý XML export Karet

Publikováno

Hotovostní transakce – XML exporty

Obecný popis

Exportní výstup Hotovostních transakcí ve formátu XML (eXtensible Markup Language) 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.

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í.

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 Hotovostní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 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í / XMLPopis poleVzor dat
transactionIdIdentifikátor transakce v systému Fidoo5c30dbd2-3756-49d1-88cb-7d12c5933218
shortExpenseIdZkrácený identifikátor výdaje propojeného s transakcí (unikátní v rámci vaší firmy)EX-2764
userCelé jméno uživatelePetr Jednatel
userDetail/firstNameJménoPetr
userDetail/lastNamePříjmení Jednatel
userDetail/employeeNumberZaměstnanecké číslo (pokud je vyplněno)1234666
userDetail/idUserIdentifikátor uživatele v systému Fidooc7583cdb-5f3b-4198-b48f-588afab3530b
walletNameNázev hotovostní peněženkyPetr Jednatel CZK
createTransactionDateČasové razítko vzniku transakce2021-06-17T00:00:00
amountOriginalCurrencyČástka platební operace-487
currencyMěna, ve které bylo placenoCZK
transactionTypeObsahuje informaci o povaze platby – např. platba u obchodníka, výběr hotovosti atp.expense
companyNamePokud 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
expenseIdUnikátní identifikátor připojeného výdaje v systému Fidoo4a400c70-1ee5-491a-b3db-9828fb36d8e5
amountPrivateCelková výše soukromých hotovostních výdajů47
icoIČO společnosti vytvářející export1234666
receiptLinks/linkOdkaz na účtenku (pokud je přiřazena)https://api-fidoo.com/doc/download/…

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

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

Publikováno

Transakce na Fidoo účtu – XML exporty

Obecný popis

Exportní výstup Transakcí na Fidoo účtu ve formátu XML (eXtensible Markup Language) 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 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 transakcích na Fidoo účtu 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 Public API (viz Public API).

Struktura a popis dat

Název interní / XMLPopis poleVzor dat
transactionIdSystémový identifikátor transakce1ab353df-7c00-47cc-a992-37e3865ec916
transactionCreateDateČasové razítko vytvoření transakce2021-01-13T13:01:00
transactionTypeTyp transakcecard-load
transactionOriginalAmountPůvodní částka20000.00000
transactionOriginalCurrencyPůvodní měnaCZK
transactionSettledAmountÚčtovaná částka-20000.00
transactionSettlementDateDatum zaúčtování2021-01-13T13:01:00
cardIdSystémové ID platební karty (pouze u transakcí souvisejících s kartami)01131d1f-a118-af09-7516-826a04f5e2d4
cardMaskedNumberMaskované číslo platební karty549546******2919
cardNameEmbosované jméno na kartěPetr Jednatel
transactionInitiatedUserEmailEmail uživatele, který transakci iniciovalkarel.schvalovatel@domena.cz
transactionInitiatedUserNameJméno uživatele, který transakci iniciovalKarel Schvalovatel
transactionNotePoznámka k transakcitext poznámky
cardHolder/firstNameJméno držitele kartyPetr
cardHolder/lastNamePříjmení držitele kartyJednatel
user/@employeeNumberZaměstnanecké číslo uživatele, který transakci vyvolal (pokud je vyplněno)123666
cardHolder/jobPozice uživatele ve své společnostiObchodník
cardHolder/idUserIdentifikátordržitele karty v systému Fidooc7583cdb-5f3b-4198-b48f-588afab3530b
cardHolder/@employeeNumberZamě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ý XML export Transakcí na Fidoo účtu

Publikováno

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í

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

Publikováno

Kniha jízd – XML exporty

Struktura a popis dat

Výpis vozidel

Název interní / XMLPopis poleVzor dat
fleetManagerApprovedIdentifikace, zda je jízda potvrzená Fleet manageremno
registrationNumberRegistrační značka vozidla7AA7000
brandZnačka (výrobce) vozidlaŠkoda
modelModelové označení vozidlaOctavia
fuelTypeTyp paliva vozidlanatural-95
fuelConsumptionSpotřeba (kombinovaná)5
lowEmissionIndikace nízkoemisního vozidlano
vehiclePricePořizovací cena vozidla1200000
startOdometerStav tachometru před jízdou [km]600
endOdometerStav tachometru po jízdě [km]900
totalDistanceDélka jízd celkem [km]300
companyDistanceDélka služebních jízd [km]200
companyDistance/totalDistancePodíl služebních jízd na jízdách celkem [*100=%]0,6667
privateDistanceDélka soukromých jízd [km]100
privateDistance/totalDistancePodíl soukromých jízd na jízdách celkem [*100=%]0,3333
priceČástka za tankování v daném měsíci [CZK]. Součet částek za tankování v daném měsíci800
amountObjem natankovaných pohonných hmot v daném měsíci [litr]. Součet natankovaných litrů z účtenek za tankování v daném měsíci20
costsPerLiterNáklady dle reality na litr pohonné hmoty [CZK]40.00
costsRealCompanyNáklady dle reality na kilometr služební cesty [CZK]8190
costsRealPrivateNáklady dle reality na kilometr soukromé cesty [CZK]455
allowancePerLiterNáklady dle vyhlášky na litr pohonné hmoty [CZK]45,8
costsRealPrivateNáklady dle vyhlášky na kilometr služební cesty [CZK]5770,8
costsAllowancePrivateNáklady dle vyhlášky na kilometr soukromé cesty [CZK]320,6

Výpis uživatelů

Název interní / XMLPopis poleVzor dat
firstNameJméno zaměstnancePetr
lastNamePříjmení zaměstnanceJednatel
emailE-mail zaměstnancepetr.jednatel@domena.cz
employeeNumberZaměstnanecké číslo zaměstnance (pokud je vyplněno)1234666
amountToTaxOdpis vozidla (nenízkoemisní 1 % z pořizovací ceny, nízkoemisní 0,5 % z pořizovací ceny)600
totalDistanceDélka jízd celkem [km]700
companyDistanceDélka služebních jízd [km]400
privateDistanceDélka soukromých jízd [km]300
costsRealPrivateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle reálných nákladů7195,5
costsAllowancePrivateSoučet nákladů na soukromé kilometry všech vozidel, které řidič v daném měsíci používal dle vyhlášky4944

Výpis jízd

Název interní / XMLPopis poleVzor dat
startLocationStartovací lokace jízdyPraha
endLocationCílová lokace jízdyBrno
distanceDélka jízdy celkem [km]150
startDateTimeČasová značka začátku jízdy01.09.2023
endDateTimeČasová značka konce jízdy01.09.2023
journeyTimeČas jízdy [hh:mm]4:00
purposeÚčel jízdyŠkolení
fuelings/fuelingTankování během jízdy, spojeno v jednom řádku. Jednotlivá tankování oddělená pomocí pipe „|“ 
fuelings/fueling/@dateČasová značka tankování01.09.2023 15:10
fuelings/fueling/@amountPočet natankovaných litrů [L]100
fuelings/fueling/@priceCelková cena tankování2500
fuelings/fueling/@currencyMěnaCZK
breaks/breakPřestávky během jízdy, spojeno v jednom řádku. Jednotlivé přestávky oddělené pomocí pipe „|“ 
breaks/break/@startZačátek přestávky01.09.2023 11:30
breaks/break/@endKonec přestávky01.09.2023 11:40
breaks/break/@totalTimeDélka přestávky [hh:mm]0:10

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

Publikováno

Jak ochránit firemní účty před „vyluxováním“

Úvod › 2024 › Strana 2

Jak s Fidoo předplacenými kartami ochránit firemní účty před „vyluxováním“

NEČTĚTE tento článek, pokud vám nevadí nechat se sem tam okrást o vlastní nebo firemní peníze. Všem ostatním přinášíme řadu užitečných tipů, jak peníze ochránit během současné „epidemie“ zneužívání platebních karet armádou digitálních podvodníků. Kromě naivních jednotlivců stále častěji cílí na firemní účty. 

Co v článku najdete:

Kdy můžete být klidní? 

Pokud používáte pro správu firemních financí Expense management od Fidoo. Chrání vás totiž už samotný fakt, že peníze na firemní předplacené kartě jsou odděleny od firemního bankovního účtu.  

Vaše peníze na Fidoo kartách ale chráníme mnoha dalšími opatřeními, na kterých si vylámou zuby i nejprohnanější hackeři.  

Jde jen o to, zda všechna opatření ve firmě opravdu využíváte. Tady je jejich přehled. 

Dvoufaktorové ověření uživatele v souladu s PSD2

Od zavedení v r. 2019 se z tohoto opatření stal nový standard. Jde o to, že držitel karty se musí ověřit kombinací dvou nezávislých faktorů. Kromě karty, kterou máte u sebe nebo v mobilu, jde typicky o PIN nebo jinou informaci, kterou víte jen vy, anebo o nějaký váš fyzický rys (otisk prstu, sken tváře).  

(I toto maximálně bezpečné opatření má však opodstatněné výjimky. Ty najdete níže v článku a doporučujeme jim věnovat pozornost.) 

Notifikace na mobil

Díky nim máte vždy okamžitý přehled o všech platbách a výběrech hotovosti, a tedy i kontrolu nad svými penězi. Po každé transakci pošle aplikace Fidoo Expense Management do mobilu odpovědné osoby push notifikaci. U neúspěšných plateb se z ní dozví důvod zamítnutí, u úspěšných se automaticky vytvoří výdaj. 

Platební limity

Limity, které si sami nastavíte, omezují platby kartou nebo výběry z bankomatů. Lze je použít pro výši automatického dobíjení karet i pro výši útraty na jednotlivé kartě apod. Zároveň můžete pro jednotlivé karty nastavit pravidla. Např. řidiči povolíte jen výdaje spojené s autodopravou a omezíte je pouze na pracovní dny. Máte pak jistotu, že žádný ze zaměstnanců si za firemní peníze nepodnikne třeba nedělní spanilou jízdu do kasina.

Dočasné uzamčení i „tvrdá“ blokace karet

Jakmile máte podezření, že se s penězi na firemní kartě děje něco, co se dít nemá, kartu ve vteřině dočasně zamknete nebo zablokujete přímo v aplikaci. A klidně i o půlnoci. Stejně tak můžete funkci uzamčení využít i v případě, kdy chcete kartu používat pouze nárazově. Během vteřiny ji v aplikaci odemknete, zaplatíte a můžete ji znovu zamknout.  

Co se týká internetových plateb, to je kapitola sama pro sebe. Obecné Zásady bezpečnosti plateb na webu pro Fidoo karty najdete pěkně pohromadě tady.  

Výjimky u PSD2 zjednodušují život, ale… 

Dvoufaktorové, „neprůstřelné“ ověření držitele karty se obvykle vypouští tam, kde jde o rychlost a co největší uživatelský komfort. Typicky při nákupu jízdenky v MHD nebo u mýtných bran (kolik jste jich na cestě do Chorvatska nebo Rakouska napočítali vy?). Kdyby měl každý řidič při platbě mýtného kartou zadávat PIN, čekání v kolonách by se prodloužilo o další hodiny.

Bohužel, podobné výjimky celkem logicky podvodníky zajímají nejvíce. Při platbách na internetu se podvody vyskytují nejčastěji u obchodníků mimo EU, kde směrnice PSD2 neplatí. 

Co od vás nikdy nebudeme žádat 

Kdybychom omezili použití Fidoo předplacených firemních karet jen na obchodní místa s možností silného ověření, znamenalo by to pro vás značné omezení a nepohodlí při jejich používání. 

A to nechceme. 

Pamatujte si proto prosím: My z  Fidoo ani internetoví obchodníci po vás nikdy nebudeme chtít přeposlání nebo sdělování jednorázových hesel, přístupových údajů nebo dat o vaší kartě. 

Právě tyto podezřelé žádosti jsou klasickým příkladem podvodných SMS zpráv (tzv. „SMSishing“) nebo podvodných e-mailů („phishing“). 

V této souvislosti proto jistě neuškodí připomenout si základní bezpečnostní opatření při jakýchkoli platbách kartou. Platí pro jednotlivce i firemní pracovníky.  

8 základních preventivních opatření při platbách kartou 

  1. Vždy víte, kde se nachází fyzická platební karta 
    Prostě se k ní chovejte se stejnou obezřetností jako k hotovosti. Pravidelně kontrolujte, zda je na svém místě a nenechávejte ji bez dohledu, typicky v autě na benzince, které při odchodu nezamknete. 
  2. Nikdy a nikomu nesdělujte citlivá karetní data  
    Např. celé číslo karty, její platnost a bezpečnostní kód CVV2. Neposílejte je emailem, SMS zprávou ani nesdělujte telefonicky.
  3. Na internetu plaťte jen na ověřených obchodních místech 
    Zjistěte si předem o internetovém obchodu co nejvíce informací (ověřte kontaktní údaje, možnost platit jiným způsobem než kartou např. při převzetí zásilky, mrkněte na obchodní podmínky a reklamační řád).  
    TIP: Pokud si pořád nejste jisti, využít můžete i stránky Rizikové e-shopy – COI.
  4. Pravidelně kontrolujte transakční historii a výpisy 
    V případě, že některou transakci nepoznáváte nebo jste si jisti, že jste ji neprováděli, kartu zablokujte a kontaktujte co nejdřív poskytovatele karty.
  5. Neukládejte kartu při jednorázovém nákupu u obchodníka 
    Proč také, když už se tam třeba nikdy nevrátíte? A i kdyby ano, prostě znovu opíšete požadované údaje. Těch pár vteřin navíc vám může ušetřit peníze i nervy.  
  6. Místo toho používejte službu Click to Pay od Mastercard 
    Jde o maximálně zabezpečený software, kam údaje z karty uložíte, abyste je nemuseli opakovaně vyplňovat v platebních branách u jednotlivých obchodníků.  
    Jak to funguje: Pro každý nákup se vytvoří tzv. token karty a s obchodním místem se nesdílí celé číslo karty spolu s dalšími citlivými údaji. V nezabezpečeném prostředí internetu se tohle hodí víc, než si možná myslíte.
  7. Plaťte s Apple Pay a Google Pay 
    Ukládání údajů v obou případech probíhá přes tokenizaci nebo Face ID (ověření skenem tváře), Touch ID (ověření otiskem prstu) nebo vašeho kódu. K číslu vaší platební karty se vždy přiřadí tzv. virtuální číslo odlišné od skutečného čísla karty. Obchodníkovi pak služby předají právě jen virtuální číslo karty, takže ani obchodník se k vašemu pravému číslu karty nedostane. Číslo platební karty nemáte uložené ani ve svém telefonu. Neprůstřelné.
  8. Pozor na předplatná a opakované platby 
    Máme na mysli zejména platby za cloudová úložiště, streamovací služby, online hry apod. Pokud opakované platby odsouhlasíte, obchodník si je následně strhává z karetního účtu automaticky, aniž pro to vy musíte cokoli dělat. Jak tedy v těchto případech předejít případnému zneužití? Dobře si přečíst podmínky budoucích opakovaných poplatků zejména tu část, která popisuje, v jaké frekvenci a výši se platba bude automaticky strhávat a za jakých podmínek je možné předplatné zrušit. Protože zrušit svolení k budoucím platbám nedokážeme my jako vydavatel karty, ale pouze držitel karty, tedy ten, kdo jej udělil. 

Teď víte vše, co je třeba, aby vaše firemní i osobní finance zůstaly v bezpečí.  

Spravujte zaměstnanecké výdaje jednodušeji a chytřeji!

Chci DEMO

Mohlo by se vám líbit...

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.