Účetní výkazy přes API - věcný obsah
Tato funkcionalita je dostupná pouze v rámci služby ABRA předplatné.
Účetní výkazy přes API jsou dostupné od verze
V této kapitole je uveden popis následujících témat týkajících se pořizování účetních výkazů:
Doplněk ABRA Účetní výkazy umožňuje načítat účetní data ze systému ABRA Flores přímo do Microsoft Excelu prostřednictvím API. Jde o alternativu původního řešení využívajícího OLE a makra VBA. Doplněk se instaluje z Microsoft Marketplace a nevyžaduje registraci knihovny ani povolená makra.
Do adresáře s instalací produktu ABRA Aiva byla přidána šablona NxDefVykPodnik2021API.xlsx pro podnikatele jako náhrada za NxDefVykPodnik2021.xlsx. Šablona používá funkce doplňku ABRA Účetní výkazy. Doplněk lze používat v desktopovém Excelu i v Excelu na webu s podporou doplňků Office.
Doplněk se aktualizuje automaticky při dalším otevření panelu. Šablona výkazů a serverová část se aktualizují s verzí systému ABRA Flores. Vlastní upravené sešity se tím automaticky nezmění.
-
Vytvořte si vlastní kopii šablony NxDefVykPodnik2021API.xlsx, která se nachází v kořenové složce instalace ABRA Flores, a kopii otevřete. Před prvním načtením dat upravte definice účtů v šabloně podle účtového rozvrhu své firmy.
-
Otevře se MS Excel. Na záložce Domů klikněte v horním panelu na Doplňky a následně dole na Další doplňky.

Otevře se Microsoft Office Marketplace. -
Vyhledejte doplněk s názvem ABRA Účetní výkazy, vyberte doplněk a klikněte na Přidat.
-
Otevřete postranní panel doplňku kliknutím na nově přidanou ikonu ABRA doplňku.
-
Vyplňte API URL včetně názvu spojení, své uživatelské jméno a heslo. Doplněk se přihlašuje prostřednictvím systémové definice JWT s druhem aplikace Doplňkové aplikace systému ABRA, kterou zakládá aktualizace databáze. Kód definice se v doplňku nezadává. Před přihlášením musí správce připravit API server a nastavit licenci a přístup uživatele.
-
Klikněte na Přihlásit se. Po úspěšném přihlášení panel zobrazí stav Připojeno.
Po přihlášení mohou funkce doplňku načítat data ze systému ABRA Flores. Před jejich aktualizací nastavte zdaňovací období a další údaje na listu EPO.
Nastavení zdaňovacího období
Pokud používáte systémovou šablonu NxDefVykPodnik2021API.xlsx, upravte před aktualizací dat první list sešitu EPO. Nastavte na něm začátek a konec zdaňovacího období, typ daňového přiznání, rozsah údajů ve výkazech a datum, ke kterému se údaje ve výkazech uvádějí. Pro rozsah údajů lze zvolit plný, zjednodušený nebo mikro rozsah. Nastavení ovlivňuje načtené hodnoty a určuje, které listy se zahrnou do výsledného souboru XML.
Volba Započítat i účetní žádosti v buňce D42 platí pro celý sešit. Výchozí hodnota Ne zahrnuje pouze zaúčtované zápisy. Hodnota Ano zahrne také účetní žádosti. Do počátečních stavů účetního období žádosti nevstupují ani při zapnuté volbě.
Doplněk si heslo neukládá. Po přihlášení používá přístupový a obnovovací token a platnost přihlášení průběžně obnovuje. Pokud přihlášení skončí, zadejte heslo a přihlaste se znovu.
Přihlášení je společné pro sešity otevřené v Excelu. Změna uživatele nebo adresy API v jednom sešitu se proto projeví i v ostatních. Funkcí Odhlásit se ukončíte používání uloženého přihlášení ve všech těchto sešitech. Funkce Ověřit znovu ověří platnost uloženého přihlášení, například po dočasném výpadku spojení.
Funkce Aktualizovat vše načte aktuální data do celého sešitu. Použijte ji po změně období, definic účtů nebo nastavení započtení účetních žádostí a také po změně dat v účetnictví. Tlačítko je dostupné po ověření přihlášení. Během aktualizace panel ukazuje průběh a tlačítkem Zastavit lze aktualizaci přerušit.
Pokud některé buňky skončí chybou, doplněk zobrazí jejich počet. Funkcí Zobrazit detail otevřete přehled příčin a dotčených buněk. Pomocí Kopírovat detail můžete údaje předat správci. Výkaz s chybovými buňkami nepoužívejte. Postup řešení popisuje část Časté chyby.
U rozsáhlého sešitu může aktualizace trvat několik minut. Při krátkém výpadku sítě nebo dočasné nedostupnosti serveru doplněk požadavek zkusí jednou zopakovat. Pokud výpočet přestane postupovat, panel na to upozorní. Po odstranění příčiny spusťte Aktualizovat vše znovu.
Po přepočtu zkontrolujte kontrolní řádky rozvahy a výsledovky a porovnejte výkazy s předvahou za stejné období a se stejným započtením účetních žádostí. Rozdíl pouze v částkách zaokrouhlených na tisíce lze vyrovnat korekcí podle listu Vysvětlení pojmu korekce. Nenulový rozdíl ve sloupcích Přesně na haléře je potřeba vyřešit kontrolou definic účtů a načtených dat.
HTTPS
Pro správné fungování doplňku je nutné, aby ABRA Web API server komunikoval prostřednictvím protokolu HTTPS. Doplněk využívá zabezpečené spojení pro veškerou komunikaci s API a bez platného HTTPS certifikátu nebude fungovat.
Pokud server zatím nemá nastavené HTTPS, musí jej nakonfigurovat správce IT nebo konzultant. Konfigurace HTTPS je popsána v kapitole Nastavení Web API.
Povolení CORS
ABRA Web API server musí mít v nastavení CORS (Cross-Origin Resource Sharing) povolenou adresu, ze které je doplněk hostován:
https://vykazy-addin.abra.software
Bez tohoto nastavení bude prohlížeč blokovat požadavky doplňku na API server a doplněk nebude schopen komunikovat se systémem ABRA. Nastavení CORS se provádí v sekci server konfiguračního souboru APIServer.yaml. Pokud používáte vlastní seznam allowedOrigins, doplňte do něj adresu doplňku a zachovejte i ostatní potřebné adresy. Pokud položka není nastavená, výchozí hodnota *.abra.software adresu doplňku povoluje.
server:
allowedOrigins:
- "https://vykazy-addin.abra.software"
Po změně tohoto nastavení restartujte API server.
Pro uživatele, který bude účetní výkazy přes API používat, je potřeba specifické nastavení práv. Nejjednodušší je přiřadit mu roli se zkratkou ExcelMin, kterou v systému zakládá aktualizace databáze. Role obsahuje všechna práva k funkcím i k definici JWT, která doplněk potřebuje, a nic navíc. Níže uvádíme, co role obsahuje a co je potřeba nastavit mimo ni.
Licence a povolení aplikace
Doplněk je dostupný pro předplatné, tj. produkt ABRA Aiva. Připojuje se jako samostatně licencovaná aplikace a nečerpá běžný uživatelský API přístup. Aplikace však musí být součástí licence a uživatel ji musí mít povolenou na spojení, ze kterého bude načítat data. Identifikace aplikace v licenci je ABRA_APPS_EXCEL_ACCSTATEMENTS.
-
V agendě Uživatelé na záložce Aplikace povolte uživateli aplikaci doplňku účetních výkazů funkcí Povolit aplikaci. Samotné přidělení licence nenahrazuje povolení aplikace na spojení.
-
Uživateli přiřaďte roli AbraAppsMinimum, která povoluje rozhraní potřebné pro používání aplikací. Při povolení první aplikace systém nabídne její připojení. Pokud už má uživatel přístup k API povolený jiným způsobem, další povolení rozhraní nepotřebuje.
-
Přiřaďte také roli ExcelMin s potřebnými právy k funkcím a systémové definici JWT. Samotné přiřazení rolí nenahrazuje povolení aplikace ani její licenci.
Doplněk nepodporuje vícefaktorové ověření. Pokud uživatel musí při přístupu přes Web API použít MFA, do doplňku se nepřihlásí. Nastavení pravidel ověření musí v takovém případě posoudit správce systému.
- Definice JWT - doplněk se přihlašuje prostřednictvím systémové definice s druhem aplikace Doplňkové aplikace systému ABRA a potřebuje k ní právo Použít. Definici zakládá aktualizace databáze a role ExcelMin toto právo obsahuje.
- Střediska, Řady a Účetní řady - nastavte pouze tehdy, pokud jsou tyto chráněné objekty ve vaší instalaci omezené. Role ExcelMin je nenastavuje. Záznamy, ke kterým uživatel nemá přístup, se do výkazů nezapočtou. Výkaz proto může být neúplný i bez chybové zprávy.
- API funkce: Zdroje pro funkce v MS Excelu: Vykonat
- API funkce: Aktuální uživatel: Vystavit přihlašovací token, Obnovit přihlašovací token
- API funkce: Dotaz na BO: Vykonat
- Nastavení: Firemní údaje: Spustit
- Kódy NACE: Spustit
- Účetnictví: Účetní deník: Spustit
Všechna tato práva obsahuje role ExcelMin.
Doplněk umí z aktuálně otevřeného sešitu připravit XML soubor určený pro načtení do portálu EPO. Export je připravený pro systémovou šablonu NxDefVykPodnik2021API.xlsx, která obsahuje potřebné listy, výpočty a technické značky pro sestavení XML.
Export spustíte v postranním panelu doplňku v části XML pro portál EPO tlačítkem Uložit XML pro EPO.
Export uloží hodnoty, které jsou v sešitu právě vypočtené, sešit sám nepřepočítává. Před exportem proto spusťte Aktualizovat vše a zkontrolujte výkazy. Pokud některá exportovaná částka nebo údaj v hlavičce obsahuje chybu, export se nedokončí a doplněk uvede dotčené údaje. Chybné hodnoty se nenahrazují nulou.
Soubor se ukládá v kódování UTF-8. Částky se zaokrouhlují na celé jednotky výkazu, u listů v tisících tedy na celé tisíce Kč, stejně jako v šabloně. Soubor vzniká z údajů v sešitu a doplněk jej na portál EPO neodesílá.
XML se sestavuje z údajů v aktuálním sešitu:
| List v sešitu | Co se z něj použije |
|---|---|
| EPO | Základní údaje pro přiznání, například zdaňovací období, typ přiznání, údaje poplatníka, adresa, kontakt a oprávněná osoba. |
| ROZP-tisíce/ROZZ-tisíce/ROZM-tisíce | Řádky aktiv a pasiv včetně částek za aktuální a minulé období. |
| ZZP_druh-tisíce/ZZZ_druh-tisíce | Řádky výsledovky v druhovém členění. |
| ZZP_účel-tisíce/ZZZ_účel-tisíce | Řádky výsledovky v účelovém členění. |
Konkrétní list rozvahy a výsledovky se vybírá podle nastavení na listu `EPO`. Rozsah účetní závěrky určuje, zda se použije plný, zkrácený nebo mikro výkaz. Typ výsledovky určuje, zda se do XML zapíše druhové nebo účelové členění. Hodnoty ve výkazech se do šablony načítají pomocí funkcí doplňku z ABRA Web API. Proto je před uložením XML důležité spustit `Aktualizovat vše` a zkontrolovat, že v buňkách nejsou chyby.
Technické značky v šabloně
Šablona obsahuje skryté technické sloupce se značkami <def>. Tyto značky nejsou určeny pro běžné vyplňování. Slouží doplňku jako orientační body, podle kterých pozná, kde v sešitu najde údaje pro XML.
Na listu `EPO` značky určují, odkud se má vzít konkrétní údaj, například začátek období, konec období, DIČ nebo název poplatníka. Na listech rozvahy a výsledovky určují začátek a konec částí výkazu a sloupce s částkami.
Značky jsou vázané i na konkrétní listy. Stejná značka může mít jiný význam podle toho, zda je na listu rozvahy nebo výsledovky. Technické skryté sloupce, značky `<def>` a názvy listů doporučujeme ponechat beze změny.
Pracujte ve vlastní kopii šablony. Soubor v instalační složce může být při aktualizaci systému nahrazen. Dodávané definice účtů jsou předpřipravené a je potřeba je přizpůsobit účtovému rozvrhu firmy.
Definice upravujte na listech bez přípony -tisíce. Listy v tisících a anglické listy je přebírají odkazem. Na listech rozvahy jsou definice ve sloupcích K (brutto běžného období), L (oprávky a opravné položky) a M (minulé období). Na listech výsledovky se upravují sloupce K a L.
Zástupné definice zakončené AÚ, například 50AÚ nebo 221AÚ, nahraďte odpovídajícími analytickými účty. Dokud je neupravíte, nemusí řádky vracet žádnou částku. Zkontrolujte také vlastní vzorce, které mají masku účtů zapsanou přímo místo odkazu na buňku.
Zachovejte názvy listů a skryté technické značky <def> používané pro export. Na listu EPO nepřesouvejte ani neodstraňujte technické sloupce a nevkládejte řádky nebo sloupce. Změna těchto částí může znemožnit správné sestavení XML.
Při přechodu ze staré šablony využívající OLE převezměte upravené definice účtů do odpovídajících sloupců nové šablony. Zkontrolujte zápis masek, zejména umístění značek, a vlastní vzorce přepište na odpovídající funkce doplňku. Původní funkce NxGetBalance, NxGetBeginning a NxGetTurnover zde nahrazují ABRA.GET_BALANCE, ABRA.GET_BEGINNING a ABRA.GET_TURNOVER s datem nebo rozsahem dat namísto čísla intervalu.
Pokud mají výkazy zahrnout jen zadaná střediska, nastavte poslední parametr divisionsWithChildren na Ne. Při jeho vynechání se zahrnou i podřízená střediska. Po přepočtu porovnejte výsledky obou řešení za stejné období a se stejným započtením žádostí. Ověřte také masky kombinující znaménko minus a filtr < nebo >, protože doplněk znaménko minus uplatní i po výběru výsledků filtrem.
Datum lze zadat jako datum v Excelu, odkaz na buňku s datem nebo text ve tvaru 2026-12-31 či 31.12.2026. Přepínače includeRequests a divisionsWithChildren přijímají hodnoty Ano, Ne, TRUE, FALSE, 1 a 0 bez ohledu na velikost písmen. Jiná hodnota vyvolá chybu. Nevyplněné započtení žádostí znamená Ne, nevyplněné zahrnutí podřízených středisek znamená Ano.
Funkce doplňku při vynechání verze masky používají verzi 2. Přímé volání API má výchozí verzi 1. Podrobnosti k přímým požadavkům naleznete v kapitole API zdroje pro funkce v MS Excelu.
Vrátí obrat za zadané období včetně počátečního i koncového dne, bez počátečních stavů. Využívá API endpoint /bookentries/turnover.
Syntaxe
=ABRA.GET_TURNOVER(dateFrom;dateTo;accounts;[firms];[divisions];[includeRequests];[version];[divisionsWithChildren])
Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| dateFrom | Ano | Počáteční datum období. |
| dateTo | Ano | Koncové datum období. |
| accounts | Ano | Účet nebo účetní výraz. Podrobná syntaxe je popsána níže u této funkce. |
| firms | Ne | Kódy firem. Lze zadat více hodnot oddělených čárkou, středníkem nebo oblastí buněk. |
| divisions | Ne | Kódy středisek. Započtení podřízených středisek určuje parametr divisionsWithChildren. |
| includeRequests | Ne | Pokud je TRUE, zahrnou se i účetní žádosti. |
| version | Ne | Verze zápisu masky účtů: 1 nebo 2. Při vynechání nebo prázdné hodnotě se použije 2. |
| divisionsWithChildren | Ne | Zahrnout podřízená střediska. Výchozí hodnota je Ano. Hodnotou Ne omezíte výpočet pouze na zadaná střediska. Bez vyplněného parametru divisions se nepoužije. |
Poznámky
- Pokud je accounts prázdný, funkce vrátí 0.
- Pokud dateFrom vypadá jako nevyplněná volba nebo krátký neplatný text, funkce vrátí 0.
- Parametr firms je dostupný jen zde, nikoli u ABRA.GET_BALANCE a ABRA.GET_BEGINNING.
Parametr accounts
Parametr accounts určuje účet nebo kombinaci účtů, pro které se má obrat spočítat. Každý účet ve výrazu může mít prefix a postfix. Zadává se kód účtu z agendy Účtový rozvrh.
Prefixy
| Prefix | Význam |
|---|---|
| + | Explicitní přičtení výrazu. |
| - | Odečtení výrazu od celku. |
Postfixy
| Postfix | Význam |
|---|---|
| MD | Jen strana Má dáti ve version=1. |
| D | Jen strana Dal ve version=1. |
| d | Jen debitní strana ve version=2. |
| c | Jen kreditní strana ve version=2. |
| > | Jen kladný výsledek daného dílčího výrazu. |
| < | Jen záporný výsledek daného dílčího výrazu. |
| s | Jen krátkodobé částky. |
| ns | Jen dlouhodobé částky. |
| t | Jen daňové částky. |
| nt | Jen nedaňové částky. |
Maska účtů se skládá z členů oddělených čárkou nebo středníkem. Lze zadat také oblast buněk. Výsledky členů se sečtou. Kratší kód účtu zahrne všechny účty, které jím začínají, desetiznakový kód určuje přesný účet.
Znaménko + nebo - patří pouze na začátek členu. Značky strany, znaménkový filtr a příznak rozsahu patří za kód účtu. V jednom členu lze použít jen jeden příznak rozsahu s, ns, t nebo nt. Kód účtu může mít nejvýše deset znaků a nesmí obsahovat mezery.
Ve verzi 2 například maska 311dc znamená součet stran Má dáti a Dal. Rozdíl obou stran se zapíše 311d,-311c. Ve verzi 1 se součet zapisuje 311MDD. Bez značky strany se výsledek počítá podle povahy účtu: u pasivních a výnosových účtů Dal minus Má dáti, u ostatních Má dáti minus Dal.
Chybně zapsaná maska, například 3-12900, 31>2900 nebo 312900st, vrátí chybu s popisem příčiny. Značka strany uvnitř kódu se považuje za součást kódu účtu. Například 31d2900 hledá účet tohoto názvu. Značky pro hlavní a vedlejší činnost m a a doplněk nepodporuje.
Parametr version
| Hodnota | Význam |
|---|---|
| prázdné | Stejné chování jako 2. |
| 1 | Legacy interpretace stran účtu: MD = Má dáti, D = Dal. |
| 2 | Moderní interpretace stran účtu: d = debit, c = credit. |
Doplňkové informace
- Ve verzi 2 značí d stranu Má dáti a c stranu Dal. Ve verzi 1 se používají značky MD a D. Velikost písmen značek nerozhoduje. Malé d proto ve verzi 1 označuje stranu Dal.
- Po použití znaménkového filtru < nebo > vrací obrat ve verzi 2 velikost dílčího výsledku bez znaménka. Ve verzi 1 znaménko zachová. Zůstatek a počáteční stav vracejí při tomto filtrování velikost bez znaménka v obou verzích. Případné znaménko minus před členem se uplatní až potom.
- Příznaky rozsahu s, ns, t a nt mají v obou verzích stejný význam.
- Jiná hodnota parametru version než 1 nebo 2 vrátí do buňky chybu s vysvětlením.
Jednoduchý obrat za účet:
=ABRA.GET_TURNOVER("2024-01-01";"2024-12-31";"221")
Obrat za více účtových výrazů:
=ABRA.GET_TURNOVER("2024-01-01";"2024-12-31";"221MD,-221D,+343t";"";"100";TRUE;1)
Moderní značení stran ve verzi 2:
=ABRA.GET_TURNOVER("2024-01-01";"2024-12-31";"221d,-221c,+343nt";"";"100";TRUE;2)
Vrátí zůstatek na konci zadaného dne včetně pohybů tohoto dne. Výpočet probíhá v účetním období, do kterého zadaný den spadá. Využívá API endpoint /utils/balance.
Syntaxe
=ABRA.GET_BALANCE(dateTo;accounts;[divisions];[includeRequests];[version];[divisionsWithChildren])
Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| dateTo | Ano | Datum, ke kterému se má zůstatek spočítat. |
| accounts | Ano | Účet nebo účetní výraz. Používá stejnou syntaxi jako u ABRA.GET_TURNOVER. |
| divisions | Ne | Kódy středisek. Započtení podřízených středisek určuje parametr divisionsWithChildren. |
| includeRequests | Ne | Pokud je TRUE, zahrnou se i účetní žádosti. |
| version | Ne | Verze zápisu masky účtů: 1 nebo 2. Při vynechání nebo prázdné hodnotě se použije 2. |
| divisionsWithChildren | Ne | Zahrnout podřízená střediska. Výchozí hodnota je Ano. Hodnotou Ne omezíte výpočet pouze na zadaná střediska. Bez vyplněného parametru divisions se nepoužije. |
Poznámky
- Oproti ABRA.GET_TURNOVER zde není parametr firms.
- Při použití postfixů > nebo < se po filtraci vrací absolutní hodnota dílčího výsledku.
- Pokud je accounts prázdný, funkce vrátí 0.
Jednoduchý zůstatek:
=ABRA.GET_BALANCE("2024-12-31";"321")
Zůstatek za středisko včetně podřízených středisek:
=ABRA.GET_BALANCE("2024-12-31";"321";"100";TRUE;1)
Zůstatek pouze za středisko 100, bez účetních žádostí a podřízených středisek:
=ABRA.GET_BALANCE("2026-12-31";"311";"100";FALSE;2;FALSE)
Součet obou stran účtů začínajících kódem 311:
=ABRA.GET_BALANCE("2026-12-31";"311dc";"";FALSE;2)
Moderní značení stran a řetězení postfixů:
=ABRA.GET_BALANCE("2024-12-31";"321d,-321c,+343t,-501nt";"100";TRUE;2)
Vrátí stav účtů na začátku zadaného dne, bez pohybů uskutečněných během tohoto dne. Výpočet probíhá v účetním období, do kterého zadaný den spadá. Pro první den účetního období proto vrací počáteční stavy tohoto období. Využívá API endpoint /utils/beginning.
Syntaxe
=ABRA.GET_BEGINNING(date;accounts;[divisions];[includeRequests];[version];[divisionsWithChildren])
Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| date | Ano | Den, k jehož začátku se stav počítá. Do API se předává jako parametr date. |
| accounts | Ano | Účet nebo účetní výraz. Používá stejnou syntaxi jako u ABRA.GET_TURNOVER. |
| divisions | Ne | Kódy středisek. Započtení podřízených středisek určuje parametr divisionsWithChildren. |
| includeRequests | Ne | Pokud je TRUE, zahrnou se i účetní žádosti. |
| version | Ne | Verze zápisu masky účtů: 1 nebo 2. Při vynechání nebo prázdné hodnotě se použije 2. |
| divisionsWithChildren | Ne | Zahrnout podřízená střediska. Výchozí hodnota je Ano. Hodnotou Ne omezíte výpočet pouze na zadaná střediska. Bez vyplněného parametru divisions se nepoužije. |
=ABRA.GET_BEGINNING("2026-01-01";"321";"100";FALSE;2)
Vrátí hlavní telefon z objektu střediska, konkrétně z SiteData a z adresy navázané na středisko (Address_ID.PhoneNumber1).
Syntaxe
=ABRA.GET_EPO_PHONE([site])
Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| site | Ne | Kód střediska. Pokud není zadán, použije se 01. Pokud předáte oblast buněk nebo seznam, použije se jen první hodnota. |
=ABRA.GET_EPO_PHONE("01")
Vrátí název ulice bez čísla domu z objektu střediska, konkrétně z SiteData a z adresy navázané na středisko.
Syntaxe
=ABRA.GET_EPO_STREET([site])
Parametry
Stejné jako u funkce ABRA.GET_EPO_PHONE.
Vrátí číslo domu z objektu střediska, konkrétně z SiteData a z adresy navázané na středisko.
Syntaxe
=ABRA.GET_EPO_STREET_NUMBER([site])
Parametry
Stejné jako u funkce ABRA.GET_EPO_PHONE.
Vrátí město z objektu střediska, konkrétně z SiteData a z adresy navázané na středisko.
Syntaxe
=ABRA.GET_EPO_CITY([site])
Parametry
Stejné jako u funkce ABRA.GET_EPO_PHONE.
Vrátí PSČ z objektu střediska, konkrétně z SiteData a z adresy navázané na středisko.
Syntaxe
=ABRA.GET_EPO_POSTCODE([site])
Parametry
Stejné jako u funkce ABRA.GET_EPO_PHONE.
Vrátí kód státu z objektu střediska, konkrétně z SiteData a z adresy navázané na středisko.
Syntaxe
=ABRA.GET_EPO_COUNTRY_CODE([site])
Parametry
Stejné jako u funkce ABRA.GET_EPO_PHONE.
Vrátí e-mail z objektu střediska, konkrétně z SiteData a z adresy navázané na středisko.
Syntaxe
=ABRA.GET_EPO_EMAIL([site])
Parametry
Stejné jako u funkce ABRA.GET_EPO_PHONE.
Vrátí DIČ účetní jednotky z globálních dat.
Syntaxe
=ABRA.GET_VAT_IDENT_NUMBER()
Vrátí právní formu účetní jednotky z globálních dat.
Syntaxe
=ABRA.GET_LEGAL_FORM()
Vrátí hlavní předmět podnikání z globálních dat.
Syntaxe
=ABRA.GET_SUBJECT_OF_ENTERPRISE()
Vrátí název poplatníka nebo firmy z globálních dat.
Syntaxe
=ABRA.GET_TAXPAYER_NAME()
Vrátí název hlavního CZ-NACE z globálních dat.
Syntaxe
=ABRA.GET_MAIN_NACE_NAME()
Vrátí kód hlavního CZ-NACE z globálních dat.
Syntaxe
=ABRA.GET_MAIN_NACE_CODE()
Bezpečné dělení dvou hodnot.
Syntaxe
=ABRA.DIVIDING(dividend;divider)
Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| dividend | Ano | Dělenec. |
| divider | Ano | Dělitel. |
=ABRA.DIVIDING(100;4)
Pokud doplněk zobrazí chybovou zprávu, podrobnosti o příčině zobrazíte tlačítkem Zobrazit detail.
Chyba: Buňka nenačetla správně data - obsahuje ERROR.
Text začínající ERROR: znamená, že se hodnotu nepodařilo získat nebo vypočítat. Příčinou může být přihlášení, licence, oprávnění, chybná maska účtů nebo argument funkce i nedostupný server. Podle textu chyby opravte příčinu a spusťte Aktualizovat vše.
Nepovolená aplikace nebo chybějící licence aplikace
Správce musí ověřit, že licence obsahuje aplikaci ABRA_APPS_EXCEL_ACCSTATEMENTS a uživatel ji má povolenou na aktuálním spojení. Při vyčerpání počtu licencí je potřeba licenci rozšířit nebo odebrat přístup uživatelům, kteří aplikaci nepotřebují. Podrobnosti viz Potřebná práva pro provoz.
Povinné vícefaktorové ověření pro Web API
Doplněk nepodporuje zadání druhého faktoru. Nastavení pravidel MFA pro daného uživatele musí posoudit správce.
Neplatný účetní výraz, verze nebo hodnota přepínače
Zkontrolujte zápis masky účtů, datum ve vzorci a existenci zadaného střediska. Verze musí být 1 nebo 2. Přepínače přijímají hodnoty Ano, Ne, TRUE, FALSE, 1 a 0.
Export XML selhal
Pokud hlášení uvádí nečíselné částky nebo chyby v hlavičce, opravte uvedené buňky a znovu načtěte data. Chybí-li list nebo technické značky, obnovte je podle dodávané šablony. Podrobnosti viz XML export pro portál EPO.
Výkaz je nulový nebo neúplný bez chybové zprávy
Zkontrolujte definice účtů, zejména zástupné hodnoty s AÚ, práva ke střediskům, řadám a účetním řadám a nastavení započtení účetních žádostí. Pro porovnání s předvahou musí být období i započtení žádostí stejné.
Chyba: V panelu doplňku nejde přihlášení - Network/CORS/SSL error.
Pokud při pokusu o přihlášení dostáváte chybovou hlášku obsahující Network/CORS/SSL error, tak zkontrolujte že:
-
API server běží na zadané adrese
-
API server má nastavenou komunikaci přes HTTPS
-
API server má správně přidanou adresu doplňku "https://vykazy-addin.abra.software" v sekci allowedOrigins v APIServer.yaml
Chyba: Na serveru chybí definice JWT s druhem aplikace Doplňkové aplikace systému ABRA.
Systémová definice JWT potřebná pro přihlášení doplňku nebyla nalezena. Spusťte aktualizaci databáze, která tuto definici automaticky založí.
Stav: Přihlášení vypršelo.
Platnost přihlášení skončila a nelze ji dále obnovit. V panelu doplňku zadejte znovu heslo a přihlaste se.
ABRA Účetní výkazy add-in je doplněk pro Microsoft Excel poskytovaný společností ABRA Software s.r.o. Doplněk slouží k připojení sešitu Excel k ABRA Aiva přes ABRA API, k načítání účetních dat do buněk sešitu a k přípravě XML exportu účetních výkazů pro portál EPO.
Jaká data doplněk používá
Doplněk pracuje s údaji, které uživatel zadá v panelu doplňku nebo které jsou obsaženy v otevřeném sešitu Excel. Jedná se zejména o:
- URL adresu ABRA API serveru,
- uživatelské jméno pro připojení k ABRA Aiva
- přístupový a obnovovací token získaný z ABRA API,
- hodnoty z buněk sešitu potřebné pro výpočet účetních výkazů a XML export,
- parametry výpočtů, například období, účty, firmy, střediska a nastavení zahrnutí žádostí,
- údaje načtené z ABRA Aiva potřebné pro účetní výkazy a EPO export, například obraty, zůstatky, údaje účetní jednotky, adresní údaje střediska, DIČ, právní forma, název poplatníka nebo CZ-NACE.
Doplněk nevyžaduje přihlášení k samostatné službě ABRA Software. Připojuje se k ABRA API serveru, jehož adresu zadá uživatel nebo správce zákaznického prostředí.
Jaká data doplněk ukládá
Doplněk ukládá do lokálního úložiště Office doplňku tyto údaje:
- URL adresu ABRA API,
- uživatelské jméno,
- přístupový token pro ABRA API,
- obnovovací token pro ABRA API.
Heslo zadané při přihlášení se neukládá. Použije se pouze pro získání přístupového tokenu z ABRA API a po úspěšném přihlášení je odstraněno z formuláře doplňku.
Doplněk dále ukládá lokálně informaci o zvoleném jazyku uživatelského rozhraní a zobrazení úvodní obrazovky. Uložené přihlášení sdílejí sešity otevřené v Excelu. Odhlášení odstraní uložené tokeny, adresu API a uživatelské jméno ponechá pro další přihlášení.
Předávání dat
Doplněk odesílá údaje pouze na ABRA API server, který uživatel nastaví v doplňku. Při připojení odešle přihlašovací údaje na tento server za účelem získání přístupového tokenu. Při práci se sešitem následně odesílá na ABRA API pouze požadavky potřebné pro výpočty a načtení dat do účetních výkazů.
ABRA Účetní výkazy add-in sám neodesílá obsah sešitu, účetní výkazy ani vygenerované XML soubory na servery ABRA Software. XML export pro portál EPO se vytváří v prostředí Excelu a ukládá se do umístění zvoleného uživatelem.
Doplněk neobsahuje vlastní analytiku, marketingové sledování ani reklamní funkce.
Hosting doplňku
Soubory doplňku mohou být načítány z webového hostingu používaného společností ABRA Software. Při načtení doplňku může hostingová infrastruktura technicky zpracovat běžné provozní údaje nezbytné pro doručení webového obsahu, například IP adresu, čas požadavku, požadovanou URL adresu, typ prohlížeče nebo technické chybové záznamy. Tyto údaje nejsou používány funkcemi doplňku k profilování uživatele.
Účel zpracování
- navázání spojení mezi Excelem a ABRA Aiva,
- ověření přístupu uživatele k ABRA API,
- výpočtu účetních hodnot v sešitu,
- načtení údajů potřebných pro účetní výkazy,
- vytvoření XML exportu pro portál EPO,
- uložení nastavení připojení pro další použití doplňku.
Role zákazníka a ABRA Software
Účetní a osobní údaje uložené v ABRA Aiva spravuje zákazník ve svém prostředí. Doplněk funguje jako klientský nástroj, který na pokyn uživatele přistupuje k ABRA API a zobrazuje nebo zpracovává data v Excelu.
ABRA Software s.r.o. nezískává prostřednictvím běžného používání doplňku kopii zákaznických účetních dat, pokud je uživatel samostatně neposkytne například v rámci podpory, servisního požadavku nebo jiné smluvní komunikace.
Zabezpečení
Doplněk komunikuje s ABRA API přes adresu nastavenou uživatelem. Pro produkční používání musí být použito zabezpečené připojení HTTPS a důvěryhodný certifikát. Přístup k datům v ABRA Aiva se řídí oprávněními uživatele a nastavením ABRA API.
Uživatel nebo správce zákaznického prostředí odpovídá za správné nastavení ABRA API serveru, přístupových práv, CORS pravidel a certifikátů.
Uchování údajů
Údaje uložené lokálně doplňkem zůstávají v úložišti Office doplňku, dokud nejsou přepsány, odstraněny uživatelem, odstraněny správcem prostředí nebo smazány společně s daty aplikace Office/prohlížeče podle nastavení daného zařízení.
Účetní data načtená do sešitu Excel jsou součástí příslušného sešitu a jejich uchování se řídí tím, jak uživatel nebo organizace s tímto sešitem nakládá.
Práva subjektů údajů
Pokud při používání doplňku dochází ke zpracování osobních údajů obsažených v ABRA Aiva nebo v sešitu Excel, je primárním správcem těchto údajů zákazník, který dané prostředí ABRA Aiva používá.
Obecné informace o zpracování osobních údajů společností ABRA Software s.r.o. jsou uvedeny v zásadách ochrany soukromí společnosti ABRA Software s.r.o.