Schnittstelle

Für Steuerberater-Software, Scanner, Kassensysteme und eigene Skripte. JSON über HTTPS, Zugang mit Token.

Zugang

Das Büro erzeugt in den Einstellungen ein Token, für das ganze Büro oder für einen Mandanten, mit Rechten: belege.lesen, belege.schreiben, abschluesse.lesen, mandanten.lesen. Das Token kommt als Authorization: Bearer … mit. Büro-Token brauchen bei Belegen den Parameter ?mandant=<id>.

Beleg hochladen

curl -X POST https://leasy.example/api/v1/belege \
  -H "Authorization: Bearer leasy_…" \
  -F "dateien=@rechnung.pdf" -F "dateien=@bon.jpg"

{ "ergebnisse": [ { "name": "rechnung.pdf", "ok": true, "belegId": "…", "belegnummer": "2026-000124", "dublette": false } ] }

Belege lesen

GET /api/v1/belege?jahr=2026&monat=10&status=bestaetigt
GET /api/v1/belege/{id}          Felder, Steuern je Satz, Positionen, Kontierung, Prüfergebnisse
GET /api/v1/dateien/{id}         Originaldatei, Kopfzeile X-SHA256

Monatspakete

GET /api/v1/abschluesse[?mandant=…]
GET /api/v1/abschluesse/{id}/paket   ZIP: DATEV-Buchungsstapel (EXTF), Belegbilder, Übersicht, Belegliste

Mandanten

GET /api/v1/mandanten   Name, Kürzel, Status, Kontenrahmen, Belegadresse, Paket

Belegadresse

Ohne Programmierung: Jeder Mandant hat eine eigene E-Mail-Adresse. Rechnungen, die dorthin weitergeleitet werden, landen als Belege; E-Rechnungen (XRechnung, ZUGFeRD) werden direkt aus dem XML gelesen.

Fehler

401 ohne oder mit ungültigem Token, 403 ohne das nötige Recht, 400 bei fehlenden Angaben, 404 wenn etwas nicht zu diesem Zugang gehört. Antworten tragen ein Feld fehler mit einem Satz.