Níže naleznete kompletní postup, jak řešit typické problémy při integraci ABRA Flexi a e-shopu. Postupujte podle jednotlivých kroků.
Ověřte uživatelská práva ve Flexi:
Zkontrolujte práva uživatele pro import dokladů (menu: Nastavení → Uživatelé → Oprávnění).
Uživatel musí mít práva pro externí integraci (API).
Zkontrolujte typy dokladů:
Ověřte, že se v integraci používá správný typ dokladu (např. „Vydaná objednávka“, „Vydaná faktura“).
Typ dokladu musí existovat ve Flexi a být aktivní.
Ověřte párování platebních/dopravních metod a středisek:
Špatně spárované platební nebo dopravní metody blokují import.
Zkontrolujte, zda názvy a kódy metod odpovídají ve Flexi a na e-shopu.
Zkontrolujte správnou účetní jednotku:
Integrace musí cílit do správné účetní jednotky ve Flexi (zejména pokud máte více jednotek).
Nový rok a inicializace skladu:
Pokud se přešlo na nový účetní rok, zkontrolujte inicializaci skladu ve Flexi (menu Sklady → Inicializace zásob).
Integrace nefunguje bez inicializace nového roku.
Zkontrolujte kódy produktů:
Kódy položek musí být unikátní v ABRA Flexi i na e-shopu.
Duplicitní kódy blokují aktualizace zásob.
Ověřte příznak „Exportovat do internetového obchodu“:
Pokud tento příznak používáte, ověřte, že je u produktů nastaven (karta produktu → záložka Internet).
Kontrola správnosti skladů:
Ověřte, že se exportují zásoby z očekávaného skladu (Flexi → menu Sklady → Seznam skladů).
Zkontrolujte případné nastavení více skladů a jejich sčítání.
Duplicitní položky na e-shopu:
Prověřte e-shop, zda produkt se stejným kódem neexistuje vícekrát.
Chyba 500 (chyba serveru e-shopu):
Chyba na straně e-shopu (kompatibilita PHP 8+, databázové chyby).
Řešení: Aktualizace aplikace e-shopu nebo nastavení kompatibilní verze PHP.
Chyba 404 (nenalezeno):
Nesprávná URL integrace nebo integrační soubor není správně nahrán na FTP.
Řešení: Zkontrolujte URL adresu a správné umístění integrátoru.
Chyba 403 nebo chyba 0 (blokace IP nebo špatné údaje):
Server e-shopu blokuje IP adresu nebo jsou chybné přihlašovací údaje.
Řešení: Ověřte dostupnost URL v prohlížeči, whitelistujte IP serveru integrace na firewallu nebo serveru e-shopu.
Přegenerujte bezpečnostní/API klíče:
Znovu vygenerujte API klíče a ověřte jejich správné nastavení na obou stranách (e-shop i Flexi).
Aktualizujte integrační aplikaci:
Nahrajte integrační skripty či moduly znovu (ideálně nejnovější dostupnou verzi).
Zajistěte whitelist IP adresy:
IP adresa serveru, kde běží integrace, musí být povolena na firewallu či v nastavení e-shopu.
✅ Import dokladů do Flexi:
Uživatelská práva
Správné typy dokladů
Párování plateb/dopravy/středisek
Správná účetní jednotka
Inicializace skladu při přechodu roku
✅ Export produktů z Flexi:
Unikátní kódy produktů
Příznak exportu do internetového obchodu
Správný sklad
Žádné duplicity produktů
✅ HTTP/FTP chyby:
Chyby 500 (kompatibilita e-shopu, PHP, DB)
Chyby 404 (špatné FTP údaje nebo složka)
Chyby 403/0 (blokace IP, špatné přihlašovací údaje)
✅ Když jiné nefunguje:
Vygenerování nových API klíčů
Aktualizace integračních skriptů/modulů
Povolení IP adresy na firewallu e-shopu
Tento návod pokrývá všechny hlavní kroky podle standardního postupu pro rychlé určení příčiny a vyřešení problémů při integraci ABRA Flexi s vaším e-shopem.