Přeskočit na hlavní obsah

Jak napojit ABRA Flexi na další aplikace?

Kdy sáhnout po hotovém můstku, kdy si napojení naprogramovat a které evidence budete přes REST API potřebovat.

Autor: Petr Pech

Chystáte se na ABRA Flexi napojit jinou aplikaci? Nejčastěji jde o e-shop, ale stejným způsobem se propojuje i skladový systém, expediční software, pokladna nebo CRM. Tento článek vysvětluje, jaké cesty k napojení existují, co si musíte zařídit předem a které evidence budete přes REST API potřebovat.

💡 Ve zkratce: ABRA Flexi má otevřené REST API, přes které ji napojíte prakticky na libovolný systém. Pro nejběžnější e-shopové platformy ale existují hotová řešení našich partnerů – programovat tedy nemusíte vždy.

Kudy na to

Napojení má tři podoby a liší se hlavně tím, kolik práce zůstane na vás. Následující tabulka vás nasměruje do správné části dokumentace.

Vaše situace

Řešení

Kde pokračovat

Mám běžnou e-shopovou platformu

Hotový můstek integračního partnera

Napojení libovolného e-shopu na ABRA Flexi a přehled doplňků

Napojuji e-shop a chci si napojení napsat sám

Vlastní vývoj nad REST API

Jak napojit e-shop na ABRA Flexi přes REST API

Napojuji sklad, expedici, pokladnu nebo CRM

Vlastní vývoj nad REST API

Tento článek a dokumentace REST API

Potřebuji z Flexi jen data pro reporting

Hotový konektor do BI nástroje

Power BI nebo Looker Studio

Jednorázově přecházím z jiného účetnictví

Migrace dat, ne integrace

Migrace dat z jiného systému do ABRA Flexi

Nechci programovat a hotové řešení neexistuje

Řešení na míru

Ozvěte se nám, doporučíme integračního partnera

Rozdíl mezi migrací a integrací se v praxi plete. Migrace je jednorázový převod dat při změně systému. Integrace je trvalé propojení dvou systémů, které si data předávají průběžně. Tento článek se věnuje integraci.

Než začnete

Následující čtyři věci si vyřešte dřív, než napíšete první řádek kódu nebo objednáte můstek. Ušetří vám to většinu problémů, se kterými se na nás zákazníci obracejí.

Přístup k API a API uživatel

API není automaticky součástí licence. Nejprve je potřeba mít k licenci aktivovanou službu Přístup k API. Po její aktivaci můžete zakládat neomezený počet API uživatelů – doporučujeme založit samostatného uživatele pro každé napojení a dát mu jen ta práva, která skutečně potřebuje. Podrobnosti popisuje licencování přístupu k API.

Pod přihlašovacími údaji API uživatele pak běží veškerá aktivita napojené aplikace, takže je v přehledu změn vždy poznat, který systém záznam založil nebo upravil. Postup založení najdete v článku API komunikace jednoduše pro ne-IT uživatele a v návodu jak pracovat s uživateli.

Adresa vaší instance

Externí aplikaci budete zadávat adresu serveru, port a identifikátor firmy. V cloudu má adresa tvar nazevfirmy.flexibee.eu, port je vždy 5434 a identifikátor firmy vyčtete z adresy webové aplikace za /c/. Provozujete-li Flexi na vlastním serveru, je adresou název nebo veřejná IP adresa serveru a port se může lišit podle jeho nastavení. Rozdíly mezi provozem v cloudu, nebo na vlastním serveru popisuje samostatný článek.

Denní limity požadavků

Počet požadavků na API je omezen denním limitem podle varianty licence:

Varianta licence

V ceně licence

Lze navýšit až na

Basic

5 000 požadavků / den

nelze navyšovat

Business

10 000 požadavků / den

200 000 požadavků / den

Premium

20 000 požadavků / den

200 000 požadavků / den

Kolik jste už vyčerpali, zkontrolujete ve webové aplikaci v agendě Licence a předplatné na záložce Využití API. Ceny za navýšení najdete v ceníku. Limit sledujte od začátku – nejsnáz ho vyčerpá špatně navržená synchronizace, která stahuje celý katalog každých pár minut.

Testovací firma

Nikdy nevyvíjejte a neladěte proti ostrým účetním datům. Vytvořte si testovací firmu ze zálohy ostré firmy a integraci zkoušejte na ní. Ukázkové dotazy z naší dokumentace si můžete vyzkoušet i na veřejné demo instanci demo.flexibee.eu.

🚨 Při extrémní zátěži provoz z naší strany omezujeme, aby neohrozil dostupnost účetnictví ostatním zákazníkům. Odblokování je pak potřeba řešit s podporou. Návrhu, který generuje lavinu paralelních dotazů, se proto vyhněte už při přípravě.

Jak data mezi systémy tečou

Některá data přenášíte z externí aplikace do Flexi, jiná naopak z Flexi ven. Do Flexi typicky putují objednávky, faktury a údaje o zákaznících, opačným směrem ceník a stavy skladu. Způsoby, jak přenos zařídit, jsou v zásadě tři a v praxi se nejlépe osvědčuje jejich kombinace.

Dávková synchronizace přenese data v pravidelném intervalu, obvykle jednou nebo několikrát denně. Je jednodušší na vytvoření, výrazně méně datově náročná a doporučujeme ji všude, kde běží účetnictví v cloudu.

Online dotazování znamená, že každá akce uživatele v externí aplikaci vyvolá dotaz do Flexi. Data jsou vždy aktuální, ale zátěž je vysoká – u provozu ve veřejném cloudu tuto variantu nedoporučujeme.

Oznamování změn je nejúspornější cesta. Potřebujete-li se v externí aplikaci dozvědět o změně dat ve Flexi, slouží k tomu webhooky – Flexi samo zavolá vaši adresu, jakmile se něco změní. Druhou možností je delta synchronizace řízená vaší stranou přes Changes API nebo pole lastUpdate.

ℹ️ Podrobné srovnání všech tří přístupů včetně jejich zátěže na API najdete v článku Jak napojit e-shop na ABRA Flexi přes REST API. Přestože je psaný pro e-shopy, úvahy o architektuře platí pro jakékoliv napojení.

Které evidence budete potřebovat

Data jsou ve Flexi uložená v evidencích (agendách) a každá z nich má svůj strojový název, který uvedete do adresy požadavku. Kompletní přehled najdete v evidence-listu v naší webové aplikaci.

O tom, jak takovou adresu poskládat, pojednává samostatný návod. Vědět byste měli také o podporovaných formátech; při čtení dat se vám bude hodit filtrace, úroveň detailu a stránkování.

Následující evidence pokrývají naprostou většinu běžných napojení:

Evidence

Endpoint

Co se přenáší

Typický směr

Přijaté objednávky

/objednavka-prijata

objednávky z e-shopu

do Flexi

Vydané faktury

/faktura-vydana

prodejní doklady

do Flexi

Adresář

/adresar

zákazníci a dodavatelé

oběma směry

Ceník

/cenik

katalog zboží a služeb

oběma směry

Individuální ceník

/odberatel, /dodavatel

prodejní a nákupní ceny pro konkrétní firmy

do Flexi

Skladové karty

/skladova-karta

stav skladu

z Flexi

Skladové pohyby

/skladovy-pohyb

příjemky a výdejky

oběma směry

Objednávky

Přenos objednávek z e-shopu do Flexi můžeme považovat za nejběžnější řešení z realizovaných napojení. Nejčastěji se přesouvají automaticky, buď vždy po jedné, nebo dávkově.

Endpoint: /objednavka-prijata
​Příklad URL: https://demo.flexibee.eu/c/demo/objednavka-prijata.json

Příklad requestu

<winstrom version="1.0">
    <objednavka-prijata>
        <id>code:OBP0080/2026</id>
        <datVyst>2026-06-16</datVyst>
        <sumCelkem>1000.0</sumCelkem>
        <sumCelkemMen>0.0</sumCelkemMen>
        <mena>code:CZK</mena>
        <firma>code:2776</firma>
        <popis></popis>
        <polozkyDokladu>
            <objednavka-prijata-polozka>
                <nazev>testovaci_polozka</nazev>
                <cenik>code:TEST</cenik>
                <sklad>code:PLZEŇ</sklad>
                <mnozMj>1.0</mnozMj>
                <cenaMj>300</cenaMj>
                <mena>code:CZK</mena>
            </objednavka-prijata-polozka>
        </polozkyDokladu>
    </objednavka-prijata>
</winstrom>

S přenosem objednávky ji lze rovnou realizovat, tedy z ní vytvořit výdejku nebo fakturu, nebo její položky objednat u dodavatele.

Faktury

Přenos faktur je druhým nejčastějším procesem. Pokud přenášíte pouze faktury, pravděpodobně vynecháváte přenos objednávek.

Endpoint: /faktura-vydana
​Příklad URL: https://demo.flexibee.eu/c/demo/faktura-vydana.json

Faktura ve výchozím stavu generuje skladový doklad, tedy výdejku. Nastavení je možné změnit v typu faktury.

Adresář

S objednávkou či fakturou, respektive s dokladem obecně, se nesou i informace o zákazníkovi. Ty se ukládají do adresáře. Do adresáře patří i všichni ostatní obchodní partneři, například dodavatelé.

Endpoint: /adresar
​Příklad URL: https://demo.flexibee.eu/c/demo/adresar.json

Příklad requestu

<winstrom version="1.0">
    <adresar>
        <id>code:ABRA</id>
        <nazev>ABRA Software a.s.</nazev>
        <ic>25097563</ic>
        <dic>CZ25097563</dic>
        <ulice>Jeremiášova 1422/7B</ulice>
        <mesto>Praha</mesto>
        <psc>155 00</psc>
        <stat>code:CZ</stat>
    </adresar>
</winstrom>

Záznam adresáře je možné založit společně s dokladem, tedy s objednávkou nebo fakturou, v jednom requestu.

Ceník

Potřebujete synchronizovat ceník, tedy produktový list, z Flexi nebo do Flexi? Pak hledáte evidenci ceník.

Endpoint: /cenik
​Příklad URL: https://demo.flexibee.eu/c/demo/cenik.json

Příklad requestu

<winstrom version="1.0">
    <cenik>
        <kod>TEST</kod>
        <nazev>testovaci_polozka</nazev>
        <cenaZakl>263.5</cenaZakl>
        <typCenyDphK>typCeny.bezDph</typCenyDphK>
        <typZasobyK>typZasoby.zbozi</typZasobyK>
        <typSzbDphK>typSzbDph.dphZakl</typSzbDphK>
        <skladove>true</skladove>
    </cenik>
</winstrom>

Na ceník se u skladových položek vážou skladové karty. Na nich je evidován stav skladu příslušných položek.

Individuální ceník

Do Flexi lze nahrát i ceník individuální. Ten může být vázán na různé firmy, skupiny firem či měny. Nahrávat můžeme individuální ceny nákupní a individuální ceny prodejní.

Endpoint prodejních cen: /odberatel
​Příklad URL: https://demo.flexibee.eu/c/demo/odberatele.json

Příklad requestu

<winstrom version="1.0">
    <odberatel>
        <prodejCena>0.5</prodejCena>
        <cenik>code:TEST</cenik>
        <firma>ABRA</firma>
        <mena>code:EUR</mena>
    </odberatel>
</winstrom>

Endpoint nákupních cen: /dodavatel
​Příklad URL: https://demo.flexibee.eu/c/demo/dodavatele.json

Příklad requestu

<winstrom version="1.0">
    <dodavatel>
        <cenik>code:TEST</cenik>
        <firma>code:DODAVATEL</firma>
        <nakupCena>200</nakupCena>
        <mena>code:CZK</mena>
    </dodavatel>
</winstrom>

Individuální ceny lze nastavit i přímo v aplikaci, k dispozici máme rovněž návod. Chcete-li místo jednotlivých cen číst výsledek celé cenotvorbu ve Flexi, použijte evidenci individuální ceník.

⚠️ Dotaz do individuálního ceníku je výpočetně náročný. Výsledek si na straně externí aplikace ukládejte do mezipaměti a aktualizaci pouštějte v době nízkého provozu.

Skladové karty

U skladových karet je, zejména v případě e-shopů, poměrně častým řešením získávání stavu skladu z Flexi.

Endpoint: /skladova-karta
​Příklad URL: https://demo.flexibee.eu/c/demo/skladova-karta.json

Do skladových karet import obvykle neprobíhá, naopak se z nich stav skladu získává. Skladové karty ve Flexi neovlivňují stav skladu, ten ovlivňují pouze skladové pohyby. Pokud potřebujete importem ovlivnit stav skladu, importujte skladové pohyby.

⚠️ Pro čtení aktuálního stavu skladu nepoužívejte evidenci stav-skladu-k-datu. Její volání je výpočetně náročné a aktuální stav skladu naleznete vždy na skladové kartě.

Skladové pohyby

Příjemka nebo výdejka, tedy doklad, který ovlivňuje stav skladu. Využijete je zejména při napojení skladových a expedičních systémů.

Endpoint: /skladovy-pohyb
​Příklad URL: https://demo.flexibee.eu/c/demo/skladovy-pohyb.json

Příklad requestu

<winstrom version="1.0">
    <skladovy-pohyb>
        <id>code:S-0093/2026</id>
        <datVyst>2026-08-09</datVyst>
        <sumCelkem>10000.0</sumCelkem>
        <mena>code:CZK</mena>
        <firma>code:ABRA</firma>
        <polozkyDokladu>
            <skladovy-pohyb-polozka>
                <nazev>testovaci_polozka</nazev>
                <cenik>code:TEST</cenik>
                <sklad>code:PLZEŇ</sklad>
                <mnozMj>1.0</mnozMj>
                <cenaMj>300</cenaMj>
                <mena>code:CZK</mena>
            </skladovy-pohyb-polozka>
        </polozkyDokladu>
    </skladovy-pohyb>
</winstrom>

Skladové pohyby obvykle vznikají přímo ve Flexi. Expediční a skladové systémy je však potřebují zakládat nebo o nich získávat informace.

To bylo vše ze základních evidencí, které využijete při napojení externí aplikace. Dostupných evidencí je přes API mnohem více – najdete je v kompletním evidence-listu, jejich pole vypíše sama aplikace, když za název evidence doplníte /properties.

Co přes REST API řešit nemusíte

Část toho, co zákazníci na začátku plánují napsat sami, už ve Flexi existuje jako hotová funkce. Než začnete programovat, projděte si tento seznam.

⚠️ Provozujete-li licenci v cloudu, API nepoužívejte k zálohování dat. K tomu určené není a zbytečně byste tím zatěžovali server – automaticky ukládané zálohy stahujte z webové aplikace.

Na co si dát pozor

Následující situace řešíme s integrátory nejčastěji. Vyhnete-li se jim, máte většinu problémů za sebou.

  • Používejte externí identifikátory. Bez nich založí opakovaně odeslaný požadavek duplicitní doklad. Oprava duplicitních faktur je po zaúčtování a odevzdání přiznání k DPH nepříjemná práce.

  • Pro načtení všech záznamů používejte limit=0, ne vysoké číslo typu limit=99999. Jednoho dne katalog tuto hranici přeroste a integrace začne tiše přenášet nekompletní data.

  • Vyplňujte jen pole, kterým rozumíte. Doklad má desítky polí, která na sebe navazují – nastavením něčeho „pro jistotu“ si můžete rozbít zaúčtování.

  • Nespouštějte lavinu paralelních dotazů. U náročnějších operací, jako je párování plateb nebo přepočet dokladů, vyčkejte na odpověď před odesláním dalšího požadavku.

  • Logujte odeslané požadavky i přijaté odpovědi. Při řešení problému s naší podporou zkrátí konkrétní požadavek a odpověď hledání příčiny o hodiny.

ℹ️ Kompletní doporučené postupy včetně tabulky všech chybových kódů najdete v článku Jak používat API?.

FAQ

Potřebuji pro napojení zvláštní licenci?

Potřebujete mít k licenci aktivovanou službu Přístup k API. Ta stojí tolik co jeden standardní přístup dané varianty a po její aktivaci zakládáte API uživatele bez omezení počtu. Podrobnosti popisuje licencování přístupu k API.

Funguje API i na vlastním serveru?

Ano, REST API je stejné pro cloud i pro provoz na vlastním serveru. Rozdíl je v tom, že u vlastního serveru zodpovídáte za jeho výkon a dostupnost sami.

Jak zjistím, jaká pole daná evidence obsahuje?

Seznam evidencí najdete v evidence-listu, pole konkrétní evidence vypíše aplikace sama, když za její název doplníte /properties.

Kolik napojení stojí?

U hotových můstků se ve většině případů hradí jednorázový poplatek za nasazení a poté měsíční částka za provoz a údržbu; konkrétní podmínky určuje integrační partner. U vlastního vývoje jde o čas vašeho vývojáře. V obou případech k tomu připočtěte službu Přístup k API.

Pro můj systém hotové napojení neexistuje. Co s tím?

Není to překážka. ABRA Flexi má otevřené REST API, takže si napojení můžete postavit sami nebo si ho nechat naprogramovat. Ozvěte se nám a doporučíme integračního partnera.

Kam dál

Napojení e-shopu:

Základy REST API:

Související oblasti:

💡 Nejste si jistí, která cesta k napojení je pro vaše procesy ta správná? Návrh integrace s vámi rádi projdeme v rámci individuální konzultaci. S technickými dotazy se obracejte na podporaflexi@abra.eu, s dotazy na licenci a ceny na obchodflexi@abra.eu.

Související články
Dostali jste odpověď na svou otázku?