REST API
Ať fakturuje váš vlastní systém
Vystavte fakturu přímo z e-shopu, aplikace nebo skriptu. Autentizace tokenem, stránkování kurzorem a idempotentní zápisy — se 100 požadavky měsíčně ve Free plánu, bez platební karty.
curl https://app.lucanto.eu/api/v1/workspaces/{workspace_id}/invoices \
-H "Authorization: Bearer lct_live_xxx"Co si postavíte
Z objednávek vznikají faktury
Váš e-shop nebo aplikace zavolá Lucanto ve chvíli, kdy je objednávka zaplacená, a faktura existuje — bez exportu, bez přepisování, bez měsíčního dohánění.
Klienti zůstávají synchronizovaní
Vytvářejte a upravujte klienty z vlastního systému a udržte kontaktní i firemní údaje shodné na obou stranách.
Doklady, které si přečtete zpátky
Stáhněte si faktury, jejich stav úhrady a data za nimi do vlastního reportingu místo exportování tabulek.
API máte i ve Free plánu
REST API není vyhrazené velkým účtům. Free zahrnuje 100 požadavků měsíčně — dost na to, abyste integraci postavili, otestovali a rozjeli menší tok faktur naostro. Když potřebujete vyšší limit, přejdete na vyšší tarif; neodemykáte funkci.
Od nuly k prvnímu volání
Vytvořte přístupový token
V aplikaci Lucanto jděte do Nastavení → API a vygenerujte token pracovního prostoru (lct_live_). Patří jednomu pracovnímu prostoru, ne osobě, takže integrace funguje dál i poté, co ten, kdo ji nastavil, odejde, a nikdy nesáhne do cizích pracovních prostorů. Na rychlé vyzkoušení z vlastního skriptu stačí osobní token (lct_pat_). Oprávnění (scopes) jsou způsob, jak udržet integraci určenou jen ke čtení opravdu jen ke čtení.
Zavolejte poprvé
Pošlete první požadavek na https://app.lucanto.eu/api/v1 s tokenem v hlavičce Authorization. Quickstart v dokumentaci vás tím provede od začátku do konce za méně než pět minut.
Připravte to na provoz
U každého POSTu posílejte Idempotency-Key, aby opakovaný pokus nevystavil fakturu dvakrát, kolekcemi procházejte kurzorem místo offsetu a ošetřete obálku chyby, ne jen kontrolu na HTTP 200.
Jak se API chová
Detaily, které rozhodnou, jestli integrace přežije svůj první zlý týden. Každý řádek odkazuje na svou stránku v dokumentaci.
| Oblast | Jak to funguje |
|---|---|
| Základní URL | https://app.lucanto.eu/api/v1 |
| Token pracovního prostoru (lct_live_) | Vázaný na jeden pracovní prostor — pro integrace e-shopů a účetnictví, které jednají za firmu |
| Osobní token (lct_pat_) | Vaše vlastní oprávnění napříč všemi pracovními prostory, kam patříte — pro skripty a AI asistenty |
| Stránkování | Kurzorem, stabilní i při vkládání nových záznamů |
| Idempotence | Hlavička Idempotency-Key u POST, takže opakování je bezpečné |
| Chyby | Jedna obálka chyby napříč všemi endpointy |
Změny zveřejňujeme
Nové endpointy, nová pole i změny narušující kompatibilitu jdou do veřejného API changelogu. Změny narušující kompatibilitu jsou označené, takže je uvidíte dřív, než se k vám dostanou — a RSS vám je přinese, aniž byste museli kontrolovat.
Požadavky podle tarifu
Limit požadavků roste s tarifem. Technická podpora k API je dostupná od tarifu Starter výše. Ceny doplňků jsou bez DPH.
| Co dostanete | Dostupnost |
|---|---|
| Požadavky — Free | 100 / měsíc |
| Požadavky — Starter | 500 / měsíc |
| Požadavky — PRO | 5 000 / měsíc |
| Požadavky — Business | 20 000 / měsíc |
| Balíčky požadavků navíc | Jen Business10 000 za 5 € · 50 000 za 20 €, bez DPH |
| Technická podpora k API | Od tarifu Starter |
| MCP server pro AI agenty | Každý tarif, včetně FreePočítá se do stejného měsíčního limitu požadavků |
Nemusíte to stavět sami
Pokud nemáte vývojáře nazbyt, existují dvě cesty, které nevyžadují žádný kód. Propojte Lucanto s AI asistentem přes MCP a požádejte ho o faktury běžnou řečí. Nebo integraci předejte některému z vývojářů níže — přesně to dělají.
Integrační partneři
Nezávislí vývojáři a studia, kteří už s API Lucanto pracovali a dokážou vám integraci postavit. Fakturují vám přímo — nebereme si provizi a práci nezprostředkováváme.
| Firma | Země | Kontakt | Stack | |
|---|---|---|---|---|
| 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 |
Chcete být v tabulce?
Pokud stavíte integrace a chcete, aby k vám chodily zakázky, napište nám. Uveďte, v jakém stacku pracujete a kde je vaši práci vidět — doplníme vás do této tabulky. hello@lucanto.eu
Časté dotazy k API
Je REST API dostupné i ve Free plánu?
Ano. REST API je součástí Lucanto i ve Free plánu, se 100 požadavky měsíčně — na propojení vlastního systému nemusíte přecházet výš. Vyšší limity přinášejí placené tarify: Starter 500, PRO 5 000 a Business 20 000 požadavků měsíčně.
Jaké jsou limity požadavků podle tarifu?
Free 100, Starter 500, PRO 5 000 a Business 20 000 požadavků měsíčně. V tarifu Business si můžete dokoupit balíčky navíc — 10 000 za 5 € nebo 50 000 za 20 €, obojí bez DPH. Nižší tarify doplněk na požadavky navíc nemají; pokud jich potřebujete víc, přejdete na vyšší tarif.
Můžu vystavit fakturu z vlastního systému?
Ano, to je hlavní smysl API. Z vlastní aplikace, e-shopu nebo interního nástroje zavoláte Lucanto a vystavíte fakturu bez jakéhokoli přepisování; stejně tak můžete synchronizovat klienty a stahovat doklady i jejich stav. Endpointy, formáty a autentizace jsou zdokumentované na docs.lucanto.eu.
Který token mám použít?
Pro integraci, která jedná za firmu — e-shop, synchronizace účetnictví, interní nástroj — použijte token pracovního prostoru (lct_live_). Je vázaný na ten jeden pracovní prostor, takže nemůže sáhnout do cizích, a nepřestane fungovat, když člověk, který ho vytvořil, odejde. Osobní token (lct_pat_) nese vaše vlastní oprávnění napříč všemi pracovními prostory, kam patříte, což se hodí pro osobní skripty a AI asistenty. Pro oba platí jedno: token je při vytvoření omezený oprávněními uživatele, který ho vydal, takže nikdy nedá víc přístupu, než má daný člověk sám.
Čím se to liší od MCP serveru?
Stejný model přístupu, jiný konzument a jiný token. REST API volá váš kód, obvykle tokenem pracovního prostoru, který patří firmě. MCP volá AI asistent jako Claude nebo ChatGPT, osobním tokenem, který patří vám. Oba používají stejná oprávnění a oba se počítají do stejného měsíčního limitu požadavků. MCP je součástí každého tarifu, i Free.
Rozbijete mi integraci?
Podstatné změny — nové endpointy, nová pole i změny narušující kompatibilitu — zveřejňujeme ve veřejném API changelogu, který můžete filtrovat podle štítků a sledovat přes RSS. Změny narušující kompatibilitu jsou takto označené, takže změnu, která by se vás dotkla, ohlásíme dřív, než dorazí k vaší integraci, místo abyste ji objevili, až něco přestane fungovat.
Nabízíte technickou podporu k API?
Technická podpora k API je dostupná od tarifu Starter výše. Ve Free plánu dostanete samotné API se 100 požadavky měsíčně, podporu k němu ale ne. Pokud pracujete na integraci a potřebujete poradit, napište nám přes kontaktní formulář.