API kľúče
V nastaveniach firmy nájdete kartu API / WooCommerce plugin, kde si môžete vytvoriť pomenovaný API kľúč. Kliknite na vytvorenie, kľúč pomenujte (napríklad „WooCommerce obchod“ alebo „Môj skript“) a tajný kľúč sa vám zobrazí iba raz – hneď si ho skopírujte, pretože ho neskôr už nie je možné znova zobraziť. Ak si ho neuložíte, jednoducho ho zrušte a vytvorte nový. Ktorýkoľvek kľúč môžete kedykoľvek z rovnakého zoznamu zrušiť.
REST API
API kľúč použijete na volanie REST API Fakturisty tak, že ho pošlete v HTTP hlavičke Authorization: Bearer <váš-api-kľúč>. API je dostupné na ceste /api a pokrýva faktúry, cenové ponuky, zálohové faktúry, partnerov, produkty, výdavky, kategórie výdavkov, platby a profil vašej firmy – pre väčšinu z nich podporuje plné vytváranie, čítanie, úpravu aj mazanie, teda v podstate to isté, čo viete robiť priamo v aplikácii.
MCP server
Fakturista poskytuje aj MCP (Model Context Protocol) server na adrese https://fakturista.app/mcp, vďaka ktorému môžete AI nástroje ako Claude Desktop alebo Cursor pripojiť priamo na dáta vašej firmy – použijete rovnaký typ API kľúča (Authorization: Bearer <kľúč>).
Po pripojení má AI nástroj k dispozícii malú, zámerne obmedzenú sadu nástrojov: zoznam faktúr, detail jednej faktúry, zoznam partnerov, detail jedného partnera, zoznam výdavkov, (neverejný) profil firmy, vytvorenie návrhu faktúry, vytvorenie nového partnera, zoznam platieb a zaznamenanie platby k vystavenej faktúre. Žiadny z nástrojov faktúru nevystaví ani neodošle – návrh faktúry si vždy musíte skontrolovať a potvrdiť. Zaznamenanie platby sa riadi rovnakými pravidlami ako v aplikácii: len k vystavenej faktúre, nikdy k návrhu, stornovanej faktúre či cenovej ponuke a najviac do neuhradenej sumy; stav faktúry (Čiastočne uhradená / Uhradená) sa podľa toho zmení. Táto sada nástrojov sa postupne rozširuje, takže ju berte ako aktuálny stav, nie ako konečný zoznam.
Bezpečnosť kľúčov
API kľúč držte v tajnosti – kto ho má, vie s ním v rámci možností daných nástrojov pracovať s dátami vašej firmy cez API aj cez MCP server. Ak máte podozrenie, že sa kľúč dostal k niekomu nepovolanému, hneď ho v nastaveniach firmy zrušte a vytvorte nový.