REST API
Lasă propriul tău sistem să factureze
Emite factura direct din magazinul online, din aplicație sau dintr-un script. Autentificare cu token, paginare cu cursor și scrieri idempotente — cu 100 de cereri pe lună în planul Free, fără card bancar.
curl https://app.lucanto.eu/api/v1/workspaces/{workspace_id}/invoices \
-H "Authorization: Bearer lct_live_xxx"Ce poți construi
Comenzile devin facturi
Magazinul sau aplicația ta apelează Lucanto în momentul în care comanda este plătită, iar factura există — fără export, fără retastare, fără recuperat la sfârșit de lună.
Clienții rămân sincronizați
Creezi și actualizezi clienți din propriul sistem și păstrezi datele de contact și de firmă identice de ambele părți.
Documente pe care le citești înapoi
Aduci facturile, starea lor de plată și datele din spatele lor în propriul raportaj, în loc să exporți tabele.
API-ul este și în planul Free
REST API nu este rezervat conturilor mari. Free include 100 de cereri pe lună — suficient ca să construiești integrarea, să o testezi și să rulezi un flux mic de facturi în producție. Când ai nevoie de o limită mai mare treci la un plan superior; nu deblochezi o funcție.
De la zero la primul apel
Creează un token de acces
În aplicația Lucanto mergi la Setări → API și generează un token de spațiu de lucru (lct_live_). Aparține unui spațiu de lucru, nu unei persoane, așa că integrarea funcționează mai departe și după ce pleacă cel care a configurat-o, și nu ajunge niciodată în alte spații de lucru. Pentru o încercare rapidă dintr-un script propriu ajunge un token personal (lct_pat_). Permisiunile (scopes) sunt modul în care păstrezi o integrare de tip „doar citire” chiar doar de citire.
Fă primul apel
Trimite prima cerere către https://app.lucanto.eu/api/v1, cu tokenul în antetul Authorization. Ghidul de start rapid din documentație te conduce cap-coadă în mai puțin de cinci minute.
Pregătește-o pentru producție
Trimite un Idempotency-Key la fiecare POST, ca o reîncercare să nu emită factura de două ori, parcurge colecțiile cu cursorul în loc de offset și tratează structura de eroare, nu doar verificarea unui HTTP 200.
Cum se comportă API-ul
Detaliile care decid dacă o integrare supraviețuiește primei săptămâni proaste. Fiecare rând trimite la pagina sa din documentație.
| Aspect | Cum funcționează |
|---|---|
| URL de bază | https://app.lucanto.eu/api/v1 |
| Token de spațiu de lucru (lct_live_) | Legat de un singur spațiu de lucru — pentru integrări de magazin online și contabilitate care acționează în numele firmei |
| Token personal (lct_pat_) | Permisiunile tale, în toate spațiile de lucru din care faci parte — pentru scripturi și asistenți AI |
| Paginare | Cu cursor, stabilă și când apar înregistrări noi |
| Idempotență | Antetul Idempotency-Key la POST, așa că reîncercările sunt sigure |
| Erori | O singură structură de eroare, la toate endpointurile |
Publicăm ce se schimbă
Endpointurile noi, câmpurile noi și modificările care rup compatibilitatea ajung într-un changelog public al API-ului. Modificările care rup compatibilitatea sunt marcate ca atare, deci le vezi înainte să ajungă la tine — iar RSS ți le aduce, fără să fie nevoie să verifici.
Cereri pe planuri
Limita de cereri crește odată cu planul. Suportul tehnic pentru API este disponibil de la Starter în sus. Prețurile suplimentelor sunt fără TVA.
| Ce primești | Disponibilitate |
|---|---|
| Cereri — Free | 100 / lună |
| Cereri — Starter | 500 / lună |
| Cereri — PRO | 5.000 / lună |
| Cereri — Business | 20.000 / lună |
| Pachete de cereri suplimentare | Doar Business10.000 pentru 5 € · 50.000 pentru 20 €, fără TVA |
| Suport tehnic pentru API | De la planul Starter |
| Server MCP pentru agenți AI | Toate planurile, inclusiv FreeSe scade din aceeași limită lunară de cereri |
Nu trebuie să construiești tu totul
Dacă nu ai un dezvoltator disponibil, există două căi care nu cer deloc cod. Conectează Lucanto la un asistent AI prin MCP și cere-i facturi în limbaj obișnuit. Sau dă integrarea unuia dintre dezvoltatorii de mai jos — exact asta fac.
Parteneri de integrare
Dezvoltatori independenți și studiouri care au lucrat deja cu API-ul Lucanto și îți pot construi integrarea. Îți facturează direct — nu luăm comision și nu intermediem lucrarea.
| Firmă | Țară | Persoană de contact | Stack | |
|---|---|---|---|---|
| SME Digital s.r.o. | Slovacia | Miloš Blaško | info@visblee.sk | PHP, Laravel, Ruby |
| Seiri s.r.o. | Slovacia | Marek Panti | marekpanti@gmail.com | Node.js, NestJS, Java |
| Seky IT s.r.o. | Slovacia | Lukáš Sekerák | sekys.sekys@gmail.com | PHP, Node.js |
| Studio TEM, s.r.o. | Slovacia | Michal Fehér | spolupraca@studiotem.com+421 911 258 330 | PHP, Laravel, WooCommerce, WordPress, Node.js |
| MATATE s.r.o. | Slovacia | Dávid Brontvaj | info@matate.sk | PHP, Next.js, Node.js |
Vrei să apari aici?
Dacă construiești integrări și vrei să îți trimitem lucrări, scrie-ne. Spune-ne în ce stack lucrezi și unde îți putem vedea munca — te adăugăm în acest tabel. hello@lucanto.eu
Întrebări frecvente despre API
REST API este disponibil și în planul Free?
Da. REST API face parte din Lucanto și în planul Free, cu 100 de cereri pe lună — nu trebuie să treci la un plan superior ca să îți conectezi propriul sistem. Limitele mai mari vin cu planurile plătite: Starter 500, PRO 5.000 și Business 20.000 de cereri pe lună.
Care sunt limitele de cereri pe fiecare plan?
Free 100, Starter 500, PRO 5.000 și Business 20.000 de cereri pe lună. În planul Business poți cumpăra pachete suplimentare — 10.000 pentru 5 € sau 50.000 pentru 20 €, ambele fără TVA. Planurile inferioare nu au supliment de cereri; dacă ai nevoie de mai multe, treci la un plan superior.
Pot emite o factură din propriul sistem?
Da, acesta este rostul principal al API-ului. Din propria aplicație, din magazinul online sau dintr-un instrument intern apelezi Lucanto și emiți factura fără să retastezi nimic; la fel poți sincroniza clienții și descărca documentele împreună cu starea lor. Endpointurile, formatele și autentificarea sunt documentate pe docs.lucanto.eu.
Ce token ar trebui să folosesc?
Pentru o integrare care acționează în numele firmei — un magazin online, o sincronizare cu contabilitatea, un instrument intern — folosește un token de spațiu de lucru (lct_live_). Este legat de acel singur spațiu de lucru, deci nu poate ajunge în altele și nu încetează să funcționeze când pleacă persoana care l-a creat. Un token personal (lct_pat_) îți poartă propriul acces în toate spațiile de lucru din care faci parte, ceea ce se potrivește scripturilor personale și asistenților AI. Un lucru este valabil pentru amândouă: la creare, tokenul este limitat de permisiunile utilizatorului care l-a emis, deci nu poate acorda niciodată mai mult acces decât are deja acea persoană.
Prin ce diferă de serverul MCP?
Același model de acces, alt consumator și alt token. REST API este ceea ce apelează codul tău, de regulă cu un token de spațiu de lucru care aparține firmei. MCP este ceea ce apelează un asistent AI precum Claude sau ChatGPT, cu un token personal care îți aparține. Amândouă folosesc aceleași permisiuni și amândouă se scad din aceeași limită lunară de cereri. MCP este inclus în toate planurile, inclusiv Free.
Îmi veți strica integrarea?
Modificările importante — endpointuri noi, câmpuri noi și modificări care rup compatibilitatea — sunt publicate într-un changelog public al API-ului, pe care îl poți filtra după etichete și urmări prin RSS. Modificările care rup compatibilitatea sunt marcate ca atare, așa că o schimbare care te-ar afecta este anunțată înainte să ajungă la integrarea ta, nu descoperită când ceva nu mai merge.
Oferiți suport tehnic pentru API?
Suportul tehnic pentru API este disponibil de la planul Starter în sus. În planul Free primești API-ul în sine, cu 100 de cereri pe lună, dar nu și suport pentru el. Dacă lucrezi la o integrare și ai nevoie de ajutor, scrie-ne prin formularul de contact.