Exact Online Schnittstelle und API-Integration
Exact Online ist der Marktführer für Cloud-Buchhaltung in den Niederlanden und Belgien und deckt Buchführung, Rechnungsstellung, Einkauf und Projektverwaltung ab. Binden Sie es über Maesn an, und Sie erreichen es mit derselben REST API und demselben Datenmodell wie jedes andere unterstützte System.
Eine Exact-Online-Anbindung in Tagen
Exact Online gibt Ihnen mehr Oberfläche als jedes andere System im Katalog, und der Preis dafür wird bei der Einrichtung bezahlt und nicht zur Laufzeit. Drei Dinge müssen vor dem ersten Aufruf geklärt sein. Hier stehen sie, und was Maesn davon abnimmt.
Drei Systeme, eine Schnittstelle
Exact Online läuft als getrennte regionale Umgebungen, und eine App wird in einer davon mit einer eigenen Redirect-URL registriert. Maesn führt jede Region als eigenes Zielsystem. In Ihrem Code kommen also eine Schnittstelle und ein Account-Key an und keine Verzweigung je Land.
Die Prüfung läuft über uns
Solange Ihre App nicht im Exact App Store veröffentlicht ist, kann sich nur das Konto an ihr authentifizieren, das sie angelegt hat. Bauen und Testen bleibt davon unberührt, einen Kunden anzubinden ist bis dahin nicht möglich. Maesn ist offizieller Exact-Partner und geht Prüfung und Eintrag mit Ihnen durch.
Einmal beim Verbinden geklärt
Exact grenzt Daten auf eine Division ein, und ein Webhook-Abonnement braucht sie als Query-Parameter, sofern der interaktive Ablauf sie nicht schon gespeichert hat. Maesn klärt sie, während Ihr Kunde sich verbindet, und hängt sie von da an jede Anfrage.
In Ihrem Code kommen ein REST-Aufruf und ein Account-Key an. Teams gehen in Tagen live, und das System nach Exact Online ist ein Konfigurationsschritt und kein zweites Projekt.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
Tipalti ist nach Benelux gegangen, ohne Exact Online zu bauen
Tipalti automatisiert den gesamten Kreditorenprozess, von der Lieferantenaufnahme bis zu weltweiten Zahlungen. In den Benelux-Markt einzutreten hieß, die Buchhaltungssysteme zu erreichen, die die Kunden dort ohnehin einsetzen, und Exact Online ist in genau dieser Region der Marktführer.
“Mit Maesn haben wir unsere europäische Expansion beschleunigt, weil komplexe ERP-Integrationen über Benelux und DACH hinweg reibungslos laufen. Für eine AP-Plattform ist verlässlicher Zugang zu den wichtigen lokalen ERP-Systemen entscheidend, und genau den gibt uns Maesn.”
Drei Gründe, die Exact Online Schnittstelle über Maesn anzubinden
Exact Online direkt anzubinden ist ein Projekt, das Sie abschließen können. Es dreimal abzuschließen, einmal je Region, und danach das nächste System hinzuzunehmen, entscheidet über Ihre Roadmap.
Die Exact-eigene Arbeit bleibt hier
Die regionale App-Registrierung, die Division bei jedem Aufruf und das Webhook-Abonnement je Kunde sind das, was jede Exact-Online-Integration lösen muss. Jedes davon wird einmal gelöst, auf unserer Seite, für jeden Kunden, den Sie anbinden.
Tiefe, die Sie nachprüfen können
Rechnungen, Eingangsrechnungen, Zahlungen, beide Seiten der Kontaktliste und das Hauptbuch lassen sich hier lesen, das meiste davon auch schreiben, und drei davon löschen. Es zählt, ob die Objekte, die Ihr Anwendungsfall braucht, darunter sind, und diese Frage beantwortet unsere Dokumentation je Objekt.
Das nächste System kostet nichts
Sobald Exact Online läuft, antwortet jedes andere unterstützte Buchhaltungs- und ERP-System auf derselben Schnittstelle. Ihre zweite Integration ist ein Konfigurationsschritt.
Die Prüfung im Exact App Store kommt vor Ihrem ersten Kunden
Die meisten Anbieter hören bei der API auf. Maesn übernimmt die technische Seite und die Beziehung, und bei Exact Online ist die zweite nicht optional: Eine unveröffentlichte App bindet niemanden an. Die App-Store-Prüfung gehört also zum Livegang und ist kein Marketingschritt danach.
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 Exact-Partner und führt Sie durch die Prüfung und den Eintrag im App Store. Die Einreichung geht damit durch, statt mit Korrekturen zurückzukommen.
Er ist es, was das Onboarding freischaltet
Vor der Veröffentlichung kann sich nur das Konto verbinden, das die App registriert hat. Die Veröffentlichung ist der Schritt, der aus einer funktionierenden Integration eine macht, die Ihre Kunden nutzen können.
Der Eintrag trägt Ihren Namen
Die App ist auf Ihr Unternehmen registriert. Der Eintrag im Exact App Store gehört also Ihrem Produkt und nicht Maesn.
Er erreicht den Markt, den Exact anführt
Exact Online ist Marktführer für Cloud-Buchhaltung in den Niederlanden und Belgien. Ein Eintrag stellt Sie also vor ein dichtes und kein verstreutes Publikum.
Die App bleibt auf Ihr Unternehmen registriert. Der Eintrag und der Partnerstatus gehören also Ihnen. Maesn ist die Schicht dahinter.
Maesn ist offizieller Exact-Partner und bereitet die Prüfung parallel zu Ihrer Integration vor.
Eine Exact-Online-App je Region, ein Account-Key
Exact Online authentifiziert über OAuth, und die App, die Ihre Kunden freigeben, ist Ihre und nicht die von Maesn. Das Eigene hier ist, dass es nicht ein Exact Online gibt: Die Plattform läuft als regionale Umgebungen, und eine App gehört zu einer davon.
- OAuth
- Ihre eigene App, je Region
Eine Integration, in welcher Region Ihr Kunde auch ist. Maesn verwahrt die Zugangsdaten und die Division dahinter.
- Ein Satz Zugangsdaten je Region
- Client-ID und Secret werden einmal je Region eingereicht und für jede Verbindung darin benutzt. Dokumentiert sind heute der niederländische, der deutsche und der britische Callback, und jeder ist hier ein eigenes Zielsystem.
- Die Division bei jedem Aufruf
- Exact grenzt Daten auf eine Division ein, und eine Division ist eine juristische Person: Ein Konzern mit sechs Tochtergesellschaften führt sechs davon, jede mit eigener Umsatzsteuer-ID und eigenem Anfragebudget. Der interaktive Ablauf ist für die niederländische Variante dokumentiert, dort wählt Ihr Kunde eine auf einer Auswahlseite, und die Wahl wird bei der Verbindung gespeichert. Anderswo läuft sie als Parameter mit, und Maesn hängt sie an.
Eines sollten Sie einplanen statt entdecken: Eine App, die die App-Store-Prüfung nicht durchlaufen hat, authentifiziert nur für den Account, der sie registriert hat. Der erste Kunde, den Sie anbinden, braucht diesen Schritt also bereits erledigt.
- 1
Ihr Kunde startet in Ihrem Produkt
Sie schicken ihn in den Ablauf, und Maesn öffnet den Zustimmungsbildschirm von Exact für seine Region. Er trägt den Namen Ihrer App, denn die App ist auf Ihr Unternehmen registriert. Die Verbindung liest sich also als Ihre und nicht als die eines Dritten.
- 2
Exact kehrt zu Maesn zurück
Die Redirect-URL Ihrer App zeigt auf den regionalen Callback von Maesn. Der Code-Tausch und das erste Token passieren also hier statt in Ihrem Backend. Wo der interaktive Ablauf gilt, wird die Division im selben Durchgang geklärt.
- 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 Exact Online ist das Protokoll gewöhnlich und die Zahl der Instanzen nicht. Unified Authentication hält das von Ihrer Seite fern: Der Redirect, der Auswahlschritt und die Art, wie Ihnen der Account-Key übergeben wird, sind dort konfigurierbar und identisch, ganz gleich, welches System oder welche Region davon ein Kunde anbindet.
Zwei Exact-Online-Eventtypen, und keiner davon ist create
Neun Exact-Online-Objekte erreichen Sie über Maesn als Events, und sie tragen genau zwei Arten: aktualisiert und gelöscht. Ein Created-Event gibt es nicht. Ein Event-Strom allein wird Ihnen also nie sagen, dass ein Datensatz neu ist.
Sie abonnieren eine Ressource statt eines Paares. Ein Abonnement liefert damit beide Typen. Kontakte kommen getrennt an, als Kunde oder als Lieferant.
Ein Abgleich hat hier also zwei Hälften. Aktualisierungen und Löschungen kommen als Events an, je Kunde, im selben Umschlag wie bei jedem anderen System, und Maesn registriert das Abonnement für Sie. Neue Datensätze findet ein Lesezugriff, und das ist derselbe gefilterte Aufruf, den Sie schon gegen Systeme fahren, die gar nichts senden. Events tragen die ID des Datensatzes und keinen Datumsbereich. Es muss also nichts aufgelöst werden, bevor es verteilt werden kann.
Neun Ressourcen sind breit, zwei Event-Typen sind schmal, und die Lücke dazwischen ist genau die Art Einzelheit, die eine Architektur nach der Demo entscheidet statt davor. Ein Event-Modell bedeutet, dass Aktualisierungen und Löschungen im selben Umschlag ankommen wie bei jedem anderen System, und ein Weg, zu filtern und zu paginieren deckt die Hälfte ab, von der Ihnen kein Event erzählt. Zwei Wege, und beide schreiben Sie einmal für den ganzen Katalog statt einmal für Exact.
Was Exact Online vorab verlangt
Exact Online stellt vier Dinge vor eine Integration, und alle lassen sich leichter einplanen als auf halber Strecke entdecken.
- Ein Exact-Online-Konto mit Administratorrechten
- Ein kostenloser regionaler Test genügt. Es trägt Ihre App und später Ihren Partnereintrag, und es muss kein Konto sein, das Sie sonst benutzen.
- Ihre eigene App, in der richtigen Region registriert
- Sie registrieren sie im Portal des Exact App Store unter dem Namen Ihres Produkts und setzen die Redirect-URL für diese Region: Die Niederlande, Deutschland und das Vereinigte Königreich haben jeweils eine eigene. Danach holen Sie Client-ID und Secret ab und schicken sie an Maesn.
- Ein Veröffentlichungsschritt, bevor Sie jemanden anbinden können
- Eine nicht veröffentlichte App authentifiziert nur für das Konto, das sie angelegt hat. Bauen und Testen funktioniert, einen Kunden anbinden nicht, und an diesem Punkt stehen Teams meist an dem Tag, an dem sie vorführen wollten.
- Eine Division je Verbindung
- Daten gehören zu einer Division und nicht zu einem Konto. Im interaktiven Ablauf wird die Wahl einmal getroffen und gespeichert, ohne ihn trägt jedes Webhook-Abonnement die Firma als Query-Parameter.
Wir gehen die regionale App und die Prüfung mit Ihnen durch.
Eine Form für Exact Online, und für das nächste System
Exact Online hat von allen Systemen hier den größten Schnittstellenumfang, und genau deshalb zählt das Datenmodell: Je mehr eine Plattform bietet, desto verlockender ist es, das eigene Produkt um dieses eine System herum zu bauen.
Eingangsrechnungen, Zahlungen und Lieferantengutschriften lassen sich löschen
Für diese drei ist hier das Löschen freigeschaltet, und das ist ungewöhnlich: Auf den meisten Systemen drängt die Buchhaltungspraxis stattdessen zu Korrekturen und Stornos als neue Belege. Bauen Sie trotzdem auf das Korrekturmuster, denn das brauchen Ihre übrigen Integrationen, und nehmen Sie das Löschen als die Abkürzung, die es ist.
Ein fehlendes Recht liefert 200 und eine leere Liste
Die eigene Tabelle der Antwortcodes von Exact sagt es deutlich: Ein Lesezugriff ohne das zugehörige Recht antwortet mit 200 und einer leeren Liste. Nichts in dieser Antwort unterscheidet sie von einem Kunden, der tatsächlich keine Daten hat. Ein kaputter Abgleich sieht auf jedem Ihrer Dashboards also gesund aus. Prüfen Sie, was der Nutzer freigegeben hat, bevor Sie eine Firma für leer halten, und zeigen Sie ihm den Unterschied, statt ihn in Ihr Log zu schreiben.
Was Sie lesen, kommt im gemeinsamen Common Data Model zurück, eine Rechnung aus Exact Online hat also dieselbe Form wie eine Rechnung aus einem System mit einem Drittel seines Umfangs, und der Code, den Sie hier schreiben, ist der Code, den Sie für das nächste wiederverwenden.
Das zählt hier mehr als anderswo, denn an der Tiefe fängt eine Integration, die für einen Hersteller gebaut ist, gewöhnlich an undicht zu werden. Eine breite Leseoberfläche lädt dazu ein, Exact Online abzubilden statt der Domäne, und in dem Moment, in dem Sie das tun, kostet das nächste System eine Neuschrift. Das Datenmodell ist das, was das verhindert, und es ist dasselbe, ob eine Plattform drei Objekte anbietet oder zwanzig.
Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen, was möglich ist.
