Produkt und Entwicklung liefern eine Integration, nicht eine je Buchhaltungssystem
Ihre Kunden führen ihre Bücher in dem System, für das sie sich entschieden haben, und diese Wahl ist ihre und nicht Ihre. Maesn legt eine REST-API vor alle diese Systeme, und Sie liefern eine Integration statt Dutzender.
- DATEVOAuth + Client Credentials, XML
- XeroMandanten-ID je Verbindung, REST
- sevdeskAPI-Token, eigene Feldnamen
- und danach ein Client je System
Jedes System erledigt denselben Use Case, aber jedes auf seine eigene Weise
Jedes System hat das Rad neu erfunden: andere Anmeldeverfahren, andere Objektstruktur, mehrere API-Aufrufe für einen einzigen Datensatz, Webhooks, die es entweder nicht gibt oder die anders funktionieren, benutzer- gegen anwendungsbezogen, synchrone gegen asynchrone Aufrufe, Technologien zwischen REST, SOAP und XML/CSV-Upload, Zulassungsverfahren, dünne Dokumentation, fehlende Sandboxes, verschiedene Paginierungen, Ratenbegrenzungen, Datenformate, Entwicklerzugänge und vieles mehr.
verlangen sieben verschiedene Sätze an Pflichtfeldern für dieselbe Ausgabe
so viele Arten gibt es, wie diese Systeme das Konto nennen, auf das die Zeile bucht
erwarten den Betrag netto, gegen vier, die ihn brutto erwarten, und der Unterschied ist die Steuer
Ein Objekt, über die Systeme gezählt, die es unterstützen. Das ist die Arbeit, die in einer Schätzung je Konnektor nicht enthalten ist, und Ausgabenmanagement legt sie Feld für Feld offen.
Ein neues System anzubinden heißt immer, neue Wege kennenzulernen, etwas zu bauen, die Einzelheiten zu verstehen und die Eigenheiten zu erkunden, die nicht dokumentiert sind. Das kostet Zeit und lässt sich oft nur erkunden, wenn man wirklich tief in ein System einsteigt und eine Technologiepartnerschaft aufbaut. Beide Hälften davon, die undokumentierten Eigenheiten und die Partnerschaft, die den Zugang überhaupt erst öffnet, stehen System für System in was der Eigenbau dieser Anbindungen bedeutet.
Aber wollen Sie das wirklich tun? Besonders dann, wenn genau das längst getan ist?
Alles vereinheitlicht, als wäre es nur ein System
GET /invoices?limit=50X-API-KEY: <x-api-key> # Ihre Kennung bei unsX-ACCOUNT-KEY: <x-account-key> # die Kennung Ihres Kunden, bei der Anmeldung erhalten# Derselbe Aufruf für jedes angebundene System. Welches System# antwortet, entscheidet der Account-Key und kein Zweig in Ihrem Code.
Sie binden einmal an, gegen ein gemeinsames Datenmodell. Eine Rechnung hat dieselben Feldnamen und dieselben Typen, ob sie aus DATEV, Xero oder sevdesk kommt, und Ihre Produktlogik trägt keinen Zweig je Hersteller mehr. Ein Aufruf wie GET /invoices bleibt derselbe Aufruf, und welches System ihn beantwortet, ist ein Wert, den Sie mitgeben, und kein Codepfad, den Sie pflegen.
Einen Kunden zu verbinden ist ein Ablauf und kein Projekt. Unified Authentication fängt die Herstellerunterschiede ab, die es wirklich gibt, hier eine App-Registrierung, dort ein Mandant, der beim Verbinden gewählt wird, und die Tokens bleiben auf unserer Seite. Wo eine Installation ein Feld trägt, nach dem sonst niemand fragt, greift Customisation Handling am Modell vorbei auf den eigenen Endpunkt des Systems, und eine Ausnahme bleibt eine Anfrage statt eines Seitenzweigs.
Alles, was die Entwicklung braucht, um in Tagen live zu gehen
Unsere Maesn-Funktionen vereinheitlichen alles, was sich vereinheitlichen lässt, und bei Herausforderungen eines einzelnen Use Case helfen wir Ihnen weiter.
- Common Data Model
Eine Feldnamen-Übersetzung je Hersteller, und die Zuordnungstabelle, die mit jedem System wächst.
- Unified Authentication
Einen Hersteller-Zugang je System, dazu den Token-Lebenszyklus dahinter.
- Unified Pagination & Filtering
Die Seitenschleife je System, und das nächtliche Komplett-Neulesen, das die Frage nach Änderungen ersetzt.
- Unified Webhooks
Ein Abonnement und einen Event-Rumpf statt eines eigenen Herstellermodells je Anbindung.
- Unified Error Handling
Einen Fehlerdialekt je System, und das Support-Handbuch, das mit jedem weiteren wächst.
- Asynchronous Processing
Eigene Ratenbegrenzung, Reihenfolge und Aufgabenverfolgung für den Monatsabschluss, der sich nicht benimmt.
- Unified Logging & Monitoring
Aus eigenen Protokollen zu raten, welches System für welchen Kunden wann ausgefallen ist.
- Customisation Handling
Einen Seitenzweig, wenn eine Installation ein Feld trägt, nach dem sonst niemand fragt.
- MCP Server
Selbst eine Agenten-Schnittstelle über Buchhaltungsdaten zu bauen, sobald Ihr Produkt eine braucht.
Manche Systeme bieten gar keine Entwickler-Sandboxes an. Für die betreiben wir Testumgebungen, die Sie nutzen können.
- AbaBau
Gemacht für Entwickler
HERO Software betreibt das Backoffice für Handwerksbetriebe, vom Angebot bis zur Rechnung, und mehr als 40.000 Handwerker arbeiten damit.
“Der Support ist wirklich erstklassig, mit beeindruckend kurzen Antwortzeiten. Die Dokumentation ist gründlich und leicht nachvollziehbar, und dadurch verlief die Anbindung für mich reibungslos. Ich schätze außerdem die große Auswahl an Buchhaltungsanbindungen und Endpunkten. Man merkt deutlich, dass die Endpunkte laufend weiterentwickelt und erweitert werden, was der Plattform noch mehr Wert gibt.”
Was über die API ankommt, und was Ihr Produkt bleibt
Eine vereinheitlichende Schicht, die über ihre Grenze vage bleibt, kostet mehr als eine, die sie eng zieht.
- Eine REST-API und ein Objektmodell über alle angebundenen Systeme
- Ein Verbindungsablauf je Kunde, dazu Tokens und ihre Erneuerung
- Eine Sandbox je System, auch bei denen ohne eigenen Test
- API-Änderungen der Hersteller zentral abgefangen, nicht in Ihrem Release
- Ein Event-Modell und ein signierter Event-Rumpf
- Wann ein Datensatz Ihr Produkt verlässt und was ihn auslöst
- Auf welches Konto, welchen Steuersatz und welche Dimension eine Zeile gehört
- Der Abgleich vor dem Schreiben, damit kein Datensatz doppelt entsteht
- Was Ihre Nutzer sehen, wenn ein Zielsystem etwas ablehnt
- Der Ablauf selbst, vom Angebot bis zur Buchung
Die Entscheidungen rechts hängen davon ab, was Sie gebaut haben, und dort sollen sie bleiben. Was die Schicht abnimmt, ist der Teil, der für jedes Produkt gleich und für jedes System anders ist. Rechnungserstellung ist das kürzeste Beispiel für beide Hälften in einem Ablauf, und das Verzeichnis der angebundenen Systeme zeigt, wogegen die rechte Spalte bestehen muss. Wie Anfragen verarbeitet werden und was unterwegs gespeichert wird, steht auf der Sicherheitsseite.
Häufige Fragen
Warum Maesn nutzen, statt die Anbindungen selbst zu bauen?
Müssen wir uns weiterhin mit den Datenformaten jedes Systems befassen?
Bekommen wir Sandboxes, und für welche Systeme?
Müssen wir Zugriffstokens selbst verwalten?
Ist die Anmeldung über alle Systeme hinweg gleich?
Wie funktionieren Webhooks hier?
Unterstützt die API Filtern, Sortieren und Paginieren?
Was passiert, wenn ein ERP stark angepasst ist?
Was passiert, wenn ein Hersteller seine API ändert?
Ist die Dokumentation auf Englisch?
Einmal bauen, auf der Unified API.
Sehen Sie, wie eine Integration über alle Systeme für Ihre Integration funktioniert, oder steigen Sie in die technische Referenz ein.