Integrace přes API: jak napojit e-shop na ERP a další systémy

Co je integrace a proč se o ní mluví pozdě

Integrace znamená, že si dva systémy předávají data samy, bez člověka uprostřed. E-shop pošle objednávku do skladu, sklad vrátí informaci o expedici, účetnictví si samo stáhne podklady pro fakturaci.

Ve firmách se na integraci obvykle přijde řeč až po tom, co jsou jednotlivé systémy nakoupené. Každý z nich byl vybraný samostatně a podle vlastních kritérií, a otázka, jak spolu budou komunikovat, se odloží. Tehdy vzniká nejdražší varianta: propojit dvě řešení, která na to nebyla stavěná.

Praktický důsledek pro vás: pokud teď vybíráte kterýkoli firemní systém, dejte existenci a kvalitu API do rozhodovacích kritérií hned vedle ceny.

Čtyři způsoby, jak systémy propojit

Cest je víc a liší se cenou i tím, jak dobře snesou provoz.

Výměna souborů. Jeden systém vygeneruje CSV nebo XML, druhý ho v pravidelném intervalu načte. Nejlevnější a nejstarší způsob, pořád běžný u napojení na starší účetnictví. Funguje, ale nese zpoždění a špatně se v něm hledají chyby — když se soubor jednou nenačte, nikdo se to nemusí dozvědět.

Přímý přístup do databáze. Jeden systém čte data přímo z databáze druhého. Rychlé na naprogramování a lákavé, ale obchází veškerou logiku aplikace a při první aktualizaci se rozbije. Pokud vám to někdo nabízí jako hlavní řešení, ptejte se proč.

API. Systém nabízí rozhraní, přes které se dá data číst a zapisovat řízeným způsobem. Dnes standard — typicky REST API s autentizací tokenem. Dodavatel garantuje, jak se rozhraní chová, a mění ho verzovaně, takže integrace přežije aktualizace.

Integrační platforma (iPaaS). Služby jako Make nebo Zapier propojí systémy bez programování. Skvělé na jednoduché scénáře a rychlé ověření, že nápad funguje. Při větších objemech ale narazíte na cenu za operaci a na limity toho, co se dá naklikat.

Co zjistit, než začnete

Než poptáte integraci, měli byste znát odpovědi na tři otázky. Ušetří vám to nejvíc peněz z celého projektu.

Má každý systém API a co v něm umí? Nestačí, že API existuje. Podstatné je, jestli umí to konkrétní, co potřebujete — zápis objednávky včetně slev a dopravy je něco jiného než čtení seznamu produktů. Vyžádejte si dokumentaci a nechte ji posoudit, ideálně před podpisem smlouvy se systémem.

Kdo je zdroj pravdy pro každý údaj? Tohle je nejčastější důvod, proč integrace selhávají. Když se cena produktu dá změnit v e-shopu i v ERP, dříve nebo později se změní na obou stranách naráz a někdo přijde o data. U každého údaje musí být jasné, který systém rozhoduje.

Co se stane při výpadku? Cizí systém bude nedostupný, na tom není nic výjimečného. Otázka je, jestli se objednávka ztratí, nebo počká ve frontě a odešle se později. Druhá varianta je dražší na vývoj a je téměř vždy správná.

Typický scénář: e-shop a ERP

Nejčastější zadání, se kterým se setkáváme, vypadá takhle: objednávka vzniká v e-shopu, zboží se vydává ze skladu v ERP a faktura se vystavuje v účetnictví.

Rozdělení rolí, které se osvědčuje:

• Produkty a ceny vznikají v ERP a do e-shopu se jen replikují. E-shop je nemění.
• Stav skladu hlídá ERP a e-shopu ho posílá v krátkých intervalech nebo při změně.
• Objednávka vzniká v e-shopu a putuje do ERP. Její stav se pak vrací zpět, aby ho zákazník viděl.
• Zákaznická data patří e-shopu, do ERP jdou jen v rozsahu potřebném pro fakturaci.

Zdánlivé detaily, na kterých projekty váznou: jak se párují produkty, když má každý systém jiné kódy; co se stane s objednávkou zboží, které mezitím došlo; jak se přenášejí slevy, aby seděly součty; a jak se řeší vratky, které jdou proti směru celého toku.

Kde integrace nejčastěji padají

Za deset let jsme viděli opakovaně stejné čtyři příčiny, a ani jedna z nich není programátorská.

• Nevyjasněný zdroj pravdy. Data se přepisují navzájem a nikdo neví, která verze platí.
• Chybějící monitoring. Integrace tiše přestane fungovat a zjistí se to po týdnu ze stížností.
• Žádné testovací prostředí. Když se dá zkoušet jen na ostrých datech, testuje se málo a opatrně.
• Neošetřené výjimky. Systém zvládá běžný průběh, ale ne stornované objednávky, částečné dodávky a vratky — tedy přesně to, co v provozu nastává.

Praktické opatření, které vyjde levně a vrátí se nejrychleji: logujte každý přenos a nastavte upozornění, když se něco nepovede. Bez toho integraci neuřídíte, ať je naprogramovaná jakkoli dobře.

Kolik to stojí a jak dlouho to trvá

Ceny se odvíjejí od toho, kolik entit se přenáší a kolika směry.

• Jednosměrné předání objednávek mezi systémy s dobrým API: 60 000 – 120 000 Kč, 2–3 týdny.
• Obousměrná synchronizace produktů, skladu a objednávek: 150 000 – 350 000 Kč, 6–10 týdnů.
• Napojení na starší ERP bez API: od 300 000 Kč, termín podle toho, co se dá zjistit o cílovém systému.

K tomu počítejte s průběžnou údržbou. Rozumný odhad je 10–15 % ceny ročně — na aktualizace API na obou stranách, na monitoring a na řešení situací, které při návrhu nikoho nenapadly.

Časté otázky

Co když náš systém nemá API?

Řešení existují, ale jsou dražší a křehčí. U starších systémů se dá číst přímo z databáze, importovat soubory ve sjednaném formátu nebo v krajním případě automatizovat práci s uživatelským rozhraním. Každá z těchto cest se ale rozbije při aktualizaci systému, se kterou nepočítáte. Než se do toho pustíte, ověřte u dodavatele, jestli API neexistuje jako placený doplněk — často vyjde levněji než obcházení.

Jak dlouho integrace trvá?

Jednosměrné předávání objednávek mezi dvěma systémy, které mají použitelné API, bývá otázka dvou až tří týdnů. Obousměrná synchronizace skladů, cen a stavů objednávek s ošetřením konfliktů je spíš dva měsíce. Nejvíc času nespotřebuje programování, ale vyjasňování toho, jak se která data mají chovat.

Musí integrace běžet v reálném čase?

Zpravidla ne a stojí to méně, když nemusí. Sklad, který se aktualizuje po pěti minutách, řeší 99 % situací a je výrazně jednodušší než okamžitá synchronizace. Reálný čas potřebujete tam, kde by prodleva způsobila škodu — typicky u rezervací kapacity nebo při prodeji posledních kusů.

Kdo integraci udržuje, když je hotová?

Někdo musí, protože se mění systémy na obou stranách. Dodavatelé API vydávají nové verze a ty staré po čase vypínají. Počítejte s vyhrazeným rozpočtem na údržbu a hlavně s monitoringem, který dá vědět, že se data přestala přenášet — nejhorší integrace je ta, o jejímž výpadku se dozvíte od zákazníka.

Závěr

Integrace je z velké části práce s daty, ne s kódem. Když si předem ujasníte, který systém o čem rozhoduje a co se má stát, když něco selže, je samotné naprogramování ta snazší polovina.

A pokud teď vybíráte nový firemní systém: kvalita jeho API je kritérium, které se vám vrátí při každém dalším projektu. Systém bez použitelného rozhraní vás bude omezovat tak dlouho, dokud ho nevyměníte.