Skip to main content
Radek Venzhöfer · sevdesk API

sevdesk Schnittstelle

sevdesk hat eine umfangreiche API, aber sie verzeiht wenig: falsche Steuerregel, falsches Buchungskonto, und der Beleg wird abgelehnt. Ich baue Anbindungen, die mit den Regeln von sevdesk arbeiten statt gegen sie.

Was über die API läuft

Die sevdesk-API deckt Ausgangs- und Eingangsseite ab, dazu die Bank.

  • Rechnungen erstellen und als PDF erzeugen
  • E-Rechnungen im ZUGFeRD- und XRechnung-Format
  • Belege mit Datei hochladen und kontieren
  • Kontakte anlegen und aktuell halten
  • Bankumsätze importieren und zuordnen
  • Dokumente festschreiben

Typische Anbindungen

Wo in Betrieben mit sevdesk am meisten abgetippt wird.

  • Shop-Bestellungen als Rechnung
  • Eingangsrechnungen aus dem Postfach als Beleg
  • Abrechnung aus Projekt- oder Zeiterfassung
  • Kontakte aus dem CRM
  • Umsätze von Zahlungsanbietern
  • Berichte aus sevdesk-Daten

Was seit sevdesk 2.0 anders ist

Mit dem Update auf Version 2.0 hat sevdesk die Buchungslogik umgestellt. Ältere Integrationen brechen genau hier.

  • Buchungskonten statt der alten Buchungsarten
  • Steuerregeln statt Steuertyp und Steuersatz-Set
  • strengere Prüfung, ungültige Daten werden abgelehnt
  • Festschreiben über eigene Endpunkte
  • Anbindungen vor 2.0 brauchen oft eine Überarbeitung

Projektsprache ist Englisch oder Tschechisch

Diese Seite ist auf Deutsch, damit Sie wissen, was Sie bekommen. Die Zusammenarbeit selbst läuft auf Englisch oder Tschechisch — Abstimmung, Dokumentation und Übergabe. Ich spreche kein Deutsch, und es ist fairer, das hier zu sagen als im ersten Gespräch. Welche Buchungskonten und Steuerregeln gelten, legen Sie mit Ihrer Steuerberatung fest; ich setze es um.

FAQ

Unsere alte sevdesk-Integration meldet plötzlich Fehler. Woran liegt das?
Häufig an sevdesk 2.0. Seitdem verwendet die API Buchungskonten und Steuerregeln statt der früheren Buchungsarten und Steuertypen, und sie lehnt Belege mit unpassenden Kombinationen ab. Eine Integration, die vor der Umstellung gebaut wurde, muss dann angepasst werden. Das übernehme ich auch für Anbindungen, die ich nicht gebaut habe.
Wie wird ein Beleg mit PDF angelegt?
In zwei Schritten: Zuerst wird die Datei hochgeladen, dann wird der Beleg mit seinen Positionen gespeichert und verweist auf diese Datei. Wer nur den zweiten Schritt kennt, bekommt Belege ohne Bild — und Rückfragen von der Steuerberatung.
Wie erfährt unser System von Änderungen in sevdesk?
In der öffentlichen API-Dokumentation von sevdesk finden sich keine Webhooks. Änderungen werden deshalb in festen Abständen abgefragt. Das plane ich so, dass nichts doppelt verarbeitet wird und ein Ausfall auffällt.
Wie wird der Zugang abgesichert?
sevdesk vergibt einen API-Token, der an einen Benutzer gebunden ist. Wird der Benutzer gelöscht oder der Token neu erzeugt, ist die Verbindung getrennt. Ich lege deshalb fest, unter welchem Benutzer die Anbindung läuft, und dokumentiere, was bei einem Wechsel zu tun ist.
Können die Daten auch zu DATEV?
Das entscheidet Ihre Steuerberatung. Wenn ein Teil der Buchhaltung direkt nach DATEV soll, beschreibe ich die möglichen Wege auf der Seite zur DATEV-Schnittstelle.

Was landet bei Ihnen heute von Hand in sevdesk?

Beschreiben Sie mir, welche Rechnungen und Belege Ihr Team in sevdesk anlegt und woher sie kommen. Wo Daten von einem System ins andere übertragen werden, lässt sich das meist abstellen.

Kontakt aufnehmen
Schreiben Sie mir auf WhatsApp