Visma eAccounting Schnittstelle und API-Integration
Visma eAccounting ist eine Cloud-Buchhaltungsplattform für kleine Unternehmen, und es ist ein System, das in jedem seiner Märkte unter einem anderen Namen verkauft wird: eAccounting in Norwegen und den Niederlanden, Spiris in Schweden. Eine API deckt alle ab. Eine Anbindung, die für einen Markt gebaut ist, erreicht damit bereits die anderen. Maesn hält den Token-Lebenszyklus, das Paging und die regionale Einrichtung hinter einer REST-Schnittstelle.
Scopes, Paging und Sandboxes entscheiden, was eine Visma-eAccounting-Anbindung kostet
Drei Dinge an Visma eAccounting entscheiden, wie viel Arbeit eine Integration wird, und keines davon taucht im ersten erfolgreichen Aufruf auf. Alle drei enden an dieser Schicht.
Der OAuth-Lebenszyklus von Visma eAccounting, vollständig von Maesn betrieben
Visma eAccounting will seine Scopes genau deklariert haben, und zwar bevor sich der erste Kunde verbindet, statt sie anzufordern, während Ihr Produkt in sie hineinwächst. Die drei Zugangsdaten und das Refresh je Mandant liegen auf dieser Seite, in Ihrem Code kommen also ein REST-Aufruf und ein Account-Key an statt eines Token-Lebenszyklus, den Sie je Kunde fahren.
Die Paginierung von Visma eAccounting, automatisch erledigt
Das System gibt standardmäßig 50 Ergebnisse je Seite zurück und hat nichts dagegen, wenn niemand nach dem Rest fragt. Ein Abgleich ohne ausdrückliches Blättern liefert eine unvollständige Menge und meldet Erfolg, und das ist die schlimmste Form, die ein Datenfehler annehmen kann. Maesn blättert jeden Sammel-Endpunkt, es kommt also die ganze Menge an.
Eine Sandbox je Region, ohne ein zweites Projekt erledigt
Eine Sandbox-Firma gehört zu einer Region, und die Region lässt sich nach dem Anlegen nicht mehr ändern, und jedes Visma-Konto trägt genau eine. Einen zweiten Markt zu testen heißt, ein zweites Konto unter einer anderen E-Mail-Adresse zu registrieren. Diese Arbeit liegt auf dieser Seite, und was Sie bekommen, ist eine Verbindung, die sich in jedem Markt gleich verhält.
In Ihrem Code kommen ein REST-Aufruf und ein Account-Key an. Die Scopes, das Refresh und die regionale Einrichtung bleiben hier, und ein schwedischer Kunde ist dieselbe Integration wie ein norwegischer.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
Findity bettet den Ausgabenabgleich in die Produkte seiner Partner ein
Findity ist eine Plattform für die Ausgabenverwaltung, die White-Label- und API-Produkte verkauft. Ihre Buchhaltungsintegrationen werden also in der Software anderer ausgeliefert statt in der eigenen.
“Maesn hat uns geholfen, Integrationen zu Buchhaltungssystemen zu bauen, und wir können uns dadurch auf andere Prioritäten in unserer Roadmap konzentrieren. Besonders schätzen wir die Unterstützung, die wir jedes Mal bekommen haben, wenn wir erweiterte Funktionen in einer Integration brauchten, die Maesn für uns eingerichtet hat.”
Drei Gründe, die Visma eAccounting Schnittstelle über Maesn anzubinden
Der erste erfolgreiche Aufruf gegen Visma eAccounting kommt schnell. Die Kosten kommen im zweiten Jahr, wenn Tokens auf Wegen abgelaufen sind, von denen niemandem erzählt wurde, und ein Abgleich die meisten Daten zurückgegeben hat statt aller.
Vollständige Seiten, nicht die ersten fünfzig Datensätze
Ein Lesezugriff, der nach der voreingestellten Seite aufhört, gibt eine gültige Antwort und einen Teil der Daten zurück, und nichts in der Nutzlast kennzeichnet sie als unvollständig. Maesn blättert jeden Sammel-Endpunkt auf dieser Seite, in Ihrem Produkt kommt also die ganze Menge an und nicht deren erste Seite.
Alle regionalen Varianten, eine Integration
Das System wird in Norwegen und den Niederlanden als eAccounting und in Schweden als Spiris verkauft, und eine Verbindung erreicht sie alle. Ein Kunde, der die lokale Marke nennt, ist dieselbe Integration wie einer, der die andere nennt. Einen weiteren seiner Märkte zu betreten ist also eine Abfrage und kein Projekt.
Eine Integration, und sie gilt nicht nur für eAccounting
Dieselbe Schnittstelle erreicht Visma e-conomic, Holded und über 30 weitere ERP- und Buchhaltungssysteme. Ein Markt, in dem ein anderes Produkt läuft als gedacht, ist eine Änderung an der Verbindung und kein Projekt.
Die Visma-eAccounting-Namen wechseln je Markt, die Verbindung nicht
Visma verkauft dieses System in jedem Markt unter einem anderen Namen. Maesn deckt jede dieser Varianten über dieselbe Anbindung ab, der Name, den ein Kunde nennt, ist damit ein Nachschlagen und keine zweite Integration.
Maesn erreicht sie alle über eine Anbindung: eAccounting in den Niederlanden und Norwegen, und Spiris, das früher SPCS hieß, in Schweden. Ein schwedischer Interessent, der Spiris nennt, und ein norwegischer, der eAccounting nennt, sind für Sie dieselbe Anbindung. Zu bestätigen bleibt die Ebene der Endpunkte: Die Verfügbarkeit ist nicht in jedem Markt gleich, nennen Sie also den Markt zusammen mit den Objekten, die Ihr Anwendungsfall braucht.
Drei Märkte über eine Anbindung sind die Reichweite, und der Markenname ist das Einzige, was sich zwischen ihnen ändert. Der Rest des Portfolios steht auf der Seite Visma API.
Sagen Sie uns, in welchem Land Ihre Kunden sitzen, und wir bestätigen, was heute möglich ist.
Visma-eAccounting-Scopes werden erklärt, bevor der erste Kunde verbindet
Visma eAccounting authentifiziert über OAuth 2.0, und eine Einzelheit unterscheidet es von den OAuth-Systemen daneben: Die Scopes müssen genau und vorab deklariert werden, statt unterwegs angefragt zu werden, was Ihre Anwendung erreichen kann, ist also entschieden, bevor sich der erste Kunde verbindet. Die Firmenauswahl liegt auf der Seite von Visma, und der Hersteller empfiehlt, diese Auswahl zu erzwingen, statt die Firma zu übernehmen, die der Nutzer ohnehin offen hatte.
- OAuth 2.0
- Scopes vorab deklariert, drei Werte einmal eingereicht
- Drei Zugangsdaten und die Scope-Deklaration
- Client-ID, Client Secret und Abonnementschlüssel, einmal eingereicht und für jeden Kunden in diesem Markt benutzt. Der Scope-Satz wird mit ihnen deklariert und nicht je Verbindung ausgehandelt.
- Das Refresh, je Mandant
- Das Erneuern der Tokens läuft je Mandant auf dieser Seite. Der Lebenszyklus ist also nichts, was Ihr Produkt je Kunde plant oder verwahrt.
Scopes vorab zu deklarieren ist etwas, um das herum man planen sollte statt daran vorbei. Sie später zu erweitern heißt, zu jedem angebundenen Kunden für eine neue Freigabe zurückzugehen. Die Frage, was Ihr Produkt in einem Jahr brauchen könnte, gehört also in das Gespräch, bevor der erste sich verbindet.
- 1
Ihr Kunde startet in Ihrem Produkt
Sie schicken ihn in den Ablauf, und Maesn öffnet den Zustimmungsbildschirm von Visma eAccounting. Er trägt den Namen Ihrer Anwendung, denn die Anwendung ist auf Ihr Unternehmen registriert.
- 2
Er stimmt den deklarierten Scopes zu
Der Zustimmungsbildschirm zeigt, was vorab deklariert wurde, und Visma fragt außerdem, für welche Firma die Verbindung gilt. Die Anfrage erzwingt diese Auswahl, statt die Firma zu übernehmen, die der Nutzer ohnehin offen hatte.
- 3
Sie arbeiten mit einem Account-Key
Maesn speichert die Verbindung und gibt einen Account-Key zurück. Jede Anfrage trägt dann Ihren Maesn-API-Schlüssel und diesen Account-Key, gleich welche der regionalen Marken der Kunde tatsächlich betreibt.
Scopes vorab zu deklarieren ist etwas, um das herum man planen sollte statt daran vorbei, denn sie später zu erweitern heißt, zu jedem angebundenen Kunden für eine neue Freigabe zurückzugehen. Unified Authentication trägt diese Deklaration und das Refresh je Mandant, in derselben Form auf jedem angebundenen System und nicht einmal je Anbieter.
Was eine Visma-eAccounting-Anbindung braucht, vor dem ersten Aufruf
Visma eAccounting verlangt vor dem ersten Aufruf mehr von Ihnen als die meisten Systeme im Katalog, und einer der Schritte liegt nicht bei Ihnen. Nichts davon ist Code.
- Ein aktives Visma-eAccounting-Konto
- Die ganze Voraussetzungsliste der Dokumentation ist eine Zeile: ein aktives Konto. Das sollte man im Qualifizierungsgespräch bestätigen, denn ohne eines gibt es nichts anzubinden.
- Eine Callback-URL, die Visma für Sie ändern muss
- Die Zugangsdaten kommen bei der Registrierung per E-Mail, und die Callback-URL ist der Teil, den Sie nicht selbst setzen können. Sie müssen Visma ansprechen und darum bitten, sie auf die Callback-Adresse von Maesn zu richten. Es ist eine kurze Anfrage und eine echte Abhängigkeit. Sie gehört also früh in den Plan und nicht auf den Tag des Starts.
- Drei Werte, einmal an Maesn übergeben
- Client-ID, Client Secret und Abonnementschlüssel zusammen. Einmal eingereicht, danach für jeden Kunden benutzt, den Sie anbinden. Das ist der breiteste Satz Zugangsdaten unter allen heute angebundenen Visma-Systemen.
- Ein Sandbox-Konto je Region, die Sie testen wollen
- Die Sandbox-Firma ist beim Anlegen an ihre Region gebunden, und jedes Konto hält eine. Eine produktive Client-ID erreicht eine Sandbox-Firma. Eine Sandbox-Client-ID erreicht aber nie eine produktive, die beiden Richtungen sind also nicht symmetrisch.
Wir gehen die Registrierung und den Callback-Wechsel mit Ihnen durch.
Ein Visma-eAccounting-Eintrag erreicht mehr Märkte, als er nennt
Die meisten Anbieter hören bei der API auf. Visma eAccounting betreibt einen eigenen Marketplace, getrennt von dem, den Visma e-conomic betreibt, und sein Publikum zu erreichen ist ein Verfahren und kein Formular.
Technische Unterstützung
Eine Integration gegen die Unified API und ein Datenmodell, identisch für Visma eAccounting 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 stößt den Eintrag gezielt für Visma eAccounting an und unterstützt das Co-Marketing, das dazugehört. Der Eintrag trägt den Namen Ihres Produkts und nicht unseren.
Ein Eintrag, mehrere Märkte
Weil dasselbe System in seinen Märkten unter verschiedenen Namen verkauft wird, steht ein Eintrag hier vor Kunden, die das Produkt anders nennen. Das ist ein Vorteil, den dieses Produkt gegenüber dem übrigen Portfolio hat.
Nicht der e-conomic-Marketplace
Die zwei Produkte betreiben getrennte Marketplaces. Die Präsenz im einen sagt also nichts über den anderen. Es ist dieselbe Zersplitterung, die die API-Seite dieses Konzerns hat, nur auf der kaufmännischen Seite.
Co-Marketing daneben
Der Eintrag ist der Anfang und nicht der ganze Nutzen. Was folgt, ist gemeinsame Sichtbarkeit mit dem Hersteller, und dort wird aus einem Eintrag Pipeline statt einer Verzeichniszeile.
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 Eintrag an und unterstützen das Co-Marketing, das dazugehört.
