Prepojenie systémov cez API: postup, ceny a 9 chýb, ktorým sa vyhnúť

01Čo je API a čo znamená prepojenie systémov

API (z anglického Application Programming Interface) je rozhranie, cez ktoré si programy vymieňajú dáta bez zásahu človeka. E-shop sa cez neho môže opýtať účtovníctva, či už faktúra existuje, alebo mu rovno poslať novú objednávku. Prepojenie systémov cez API, často sa mu hovorí API integrácia, znamená, že dáta vzniknú na jednom mieste a do ostatných systémov sa prenesú samy.

Nie každé prepojenie však musí byť cez API na mieru. V praxi sa používajú štyri spôsoby:

02Ako sú na tom slovenské firmy

V používaní firemných systémov Slovensko zaostáva. Podľa Eurostatu malo v roku 2025 systém ERP 26,7 % a CRM 19,7 % slovenských firiem s aspoň 10 zamestnancami, priemer EÚ bol 46,5 % a 28,5 %. V roku 2023 si údaje o zásobách, plánoch výroby alebo zásielkach elektronicky vymieňalo so zákazníkmi a dodávateľmi 17,8 % firiem, priemer EÚ bol 24,6 %.

Pri faktúrach je rozdiel menší ako pri ERP. E-faktúry, ktoré systém príjemcu dokáže sám spracovať, posielalo v roku 2023 25,4 % slovenských firiem, priemer EÚ bol 38,7 %. Faktúry v elektronickej podobe, ktorú treba prečítať a prepísať alebo nechať vyťažiť, zvyčajne PDF v e-maile, posielalo 56,7 % firiem a papierové 63,0 %. Jedna firma pritom môže posielať faktúry viacerými spôsobmi.

Ani vo svete to nie je oveľa lepšie. Podľa správy MuleSoft Connectivity Benchmark 2026, pre ktorú odpovedalo 1 050 vedúcich pracovníkov IT z veľkých organizácií z celého sveta, používa priemerná veľká organizácia 957 aplikácií a prepojených je z nich len 27 %. Rok predtým to bolo 29 %. Návrhom, vývojom a testovaním nových integrácií pritom IT tímy trávia viac ako tretinu času.

03Povinná e-fakturácia od roku 2027

Od 1. januára 2027 sa na Slovensku mení spôsob, akým firmy vystavujú a prijímajú faktúry. Podľa Finančnej správy sa povinnosť týka najmä vzťahov medzi podnikateľmi (B2B) a medzi podnikateľmi a verejnou správou (B2G). Bežných spotrebiteľov sa netýka.

• Platitelia DPH budú pri zákonom určených tuzemských dodaniach elektronické faktúry vyhotovovať, odosielať aj prijímať.
• Faktúry doručuje takzvaný digitálny poštár, teda poskytovateľ certifikovaný v sieti Peppol a akreditovaný Finančnou správou SR.
• Neplatiteľ DPH povinnosť vyhotovovať e-faktúry nemá a môže fakturovať ako doteraz, napríklad v PDF.
• Pokuta za nesplnenie povinností môže dosiahnuť až 10 000 €, pri opakovanom porušení až 100 000 €.

Prepojeniu systémov to pomôže. Faktúra príde ako štruktúrované dáta, ktoré účtovníctvo načíta bez prepisovania. Aby to fungovalo naozaj automaticky, musí byť fakturačný alebo účtovný systém napojený na digitálneho poštára a údaje v ňom musia byť správne, od IČ DPH po sadzby dane. Podrobnosti zverejňuje Finančná správa na stránke eFaktúra aj v manuáli krok za krokom.

Na úrovni EÚ prinesie ďalšiu zmenu balík ViDA. Od 1. júla 2030 zavádza digitálne hlásenie cezhraničných plnení medzi firmami v rámci EÚ, postavené na e-faktúrach.

04Čo sa v praxi prepája

• E-shop a účtovníctvo. Z objednávky vznikne faktúra, z platby úhrada. Pozor na zaokrúhľovanie, sadzby DPH, zľavové kupóny a dobropisy.
• Banka a účtovníctvo. Pohyby na účte sa sťahujú a párujú s faktúrami podľa variabilného symbolu. Niektoré banky, napríklad Fio banka, ponúkajú firmám priame API. Treba však strážiť platnosť prístupového tokenu alebo súhlasu, ak ju banka obmedzuje. Keď vyprší a nikto ho neobnoví, sťahovanie platieb prestane fungovať.
• Register právnických osôb a CRM alebo fakturácia. Podľa IČO sa doplní názov firmy a adresa. Register právnických osôb Štatistického úradu SR má verejné API, dopyt podľa IČO funguje bez registrácie aj bez kľúča.
• E-shop, sklad a dopravcovia. Stav zásob, rezervácie a čísla zásielok. Tu rozhoduje rýchlosť, pretože tovar, ktorý sa minul, by sa nemal ďalej predávať.
• CRM a e-mailing alebo reklama. Kontakty, súhlasy a segmenty zákazníkov. Ide o osobné údaje, takže platia pravidlá GDPR (pozri chybu č. 9).

Ak máte zákazníkov a zákazky zatiaľ hlavne v tabuľkách, prečítajte si najprv, kedy už Excel nestačí a kedy sa oplatí CRM na mieru. Prepájať tabuľky s ostatnými systémami sa dá, ale je to krehké.

05Dopytovanie, alebo webhook: ako dáta putujú

Systém sa môže druhého pravidelne pýtať, či je niečo nové. Tomu sa hovorí dopytovanie, po anglicky polling. Alebo mu druhý systém sám pošle správu vo chvíli, keď sa niečo stane, napríklad keď zákazník zaplatí. Takej správe sa hovorí webhook.

Dopytovanie je jednoduchšie, ale zbytočne zaťažuje obe strany a dáta prichádzajú s oneskorením. Webhook je rýchlejší. Keď však prijímajúca strana práve nebeží a odosielateľ správu neskúsi poslať znova, stratí sa. Stripe napríklad nedoručený webhook v ostrej prevádzke opakuje až tri dni, nie každá služba je však taká trpezlivá. Spoľahlivé prepojenie preto zvyčajne kombinuje oboje: webhook kvôli rýchlosti a pravidelnú kontrolu, ktorá dobehne, čo sa cestou stratilo.

069 chýb, ktoré sa pri prepájaní opakujú

1. Nie je jasné, ktorý systém má pravdu

Keď sa adresa zákazníka dá zmeniť v e-shope aj v CRM, skôr či neskôr sa obe verzie rozídu. Pri každom údaji preto musí byť jeden hlavný systém. Ceny môže spravovať ERP, kontakty CRM a prijaté platby banka. Ostatné systémy údaje preberajú, a keď u nich vznikne zmena, pošlú ju do hlavného systému namiesto toho, aby ju ukladali len u seba.

2. Nikto nespísal, ako sa údaje prevádzajú

Každý systém ukladá dáta trochu inak. Jeden počíta DPH z ceny s daňou, druhý z ceny bez dane. Jeden zaokrúhľuje každú položku, druhý až celkovú sumu. Líši sa formát dátumu, desatinná čiarka a bodka, kódovanie diakritiky aj dĺžka polí. Pred programovaním preto vzniká mapa polí: čo odkiaľ kam ide, v akom formáte a čo sa stane, keď údaj chýba.

3. Opakovaná požiadavka vytvorí druhú faktúru

Spojenie vypadne, program pošle požiadavku znova a v účtovníctve sú dve rovnaké faktúry. Proti tomu pomáha takzvaná idempotencia: opakovaná požiadavka má rovnaký výsledok ako prvá. Najčastejšie sa zabezpečuje tak, že každá operácia nesie jedinečný kľúč a druhá požiadavka s rovnakým kľúčom vráti už existujúci výsledok. Platobná brána Stripe to rieši kľúčom s dĺžkou až 255 znakov, ktorý si pamätá najmenej 24 hodín. Hlavička Idempotency-Key sa v praxi používa bežne, oficiálnym štandardom IETF však zatiaľ nie je, stále je len návrhom (Internet-Draft).

4. Prepojenie nepočíta s limitmi

Takmer každé verejné API má limit, koľko požiadaviek prijme. HubSpot povolí súkromným aplikáciám podľa tarify 100 až 190 požiadaviek za 10 sekúnd. Staršie REST API Shopify prijme pri bežných tarifách naraz 40 požiadaviek a ďalšie uvoľňuje rýchlosťou dve za sekundu. Po prekročení vráti server chybu 429 Too Many Requests a často aj hlavičku Retry-After, ktorá určí, o koľko neskôr to skúsiť znova. Prepojenie, ktoré s tým nepočíta, sa zasekne presne vtedy, keď je najviac práce, napríklad počas výpredaja.

5. O chybe sa nikto nedozvie

Najdrahšie sú tiché chyby. Britská agentúra Public Health England v roku 2020 nezapočítala do denných hlásení 15 841 pozitívnych testov na covid z 25. septembra až 2. októbra a doplnila ich až s oneskorením. Niektoré dátové súbory totiž prekročili maximálnu veľkosť, ktorú zvládol nástroj na ich načítanie do centrálnych systémov. Prepojenie preto potrebuje záznam o každom prenose a upozornenie, ktoré dostane zodpovedný človek. Hodí sa aj prehľad toho, čo čaká v rade a čo zlyhalo.

6. Kľúče k API ležia tam, kde nemajú

Prístupový kľúč k API v e-maile, v zdieľanej tabuľke alebo priamo v kóde skôr či neskôr unikne. Kľúč má mať len oprávnenia, ktoré prepojenie naozaj potrebuje, má byť uložený v správcovi hesiel alebo v premenných prostredia servera a mať zodpovednú osobu, ktorá ho vie vymeniť. Ako kľúče najčastejšie unikajú, opisujeme v článku o API kľúčoch a útokoch cez npm.

Organizácia OWASP vo svojom rebríčku desiatich najväčších bezpečnostných rizík API upozorňuje aj na riziko z druhej strany, teda na dáta, ktoré do vášho systému prichádzajú. Podľa bodu API10:2023 vývojári veria dátam z cudzích API viac ako tomu, čo zadá používateľ. Dáta z prepojeného systému sa preto majú kontrolovať rovnako dôkladne ako dáta z formulára na webe.

7. Webhook prijme čokoľvek

Adresa, na ktorú chodia webhooky, je verejná. Kto ju pozná, môže na ňu poslať falošnú správu, napríklad o zaplatenej objednávke. Každú správu je preto potrebné overiť, najlepšie podpisom odosielateľa. Pri Stripe je podpis v hlavičke Stripe-Signature. Prijímajúca strana navyše musí odpovedať rýchlo. GitHub čaká na odpoveď 10 sekúnd, potom spojenie ukončí a doručenie považuje za neúspešné. Správu je preto lepšie hneď uložiť, potvrdiť a spracovať až potom. Rovnaká udalosť navyše môže prísť viackrát, takže príjemca má preskočiť udalosti, ktoré už spracoval.

8. Nikto nestráži verzie a koniec podpory

API sa časom mení. Shopify napríklad od 1. októbra 2024 vedie svoje REST Admin API ako staršie (legacy) a nové verejné aplikácie musia od 1. apríla 2025 stavať na GraphQL. Poskytovatelia ohlasujú zmeny v dokumentácii, e-mailom a niektorí aj v HTTP hlavičkách Deprecation a Sunset (RFC 9745 a RFC 8594). Pri prepojení musí byť jasné, kto tieto správy číta a kto úpravu urobí a zaplatí.

9. Osobné údaje tečú bez pravidiel

Keď prepojenie prenáša mená, e-maily alebo telefónne čísla, ide o spracúvanie osobných údajov. Prenášať sa má len to, čo druhý systém naozaj potrebuje (zásada minimalizácie podľa čl. 5 GDPR), prenos má byť zabezpečený (čl. 32) a s každým dodávateľom, ktorý údaje spracúva za vás, musíte mať sprostredkovateľskú zmluvu podľa čl. 28. Úrad na ochranu osobných údajov SR na to zverejňuje nezáväzný vzor zmluvy. Ak dáta tečú cez službu mimo EÚ, napríklad cez integračnú platformu z USA, overte aj právny základ na prenos do tretej krajiny (kapitola V GDPR).

07Ako prepojenie pripraviť krok za krokom

1. Spíšte systémy a toky dát. Ktoré systémy máte, čo v nich vzniká a čo sa dnes prepisuje ručne.
2. Určte hlavný systém pre každý údaj. Ceny, sklad, kontakty, faktúry a platby.
3. Prečítajte si dokumentáciu API oboch strán. Limity, spôsob prihlásenia, webhooky, testovacie prostredie a cenník. Niektoré systémy sprístupňujú API až vo vyšších tarifách.
4. Spíšte mapu polí a pravidlá pre výnimky. Čo ak chýba IČO, čo ak sa zmení cena, čo s dobropisom alebo stornom.
5. Vyvíjajte a testujte mimo ostrej prevádzky. Skúšajte aj chyby: výpadok spojenia, dvojitú požiadavku, prekročenie limitu (chyba 429) a chybné dáta.
6. Spustite pilot na časti dát. Napríklad na jednej kategórii tovaru alebo na objednávkach z jedného týždňa a výsledok porovnajte s ručným spracovaním.
7. Nastavte monitoring a zodpovednosť. Kto dostane upozornenie, kto chybu opraví a kto stráži zmeny API.

08Koľko prepojenie stojí

Cena závisí hlavne od toho, koľko systémov prepájate a koľko výnimiek musí prepojenie zvládnuť. Na orientáciu:

Pri malých objemoch preto často vyjde lepšie platforma, pri tisícoch objednávok mesačne a vlastných pravidlách často v priebehu pár rokov vyjde lacnejšie prepojenie na mieru. Orientačnú cenu si vypočítate v kalkulačke systémov na mieru. Koľko stojí samotné CRM v dlhšom horizonte, sme vypočítali v článku Koľko stojí CRM za 5 rokov. Ako u nás vývoj prebieha, opisujeme na stránke Ako to prebieha, ceny ostatných služieb nájdete v cenníku.

09Časté otázky

10Zdroje

• Eurostat: isoc_eb_iip (ERP a CRM, 2025) a isoc_eb_ics (e-faktúry a zdieľanie dát, 2023)
• eFaktúra a manuál povinnej elektronickej fakturácie, Finančná správa SR, august 2026
• VAT in the Digital Age (ViDA), Európska komisia
• Connectivity Benchmark Report 2026 a 2025, MuleSoft
• API bankovníctvo, Fio banka
• Idempotentné požiadavky a webhooky, Stripe
• Návrh hlavičky Idempotency-Key, IETF
• Limity API, HubSpot, a REST Admin API a jeho limity, Shopify
• RFC 6585 (chyba 429), RFC 9110 (Retry-After), RFC 9745 (Deprecation) a RFC 8594 (Sunset)
• PHE statement on delayed reporting of COVID-19 cases, GOV.UK, 2020
• OWASP API Security Top 10 2023
• Best practices for using webhooks, GitHub
• Vzor sprostredkovateľskej zmluvy, Úrad na ochranu osobných údajov SR, a text GDPR
• Cenník Zapier