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í

Odbíjení peněz z Fidoo účtu

Vybití Fidoo účtu

  1. Sekce Firemní finance Fidoo účet Vybít účet (vpravo nahoře).
  2. Zadejte sumu nebo zaškrtněte celou částku, případně doplňte důvod a Potvrďte.

Nastavení oznámení o nízkém zůstatku

  1. Sekce Nastavení Firma Fidoo účet.
  2. V okně Oznámení o nízkém zůstatku na Fidoo účtu zvolte Změnit nastavení.
  3. Aktivujte, zadejte limit, zvolte způsob odeslání a Potvrďte.

V případě, že máte v aplikaci zavedeno více firemních účtů, jsou prostředky při odbití účtu zasílány pouze na jeden vámi zvolený bankovní účet, který je u nás vedený jako hlavní účet.

Jak zprovoznit pokladnu

Abyste v aplikaci Fidoo mohli využívat pokladnu, je potřeba nejprve jednoho z uživatelů dosadit do role pokladní. Roli pokladní může určit osoba vedená jako statutární zástupce nebo hlavní správce v aplikaci, a to v sekci: Nastavení – Firma – Klíčové role. 

Zprovozněním pokladny se vám otevírá možnost správy hotovostních peněženek jednotlivých uživatelů aplikace, a to jak v českých korunách tak v ostatních měnách. 

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 integrace – Pohoda export Výdajů

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 Exportní formát pro Pohodu zapnutý a aktivní. Případně jej zapněte. 
    (NastaveníIntegraceSpecifický formát Pohoda)
  2. V detailu nastavení exportního formátu pro Pohodu si v komponentě „Výdaje“ nastavte: 
          a) IČ Vaší firmy shodné s IČ Vaší firmy nastavené v Pohodě (v případě rozdílných IČ v tomto nastavení import do Pohody vůbec neproběhne). 
          b) Prefix pro číselnou řadu Závazků, která se použije při importu pro výdaje z Fidoo 
    (v případě, že zde bude vyplněn prefix, který v Pohodě není definovaný, případně nebude vyplněno nic, tak se při importu do Pohody použije Výchozí číselná řada Závazků nastavená v Pohodě) – viz „Příprava a nastavení na straně Pohody“.
          c) Prefix pro číselnou řadu Faktur Přijatých, která se použije při importu pro výdaje z Fidoo 
    (v případě, že zde bude vyplněn prefix, který v Pohodě není definovaný, případně nebude vyplněno nic, tak se při importu do Pohody použije Výchozí číselná řada Faktur Přijatých nastavená v Pohodě) – viz „Příprava a nastavení na straně Pohody“.
    (NastaveníIntegraceSpecifický formát Pohoda
  3. (Volitelně) Vytvořte si nákladová střediska shodně s tím, jaký máte nastavený seznam nákladových středisek v Pohodě. 
    (NastaveníVýdajeNákladová střediska)
  4. (Volitelně) Vytvořte si seznam Členění DPH shodně s tím, jaký máte nastavený seznam Členění DPH v Pohodě. 
    (NastaveníVýdajeČlenění DPH)
  5. (Volitelně) Vytvořte si seznam Předkontací shodně s tím, jaký máte nastavený seznam Předkontací v Pohodě. 
    (NastaveníVýdajePředkontace)
  6. (Volitelně) Vytvořte si seznam Projektů shodně s tím, jaký máte nastavený seznam Zakázek v Pohodě.
    (NastaveníProjekty

Příprava a nastavení na straně Pohody

V aplikaci Pohoda je potřeba zkontrolovat případně nastavit zejména následující oblasti: 

  •  Přidat (či zvolit existující) číselnou řadu pro Závazky 
  • Přidat (či zvolit existující) číselnou řadu pro Faktury Přijaté
  1. Z menu „Nastavení“ jděte na „Seznamy“ a dále na „Číselné řady“. 


  2. V definici číselných řad zvolte agendu číselných řad pro „Ostatní Závazky“. Zde vytvořte novou číselnou řadu pro Ostatní závazky z Fidoo. V rámci čísla si zvolte prefix a počet číslic dané řady a dále zvolte Název číselné řády. Zvolený prefix číselné řady Ostatních závazků vložte také do Fidoo do nastavení integrace na Pohodu, do části „Výdaje“. (Viz Příprava a nastavení na straně Fidoo). Vytvořený záznam uložte.

  3. Dále zvolte agendu číselných řad pro „Přijaté faktury„. Zde vytvořte novou číselnou řadu pro Přijaté faktury z Fidoo. V rámci čísla si zvolte prefix a počet číslic dané řady a dále zvolte Název číselné řády. Zvolený prefix číselné řady Přijatých faktur vložte také do Fidoo do nastavení integrace na Pohodu, do části „Výdaje“. (Viz Příprava a nastavení na straně Fidoo). Vytvořený záznam uložte. 


    Nyní jsou nastavení potřebná pro import výdajů z Fidoo do závazků a faktur přijatých v Pohodě připravena. 

Export z Fidoo

Exportovat Výdaje lze ve Fidoo na dvou místech. 
1. Nad jakýmkoliv seznamem výdajů (např. Firemní Finance – Výdaje).
2. V účetní agendě v části „Export výdaje“.

Rozdíl je v tom, že v účetní agendě se při exportu aplikují kontroly zamezující vyexportovat výdaje duplicitně a karetní výdaje, které nemají svou karetní transakci ještě zúčtovanou. Nad běžným seznamem výdajů kdekoliv v aplikaci se žádné kontroly neaplikují a lze tak vyexportovat libovolnou skupinu výdajů dle preferencí nastavených ve filtru.

Export z Fidoo nad seznamem výdajů 

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

  3. Nad vyfiltrovaným seznamem Výdajů zvolte volbu „Export“ 
    (Firemní Finance / Týmové Finance / Moje FinanceVýdaje).

  4. Vyberte Specifický exportní formát Pohoda, zvolte si, zda chcete společně s datovým exportním souborem vyexportovat i naskenované obrázky účtenek a výběr potvrďte zeleným tlačítkem „Exportovat“. 
    (Firemní Finance / Týmové Finance / Moje FinanceVýdaje).

     

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 výdaje, 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 výdajů„. 
  2. Zvolte Nový export. Pomocí filtru si můžete omezit seznam výdajů, které budete exportovat. 
    Výchozí hodnoty filtru jsou zde nastaveny tak, aby výběr obsahoval všechny výdaje, které už jsou připraveny k exportu a ještě před tím nebyly exportovány (Doporučujeme neměnit). 
    Zkontrolujte počet výdajů, které se chystáte vyexportovat a exportovací 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 výdajů ve všech dostupných / aktivních exportních formátech, které máte k dispozici včetně scanů účetních dokladů. 
    Z balíku si rozbalte soubor s formátem dat pro Pohodu a uložte si ho na disk počítače, kde ho později budete schopni najít.


    Export výdajů je hotov.

Import do Pohody

  1. horním menu „Soubor“ zvolte položku „Datová komunikace a dále XML import/export„.  


  2. Nejprve označíme Exportní soubor z Fidoo jako „Vstupní soubor“ pro Import do Pohody. Hledání souboru zahájíme tlačítkem se třemi tečkami. 


  3. Vyhledejte si Exportní soubor, který jste si předtím vyexportovali z Fidoo a uložili k sobě do počítače (Viz sekce „Export z Fidoo„). Výběr potvrďte tlačítkem „Otevřít“. 


  4. Zkontrolujeme si, že umístění pro výstupní zprávu je nazvané jinak než vstupní soubor (aby se vstupní soubor výstupní zprávou nepřepsal) a potvrdíme tlačítkem „Další“. 


  5. Zvolíme, co se má stát s importním souborem po dokončení importu a zahájíme import tlačítkem Dokončit. Tím se spustí import výdajů z Fidoo do Přijatých faktur a Ostatních závazků v Pohodě.


  6. Po dokončení importu se nám zobrazí výsledná zpráva o tom, jak import dopadl. Potvrdíme tlačítkem „Dokončit“.


  7. Import Ostatních závazků z výdajů ve Fidoo do Pohody je dokončen a v sekci Ostatní závazky jsou všechny naimportované závazky vidět.




  8. Zároveň je dokončen i import Přijatých faktur z výdajů ve Fidoo a v sekci Přijaté faktury jsou vidět i všechny naimportované Přijaté Faktury.




    Import výdajů z Fidoo do Ostatních závazků a Přijatých Faktur v Pohodě je hotov.