Lexware Office Schnittstelle und API-Integration
Lexware Office, früher lexoffice, ist eine der am weitesten verbreiteten Cloud-Buchhaltungsplattformen bei deutschen KMU, Freiberuflern und Kanzleien. Sie deckt Rechnungsstellung, Ausgabenerfassung, Kontakte und Steuerauswertungen 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 Lexware-Office-Anbindung in Tagen
Lexware Office ist nicht schwer anzubinden, es ist eigen. Drei dieser Eigenheiten landen normalerweise bei Ihren Entwicklern. Hier stehen sie, und was Maesn davon abnimmt.
Die Qualifizierung läuft über uns
Die Public API setzt beim Kunden den XL-Tarif voraus, und wer darüber hinaus will, qualifiziert sich direkt bei Lexware. Maesn ist offizieller Technology Partner und geht diesen Weg mit Ihnen.
Der Entzug kommt als Event an
Lexware Office löst ein eigenes Token-Event aus, wenn ein Nutzer den Zugriff entzieht oder ein Token sich nicht erneuern lässt. Maesn leitet es weiter wie jedes andere Event, Sie reagieren also auf eine verlorene Verbindung, statt sie an fehlschlagenden Aufrufen zu bemerken.
Für Sie angelegt und vereinheitlicht
Webhooks werden nicht einmal für Ihre App registriert, sondern je angebundenem Kunden eingerichtet. Maesn legt diese Abonnements an und bringt die Nutzlasten in dieselbe Form wie bei jedem anderen System.
Auf Ihrer Seite bleibt ein REST-Aufruf gegen ein Datenmodell, das Sie einmal implementieren. Teams gehen in Tagen live, statt ein Quartal auf ein einzelnes System zu verwenden.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
Clockin hat aus Integrationen einen Wachstumskanal gemacht
Clockin digitalisiert die Zeiterfassung für kleine und mittlere Unternehmen. Die Integrationen, die sie gebaut haben, sind kein Supportkosten-Posten mehr.
“Wir nutzen Maesn, um Integrationen und Partnerschaften erfolgreich als wichtigen Treiber für Leadgenerierung und für den Schritt in neue Märkte und Kundensegmente einzusetzen.”
Drei Gründe, die Lexware Office Schnittstelle über Maesn anzubinden
Lexware Office direkt anzubinden ist ein Projekt, das Sie abschließen können. Es dann zu besitzen, und danach das nächste System, entscheidet über Ihre Roadmap.
Ein Partner, kein Scraper
Maesn ist offizieller Lexware Technology Partner. Das öffnet den tieferen Zugriff und die Marketplace-Einträge, und beides erreichen Sie nicht, indem Sie eine öffentliche API nachbauen.
Die Objekte, die Ihr Anwendungsfall braucht, freigeschaltet
Rechnungen, Kontakte, Belege und der Rest kommen über eine Schnittstelle an, und was noch nicht freigeschaltet ist, wird freigeschaltet, sobald ein Anwendungsfall es braucht. Sagen Sie uns, mit welchen Objekten Ihr Produkt arbeitet, und wir bestätigen sie je System.
Das nächste System kostet nichts
Sobald Lexware Office läuft, antwortet jedes andere unterstützte Buchhaltungs- und ERP-System auf derselben Schnittstelle. Ihre zweite Integration ist ein Konfigurationsschritt.
Zwei Wege zu Lexware-Kunden, eine Anbindung
Die meisten Anbieter hören bei der API auf. Maesn übernimmt die technische Seite und die Beziehung, denn bei einem System wie Lexware Office entscheidet die zweite darüber, wie weit die erste Sie bringt.
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 Lexware Technology Partner. Wir führen die Qualifizierung, begleiten das Onboarding und helfen Ihnen zu einer echten Beziehung mit Lexware, so wie bei jedem anderen System, das wir freischalten.
Ohne Partnerschaft
Ihre Integration funktioniert, und Ihre Kunden verbinden sie selbst mit einem API-Schlüssel. Diesen Schlüssel anzulegen setzt den XL-Tarif voraus. Das Abonnement Ihres Kunden entscheidet also darüber, ob er sich überhaupt verbinden kann.
Mit Partnerschaft
Ihr Produkt steht an zwei Stellen gleichzeitig, auf der Lexware-Website als Partner und in Lexware Office unter Erweiterungen. Ihre Kunden verbinden sich über einen anderen Authentifizierungsweg. Die Tarifvoraussetzung entfällt damit, und jeder Lexware-Kunde kann sich verbinden.
Der Eintrag läuft unter Ihrer Marke, nicht unter der von Maesn. Ihr Name ist das, was der Kunde beim Verbinden sieht.
Maesn führt die Qualifizierung bei Lexware parallel zu Ihrer Integration.
Verschiedene Verfahren auf der Lexware-Seite, eine Umsetzung
Lexware Office unterstützt mehr als ein Authentifizierungsverfahren, und welches gilt, hängt vom Anwendungsfall und von Ihrer Beziehung zu Lexware ab. Der Weg, der allen offensteht, ist die Public API, authentifiziert mit einem API-Schlüssel, und es gibt zwei Wege, ihn einzusammeln.
- API-Schlüssel
- Public API
- Weitere Verfahren
- Innerhalb einer Partnerschaft
Maesn vereinheitlicht beide. Ihre Implementierung ändert sich also nicht mit dem Verfahren, bei dem Ihre Kunden landen.
- Maesn Connect
- Ein Popup in Ihrem eigenen Erscheinungsbild. Ihr Kunde fügt den Schlüssel ein, und die Verbindung steht.
- Headless
- Bauen Sie die Eingabe selbst und reichen Sie den Schlüssel über den Create-Account-Endpunkt ein. Vollständig programmatisch.
Über die Public API hinaus gibt es innerhalb einer Lexware-Partnerschaft weitere Verfahren. Maesn ist offizieller Lexware Technology Partner und geht dieses Verfahren mit Ihnen durch.
- 1
Ihr Kunde holt den Schlüssel
In Lexware Office öffnet ein Administrator die Add-on-Seite der Public API und kopiert den Schlüssel. Er gehört zu genau diesem Konto. Jeder Ihrer Kunden geht das also einmal für die eigene Umgebung durch.
- 2
Der Schlüssel erreicht Maesn
Welchen der beiden Wege Sie gewählt haben, Maesn Connect oder headless, der Schlüssel landet bei Maesn und wird beim Absenden geprüft. Ein ungültiger Schlüssel scheitert dort und nicht später im Produktivbetrieb.
- 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, von API-Schlüsseln über OAuth bis zu Datenbank-Zugangsdaten und Abläufen über mehrere Firmen. Unified Authentication hält diesen Unterschied von Ihrer Seite der Integration fern: Sie bauen einen Ablauf, und Maesn löst dahinter auf, was jedes System verlangt.
Native Lexware-Webhooks, mit normalisierten Payloads
Lexware Office unterstützt native Webhooks, Änderungen erreichen Sie also als Events statt über Abfragen. Maesn legt die Abonnements je angebundenem Kunden an und vereinheitlicht die Nutzlasten. Die Form, die Sie verarbeiten, ist damit bei jedem System identisch, das Sie anbinden.
Die Token-Ressource ist die, gegen die Sie bewusst bauen sollten: Lexware Office löst sie aus, wenn ein Nutzer den API-Zugriff entzieht oder wenn ein Token nicht mehr erneuert werden kann. Maesn leitet dieses Event weiter. Ihr Produkt kann also auf eine verlorene Verbindung reagieren, statt sie über fehlschlagende Aufrufe zu entdecken.
Nicht jedes Buchhaltungssystem bietet Webhooks, und mehrere bieten gar keine. Maesn schließt diese Lücke, und ein Event-Modell deckt den ganzen Katalog ab. Der Handler, den Sie für Lexware Office bauen, funktioniert also weiter für ein System, das darunter abgefragt werden muss.
Seitengrößen, die je Endpunkt wechseln, eine Konvention
Lexware Office wendet seine Paging-Regeln uneinheitlich an, und ausgerechnet der uneinheitliche Teil ist nicht dokumentiert. Maesn vereinheitlicht ihn, eine Seitengröße funktioniert also überall.
Lexware setzt die Obergrenze je Endpunkt
Der Parameter heißt size, die Standardseite umfasst 25 Einträge und das Maximum liegt bei 100 oder 250, je nachdem, welchen Endpunkt Sie aufrufen. Für die höhere Obergrenze sind fünf Endpunkte dokumentiert.
Items lehnt alles unter 25 ab
Eine Seitengröße unterhalb dieser Untergrenze wird mit einem 406 beantwortet, der Lesezugriff schlägt also fehl, statt still weniger zu liefern. Für keinen Endpunkt ist ein Minimum dokumentiert, Sie lernen diese Grenze also kennen, indem Sie dagegenlaufen.
Über Maesn senden Sie eine Seitengröße aus fünf dokumentierten Werten, 5, 10, 20, 50 oder 100, und eine Seitenzahl, die immer bei 1 beginnt. Das ist unser Unified Pagination & Filtering: Es vereinheitlicht den Paging-Kontrakt jedes angebundenen Systems zu einer einzigen Anfrageform, und so erreicht eine Inkonsistenz in der API eines Anbieters nie Ihren Code.
Lexware Office Paginierung geht beide Seiten dieses Kontrakts durch, die dokumentierten Werte auf jeder Seite und den Statuscode, unter dem eine abgelehnte Seitengröße ankommt.
Was Lexware Office voraussetzt
Lexware Office stellt drei Bedingungen vor eine Integration, und alle lassen sich leichter einplanen als auf halber Strecke entdecken.
- Die Public API braucht den XL-Tarif
- Das Lexware-Office-Abonnement Ihres Kunden muss im XL-Tarif laufen, damit die Public API zur Verfügung steht. Eine Lexware-Partnerschaft hebt diese Voraussetzung für Ihre Nutzer auf, und weiter unten auf dieser Seite steht, wie das läuft.
- Tieferen Zugriff gewährt Lexware
- Lexware öffnet weiteren Zugriff über eine bilaterale Qualifizierung mit dem Partnerteam, und damit ändert sich auch, wie Ihre Kunden sich authentifizieren. Maesn ist offizieller Lexware Technology Partner und führt dieses Verfahren mit Ihnen durch.
- Ein Konto mit Administratorrechten
- Der API-Schlüssel wird in Lexware Office erzeugt. Der verbindende Nutzer braucht also Administratorrechte für das Konto.
Wir gehen den Tarif und die Zugangsvoraussetzungen mit Ihnen durch.
Eine Form für Lexware Office und für alles daneben
Was Sie hier lesen, kommt in derselben Form an wie alles, was Sie über Maesn aus anderen Systemen lesen. Genau das macht die zweite Integration günstig.
Was Sie lesen, kommt im gemeinsamen Common Data Model zurück, eine Rechnung aus Lexware Office hat also dieselbe Form wie eine Rechnung aus jedem anderen unterstützten System, und der Code, den Sie hier schreiben, ist der Code, den Sie für das nächste wiederverwenden.
Was Maesn auf diesem System erreicht, deckt beide Wege nach Lexware Office ab und nicht nur den, den Ihre Kunden selbst öffnen können. Sagen Sie uns, mit welchen Objekten Ihr Anwendungsfall arbeitet, und wir bestätigen sie für den Weg, auf dem Ihre Kunden sind.
Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen, was möglich ist.
