Sevdesk-Schnittstelle und API-Integration
Sevdesk ist eine Cloud-Buchhaltungsplattform für kleine Unternehmen, Freiberufler und ihre Steuerberater in Deutschland, Österreich und der Schweiz. Sie deckt Rechnungsstellung, Ausgaben, Kontakte und GoBD-konforme Buchführung ab. Binden Sie sie über Maesn an, und Sie erreichen sie mit derselben REST API und demselben Datenmodell wie jedes andere unterstützte System.
Eine sevdesk-Anbindung in Tagen
Sevdesk ist eine der kürzeren Integrationen im Katalog, und was es von Ihnen verlangt, sind drei Entscheidungen statt eines langen Baus. Hier stehen sie, und was Maesn davon abnimmt.
Eingesammelt, wo es Ihnen passt
Sevdesk authentifiziert mit einem API-Schlüssel, den nur ein Administrator abrufen kann. Ihr Kunde kann ihn auf einer Seite einfügen, die wir hosten, oder in ein Formular in Ihrem eigenen Produkt: Sie schicken uns den Schlüssel, und wir schicken den Account-Key zurück, der diese Verbindung bei jeder späteren Anfrage kennzeichnet.
Derselbe Abruf wie überall sonst
Nichts in einem sevdesk-Konto ruft Ihren Endpunkt auf, Änderungen zu erkennen ist also ein geplanter Lesezugriff. Wie oft er läuft, entscheiden weiterhin Sie, aber Sie schreiben ihn für sevdesk nicht noch einmal: Filter und Paginierung sind die, die Sie für jedes andere System schon benutzen.
Wir sind auf der anderen Seite schon da
Sevdesk verlangt vor dem Bauen keine Freigabe und keine Registrierung. Für das Technology-Partner-Programm melden Sie sich an, sobald Ihre Integration die ersten zehn Nutzer angebunden hat, und Maesn geht diesen Schritt als bestehender Partner mit Ihnen.
In Ihrem Code kommen ein REST-Aufruf und ein Account-Key an. Teams gehen in Tagen live, und das System nach sevdesk ist ein Konfigurationsschritt und kein zweites Projekt.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
HubSpot erreicht sevdesk, Lexware und DATEV über eine API
HubSpot gleicht Kundendaten, Rechnungen und Zahlungserinnerungen nach sevdesk, Lexware, DATEV und weitere Systeme ab, für Hunderte seiner Kunden im DACH-Raum, ohne eine einzige dieser Integrationen selbst zu bauen oder zu pflegen.
“Wir binden deutsche Buchhaltungssysteme an und verlassen uns dabei auf Maesn als verlässlichen Partner, der für reibungslosen Datenfluss, vollständige Compliance, stärkere Partnerschaften und effiziente, verlässliche Finanzprozesse sorgt, die unser Wachstum tragen.”
Drei Gründe, die sevdesk-Schnittstelle über Maesn anzubinden
Sevdesk direkt anzubinden ist ein kurzes Projekt. Es ohne ein einziges Event aktuell zu halten, und danach das nächste System hinzuzunehmen, entscheidet über Ihre Roadmap.
Die sevdesk-Arbeit bleibt hier
Den API-Schlüssel einzusammeln, die Verbindung am Leben zu halten und die Events zu ersetzen, die sevdesk nicht sendet, ist das, was jede sevdesk-Integration lösen muss. Gelöst wird es einmal, hier, für jeden Kunden, den Sie anbinden.
Die Schreibseite ist echt und kein reiner Lesespiegel
Rechnungen, Kunden, Lieferanten, Zahlungen und Bankdaten gehen über dieselbe Schnittstelle nach sevdesk, mit der Sie sie lesen, und Kunden und Lieferanten lassen sich an Ort und Stelle aktualisieren. Was Ihr Anwendungsfall darüber hinaus braucht, ist eine Anfrage und kein Umbau.
Das nächste System kostet nichts
Sobald sevdesk läuft, antwortet jedes andere unterstützte Buchhaltungs- und ERP-System auf derselben Schnittstelle. Ihre zweite Integration ist ein Konfigurationsschritt.
Ein sevdesk-Partnerprogramm, das vorab nichts verlangt
Die meisten Anbieter hören bei der API auf. Maesn übernimmt die technische Seite und die Beziehung, und bei sevdesk ist die Beziehung ungewöhnlich günstig zu betreten: Die Dokumentation sagt ausdrücklich, dass es kein Freigabeverfahren und keine Registrierung gibt, und an dem Tag, an dem Sie beitreten, ändert sich nichts an dem, was Sie bauen können.
Technische Unterstützung
Eine Integration gegen die Unified API und ein Datenmodell, identisch zu jedem anderen System, das Maesn unterstützt. Ihre Entwickler treffen hier auf dieselbe Schnittstelle wie beim nächsten System.
Unterstützung bei der Partnerschaft
Maesn ist offizieller sevdesk Technology Partner und führt Sie durch das Programm, wenn Ihre Integration so weit ist, und nicht als Hürde, die vorher zu nehmen wäre.
Vorab nichts zu klären
Es gibt kein Freigabeverfahren und keine Registrierung, bevor Sie anfangen. Jeder kann eine sevdesk-Integration bauen und danach Technology Partner werden.
Die Schwelle liegt bei zehn angebundenen Nutzern
Für das Programm melden Sie sich an, sobald Ihre Integration die ersten zehn Nutzer angebunden hat. Der Meilenstein folgt also auf die Nachfrage, statt ihr vorauszugehen.
Die Anforderungen gibt es nur auf Deutsch
Sevdesk veröffentlicht die Partneranforderungen auf Deutsch und nur auf Deutsch, und das sollten Sie wissen, wenn das Team, dem Partnerschaften gehören, nicht auf Deutsch arbeitet.
Die Integration läuft unter dem Namen Ihres Produkts, und der Partnerstatus gehört Ihnen und nicht uns. Maesn ist die Schicht dahinter.
Maesn ist bereits sevdesk Technology Partner und übernimmt Ihren Schritt gemeinsam mit Ihnen.
Ein sevdesk-Schlüssel von Ihrem Kunden, abgeholt, wo Sie wollen
Sevdesk authentifiziert mit einem API-Schlüssel statt mit einem Redirect, und das macht es zu einer der schnellsten Anbindungen im Katalog und verschiebt die einzige echte Frage auf das Nutzererlebnis: Ihr Kunde muss einen Schlüssel holen und übergeben, und wo das geschieht, entscheiden Sie.
- API-Schlüssel
- Von Ihrem Kunden abgerufen
Ein Schlüssel hinein, ein Account-Key heraus. Wo Ihr Kunde ihn eingibt, entscheiden Sie und nicht sevdesk.
- Die Maesn-Seite
- Ihr Kunde fügt den Schlüssel in Maesn Connect ein und bekommt eine Bestätigung, sobald er geprüft ist. Nichts zu bauen, und die Seite lässt sich mit Ihren Farben und Ihrem Logo gestalten.
- Der Headless-Weg
- Sie senden den Schlüssel aus Ihrem eigenen Formular an den Create-Account-Endpunkt, und der Account-Key kommt in der Antwort zurück, keine Seite außerhalb Ihres Produkts ist also beteiligt. Für sieben Systeme verfügbar, und sevdesk ist eines davon.
Die gehostete Seite ist markenfähig statt generisch: Hintergrund, Knopf, Text, Eingabefeld und Fehlerfarben plus Ihr SVG-Logo werden auf unserer Seite konfiguriert. Ein Kunde, der Ihren Ablauf nie verlässt, landet also nicht auf etwas, das nach einem Dritten aussieht.
- 1
Ihr Kunde holt den Schlüssel
Er meldet sich bei sevdesk an und kopiert den API-Schlüssel aus seinem Konto. Dafür braucht er Administratorrechte. Sagen Sie das in Ihrer eigenen Oberfläche, denn es ist der eine Schritt, den Sie ihm nicht abnehmen können.
- 2
Der Schlüssel erreicht Maesn
Entweder über die gehostete Seite oder über Ihr eigenes Formular und den Create-Account-Endpunkt. Beide Wege enden an derselben Stelle, und der Schlüssel wird bei der Verbindung verwahrt, statt mit Ihren Anfragen mitzulaufen.
- 3
Sie arbeiten mit einem Account-Key
Maesn speichert die Verbindung und gibt einen Account-Key zurück. Ab da trägt jede Anfrage Ihren API-Schlüssel und diesen Account-Key, dieselben zwei Header, die Sie für jedes andere System im Katalog ohnehin schon senden.
Jedes System im Katalog authentifiziert anders, und bei sevdesk sind die Zugangsdaten trivial und die Frage ist, wo Ihr Kunde ihnen begegnet. Unified Authentication macht daraus eine Wahl statt einer Vorgabe: Die gehostete Seite, der Headless-Endpunkt und die Art, wie Ihnen der Account-Key übergeben wird, sind dort konfigurierbar und identisch, ganz gleich, welches System ein Kunde anbindet.
sevdesk sendet nichts, also fragen Sie ab
Sevdesk veröffentlicht keine Webhooks. Kein Objekt in der Abdeckungsmatrix trägt eines, und die Dokumentation hat keinen Webhook-Abschnitt. Nichts im Konto eines Kunden wird also je Ihren Endpunkt aufrufen.
Nichts. Auf keinem Objekt gibt es ein natives Event. Eine Änderung im Konto eines Kunden bleibt also unsichtbar, bis etwas sie liest.
Ein geplanter Lesezugriff, mit demselben Filter und derselben Paginierung, die Sie für jedes andere System benutzen. Der Code, der Änderungen auf sevdesk erkennt, ist der Code, den Sie bereits geschrieben haben, nur auf einen anderen Account-Key gerichtet.
Weil die Erkennung ein Lesezugriff ist und kein Push, hängt die Aktualität Ihrer Daten davon ab, wie oft Sie ihn fahren. Das Abfragen hat einen Vorteil, den man leicht übersieht: Wenn Ihr Dienst eine Stunde lang ausfällt, liefert der nächste Lesezugriff trotzdem alles, was sich in der Zwischenzeit geändert hat. Ein Event, das in dieser Stunde ausgelöst wurde, wäre verloren gewesen.
Ein System ohne Events ist die Stelle, an der die Kosten einer Integration je System am deutlichsten sichtbar werden: Sie schreiben eine Schleife zur Änderungserkennung für sevdesk und dann noch eine für das nächste System, mit eigener Filtersyntax und einer eigenen Vorstellung davon, was eine Seite ist. Ein Weg, zu filtern und zu paginieren nimmt diese Wiederholung weg, der Delta-Abruf, den Sie hier bauen, funktioniert also weiter gegen ein System, das Events sendet. Systeme, die ihre Änderungen selbst melden, und Systeme, die Sie fragen müssen, erreichen Sie über zwei Wege derselben Schnittstelle: das Event-Modell und den Lesezugriff nach Zeitplan. Sevdesk bietet heute nur den zweiten, an dem Tag, an dem Sie ein System hinzunehmen, das sendet, ändert sich Ihr Code also nicht.
Was sevdesk vorab verlangt
Die Liste der Voraussetzungen in der eigenen Dokumentation von sevdesk ist eine Zeile lang: ein Konto mit Administratorrechten. Vier Dinge lohnen sich trotzdem einzuplanen.
- Ein sevdesk-Konto mit Administratorrechten
- Das Konto Ihres Kunden, nicht Ihres. Den API-Schlüssel kann nur ein Administrator abrufen, und zwar in sevdesk selbst.
- Eine Entscheidung darüber, wo der Schlüssel eingegeben wird
- Die Seite von Maesn ist der Standard und verlangt nichts von Ihnen. Auf dem Headless-Weg bauen Sie das Formular selbst und senden den Schlüssel an den Create-Account-Endpunkt, der den Account-Key sofort zurückgibt und den ganzen Schritt in Ihrem Produkt hält.
- Ein Zeitplan, denn nichts ruft Sie an
- Auf keinem sevdesk-Objekt gibt es ein natives Event. Die Änderungserkennung ist ein Lesezugriff, den Sie in einem Intervall fahren, und dieses Intervall ist eine Produktentscheidung, die vor den Bau gehört und nicht hinter die erste Beschwerde.
- Aus dem Partnerprogramm bisher gar nichts
- Keine Freigabe, keine Registrierung, keine Gebühr, bevor Sie anfangen. Der Schritt zum Technology Partner kommt nach Ihren ersten zehn angebundenen Nutzern, und die Anforderungen sind nur auf Deutsch veröffentlicht.
Wir gehen die Schlüsselerfassung und den Partnerschritt mit Ihnen durch.
Eine Form für sevdesk, und für das nächste System
Sevdesk ist Rechnungsstellung und Buchhaltung für kleine Unternehmen, mit den Stärken und den Kanten, die daraus folgen. Eine gemeinsame Form hält beide aus Ihrem Code heraus.
Zahlungen lassen sich schreiben, nicht lesen
Sie können eine Zahlung nach sevdesk buchen, und es gibt keinen Weg, eine zurückzulesen: Die Matrix führt für Zahlungen das Anlegen und überhaupt kein Lesen. Wenn Ihr Produkt abstimmt und nicht nur erfasst, ist das die Grenze, die Sie vor allem anderen prüfen sollten.
Kunden und Lieferanten lassen sich an Ort und Stelle aktualisieren
Diese beiden nehmen eine Änderung an einem bestehenden Datensatz direkt an. Überall sonst wird eine Korrektur als neuer Beleg geschrieben, und genau das erwartet die Buchhaltungspraxis ohnehin. Die Kombinationen aus Objekt und Operation, die nicht standardmäßig freigeschaltet sind, sind auf Anfrage verfügbar statt unverfügbar, sagen Sie uns also, welche Ihr Anwendungsfall braucht.
Standardmäßig löscht kein Objekt
Für kein Objekt ist Löschen freigeschaltet. Die Buchhaltungspraxis erwartet Korrekturen und Stornos ohnehin als neue Belege, planen Sie sie also so und nicht um ein Löschen herum, das Sie erst anfragen müssten.
Was Sie lesen, kommt im gemeinsamen Common Data Model zurück, eine Rechnung aus sevdesk hat also dieselbe Form wie eine Rechnung aus einem zehnmal so großen System, und der Code, den Sie hier schreiben, ist der Code, den Sie für das nächste wiederverwenden.
Das zählt am meisten dort, wo ein Produkt über einen Hersteller hinauswächst. Sevdesk deckt Rechnungsstellung, Ausgaben und GoBD-konforme Buchhaltung ab, und darauf führen seine Kunden ihr Unternehmen. Die Hauptbuchseite, die ein größerer Finanz-Stack erwartet, darunter Journale und eine Summen- und Saldenliste, liegt in anderen Systemen, und die sind über dieselbe Schnittstelle ohne zweite Integration erreichbar. Gegen das Modell zu bauen statt gegen einen Hersteller macht daraus einen Konfigurationsschritt statt eines Projekts.
Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen, was möglich ist.
