Flexibee: jak připojit Fakturqa k tvé instanci

Flexibee je v české krajině trochu jiný hráč — používáš ho buď v cloudu (managed instance na Flexibee serverech) nebo na vlastní instalaci (on-premise). V obou případech se autentizuješ proti REST API přihlašovacími údaji k instanci. To je trochu jiné než u OAuth-based iDokladu nebo Fakturoidu — ale stejně jednoduché na nastavení.

Co potřebuješ vědět dopředu

• URL tvé Flexibee instance. U cloudu vypadá typicky https://demo.flexibee.eu/ nebo https://muj-ucet.flexibee.eu/. U on-premise je to URL tvé serverové instalace.
• Uživatelské jméno a heslo nebo lépe API token. Doporučujeme vytvořit dedikovaného uživatele s minimálním rozsahem práv (přístup k modulu Přijaté faktury).
• Kód firmy, pokud máš ve Flexibee víc firem — Fakturqa potřebuje vědět, do které ji založit.

1. Propojení ve Fakturqa

1. V Fakturqa jdi do Nastavení → Propojení → Připojit Flexibee.
2. Vyplň URL instance, kód firmy, uživatelské jméno a heslo.
3. Klikni Otestovat propojení. Fakturqa ti hned řekne, jestli se umí přihlásit a získat seznam dodavatelů. Pokud ano, ulož.
4. Tvoje přístupy ukládáme šifrované přes AES-256-GCM s klíčem, který má jen běžící aplikace — v DB jsou nečitelné i pro nás. Můžeš je kdykoliv smazat jedním kliknutím.

2. Jak vypadá doklad ve Flexibee po vytvoření

Fakturqa vytváří dokument typu faktura-prijata přes Flexibee REST endpoint. Z extrahovaných dat naplní:

• Číslo dokladu (z faktury, ne přidělené Flexibee řadou)
• Variabilní symbol, KS, SS — pokud byly na faktuře
• Dodavatele (Fakturqa zkusí spárovat s existujícím dodavatelem podle IČO; pokud neexistuje, založíme nového)
• Datum vystavení, splatnost, datum zdanitelného plnění
• Položky s názvem, množstvím, jednotkovou cenou a sazbou DPH
• Celkovou částku včetně DPH

3. Multi-firma

Pokud máš ve Flexibee víc firem (např. provoz + holding), můžeš v Fakturqa vytvořit víc propojení — každé na jiný kód firmy. Typicky:

• Propojení A: kód firmy demo, inbound adresa demo@mail.fakturqa.com
• Propojení B: kód firmy holding, inbound adresa holding@mail.fakturqa.com

Faktury přeposílané na danou adresu pak míří do správné firmy ve Flexibee.

4. Pošli první fakturu

1. V Nastavení → Inbound adresy najdeš svou adresu, např. flex-2891@mail.fakturqa.com.
2. Přepošli na ni libovolnou přijatou fakturu (z emailu, nebo ji vyfoť v mobilní apce).
3. Během ~5 sekund se ti v Fakturqa objeví záznam ve stavu Ke schválení. Zkontroluj data, opravˇ pokud potřeba, klikni Potvrdit.
4. Fakturqa zavolá Flexibee REST endpoint a vytvoří přijatou fakturu. Otevři si Flexibee a najdeš ji v Přijaté faktury.

Časté problémy

Test propojení selhal s 401 Unauthorized

• Zkontroluj URL — Flexibee je citlivý na lomítko na konci. Zkus s i bez.
• Ověř, že uživatel skutečně může otevřít REST endpoint — některé Flexibee role mají REST API explicitně vypnuté.
• U on-premise instalace si ověř, že server běží na HTTPS s validním certifikátem. Self-signed certifikáty Fakturqa odmítá.

Dodavatel se zakládá pokaždé znovu (duplicity)

Fakturqa páruje dodavatele podle IČO. Pokud máš ve Flexibee dodavatele bez IČO, párovat se nedaří a vytváří se nový záznam. Doporučujeme dodavatele ve Flexibee jednorázově projít a IČO doplnit — pak už se duplicity neopakují.

Sazba DPH se mapuje špatně

Flexibee má vlastní číselník DPH sazeb. Fakturqa mapuje standardní CZ sazby (21 %, 15 %, 12 %, 10 %, 0 %, osvobozeno) podle defaultního číselníku. Pokud máš ve Flexibee custom kódy DPH, napiš mi — pošli mi seznam tvých DPH kódů a domapujeme to.

Shrnutí

• Vytvoř ve Flexibee dedikovaného uživatele fakturqa-api s minimálními právy.
• V Fakturqa zadej URL instance, kód firmy a přístupy. Otestuj propojení.
• Přeposílej faktury na svou inbound adresu — Fakturqa je vytěží a vytvoří ve Flexibee.
• Pro víc firem ve Flexibee si vytvoř víc propojení s různými inbound adresami.

Vyzkoušej s Flexibee — zdarma

5 faktur měsíčně zdarma navždy. Propojení trvá minutu.