Starší napojení na FlexiBee, které znovu spolehlivě funguje

FlexiBee, nebo ABRA Flexi?

Jde o stejný systém. FlexiBee je původní název ekonomického systému, který dnes ABRA Software prodává jako ABRA Flexi. Starý název ale v praxi žije dál: dokumentace a podpora běží na doménách flexibee.eu a podpora.flexibee.eu, XML komunikace používá kořenový element winstrom a hlavička pro serverovou autorizaci se jmenuje X-FlexiBee-Authorization. Když tedy hledáte „FlexiBee API“, jde o dnešní REST API ABRA Flexi. Obecné napojení nového e-shopu popisujeme na stránce ABRA Flexi a Gen.

Proč starší integrace přestávají fungovat

Nejčastější příčinou je licence. Od 1. 12. 2024 se přístup k API v ABRA Flexi licencuje samostatně a podle ABRA Software licence bez něj od 1. 1. 2025 API nepoužívají. Integrace postavené na běžném uživatelském účtu tak mohly ze dne na den skončit chybou autorizace. Nové licencování zároveň dovoluje zakládat neomezený počet API uživatelů. Starou praxi — jeden účet s plnými právy sdílený e-shopem, dopravcem i účetní — proto při převodu nahrazujeme samostatným uživatelem pro každou integraci. Aktuální ceník přístupu k API ověřte u poskytovatele (k 9/2026).

Druhou příčinou bývá způsob synchronizace. Starší skripty často každých pár minut stahují celý ceník a skladové karty a porovnávají je s e-shopem. U většího katalogu to je pomalé a zbytečně to zatěžuje server.

Changes API a webhooky místo stahování všeho

ABRA Flexi má Changes API: po zapnutí eviduje každou změnu dat s pořadovým číslem verze. Integrace si pamatuje poslední zpracovanou verzi a stahuje jen to, co přibylo. Podle dokumentace je to pro synchronizaci spolehlivější než filtrování podle data poslední změny. Changes API vyžaduje aktivní REST API alespoň pro čtení a zapíná se ve webovém rozhraní nebo požadavkem na API.

Nad Changes API fungují webhooky. Registrují se požadavkem na evidenci hooks s adresou, formátem a volitelným bezpečnostním klíčem. Flexi při registraci pošle na adresu prázdnou zkušební notifikaci a hook zaregistruje, jen když dostane odpověď 2xx. U vlastního serveru je navíc potřeba webhooky povolit v konfiguračním souboru serveru. E-shop se pak o změně zásoby nebo ceny dozví hned, bez neustálého dotazování.

Jak převod probíhá v praxi

Nejdřív zmapujeme, co stará integrace dělá — často to nikdo přesně neví. Pak ji přepíšeme po částech: nejprve čtení skladu a cen přes Changes API, potom zápis objednávek s kontrolou duplicit. Starou a novou verzi krátce provozujeme souběžně a porovnáváme výsledky. Víc o systému v hesle FlexiBee.