Abra Flexi
Napojení TAXY na ABRA Flexi přes REST API — správný tvar adresy, první propojení a řešení nejčastějších potíží.
TAXY umí předávat potvrzené doklady do ABRA Flexi a synchronizovat z ní číselníky. Napojení probíhá přes REST API ABRA Flexi. Obecný princip přenosu popisuje Obecný princip.
Co integrace umí
- Předává vytěžené a potvrzené doklady z TAXY do ABRA Flexi.
- Synchronizuje číselníky pro účtování a export (účtový rozvrh, dokladové řady, předkontace, střediska a další).
- Respektuje nastavení vytěžování u konkrétního klienta.
- K dokladu v ABRA Flexi umí přiložit odkaz do TAXY, nebo originální soubor (podle nastavení klienta).
Požadavky před propojením
- ABRA Flexi v cloudu (adresa
*.flexibee.eu), nebo vlastní server s dostupným REST API. - Uživatel ABRA Flexi s právy pro REST API. Běžné přihlášení do webové aplikace nestačí, přístup přes API se uživateli povoluje ve správě uživatelů ABRA Flexi. U nové licence bývá vypnutý.
- Adresa firmy v ABRA Flexi (REST API) — viz další kapitola, na správném tvaru adresy napojení stojí.
Správný tvar adresy
TAXY potřebuje adresu REST API konkrétní firmy, ne adresu webové aplikace. Rozdíl je v cestě za doménou:
| Tvar adresy | Příklad | |
|---|---|---|
| ✅ REST API (tuto zadejte do TAXY) | https://<server>.flexibee.eu/c/<kód_firmy> | https://mojefirma.flexibee.eu/c/mojefirma_s_r_o_ |
| ❌ Webová aplikace (nefunguje) | https://<server>.flexibee.eu/flexi/… | https://mojefirma.flexibee.eu/flexi/mojefirma_s_r_o_ |
Na adresu dejte pozor hlavně při kopírování z prohlížeče:
- Adresa musí začínat
https://. Prohlížeč začátek adresy v řádku skrývá, při kopírování výběrem textu se proto snadno ztratí. - Bez lomítka na konci a bez mezer před a za adresou.
- Kód firmy je poslední část adresy, kterou vidíte po přihlášení do webové aplikace ABRA Flexi (část za
/flexi/). Nemusí odpovídat názvu firmy — u firem založených později mívá na konci datum vzniku (např.mojefirma_s_r_o__2026_02_04_1145). Vždy ho zkopírujte celý.
Ověření adresy a údajů v prohlížeči
Před nastavením v TAXY si správnost všeho ověříte za minutu. Do prohlížeče zadejte:
https://<server>.flexibee.eu/c/<kód_firmy>/udalost.jsonProhlížeč si vyžádá jméno a heslo (zadejte ty, které chcete použít v TAXY). Pokud se zobrazí odpověď začínající {"winstrom":…, jsou adresa, uživatel i heslo v pořádku a stejné hodnoty projdou i v TAXY.
Pokud ověření neprojde:
- Stránka s chybou 404 — kód firmy v adrese není správný. Přesný kód zjistíte po přihlášení do webové aplikace ABRA Flexi z adresního řádku.
- Opakovaný dotaz na jméno a heslo — uživatel nemá povolený přístup přes REST API, nebo je heslo špatně. Práva API nastavíte ve správě uživatelů ABRA Flexi.
První propojení klienta
Ověřte adresu a údaje v prohlížeči — podle předchozí kapitoly. Ušetří to dohadování s formulářem.
V TAXY otevřete nastavení klienta — sekce Účetní program, vyberte ABRA Flexi a typ napojení API.
Vyplňte údaje — do pole URL společnosti ve FlexiBee vložte adresu ve tvaru https://<server>.flexibee.eu/c/<kód_firmy>, doplňte uživatele a heslo.
Uložte — TAXY při uložení spojení rovnou ověří. Když ověření neprojde, nastavení se neuloží a zůstává v platnosti předchozí stav.
Zkontrolujte stav a číselníky — po úspěšném uložení se zobrazí zelené potvrzení, že je spojení nastaveno a online, a automaticky se spustí synchronizace číselníků. Přes odkaz Zobrazit číselníky ověřte, že se naplnily.
Časté situace
Nastavení nejde uložit („Nepodařilo se uložit nastavení")
TAXY před uložením zkouší živé spojení s ABRA Flexi a při neúspěchu nic neuloží. Zkontrolujte:
- Adresa začíná
https://a nemá na konci lomítko ani mezery. - Adresa má tvar REST API s
/c/<kód_firmy>, ne tvar webové aplikace s/flexi/. - Jméno, heslo a práva API — nejrychleji ověříte testem v prohlížeči.
Spojení je „úspěšně nastaveno", ale zároveň se „nelze spojit"
První hláška říká jen to, že jsou v TAXY uložené přihlašovací údaje. Druhá je výsledek skutečného testu — spojení nefunguje. Nejčastější příčinou je uložená adresa ve tvaru webové aplikace (s /flexi/) nebo bez kódu firmy. Opravte adresu podle kapitoly Správný tvar adresy a uložte znovu. Nic mazat nemusíte, nové uložení předchozí hodnoty přepíše.
Doklad se nepřenese
Postup je obecný napříč účetními programy. Viz Potíže s přenosem do účetního programu.
Chyba kódu účtu nebo banky při přenosu
Při exportu může ABRA hlásit, že zadaný text (např. kód bankovního účtu) neodpovídá záznamu v číselníku. Ověřte v TAXY i v ABRA, že název a formát účtu jsou shodné. Po úpravě v ABRA nebo v TAXY spusťte synchronizaci číselníků a přenos zkuste znovu.
Účtenka končí v Ostatních závazcích místo v Pokladně
Záleží na nastavení typu a podtypu dokladu. Viz Typ dokladu při exportu.