REST API gateway pro Vario ERP — spolehlivé propojení e-shopu s ERP systémem bez zbytečných komplikací
Výchozí situace
Vario patří k nejrozšířenějším českým ERP systémům — účetnictví, sklad, objednávky, fakturace, CRM. Používají ho stovky firem v Česku i na Slovensku. Má ale jedno zásadní omezení.
Systém běží nad Microsoft SQL Server databází a nenabízí žádné nativní REST API pro integraci s externími aplikacemi. Pokud provozujete e-shop a potřebujete synchronizovat produkty, ceny, skladové stavy nebo objednávky, nemáte se standardní cestou jak napojit.
Náš klient tuto situaci řešil ručním přepisováním dat a importy přes CSV soubory. Při malém objemu objednávek to bylo únosné, ale s růstem firmy přibývaly chyby, prodlužovaly se doby zpracování a celý proces přestal škálovat.
Naše řešení
Vyvinuli jsme Vario Bridge — gateway napsaný v Go, který se připojí přímo k SQL Server databázi Vario a zpřístupní její data prostřednictvím REST API. E-shop nebo jakýkoli jiný systém komunikuje přes standardní HTTP requesty a dostává odpovědi ve formátu JSON — bez přímého přístupu k SQL, bez znalosti interní struktury databáze.
Bridge funguje jako mezivrstva mezi oběma systémy: přijme požadavek na REST endpoint, přeloží ho na odpovídající uloženou proceduru nebo SQL dotaz, zpracuje transakci, validuje data a zaznamená celou komunikaci do logu. Klientská aplikace se nemusí zabývat vnitřní logikou Vario.
Klíčové funkce
Synchronizace katalogu
Produkty, ceny, kategorie a skladové stavy se synchronizují automaticky. Bridge využívá change tracking, takže přenáší pouze záznamy změněné od poslední synchronizace. Minimalizuje se tak zátěž databáze i síťový provoz.
Objednávky
Objednávka z e-shopu se automaticky vytvoří jako zakázka ve Vario. Bridge podporuje kompletní workflow: vytvoření zakázky, rezervaci skladu, expedici zboží a vystavení faktury. Každý krok je konfigurovatelný podle typu dokladu — faktura, dobropis, zakázka a další.
Zákazníci a firmy
Při první objednávce z e-shopu Bridge automaticky založí záznam zákazníka v adresáři Vario. Součástí je správa firemních údajů, bankovních účtů i párování s existujícími záznamy.
Bezpečnost
Veškerá komunikace probíhá přes mTLS (mutual TLS) — certifikát vyžaduje jak server, tak klient. Každé připojení disponuje vlastní sadou certifikátů, IP whitelistem a izolovanou konfigurací. Hesla v konfiguračních souborech jsou šifrována.
Multi-tenant architektura
Jeden server může obsluhovat více nezávislých připojení — různé e-shopy, pobočky nebo databáze. Každé připojení má vlastní certifikáty, workflow a nastavení.
Admin panel
Webové rozhraní pro kompletní správu konfigurace: nastavení serveru, TLS certifikáty, připojení k databázím, konfigurace Vario knih a workflow. Změny se aplikují okamžitě pomocí hot-reload — bez nutnosti restartu služby.
Monitoring
Integrovaný log viewer zobrazuje všechny API requesty v reálném čase. K dispozici je filtrování podle log levelu (debug/info/warn/error), podle připojení i fulltextové vyhledávání. Každý záznam obsahuje timestamp, HTTP metodu, endpoint, status kód, dobu odezvy a ID připojení.
Po kliknutí na záznam se zobrazí kompletní request i response body, což výrazně usnadňuje diagnostiku případných problémů.
API dokumentace
API je popsáno pomocí OpenAPI 3.0 specifikace s interaktivní Swagger UI. Vývojáři si mohou API otestovat přímo v prohlížeči bez nutnosti dalších nástrojů. Endpointy pokrývají kompletní obchodní cyklus:
- Products — katalog, ceny, změny, vyhledávání
- Customers — adresář firem a osob, bankovní účty
- Orders — zakázky, workflow (rezervace, expedice, fakturace)
- Invoices — faktury, dobropisy
- Delivery Notes — dodací listy
- Prices — ceníky a cenové hladiny
- Categories, Storage — kategorie zboží, sklady
Provoz a aktualizace
Bridge běží jako systémová služba na Linuxu i Windows. Aktualizace probíhají automaticky z GitLab repozitáře — nová verze se stáhne, ověří a nasadí. V případě chyby proběhne automatický rollback. Logy se rotují s konfigurovatelnou velikostí a počtem záloh.
Reference
- Order.cz — modulární e-commerce se synchronizací produktů, objednávek a skladu
- CARsys — systém pro autoservis se synchronizací servisních zakázek
- ERP Viewer — prohlížeč dat z Vario s REST API přístupem
Potřebujete propojit váš systém s Vario nebo s jiným ERP? Ozvěte se.