Dokumentace

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 adresyPří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.json

Prohlíž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:

  1. Adresa začíná https:// a nemá na konci lomítko ani mezery.
  2. Adresa má tvar REST API s /c/<kód_firmy>, ne tvar webové aplikace s /flexi/.
  3. 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.

Související návody