Sage-Schnittstelle und API-Integration
Sage ist eine Gruppe, die durch Zukäufe gewachsen ist, und kein einzelnes System, und die Produkte, die sie in einem Land unter einem Namen verkauft, haben häufig nichts mit den Produkten zu tun, die sie in einem anderen unter demselben Namen verkauft. Maesn bindet heute Sage Active und Sage Accounting an, über eine REST API, und Sage Active allein kommt als drei Zielsysteme, weil jedes Land sein eigenes betreibt.
Drei Kosten einer Sage-Anbindung, die hier bleiben
Sage über mehr als einen Markt hinweg anzubinden sind drei Probleme, und nur das dritte ist eine API. Hier steht, was jedes davon kostet und was Maesn abfängt.
Der Markt entscheidet das System
Sage Active trägt in Deutschland, Spanien und Frankreich einen Namen und antwortet als drei getrennte Zielsysteme, jedes mit eigener App-Registrierung. Für ein Team, das in mehrere Länder verkauft, lautet die erste Frage nie, wie man die API aufruft, sondern welches Sage der Kunde vor Ihnen tatsächlich betreibt. Maesn hält diese Zuordnung. Eine Verbindung wird also ausgewählt statt recherchiert.
Ein Datenmodell über sie alle
Sage Active registriert Apps im Konto des Kunden und gibt vier Werte aus, von denen Maesn drei braucht. Sage Accounting benutzt ein eigenes Entwicklerportal und gibt zwei aus. Das eine verlangt bei jedem Aufruf eine Firmenkennung, das andere behandelt sie als optional. Das eine spricht GraphQL. Über Maesn beantworten sie dieselben REST-Aufrufe, in derselben Form, mit demselben Filtern und Blättern.
Der Partnerprozess, je Land durchlaufen
Ein Eintrag für Sage Active in Spanien ist ein anderes Verfahren mit anderen Menschen als ein Eintrag für Sage Accounting im Vereinigten Königreich, denn die Marketplaces sind national. Maesn ist offizieller Sage-Partner und übernimmt diese Verfahren je System und je Markt, statt einmal und allgemein. Gespart wird dabei weniger der Papierkram als das Herausfinden, welcher Papierkram überhaupt gilt.
In Ihrem Code kommen ein REST-Aufruf und ein Account-Key für das System an, das dieser Kunde einsetzt. Welches Sage das ist, wird zu einer Konfigurationsfrage, und der nächste Sage-Markt ist eine kommerzielle Entscheidung und keine technische.
Ein kurzes Gespräch genügt meist, um zu klären, welches Sage Ihre Kunden einsetzen.
Welche Sage-Systeme Sie erreichen, über die Maesn Unified API
Sage verkauft Produkte für den Mittelstand und Produkte für Finanzabteilungen, und mehrere davon tragen Namen, die sich über Länder hinweg wiederholen. Hier sehen Sie, wo jedes einzelne bei Maesn gerade steht.
Zwei davon sprechen heute die Maesn API an. Die anderen zwei sind benannt, damit Sie sehen, was kommt, bevor Sie darum herum planen.
Clockin hat aufgegeben, die Systeme selbst zu bauen
Clockin digitalisiert die Zeiterfassung für kleine und mittlere Unternehmen, und ihre Kunden buchen in dem, was ihre Kanzlei ihnen vorgesetzt hat. Die veröffentlichte Studie nennt Sage unter diesen Systemen und gibt die schiere Vielfalt als Grund an, warum die Integrationen selbst zu bauen nie realistisch war.
“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 Sage-Schnittstelle über Maesn anzubinden
Eine Sage-Integration, die nur je ein Land bedienen muss, ist eine normale Integration. Die Kosten tauchen mit dem zweiten Land auf, und sie tauchen mit dem dritten wieder auf, denn jedes ist ein anderes System hinter derselben Marke.
Die Produktrecherche endet hier
Welches Sage in welchem Markt läuft, wie es dort heißt und wie es authentifiziert, ist die Arbeit vor der Arbeit. Maesn trägt sie, und sie muss nicht neu gemacht werden, wenn der nächste Interessent sagt, er sei auf Sage.
Zwei Systeme, und der Unterschied ist die Antwort
Sage Active und Sage Accounting sind zwei Produkte, die ein Kunde aus verschiedenen Gründen in verschiedenen Märkten gewählt hat, und nicht zwei Konfigurationen eines Produkts. Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen sie für das System, auf dem Ihr Kunde ist.
Eine Integration, und sie gilt nicht nur für Sage
Dieselbe Schnittstelle, die Sage Active erreicht, erreicht jedes andere unterstützte Buchhaltungs- und ERP-System. Das Sage-Portfolio wächst auf unserer Seite und nicht in Ihrer Codebasis, und alles daneben ebenso.
Jeder Sage-Markt hat einen eigenen Marketplace
Die meisten Anbieter hören bei der API auf. Maesn übernimmt die technische Seite und die Beziehung, und bei Sage ist die Beziehung nicht eine Beziehung: Die Marketplaces sind national. Ein Eintrag wird also je System und je Markt mit den Menschen angestoßen, die diesen Markt betreiben.
Technische Unterstützung
Eine Integration gegen die Unified API und ein Datenmodell, identisch für jedes Sage-System und für alles andere, was Maesn unterstützt. Ihre Entwickler treffen auf eine Schnittstelle und nicht auf eine je Produkt.
Unterstützung bei der Partnerschaft
Maesn ist offizieller Sage-Partner und stößt den Partnerprozess und den Eintrag für das jeweilige System im jeweiligen Markt an, von Sage Active in Spanien bis Sage Accounting im Vereinigten Königreich. Der Eintrag trägt den Namen Ihres Produkts, nicht unseren.
Nationale Marketplaces
Sage betreibt seine Marketplaces je Land, Publikum, Ansprechpartner und Qualifizierung sind also die dieses Marktes. Ein Produkt, das in drei Sage-Märkten live ist, hat das Verfahren dreimal durchlaufen.
Je System, nicht je Marke
Sage Active und Sage Accounting haben jeweils ein eigenes Programm. Für das eine gelistet zu sein sagt nichts über das nächste, und das ist dieselbe Zersplitterung, die auch die API-Seite hat.
Eine manuelle Tür
Nichts davon ist eine Einreichung in Selbstbedienung. Das ist langsamer als ein Formular, und es heißt auch, dass ein Eintrag nicht etwas ist, das jeder Wettbewerber in diesem Markt von Haus aus hat.
Die Integration läuft unter dem Namen Ihres Produkts, und der Eintrag gehört Ihnen und nicht uns. Maesn ist die Schicht dahinter.
Wir stoßen den Prozess für das konkrete System im konkreten Markt mit Ihnen an.
Zwei angebundene Sage-Systeme, zwei verschiedene Eingänge
Zwei Sage-Produkte sind angebunden, und sie kommen als vier Zielsysteme: Sage Accounting als eines, Sage Active als eines je Land für Deutschland, Spanien und Frankreich. Beide authentifizieren über OAuth 2.0 gegen eine App, die Sie selbst registrieren, und dort endet die Ähnlichkeit. Sage Active wird im kundenseitigen Produkt registriert, trägt einen Ländertyp und stellt vier Werte aus, von denen Maesn die Client-ID, das Client-Secret und den primären Abonnementschlüssel braucht. Sage Accounting wird in einem eigenen Entwicklerportal registriert und stellt zwei aus. Was alle vier teilen, ist der Firmenschritt, der unten beschrieben ist.
Zwei Systeme, zwei Registrierungen und zwei Token-Laufzeiten sind drei Dinge, die Ihr Produkt sonst tragen würde. Maesn hält sie hinter einem Ablauf für Unified Authentication, eine Sage-Verbindung wird also einmal je Kunde hergestellt und verhält sich danach wie jeder andere Account-Key in Ihrem System.
- OAuth 2.0
- Sage Active, eine App je Land
- OAuth 2.0
- Sage Accounting, eine App für alle Märkte
Zwei Eingänge, eine Implementierung. Maesn verwahrt beide Sätze App-Zugangsdaten, und jeder Kunde, den Sie anbinden, liefert einen Account-Key für das Sage-System zurück, das er einsetzt.
- Ein Satz App-Zugangsdaten je System
- Client-ID und Secret für Sage Accounting, und für Sage Active dazu der Subscription Primary Key. Sage stellt außerdem einen zweiten Abonnementschlüssel aus, und Maesn braucht ihn nicht. Einmal eingereicht, für jeden Kunden benutzt, den Sie in diesem Markt anbinden.
- Der Firmenkontext und die Tokens
- Die Firma, die ein Kunde auswählt, wird an der Verbindung verwahrt und an spätere Anfragen gehängt. Das Erneuern der Tokens läuft hier, auf beiden Systemen, mit ihren unterschiedlichen Lebensdauern.
Sage Accounting hat eine kostenlose Entwickler-Testphase, für die Sie sich registrieren können. Sage Active hat keine, deshalb stellt Maesn die Sandbox dafür. Nutzen Sie eine, bevor ein Kunde den Ablauf sieht, denn die Firmenauswahl und der Ländertyp sind die zwei Schritte, die ein direkter Bau zuerst falsch macht.
- 1
Ihr Kunde startet in Ihrem Produkt
Sie schicken ihn in den Ablauf, und Maesn öffnet den Zustimmungsbildschirm des Sage-Systems, das er betreibt. Er trägt den Namen Ihrer App, denn die App ist auf Ihr Unternehmen registriert.
- 2
Er wählt die Firma
Eine Sage-Anmeldung erreicht meist mehr als eine Firma. Der Kunde wählt also, mit welcher Ihr Produkt sich verbindet. Maesn zeigt diese Wahl als Schritt im Verbindungsablauf, in Ihren Farben gestaltet, und verwahrt die Antwort an der Verbindung. Alle vier Sage-Zielsysteme arbeiten so.
- 3
Sie arbeiten mit einem Account-Key
Maesn speichert die Verbindung und gibt einen Account-Key für das Sage-System dieses Kunden zurück. Jede Anfrage trägt dann Ihren Maesn-API-Schlüssel und diesen Account-Key. Die zwei Systeme unterscheiden sich darin, was sie führen. Ihr Produkt weiß also weiterhin, mit welchem es spricht, aber die Aufrufe, die Filter und das Blättern sind identisch.
Beide Sage-Systeme bleiben synchron mit einem geplanten Abruf
Beide angebundenen Sage-Systeme bleiben über einen geplanten Lesezugriff synchron. Keines von beiden sendet heute Events. Es muss also nichts eingeschaltet werden, bevor der Lesezugriff funktioniert.
Nichts, auf keinem der beiden Systeme. Eine Änderung im Sage-Konto eines Kunden bleibt unsichtbar, bis etwas sie liest. Würden Events auf einem bestimmten Objekt ändern, wie Ihr Produkt arbeitet, sagen Sie uns Bescheid, und wir sehen uns an, sie für dieses System freizuschalten.
Ein geplanter Lesezugriff, mit demselben Filter und derselben Paginierung auf beiden Systemen und auf allem anderen, das Sie anbinden. Der Code zur Änderungserkennung wird einmal geschrieben und auf einen anderen Account-Key gerichtet.
Sage Active paginiert über einen Cursor, kann sich also nur vorwärts bewegen: Seite fünfzig zu erreichen heißt, die neunundvierzig davor anzufordern. Sage Accounting paginiert über Offset und kann springen. Über Maesn fragen Sie beide gleich, mit einem Offset, und Maesn übernimmt bei Sage Active das Vorwärtsdurchlaufen für Sie.
Zwei Systeme, die unterschiedlich paginieren und unterschiedlich antworten, müssen trotzdem vom selben Code nach demselben Zeitplan gelesen werden. Ein Weg, zu filtern und zu paginieren macht das möglich, und das Event-Modell ist der Ort, an dem ein Sage-Objekt landet, sobald eines dieser Systeme anfängt zu pushen.
Was eine Sage-Anbindung braucht, vor dem ersten Aufruf
Was eine Sage-Integration vor dem ersten Aufruf braucht, hängt davon ab, welches Sage es ist. Drei Dinge gelten über beide angebundenen Systeme hinweg.
- Eine eigene App, je Sage-System
- Beide angebundenen Systeme erwarten, dass Sie eine Anwendung registrieren und die Zugangsdaten einmal an Maesn übergeben. Sie tun das an verschiedenen Orten: Sage Active unter Einstellungen und Anwendungsschlüssel im Konto selbst, Sage Accounting in einem eigenen Selbstbedienungsportal für Entwickler.
- Das Land, entschieden bevor es die App gibt
- Sage Active trägt an der App selbst einen Ländertyp, DE, ES oder FR, mit einer dazu passenden Callback-URL. Diese Wahl gehört in den Plan und nicht in eine spätere Migration, denn sie ist eine Eigenschaft der Registrierung und kein Parameter zur Laufzeit.
- Ein Kundenkonto mit gültigem Abonnement
- Beide Systeme nennen das als ihre gesamte Voraussetzungsliste. Das sollte man im Qualifizierungsgespräch bestätigen, denn in den kleineren Tarifen mancher Sage-Produkte gibt es nichts anzubinden.
Wir gehen die App-Registrierung für jedes System mit Ihnen durch.
Zwei Sage-Systeme, eine Form in Ihrem Code
Sage Active und Sage Accounting sind zwei Produkte, für die ein Kunde sich aus verschiedenen Gründen entschieden hat. Ihrem Code antworten sie gleich.
Was Sie abrufen, kommt im selben Common Data Model zurück, und genau das erlaubt einem Stück Ihres Codes, beide zu verarbeiten. Die beiden Systeme sind nicht zwei Konfigurationen eines Produkts: Es sind zwei Produkte, für die ein Kunde sich aus verschiedenen Gründen in verschiedenen Märkten entschieden hat.
Das ist zugleich das praktische Argument dafür, gegen das Modell zu bauen statt gegen einen Hersteller. Ein Kunde, der von Sage Accounting zu Sage Active wechselt, oder ein Markt, in dem sich ein anderes Sage herausstellt als angenommen, ist hier ein Verbindungswechsel und kein Projekt. Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen sie für das System, auf dem Ihr Kunde ist.
Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen, was je System möglich ist.
