Návody na integrace – Helios iNuvio

Příprava a nastavení na straně Fidoo

Ve Fidoo aplikaci je potřeba vygenerovat API klíč, který bude modul FISFIB používat pro autorizaci při komunikaci s Fidoo.

  1. Na lince Péče o klienty Fidoo (+420 290 290 290) si zažádejte o zpřístupnění funkce Správa API klíče v aplikaci Fidoo pro zvoleného uživatele. 
    Uživatel Fidoo, kterému necháte zpřístupnit funkci generování API klíče, musí mít ve Fidoo roli Hlavní správce.
  2. V nastavení Správa API klíčů si vygenerujte nový API klíč tlačítkem Přidat API klíč
    (Nastavení Firma -> Správa API klíčů). 


  3. Zvolte si libovolný název klíče, zvolte oprávněného uživatele, na jehož účet bude klíč vytvořen (musí mít roli hlavního spráce) a nastavte oprávnění klíče pro čtení i zápis. Potvrďte tlačítkem Vytvořit
    (Nastavení – Firma – Správa API klíčů).


  4. Vygenerovaný API klíč si zkopírujte do „schránky“ a zabezpečeným způsobem ho předejte pracovníkům firmy First IS, kteří ho použijí pro nastavení přístupu modulu FISFIB v rámci implementace FISFIB do systému HELIOS iNuvio. 

Ve Fidoo nic dalšího není potřeba nastavovat. Nastavení na straně Fidoo je hotovo.

Příprava a nastavení na straně Helios iNuvio (a modulu FISFIB)

V první řadě je potřeba, aby firma First IS provedla implementaci modulu FISFIB do Vašeho systému HELIOS iNuvio.

Další nastavení modulu FISFIB bude provedeno pracovníky First IS na míru pracovním postupům a účetním metodám zákazníka při implemantaci FISIFB do systému HELIOS.

 

Práce s modulem FISFIB v Helios iNuvio

Nové přehledy v Heliosu

Po nainstalování doplňku FISFIB se v nabídce stromové struktury v Heliosu objeví nové přehledy týkající se aplikace Fidoo.

HELIOS – Zakázky – přehled zakázek, které se z Heliosu přenáší do Fidoo buď automaticky – při 
založení zakázky do Heliosu, nebo ručně – pomocí akce Fidoo v přehledu zakázek. Zaškrtnutím 
příslušného záznamu se v stanoveném intervalu odešle zakázka do aplikace Fidoo. Zakázky 
v Heliosu jsou ve Fidoo označované jako projekty. 

HELIOS – Střediska – přehled středisek, které se z Heliosu přenáší do Fidoo buď automaticky 
nebo ručně – pomocí akce Fidoo v přehledu Organizační struktura. Zaškrtnutím příslušného 
záznamu se v stanoveném intervalu odešle zakázka do aplikace Fidoo. 
Nastavení automatického nebo ručního odesílání zakázek a středisek do Fidoo se nakonfiguruje 
při implementaci řešení. 

Fidoo – Karty – přehled karet používaných ve Fidoo. Jsou zde všechny důležité informace o 
kartě – typ karty, název, aktuální, disponibilní, účetní zůstatek, datum expirace, … 

Fidoo – Výdaje – přehled všech výdajů – hotovostních i placených kartou – stažených z Fidoo do 
Heliosu. Stahování probíhá průběžně. 

Fidoo – Cesťáky (zprávy) – přehled cestovních příkazů (cesťáků), stažených z Fidoo do 
Heliosu. Do Heliosu se stahují pouze cestovní příkazy vyplněné po uskutečněné cestě, ve Fidoo 
jsou označované jako zprávy. Stahování probíhá průběžně. 

 

Fidoo – Výdaje

Přehled zobrazuje všechny výdaje s příslušnými informacemi přenesenými z aplikace Fidoo.

Akce nad přehledem Fidoo – Výdaje 

Zpracuj výdaj – tato akce generuje účetní doklady do účetního deníku. Uživatel označí výdaje, 
které chce zpracovat a vybere deník, do kterého se budou výdaje účtovat. Po proběhnutí akce se 
objeví hláška o ukončení akce. O zpracovaných záznamech je uživatel informován atributem 
Zpracovaný – zeleným semaforem, případně datem zpracování – atribut Datum zpracování

Položky výdajů – zobrazí se přehled položek výdaje. O tom, jestli daný výdaj obsahuje položku nebo jen hlavičku, informuje sloupec „Existují položky?“

Hromadná změna kontace – akce umožňuje nastavit na označených záznamech kontaci před zpracováním výdaje do účetního deníku. Funkcionalita se využije v případě, že uživatelé Fidoo nevyplňují kontaci.

Hromadná změna zakázky – akce umožní hromadně změnit, případně nastavit zakázku na výdaji.

Hromadná změna útvaru – akce umožní hromadně změnit, případně nastavit středisko na výdaji.

Hromadná změna vozidla – akce doplní k označeným výdajům zvolené vozidlo, na které se pak bude výdaj účtovat.

Hromadná změna názvu výdaje Helios – v případě, že je potřeba změnit název výdaje vyplněného uživatelem ve FIDOO, pomocí této akce je možné hromadně změnit text, který se pak použije pro účtování.

V hromadných akcích, v případě zaškrtnutí atributu „Aktualizovat i položky“, se změna projeví i na položkách označených výdajů.

Zruš příznak zpracování – použije se v případě, že zpracovaný výdaj byl z účetního deníku vymazán a je nutné tento výdaj opětovně poslat do účetního deníku.

Dokumenty – zde se zobrazují ofocené platební doklady.

 

Přehled položek

Výdaje, které obsahují položky, mají zaškrtnutý atribut „Existují položky?“. Tyto položky je možné samostatně editovat před zpracováním hromadnými akcemi jako v přehledu „Výdaje“.

 

Postup zpracování výdajů

  1. Uživatel označí zvolené výdaje, které chce zpracovat a spustí akci Zpracuj výdaj. Vybere účetní deník a v případě potřeby nastaví Období DPH a Datum případu. Zpracované záznamy se pak hromadně převedou z pomocné importní tabulky do zvoleného účetního deníku.

  2. Následně v importní tabulce zpracuje záznamy do účetního deníku.
    Účetní deník – záložka AkceImport/Export – akce Import – označení záznamů – akce Převod označených dokladů.

V případě opravy je možné záznamy v účetním deníku vymazat. V přehledu „Výdaje“ zrušit příznak zpracování, záznam opravit a následně znovu zpracovat výdaj.

Fidoo – Cesťáky (zprávy)

Přehled Cesťáky (zprávy) zobrazuje všechny cesťáky s příslušnými informacemi přenesenými z aplikace Fidoo.

Akce nad přehledem Fidoo – Cesťáky

Zpracuj cesťák (zprávu) – akce generuje účetní doklady do pomocné importní tabulky, z které se pak hromadně převedou do účetního deníku. Uživatel označí cestovní příkazy, které chce zpracovat a zprávy se automaticky zpracují do přednastaveného deníku.  Po proběhnutí akce se objeví hláška o ukončení akce. O zpracovaných záznamech je uživatel informován atributem „Zpracovaný“ – zeleným semaforem, případně datem zpracování – atribut „Datum zpracování“. 

Detail jízdy – zobrazí detailní informace o jízdě

Přehled výdajů – zobrazí výdaje náležící k danému cesťáku

Hromadná změna zakázky – provede změnu zakázky nad označenými záznamy

Hromadná změna útvaru – provede změnu útvaru nad označenými záznamy

Hromadná změna vozidla – akce doplní k označenými cesťákům zvolené vozidlo, na které se bude následně cesťák účtovat

Hromadná změna názvu cesťáku Helios – v případě, že je potřeba změnit název cesťáku vyplněného uživatelem ve Fidoo, pomocí této akce lze hromadně změnit text, který se pak použije pro účtování

Zruš příznak zpracování – použije se v případě, že zpracovaný cesťák byl z účetního deníku vymazán a je nutné ho opětovně poslat do účetního deníku

Dokumenty – zobrazí ofocené platební doklady

 

Postup zpracování cesťáků (zpráv)

  1. Uživatel označí záznamy, které chce zpracovat a zpustí akci Zpracuj. V případě potřeby upraví Datum dokladu a potvrdí OK.


  2. Zpracované záznamy se pak hromadně převedou z pomocné importní tabulky do zvoleného účetního deníku.

  3. Účetní deník – akce Import/Export – akce Import – označení záznamů – akce Převod označených dokladů.

    V případě opravy, je možné záznamy v účetním deníku vymazat. V přehledu cesťáků zrušit příznak zpracování, záznam opravit a následně znovu zpracovat cesťák.

Popis Helios iNuvio

Obecný popis

Integraci Fidoo na Helios iNuvio (dříve Helios Orange) doporučujeme řešit implementací doplňku First IS Fidoo Integration Bridge (FISFIB) od společnosti First IS přímo do Vašeho systému Helios iNuvio. 

Doplněk FISFIB automatizuje celý proces přenosu a účtování cesťáků a výdajových dokladů vytvořených ve FIDOO do systému HELIOS iNuvio (výdajové doklady vč. fotografií účtenek a cestovní náhrady). 


Přínosy řešení:

  • Přenos všech výdajů, včetně ofocených platebních dokladů z APP Fidoo do IS HELIOS
  • Přenos cesťáků, včetně souvisejících výdajů z APP Fidoo do IS HELIOS 
  • Generování účetních dokladů v IS HELIOS  
  • Přenos a přehled aktuálních zůstatků Fidoo karet v IS HELIOS
  • Automatická synchronizace seznamu Zakázek a Nákladových středisek v IS HELIOS a APP Fidoo
  • Úspora času při proplácení účtenek, cestovného, stravného a dalších výdajů na straně zaměstnanců i pracovníka účtárny 

Technické předpoklady:

  • Funkční IS HELIOS ve verzi iNUVIO
  • Aktivovaný modul účetnictví
  • Aktivovaný modul nástroje customizace (doporučeno)

Soubor ke stažení (pdf): Propagační leták FISFIB

Transformační pravidla

Transformační pravidla pro vyplňování detailu příchozích transakcí a rozúčtovávání v HELIOS se definují přímo v nastavení modulu FISFIB v IS HELIOS. Každý zákazník si tak může nastavit pravidla dle své potřeby a účetních metod. Tyto pravidla jsou typicky nastavována během implementace FISFIB do HELIOS. 

Struktura a popis dat

Struktura a popis přenášených dat zde není dostupný.

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

Komunikace mezi systémy Direct Fidoo a Helios iNuvio probíhá automaticky pomocí API. 
Exportní soubory zde nejsou potřeba. 

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 Exportu
      
   
Název   interní / XML
      
   
Popis   pole
      
   
Vzor   dat       
   
   
card_id
      
   
cardId
      
   
Unikátní   identifikátor každé karty v systému Fidoo
      
   
04410424-5c86-4bb4-a026-a0c3f7dd7db7       
   
   
card_number
      
   
cardNumber
      
   
Maskovaný   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_to
      
   
cardValidTo
      
   
Datum   expirace karty
      
   
30.11.2024       
   
   
card_name
      
   
cardName
      
   
Zadaný   název karty v systému Fidoo
      
   
KARTA   JARDA       
   
   
card_state
      
   
cardState
      
   
Aktuální   stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp.
      
   
first-ordered       
   
   
card_type
      
   
cardType
      
   
Dle   typu karty nabývá hodnot Osobní nebo Týmová
      
   
shared       
   
   
card_profile
      
   
cardProfile
      
   
ID   spojené karetní transakce (platí jen pro platby kartou
      
   
business       
   
   
card_users_id
      
   
cardUser/idUser
      
   
Unikátní   identifikátory současných uživatelů spojených s kartou – v případě vícero   uživatelů jsou odděleny středníkem
      
   
f136de1b-d6dc-4a6e-8a8a-91713d2e9f93       
   
   
card_holder_name_surname
      
   
cardUser/firstName;cardUser/lastName
      
   
Jméno   a příjmení uživatele karty
      
   
Sam   Adams       
   
   
account_balance
      
   
accountBalance
      
   
Současný   účetní zůstatek karty
      
   
0       
   
   
available_balance
      
   
availableBalance
      
   
Současný   disponibilní zůstatek karty
      
   
0       
   
   
card_approver_id
      
   
cardApprover/idUser
      
   
Unikátní   identifikátor schvalovatele karty
      
   
4099648b-e6b8-4b4b-aa44-3591fe2ec382       
   
   
card_approver_name_surname
      
   
cardApprover/firstName;cardApprover/lastName
      
   
Jméno   a příjmení schvalovatele karty
      
   
Jana   Bobošíková       
   
   
load_type
      
   
loadType
      
   
Typ   dobíjení
      
   
manual       
   
   
load_frequency
      
   
loadFrequency
      
   
Frekvence   dobíjení
      
   
weekly       
   
   
load_on_amount
      
   
loadOnAmount
      
   
Dobíjení   na konkrétní částku
      
   
        
   
   
when_the_available_balance_drops_below
      
   
whenTheAvailableBalanceDrops
      
   
Limit,   jehož dosažení spouští dobití karty
      
   
        
   
   
maximum_limit
      
   
maximumLimit
      
   
Maximální   limit čerpání na kartě
      
   
        
   
   
restrictions_of_card_usage
      
   
restrictionsOfCardUsage
      
   
Omezení   placení kartou
      
   
atm: true, merchants: true,   e-payments: true       
   
   
delivery_address_street
      
   
deliveryAddressStreet
      
   
Dodací   adresa ulice
      
   
Václavská
180       
   
   
delivery_address_building_number
      
   
deliveryAddressBuildingNumber
      
   
Dodací   adresa číslo domu
      
   
        
   
   
delivery_address_city
      
   
deliveryAddressCity
      
   
Dodací   adresa město
      
   
Chrudim       
   
   
delivery_address_postcode
      
   
deliveryAddressPostcode
      
   
Dodací   adresa poštovní směrovací číslo
      
   
53701       
   
   
delivery_address_country
      
   
deliveryAddressCountry
      
   
Dodací   adresa země
      
   
cze       
   
   
order_date
      
   
orderDate
      
   
Datum   objednání
      
   
03.12.2021       
   
   
order_state
      
   
orderState
      
   
Stav   objednání karty
      
   
ordered       
   
   
alias
      
   
alias
      
   
Volitelný   název karty pro snadné hledání v systému
      
   
nou go       

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

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 Exportu
      
   
Název   interní / XML
      
   
Popis   pole
      
   
Vzor   dat       
   
   
user_id
      
   
userId
      
   
Unikátní   identifikátor uživatele ve Fidoo
      
   
27d01358-3ea6-4385-8cb3-3d48eaf76df7       
   
   
first_name
      
   
firstName
      
   
Jméno   uživatele
      
   
Test       
   
   
last_name
      
   
lastName
      
   
Příjmení   uživatele
      
   
Aktivace       
   
   
email
      
   
email
      
   
Emailová   adresa uživatele
      
   
test@aktivace1.cz       
   
   
phone
      
   
phone
      
   
Telefon   uživatele (který slouží pro ověření)
      
   
+420608112233       
   
   
uses_application
      
   
usesApplication
      
   
Identifikátor,   zda uživatel používá aplikaci
      
   
yes       
   
   
active_application
      
   
activeApplication
      
   
Identifikátor,   zda má uživatel aktivní aplikaci
      
   
yes       
   
   
uses_card
      
   
usesCard
      
   
Identifikátor,   zda uživatel používá kartu
      
   
yes       
   
   
employee_number
      
   
employeeNumber
      
   
Zaměstnanecké   číslo uživatele, pokud je vyplněno v profilu uživatele
      
   
1255       
   
   
department
      
   
department
      
   
Oddělení   uživatele karty
      
   
0       
   
   
insurance_type
      
   
insuranceType
      
   
Typ   pojištění v rámci produktu
      
   
Plus       
   
   
insurance_create_date
      
   
insuranceCreatedDate
      
   
Datum   počátku pojištění
      
   
20.10.2021       
   
   
is_KYC_verified
      
   
isKycVerified
      
   
Nabývá   hodnot ověřený/neověřený/ uživatel v závislosti na jeho stavu.
      
   
yes       
   
   
user_state
      
   
userState
      
   
Nabývá   hodnot PRAVDA /NEPRAVDA. Pravda značí, že je aplikace pro tohoto uživatele   aktivní.
      
   
active       

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

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í / XML
      
   
Popis   pole
      
   
Vzor   dat       
   
   
cardId
      
   
Unikátní   identifikátor každé karty v systému Fidoo
      
   
04410424-5c86-4bb4-a026-a0c3f7dd7db7       
   
   
cardNumber
      
   
Maskovaný   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       
   
   
cardValidTo
      
   
Datum   expirace karty
      
   
30.11.2024       
   
   
cardName
      
   
Zadaný   název karty v systému Fidoo
      
   
KARTA   JARDA       
   
   
cardState
      
   
Aktuální   stav karty k momentu vzniku exportu. Například Objednaná, aktivní atp.
      
   
first-ordered       
   
   
cardType
      
   
Dle   typu karty nabývá hodnot Osobní nebo Týmová
      
   
shared       
   
   
cardProfile
      
   
ID   spojené karetní transakce (platí jen pro platby kartou
      
   
business       
   
   
cardUser/idUser
      
   
Unikátní   identifikátory současných uživatelů spojených s kartou – v případě vícero   uživatelů jsou odděleny středníkem
      
   
f136de1b-d6dc-4a6e-8a8a-91713d2e9f93       
   
   
cardUser/firstName;cardUser/lastName
      
   
Jméno   a příjmení uživatele karty
      
   
Sam   Adams       
   
   
accountBalance
      
   
Současný   účetní zůstatek karty
      
   
0       
   
   
availableBalance
      
   
Současný   disponibilní zůstatek karty
      
   
0       
   
   
cardApprover/idUser
      
   
Unikátní   identifikátor schvalovatele karty
      
   
4099648b-e6b8-4b4b-aa44-3591fe2ec382       
   
   
cardApprover/firstName;cardApprover/lastName
      
   
Jméno   a příjmení schvalovatele karty
      
   
Jana   Bobošíková       
   
   
loadType
      
   
Typ   dobíjení
      
   
manual       
   
   
loadFrequency
      
   
Frekvence   dobíjení
      
   
weekly       
   
   
loadOnAmount
      
   
Dobíjení   na konkrétní částku
      
   
        
   
   
whenTheAvailableBalanceDrops
      
   
Limit,   jehož dosažení spouští dobití karty
      
   
        
   
   
maximumLimit
      
   
Maximální   limit čerpání na kartě
      
   
        
   
   
restrictionsOfCardUsage
      
   
Omezení   placení kartou
      
   
atm: true, merchants: true,   e-payments: true       
   
   
deliveryAddressStreet
      
   
Dodací   adresa ulice
      
   
Václavská
180       
   
   
deliveryAddressBuildingNumber
      
   
Dodací   adresa číslo domu
      
   
        
   
   
deliveryAddressCity
      
   
Dodací   adresa město
      
   
Chrudim       
   
   
deliveryAddressPostcode
      
   
Dodací   adresa poštovní směrovací číslo
      
   
53701       
   
   
deliveryAddressCountry
      
   
Dodací   adresa země
      
   
cze       
   
   
orderDate
      
   
Datum   objednání
      
   
03.12.2021       
   
   
orderState
      
   
Stav   objednání karty
      
   
ordered       
   
   
alias
      
   
Volitelný   název karty pro snadné hledání v systému
      
   
nou go       

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

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í / XML
      
   
Popis   pole
      
   
Vzor   dat       
   
   
userId
      
   
Unikátní   identifikátor uživatele ve Fidoo
      
   
27d01358-3ea6-4385-8cb3-3d48eaf76df7       
   
   
firstName
      
   
Jméno   uživatele
      
   
Test       
   
   
lastName
      
   
Příjmení   uživatele
      
   
Aktivace       
   
   
email
      
   
Emailová   adresa uživatele
      
   
test@aktivace1.cz       
   
   
phone
      
   
Telefon   uživatele (který slouží pro ověření)
      
   
+420608112233       
   
   
usesApplication
      
   
Identifikátor,   zda uživatel používá aplikaci
      
   
yes       
   
   
activeApplication
      
   
Identifikátor,   zda má uživatel aktivní aplikaci
      
   
yes       
   
   
usesCard
      
   
Identifikátor,   zda uživatel používá kartu
      
   
yes       
   
   
employeeNumber
      
   
Zaměstnanecké   číslo uživatele, pokud je vyplněno v profilu uživatele
      
   
1255       
   
   
department
      
   
Oddělení   uživatele karty
      
   
0       
   
   
insuranceType
      
   
Typ   pojištění v rámci produktu
      
   
Plus       
   
   
insuranceCreatedDate
      
   
Datum   počátku pojištění
      
   
20.10.2021       
   
   
isKycVerified
      
   
Nabývá   hodnot ověřený/neověřený/ uživatel v závislosti na jeho stavu.
      
   
yes       
   
   
userState
      
   
Nabývá   hodnot PRAVDA /NEPRAVDA. Pravda značí, že je aplikace pro tohoto uživatele   aktivní.
      
   
active       

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

Karetní transakce – XLS (Old) export

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ů

Transformační pravidla

  • Nejsou zde definovaná žádná transformační pravidla.

Struktura a popis dat

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

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

Příprava a nastavení na straně Fidoo

Ve Fidoo aplikaci je potřeba provést následující nastavení.

  1. Přesvědčte se, že máte Generický formát XLSX zapnutý a aktivní. Případně jej zapněte  
    (NastaveníIntegraceXLSX)


  2. (Volitelně) Vytvořte si seznam Nákladových středisek.
    (Nastavení  Výdaje  Nákladová střediska)


  3. (Volitelně) Vytvořte si seznam Projektů.
    (Nastavení  Projekty).

Export z Fidoo

Exportovat výdaje lze ve Fidoo na dvou místech: 
1. Nad jakýmkoliv seznamem výdajů (např. Firemní finance – Cesťáky – Zprávy).
2. V účetní agendě v části „Export cesťáků“. 

Rozdíl je v tom, že v účetní agendě se při exportu aplikují kontroly zamezující vyexportovat Zprávy duplicitně, zatímco nad běžným seznamem Zpráv kdekoliv v aplikaci se žádné kontroly neaplikují a lze tak vyexportovat libovolnou skupinu Zpráv dle preferencí nastavených ve filtru. 

Export z Fidoo nad seznamem Zpráv

  1. Ve Fidoo aplikaci jděte nad jakýkoliv seznam Zpráv.
    (Firemní Finance / Týmové Finance / Moje FinanceCesťákyZprávy).
  2. Vyfiltrujte si období nebo jiné omezující podmínky pro váš export. 
    (Firemní Finance / Týmové Finance / Moje FinanceCesťákyZprávy)



  3. Nad vyfiltrovaným seznamem Zpráv zvolte volbu „Export“.
    (Firemní Finance / Týmové Finance / Moje FinanceCesťákyZprávy).


  4. Vyberte Generický formát XLSX a potvrďte zeleným tlačítkem „Exportovat“.
    (Firemní Finance / Týmové Finance / Moje FinanceCesťákyZprávy).

     

Export z Fidoo z Účetní agendy

Fidoo zde hlídá všechny provedené exporty v rámci účetní agendy a snaží se předejít duplicitám při exportu. K exportu jsou zde nabízeny pouze  Zprávy, které ještě dříve nebyly exportovány a zároveň už jsou z hlediska schvalovacího procesu ve stavu „Vyúčtovaná“ (tj. jsou součástí uzavřeného osobního vyúčtování).

  1. Ve Fidoo aplikaci jděte do části Účetní agenda a zde zvolte Export cesťáků. 


  2. Zvolte Nový exportPomocí filtru si můžete omezit seznam Zpráv, které budete exportovat. 
    Výchozí hodnoty filtru jsou zde nastaveny tak, aby výběr obsahoval všechny Zprávy, které už jsou připraveny k exportu a ještě před tím nebyly exportovány (doporučujeme neměnit). 
    Zkontrolujte počet Zpráv, které se chystáte vyexportovat a exportní proces započněte zeleným tlačítkem Exportovat. 


  3. Zvolte si název exportního souboru. Budete se moci k němu později opakovaně ve Fidoo vracet.  


  4. Ve vytvořeném exportu zvolte černé tlačítko Stáhnout data. 


  5. Stáhne se vám zazipovaný balík obsahující exportní soubory Zpráv ve všech dostupných / aktivních exportních formátech, které máte k dispozici.

     

             Export cesťáků je hotov.

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

Příprava a nastavení na straně Fidoo

Ve Fidoo aplikaci je potřeba provést následující nastavení.

  1. Přesvědčte se, že máte Generický formát XLS (old) zapnutý a aktivní. Případně jej zapněte  
    (NastaveníIntegraceXLS (old))
  2. (Volitelně) Vytvořte si seznam Nákladových středisek. 
    (Nastavení  Výdaje  Nákladová střediska
  3. (Volitelně) Vytvořte si seznam Členění DPH. 
    (Nastavení  Výdaje  Členění DPH
  4. (Volitelně) Vytvořte si seznam Projektů. 
    (Nastavení  Projekty). 
  5. (Volitelně) Vytvořte si seznam Předkontací. 
    (NastaveníVýdajePředkontace)

Export z Fidoo

Exportovat transakce lze ve Fidoo na dvou místech. 
1. Nad jakýmkoliv seznamem karetních transakcí (např. Firemní FinanceKartyTransakce).
2. V účetní agendě v části Export karetních transakcí.

Rozdíl je v tom, že v účetní agendě se při exportu aplikují kontroly zamezující vyexportovat transakce duplicitně. Nad běžným seznamem transakcí kdekoliv v aplikaci se žádné kontroly neaplikují a lze tak vyexportovat libovolnou skupinu transakcí dle preferencí nastavených ve filtru. 

Export z Fidoo nad seznamem karetních transakcí 

  1. Ve Fidoo aplikaci jděte nad jakýkoliv seznam karetních transakcí
    (Firemní Finance / Týmové / Moje FinanceKartyTransakce)

     

  2. Vyfiltrujte si období nebo jiné omezující podmínky pro váš export                                                     (Firemní Finance / Týmové finance / Moje finance – KartyTransakce)





  3. Nad vyfiltrovaným seznamem Karetních transakcí  zvolte volbu Export 
    (Firemní Finance / Týmové Finance / Moje FinanceKartyTransakce).

     

  4. Vyberte Generický formát XLS (old) a výběr potvrďte zeleným tlačítkem Exportovat
    (Firemní Finance / Týmové Finance / Moje FinanceKartyTransakce).

Export z Fidoo z Účetní agendy

Fidoo zde hlídá všechny provedené exporty v rámci účetní agendy a snaží se předejít duplicitám při exportu. K exportu jsou zde nabízeny pouze transakce zúčtované bankou, které dosud nebyly exportovány.

  1. Ve Fidoo aplikaci jděte do části Účetní agenda a zde zvolte Export karetních transakcí.
  2. Zkontrolujte si období, za které budete provádět export. Výchozí hodnoty jsou zde nastaveny na datum nejstarší a nejnovější transakce, která ještě nebyla vyexportována  (doporučujeme neměnit). Zkontrolujte počet transakcí, které se chystáte vyexportovat a proces exportu započněte zeleným tlačítkem Exportovat.

  3. Zvolte si název exportního souboru. Budete se moci k němu později opakovaně ve Fidoo vracet.

  4. Ve vytvořeném exportu zvolte černé tlačítko Stáhnout data.

  5. Stáhne se Vám zazipovaný balík obsahující exportní soubory karetních transakcí ve všech
    dostupných / aktivních exportních formátech, které máte k dispozici.



    Export karetních transakcí je hotov.

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

Příprava a nastavení na straně Fidoo

Ve Fidoo aplikaci je potřeba provést následující nastavení.

Přesvědčte se, že máte Generický formát XLSX zapnutý a aktivní. Případně jej zapněte  
(NastaveníIntegraceXLSX)

Export z Fidoo

Exportovat karty lze nad seznamem karet (Firemní finance / Týmové finance / KartyInformace o kartách).
Zde lze exportovat libovolnou skupinu karet dle preferencí nastavených ve filtru. 

  1. Ve Fidoo aplikaci jděte nad seznam karet.
    (Firemní / Týmové financeKartyInformace o kartách)
     
  2. Vyfiltrujte si omezující podmínky pro váš export 
    (Firemní Finance / Týmové finance – KartyInformace o kartách)



  3. Nad vyfiltrovaným seznamem karet zvolte volbu Export
    (Firemní Finance / Týmové FinanceKartyInformace o kartách).


  4. Vyberte Generický formát XLSX a výběr potvrďte zeleným tlačítkem Exportovat
    (Firemní Finance / Týmové FinanceKartyInformace o kartách).


    Vytvoří se exportní soubor a uloží se vám do počítače. 

Export z Fidoo z Účetní agendy

Fidoo zde hlídá všechny provedené exporty v rámci účetní agendy a snaží se předejít duplicitám při exportu. K exportu jsou zde nabízeny pouze transakce zúčtované bankou, které dosud nebyly exportovány.

  1. Ve Fidoo aplikaci jděte do části Účetní agenda a zde zvolte Export karetních transakcí.


  2. Zkontrolujte si období, za které budete provádět export. Výchozí hodnoty jsou zde nastaveny na datum nejstarší a nejnovější transakce, která ještě nebyla vyexportována  (doporučujeme neměnit). Zkontrolujte počet transakcí, které se chystáte vyexportovat a proces exportu započněte zeleným tlačítkem Exportovat.


  3. Zvolte si název exportního souboru. Budete se moci k němu později opakovaně ve Fidoo vracet.


  4. Ve vytvořeném exportu zvolte černé tlačítko Stáhnout data.


  5. Stáhne se Vám zazipovaný balík obsahující exportní soubory karetních transakcí ve všech
    dostupných / aktivních exportních formátech, které máte k dispozici.



    Export karetních transakcí je hotov.