Připojení k ABRA Flexi

Přímé propojení odesílá doklady z DOXIO rovnou do vaší firmy v ABRA Flexi přes jeho REST API — bez stahování a importu souborů. Do Flexi se založí přijatá či vydaná faktura nebo pokladní doklad, dodavatel nebo odběratel v adresáři a jako příloha PDF dokladu.

Co budete potřebovat:

• ve Flexi aktivní službu Přístup k API,
• samostatného API uživatele bez dvoufázového ověření,
• adresu serveru a kód firmy.

Aktivace přístupu k API ve Flexi#

API není automaticky součástí licence ABRA Flexi. Jde o placenou službu Přístup k API; s jednou aktivovanou službou můžete založit neomezený počet API uživatelů. Cena a denní limit API požadavků se liší podle varianty licence (Basic, Business, Premium) — aktuální údaje najdete v ceníku ABRA Flexi.

1. 1
   Ve webovém rozhraní Flexi otevřete Nastavení → Licence a předplatné.
2. 2
   Aktivujte službu přístupu k API. K tomu potřebujete uživatele s oprávněním spravovat licence.
3. 3
   Pokud službu aktivovat nemůžete, požádejte o ni obchodní oddělení ABRA.

Podrobný postup popisuje ABRA v článku API komunikace jednoduše pro ne-IT uživatele.

Založení API uživatele#

DOXIO se do Flexi přihlašuje jménem a heslem uživatele typu API přístup. Běžný uživatel s přístupem pro zápis se přes API přihlásit nemůže a API uživatel se naopak nepřihlásí do aplikace Flexi. ABRA doporučuje pro každé napojení samostatného API uživatele — založte ho tedy jen pro DOXIO.

Ve webovém rozhraní Flexi:

1. 1
   Otevřete Nastavení → Přehled uživatelů a klikněte na Založit uživatele.
2. 2
   Jako Typ uživatele zvolte API přístup.
3. 3
   Vyplňte jedinečné přihlašovací jméno (např. doxio) a silné heslo.
4. 4
   Přiřaďte uživateli firmu, do které má DOXIO doklady posílat, a roli s potřebnými právy (viz níže).
5. 5
   Uložte.

V desktopové aplikaci je postup Nástroje → Uživatelé ve firmě → Nový, na záložce přihlašovacích údajů zvolte typ uživatele REST-API.

Potřebná oprávnění#

Role uživatele ve Flexi určuje, do kterých evidencí smí zapisovat. API uživatel potřebuje plný přístup (přidávat nové i měnit existující záznamy) do těchto částí:

Dále musí mít uživatel možnost číst účetní období a přidávat k dokladům přílohy. Můžete použít některou ze standardních rolí Flexi (například Účetní, určenou pro běžné účetní operace) — v Nástroje → Uživatelské role si tlačítkem Otevřít ověřte, že výše uvedené části povoluje. Pokud chcete práva omezit přesněji, vytvořte vlastní roli jako kopii role s vyššími právy a nepotřebné části odeberte (viz Uživatelské role v nápovědě ABRA).

Bez dvoufázového ověření#

U uživatele s dvoufázovým ověřením (2FA) chce Flexi jednorázový kód při každém požadavku, takže ho DOXIO použít nemůže. Pro API uživatele 2FA nezapínejte. Pokud už zapnuté je, administrátor ho vypne v Nástroje → Uživatelé ve firmě → vybraný uživatel → Vypnout dvoufázové ověření.

Váš běžný účet ve Flexi může mít 2FA zapnuté dál — týká se to jen uživatele, kterého zadáte do DOXIO.

Adresa serveru a kód firmy#

Obě hodnoty zjistíte z adresy, na které máte Flexi otevřené v prohlížeči.

• Adresa serveru — u cloudu ABRA má tvar https://vasefirma.flexibee.eu (Flexi v cloudu používá port 5434, můžete ho uvést: https://vasefirma.flexibee.eu:5434). U vlastního serveru zadejte jeho veřejnou adresu včetně portu.
• Kód firmy — identifikátor databáze firmy. V adrese REST API je to část za /c/, ve webové aplikaci část za /flexi/.

https://vasefirma.flexibee.eu:5434/c/vase_firma/faktura-prijata
                                    ^^^^^^^^^^ kód firmy

Co DOXIO do pole Adresa serveru přijme:

• adresu s https:// i bez něj (vasefirma.flexibee.eu se doplní na https://vasefirma.flexibee.eu),
• celou adresu zkopírovanou z prohlížeče — DOXIO si z ní ponechá jen server a port, zbytek cesty zahodí,
• jen zabezpečené spojení — adresa s http:// se odmítne,
• jen veřejný server — adresy jako localhost, *.local, *.internal nebo neveřejné IP adresy z bezpečnostních důvodů použít nelze.

Zadání připojení v DOXIO#

1. 1
   Otevřete Nastavení → Účetnictví a sjeďte k oddílu ABRA Flexi.
2. 2
   Vyplňte Adresa serveru, Kód firmy, Uživatel API a Heslo.
3. 3
   Klikněte na Ověřit a uložit.

DOXIO se nejprve přihlásí do Flexi, otevře firmu, načte účetní období a odhlásí se. Připojení uloží, jen když tohle všechno projde — nefunkční údaje se neuloží. Po úspěchu uvidíte zprávu „Připojení k ABRA Flexi je ověřené a uložené.“

Heslo je uložené šifrovaně a už se nikde nezobrazuje. Po uložení vidíte stav Připojeno, server, firmu (název z Flexi a kód), uživatele API a čas posledního ověření.

Úprava a odpojení#

• Upravit připojení otevře formulář znovu. Pole Heslo můžete nechat prázdné — zůstane uložené původní, pokud neměníte adresu serveru, kód firmy ani uživatele API. Při změně kteréhokoli z nich heslo zadejte znovu (uložené heslo se z bezpečnostních důvodů nikdy neodešle na jiný server ani za jiného uživatele). Změny se opět nejdřív ověří.
• Odpojit smaže uložené přihlašovací údaje. Doklady, které už ve Flexi jsou, zůstanou beze změny. Odpojit lze vždy, i po přechodu na nižší tarif.

Členové organizace bez role vlastníka nebo administrátora vidí stav připojení jen pro čtení (viz Tým a role).

Ověření připojení#

Tlačítko Ověřit připojení zopakuje kontrolu s uloženými údaji: přihlášení, otevření firmy a načtení účetních období. Při úspěchu uvidíte například „Připojení funguje — firma Vzorová s.r.o., účetních období: 3.“ a aktualizuje se Naposledy ověřeno.

Pokud kontrola selže, stav se změní na Chyba připojení a pod ním se zobrazí důvod (viz Řešení potíží). Ověření i uložení můžete spustit nejvýše 10krát za 10 minut.

Výchozí hodnoty dokladů#

Jak se doklad ve Flexi zaúčtuje, určují kódy z oddílu Výchozí zaúčtování v Nastavení → Účetnictví, nastavené zvlášť pro každý druh dokladu (faktura přijatá, faktura vydaná, pokladní doklad příjmový a výdajový). U jednotlivého dokladu je můžete v panelu Údaje dokladu přepsat. Podrobnosti najdete v článku Nastavení účetnictví.

Zadávejte přesně ty kódy, které máte ve Flexi. Když Číselná řada chybí, DOXIO použije typy dokladu, které má každá nová firma ve Flexi: FAKTURA pro faktury a STANDARD pro pokladní doklady. V dialogu exportu na to upozorní.

Doklady se do Flexi zakládají jako bezpoložkové, s rekapitulací DPH podle sazeb. Číslo dokladu dodavatele se ukládá jako číslo došlé, číslo vašeho vydaného dokladu jako interní číslo. Interní číslo přijatého dokladu přidělí Flexi podle číselné řady typu dokladu.

Dodavatele nebo odběratele DOXIO nejdřív hledá ve Flexi podle IČO, potom podle DIČ. Existující záznam v adresáři nikdy nepřepíše; nový založí, jen když ho nenajde.

Odesílání dokladů#

Doklady pošlete ručně z dialogu Exportovat do účetnictví (v klientském prostoru nebo v Dokumentech):

1. 1
   Vyberte doklady a klikněte na Exportovat do účetnictví.
2. 2
   Jako Účetní program zvolte ABRA Flexi a jako Formát Odeslat přímo do ABRA Flexi. Tato volba se nabízí jen s uloženým připojením.
3. 3
   Zkontrolujte upozornění u dokladů a klikněte na Odeslat.

Najednou lze odeslat až 200 dokladů. Do 5 dokladů uvidíte výsledek hned, větší dávka běží na pozadí a výsledek najdete v Historii exportů. Nepotvrzené (rozpracované) doklady se odešlou jen se zaškrtnutou volbou Zahrnout i nezkontrolované (rozpracované) doklady.

Automatické odesílání#

Pod uloženým připojením je volba Po potvrzení dokladu automaticky odeslat do ABRA Flexi. Když je zapnutá, DOXIO odešle doklad na pozadí ve chvíli, kdy v panelu Údaje dokladu kliknete na Potvrdit.

Doklad se automaticky odešle, jen když:

• jsou v organizaci zapnuté účetní údaje,
• připojení je ve stavu Připojeno — při chybě připojení automatické odesílání čeká („Automatické odesílání čeká na funkční připojení — ověřte ho znovu.“),
• doklad má všechny údaje potřebné pro export.

Zapnout automatické odesílání lze jen v tarifu Kancelář a vyšším, vypnout jde vždy. Neúspěch odeslání potvrzení dokladu nijak neovlivní — chyba se jen zobrazí u dokladu.

Stav odeslání u dokladu#

V panelu Údaje dokladu vidíte, jak odeslání dopadlo:

• Ve Flexi: PF0177/2026 — doklad je ve Flexi; číslo je odkaz, který otevře záznam ve webové aplikaci Flexi (po vašem přihlášení do Flexi).
• Odesílám do ABRA Flexi… — odeslání probíhá, stav se sám obnoví.
• Odeslání do ABRA Flexi se nezdařilo. — pod zprávou je důvod a případně původní hláška Flexi. Po opravě klikněte na Zkusit znovu.
• Doklad nelze odeslat do ABRA Flexi. — doklad neprošel kontrolou (např. chybí údaje nebo není potvrzený). Doplňte údaje a odešlete ho znovu.

Přerušené odesílání#

Výsledek každé dávky najdete v Historii exportů u jednotlivých dokladů. Pokud se odesílání větší dávky přeruší (např. při restartu serveru), objeví se v detailu exportu spuštěného před více než 5 minutami, který stále obsahuje neodeslané doklady, tlačítko Pokračovat v odesílání. Pošle zbývající doklady; ty už odeslané se znovu neposílají.

Řešení potíží#

Dočasné chyby (omezení počtu požadavků, chyba serveru, vypršení času, výpadek sítě) DOXIO při odesílání sám několikrát zopakuje. Chyby přihlášení, oprávnění a adresy odesílání dávky zastaví a připojení přepnou do stavu Chyba připojení.

Další hlášky při zadávání připojení a odesílání: