REST-API
Ihr System erledigt die Rechnungsstellung
Stellen Sie Rechnungen direkt aus Ihrem Onlineshop, Ihrer App oder Ihrem Skript aus. Token-Authentifizierung, Cursor-Paginierung und idempotente Schreibzugriffe – mit 100 Anfragen pro Monat im kostenlosen Tarif, ganz ohne Kreditkarte.
curl https://app.lucanto.eu/api/v1/workspaces/{workspace_id}/invoices \
-H "Authorization: Bearer lct_live_xxx"Was Sie damit umsetzen können
Aus Bestellungen werden Rechnungen
Ihr Onlineshop oder Ihre App ruft Lucanto auf, sobald eine Bestellung bezahlt ist. Die Rechnung entsteht ohne Export, erneute Dateneingabe oder monatliche Nacharbeit.
Kundendaten bleiben synchron
Legen Sie Kunden aus Ihrem System an und aktualisieren Sie sie. Kontakt- und Unternehmensdaten bleiben auf beiden Seiten gleich.
Belege und Status abrufen
Übernehmen Sie Rechnungen, Zahlungsstände und zugehörige Daten in Ihre Berichte, statt Tabellen zu exportieren.
Die API gibt es schon im kostenlosen Tarif
Die REST-API ist nicht großen Konten vorbehalten. Der kostenlose Tarif enthält 100 Anfragen pro Monat – genug, um eine Integration zu entwickeln, zu testen und einen kleinen echten Rechnungsablauf zu betreiben. Für ein höheres Limit wechseln Sie den Tarif; Sie müssen die Funktion nicht erst freischalten.
Von null bis zur ersten Anfrage
Zugriffstoken erstellen
Erstellen Sie in Lucanto unter Einstellungen → API einen Arbeitsbereich-Token (lct_live_). Er gehört zu einem Arbeitsbereich statt zu einer Person. So läuft die Integration weiter, wenn die Person, die sie eingerichtet hat, das Team verlässt, und sie kann nicht auf deren andere Arbeitsbereiche zugreifen. Für einen schnellen Test mit Ihrem eigenen Skript genügt ein persönlicher Token (lct_pat_). Mit Berechtigungen halten Sie eine reine Leseintegration schreibgeschützt.
Erste Anfrage senden
Senden Sie Ihre erste Anfrage an https://app.lucanto.eu/api/v1 und übergeben Sie den Token im Authorization-Header. Der Schnellstart in der Dokumentation führt Sie in weniger als fünf Minuten durch alle Schritte.
Für den Produktivbetrieb absichern
Senden Sie bei jedem POST einen Idempotency-Key, damit ein erneuter Versuch keine Rechnung doppelt ausstellt. Blättern Sie mit dem Cursor statt mit einem Offset durch Listen und verarbeiten Sie die Fehlerantwort, statt nur auf HTTP 200 zu prüfen.
So verhält sich die API
Die Details, die eine Integration auch dann zuverlässig machen, wenn etwas schiefgeht. Jede Zeile führt zur entsprechenden Dokumentationsseite.
| Aspekt | Funktionsweise |
|---|---|
| Basis-URL | https://app.lucanto.eu/api/v1 |
| Arbeitsbereich-Token (lct_live_) | An einen einzelnen Arbeitsbereich gebunden – für Onlineshop- und Buchhaltungsintegrationen, die im Auftrag des Unternehmens handeln |
| Persönlicher Token (lct_pat_) | Ihre eigenen Berechtigungen in allen Arbeitsbereichen, denen Sie angehören – für Skripte und KI-Assistenten |
| Paginierung | Cursor-basiert und auch bei neuen Einträgen stabil |
| Idempotenz | Idempotency-Key-Header bei POST, damit Wiederholungen sicher sind |
| Fehler | Einheitliches Fehlerformat für alle Endpunkte |
Änderungen dokumentieren wir öffentlich
Neue Endpunkte, neue Felder und inkompatible Änderungen stehen im öffentlichen API-Änderungsprotokoll. Inkompatible Änderungen sind gekennzeichnet, damit Sie sie vor der Einführung sehen. Per RSS kommen die Neuigkeiten direkt zu Ihnen.
Anfragen je Tarif
Das Anfragekontingent wächst mit dem Tarif. Technischer API-Support ist ab Starter verfügbar. Preise für Zusatzpakete verstehen sich zuzüglich USt.
| Leistung | Verfügbarkeit |
|---|---|
| Anfragen – Free | 100 / Monat |
| Anfragen – Starter | 500 / Monat |
| Anfragen – PRO | 5.000 / Monat |
| Anfragen – Business | 20.000 / Monat |
| Zusätzliche Anfragenpakete | Nur Business10.000 für 5 € · 50.000 für 20 €, zzgl. USt. |
| Technischer API-Support | Ab Starter |
| MCP-Server für KI-Agenten | In jedem Tarif, auch FreeZählt zum selben monatlichen Anfragekontingent |
Sie müssen die Integration nicht selbst entwickeln
Wenn Ihnen kein Entwickler zur Verfügung steht, gibt es zwei Wege ohne eigenen Code: Verbinden Sie Lucanto per MCP mit einem KI-Assistenten und bitten Sie ihn in natürlicher Sprache um Rechnungen. Oder beauftragen Sie einen der unten genannten Entwickler mit der Integration – genau darauf sind sie spezialisiert.
Integrationspartner
Unabhängige Entwickler und Studios mit Erfahrung in der Lucanto-API, die Ihre Integration umsetzen können. Sie rechnen direkt mit Ihnen ab – wir erhalten keine Provision und vermitteln den Auftrag nicht.
| Unternehmen | Land | Kontakt | Technologien | |
|---|---|---|---|---|
| SME Digital s.r.o. | Slowakei | Miloš Blaško | info@visblee.sk | PHP, Laravel, Ruby |
| Seiri s.r.o. | Slowakei | Marek Panti | marekpanti@gmail.com | Node.js, NestJS, Java |
| Seky IT s.r.o. | Slowakei | Lukáš Sekerák | sekys.sekys@gmail.com | PHP, Node.js |
| Studio TEM, s.r.o. | Slowakei | Michal Fehér | spolupraca@studiotem.com+421 911 258 330 | PHP, Laravel, WooCommerce, WordPress, Node.js |
| MATATE s.r.o. | Slowakei | Dávid Brontvaj | info@matate.sk | PHP, Next.js, Node.js |
Möchten Sie hier erscheinen?
Wenn Sie Integrationen entwickeln und neue Aufträge suchen, schreiben Sie uns. Nennen Sie Ihre Technologien und zeigen Sie uns Arbeitsproben – wir nehmen Sie in diese Liste auf. hello@lucanto.eu
Häufige Fragen zur API
Ist die REST-API im kostenlosen Tarif verfügbar?
Ja. Die REST-API gehört auch im kostenlosen Tarif zu Lucanto, mit 100 Anfragen pro Monat. Sie müssen für die Anbindung Ihres Systems nicht upgraden. Die kostenpflichtigen Tarife bieten höhere Limits: Starter 500, PRO 5.000 und Business 20.000 Anfragen pro Monat.
Welche Anfragelimits gelten je Tarif?
Free umfasst 100, Starter 500, PRO 5.000 und Business 20.000 Anfragen pro Monat. Im Business-Tarif können Sie Pakete mit 10.000 Anfragen für 5 € oder 50.000 für 20 € hinzubuchen, jeweils zuzüglich USt. In niedrigeren Tarifen gibt es kein Zusatzpaket; für mehr Anfragen wechseln Sie den Tarif.
Kann ich eine Rechnung aus meinem System ausstellen?
Ja, das ist der Hauptzweck der API. Ihre App, Ihr Onlineshop oder Ihr internes Werkzeug ruft Lucanto auf und stellt eine Rechnung aus, ohne Daten erneut einzugeben. Sie können auch Kunden synchronisieren und Belege samt Status abrufen. Endpunkte, Formate und Authentifizierung sind unter docs.lucanto.eu dokumentiert.
Welchen Token sollte ich verwenden?
Für eine Integration, die im Auftrag des Unternehmens handelt – etwa Onlineshop, Buchhaltungssynchronisierung oder internes Werkzeug – verwenden Sie einen Arbeitsbereich-Token (lct_live_). Er ist an diesen einen Arbeitsbereich gebunden, kann keine anderen Arbeitsbereiche einer Person erreichen und bleibt gültig, wenn seine Erstellerin oder sein Ersteller das Unternehmen verlässt. Ein persönlicher Token (lct_pat_) übernimmt Ihre Berechtigungen in allen Arbeitsbereichen, denen Sie angehören. Das passt zu eigenen Skripten und KI-Assistenten. Für beide gilt: Die Berechtigungen eines Tokens können bei der Erstellung nie über die Rechte der ausstellenden Person hinausgehen.
Worin unterscheidet sich das vom MCP-Server?
Das Zugriffsmodell ist gleich, aber Nutzer und Token unterscheiden sich. Die REST-API wird von Ihrem Code aufgerufen, meist mit einem Arbeitsbereich-Token für das Unternehmen. MCP wird von einem KI-Assistenten wie Claude oder ChatGPT mit einem persönlichen Token aufgerufen. Beide nutzen dieselben Berechtigungen und zählen zum selben monatlichen Anfragekontingent. MCP ist in jedem Tarif enthalten, auch in Free.
Können Änderungen meine Integration beeinträchtigen?
Wichtige Änderungen – neue Endpunkte, neue Felder und inkompatible Änderungen – veröffentlichen wir in einem öffentlichen API-Änderungsprotokoll. Sie können es nach Kategorien filtern und per RSS verfolgen. Inkompatible Änderungen sind gekennzeichnet und werden angekündigt, bevor sie Ihre Integration erreichen.
Bieten Sie technischen Support für die API an?
Technischer API-Support ist ab dem Starter-Tarif verfügbar. Im kostenlosen Tarif erhalten Sie die API mit 100 Anfragen pro Monat, jedoch keinen technischen API-Support. Wenn Sie bei einer Integration Hilfe benötigen, schreiben Sie uns über das Kontaktformular.