REST API
Fakturácia, ktorú riadi tvoj systém
Vystav faktúru priamo z e-shopu, aplikácie alebo skriptu. Autentifikácia tokenom, stránkovanie cursorom a idempotentné zápisy — a 100 požiadaviek mesačne už vo Free pláne, bez platobnej karty.
curl https://app.lucanto.eu/api/v1/workspaces/{workspace_id}/invoices \
-H "Authorization: Bearer lct_live_xxx"Čo cez API postavíš
Z objednávky faktúra
Tvoj e-shop alebo aplikácia zavolá Lucanto, keď je objednávka zaplatená, a faktúra existuje — bez exportu, bez prepisovania, bez mesačného doháňania.
Klienti sedia na oboch stranách
Vytváraj a upravuj klientov z vlastného systému a udrž kontaktné aj firemné údaje rovnaké v Lucanto aj u seba.
Doklady, ktoré si vieš prečítať späť
Stiahni faktúry, ich stav úhrady aj dáta za nimi do vlastného reportingu namiesto exportovania tabuliek.
API máš už vo Free pláne
REST API nie je funkcia vyhradená pre veľké účty. Free obsahuje 100 požiadaviek mesačne — dosť na to, aby si napojenie postavil, otestoval a rozbehol menší tok faktúr naostro. Keď potrebuješ vyšší limit, prejdeš na vyšší plán; neodomykáš funkciu.
Od nuly k prvému volaniu
Vytvor si prístupový token
V Lucanto choď do Nastavenia → API a vygeneruj workspace token (lct_live_). Je viazaný na jeden workspace, nie na človeka, takže napojenie funguje ďalej aj vtedy, keď z firmy odíde ten, kto ho vytvoril, a nesiaha do žiadneho iného workspace-u. Na rýchle vyskúšanie z vlastného skriptu stačí osobný token (lct_pat_). Rozsahmi udržíš integráciu určenú na čítanie naozaj len na čítanie.
Pošli prvé volanie
Prvú požiadavku pošli na https://app.lucanto.eu/api/v1 s tokenom v hlavičke Authorization. Quickstart v dokumentácii ťa tým prevedie od začiatku do konca za menej než päť minút.
Priprav to na produkciu
Pri každom POST posielaj hlavičku Idempotency-Key, aby opakovaný pokus nevystavil faktúru dvakrát, kolekcie prechádzaj cursorom namiesto offsetu a spracuj chybovú obálku, nielen kontrolu na HTTP 200.
Ako sa API správa
Detaily, ktoré rozhodnú, či integrácia prežije prvý zlý týždeň. Každý riadok odkazuje na svoju stránku v dokumentácii.
| Vlastnosť | Ako to funguje |
|---|---|
| Základná adresa | https://app.lucanto.eu/api/v1 |
| Workspace token (lct_live_) | Viazaný na jeden workspace — na e-shop a účtovné napojenia, ktoré konajú za firmu |
| Osobný token (lct_pat_) | Tvoje vlastné oprávnenia, naprieč všetkými tvojimi workspace-mi — na skripty a AI asistentov |
| Stránkovanie | Cursor, stabilný aj pri pribúdaní záznamov |
| Idempotencia | Hlavička Idempotency-Key pri POST, takže opakovanie je bezpečné |
| Chyby | Jedna chybová obálka naprieč všetkými endpointmi |
Zmeny zverejňujeme
Nové endpointy, nové polia aj nekompatibilné zmeny idú do verejného changelogu API. Nekompatibilné zmeny označujeme štítkom, takže ich vidíš skôr, než sa ťa dotknú — a cez RSS ti prídu samy, bez toho, aby si sa sem chodil pozerať.
Požiadavky podľa plánu
Limit požiadaviek rastie s plánom. Technická podpora k API je dostupná od plánu Starter. Ceny doplnkov sú bez DPH.
| Čo dostaneš | Dostupnosť |
|---|---|
| Požiadavky — Free | 100 / mesiac |
| Požiadavky — Starter | 500 / mesiac |
| Požiadavky — PRO | 5 000 / mesiac |
| Požiadavky — Business | 20 000 / mesiac |
| Extra balíky požiadaviek | Len v pláne Business10 000 za 5 € · 50 000 za 20 €, bez DPH |
| Technická podpora k API | Od plánu Starter |
| MCP server pre AI agentov | Všetky plány vrátane FreePočíta sa do rovnakého mesačného limitu požiadaviek |
Nemusíš to programovať sám
Ak na to nemáš vývojára, sú dve cesty, ktoré nevyžadujú ani riadok kódu. Pripoj Lucanto k AI asistentovi cez MCP a pýtaj si faktúry bežnou rečou. Alebo napojenie zver niektorému z vývojárov nižšie — robia presne toto.
Partneri pre integráciu
Nezávislí vývojári a štúdiá, ktorí s Lucanto API už pracovali a napojenie ti postavia na kľúč. Fakturujú ti priamo — nemáme z toho províziu a prácu nesprostredkúvame.
| Firma | Krajina | Kontaktná osoba | Technológie | |
|---|---|---|---|---|
| SME Digital s.r.o. | Slovensko | Miloš Blaško | info@visblee.sk | PHP, Laravel, Ruby |
| Seiri s.r.o. | Slovensko | Marek Panti | marekpanti@gmail.com | Node.js, NestJS, Java |
| Seky IT s.r.o. | Slovensko | Lukáš Sekerák | sekys.sekys@gmail.com | PHP, Node.js |
| Studio TEM, s.r.o. | Slovensko | Michal Fehér | spolupraca@studiotem.com+421 911 258 330 | PHP, Laravel, WooCommerce, WordPress, Node.js |
| MATATE s.r.o. | Slovensko | Dávid Brontvaj | info@matate.sk | PHP, Next.js, Node.js |
Chceš byť v zozname?
Ak staviaš integrácie a chceš, aby ti chodila práca, napíš nám. Uveď, v čom robíš a kde si vieme pozrieť tvoju prácu — doplníme ťa do tabuľky. hello@lucanto.eu
Časté otázky o API
Je REST API dostupné aj vo Free pláne?
Áno. REST API je súčasťou Lucanto už vo Free pláne so 100 požiadavkami mesačne — nemusíš prejsť na vyšší plán, aby si napojil vlastný systém. Vyšší limit prichádza s platenými plánmi: Starter 500, PRO 5 000 a Business 20 000 požiadaviek mesačne.
Aké sú limity požiadaviek podľa plánu?
Free 100, Starter 500, PRO 5 000 a Business 20 000 požiadaviek mesačne. V pláne Business si vieš dokúpiť extra balíky — 10 000 za 5 € alebo 50 000 za 20 €, obe bez DPH. Nižšie plány doplnok na extra požiadavky nemajú; ak ich potrebuješ viac, prejdeš na vyšší plán.
Dá sa cez API vystaviť faktúru z vlastného systému?
Áno, to je hlavný zmysel API. Z vlastnej aplikácie, e-shopu alebo interného nástroja zavoláš Lucanto a vystavíš faktúru bez ručného prepisovania; rovnako vieš synchronizovať klientov a sťahovať doklady aj ich stavy. Endpointy, formáty aj autentifikáciu nájdeš v dokumentácii na docs.lucanto.eu.
Ktorý token mám použiť?
Na integráciu, ktorá koná za firmu — e-shop, napojenie na účtovníctvo, interný nástroj — použi workspace token (lct_live_). Je viazaný na ten jeden workspace, takže nesiaha do iných workspace-ov a neprestane fungovať, keď z firmy odíde človek, ktorý ho vytvoril. Osobný token (lct_pat_) nesie tvoj vlastný prístup naprieč všetkými workspace-mi, do ktorých patríš, a hodí sa na vlastné skripty či AI asistentov. Pre oba platí jedno: token je pri vytvorení zastropovaný oprávneniami toho, kto ho vydal, takže nikdy nedá väčší prístup, než má sám vydávajúci.
Aký je rozdiel oproti MCP serveru?
Rovnaký model prístupu, iný konzument a iný token. REST API volá tvoj kód, spravidla s workspace tokenom, ktorý patrí firme. MCP volá AI asistent ako Claude či ChatGPT, s osobným tokenom, ktorý patrí tebe. Oba používajú tie isté rozsahy oprávnení a oba sa počítajú do rovnakého mesačného limitu požiadaviek. MCP máš vo všetkých plánoch vrátane Free.
Nerozbijete mi integráciu?
Podstatné zmeny — nové endpointy, nové polia aj nekompatibilné zmeny — zverejňujeme vo verejnom changelogu API, ktorý sa dá filtrovať podľa štítkov a sledovať cez RSS. Nekompatibilné zmeny sú takto označené, takže zmenu, ktorá sa ťa dotkne, ohlásime skôr, než ti príde do integrácie — nezistíš ju až tým, že niečo prestane fungovať.
Poskytujete technickú podporu k API?
Technická podpora k API je dostupná od plánu Starter vyššie. Vo Free pláne máš k dispozícii samotné API so 100 požiadavkami mesačne, no technickú podporu k nemu nie. Ak riešiš napojenie a potrebuješ poradiť, napíš nám cez kontaktný formulár.