QuickBooks-Schnittstelle und API-Integration
QuickBooks Online ist die Cloud-Buchhaltungsplattform von Intuit, genutzt von kleinen Unternehmen und ihren Kanzleien in den Vereinigten Staaten, Kanada, dem Vereinigten Königreich und Australien. Sie deckt Rechnungsstellung, Ausgaben, Bankabstimmung 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 QuickBooks-Anbindung in Tagen
QuickBooks ist eine große, vielbereiste API, und den ersten Aufruf beantwortet zu bekommen ist der leichte Teil. Die Arbeit liegt an drei Stellen, an denen Intuit es auf seine eigene Weise macht. Hier stehen sie, und was Maesn davon abnimmt.
Der Lesezugriff kommt vor dem Schreibzugriff
QuickBooks versioniert jeden Datensatz mit einem SyncToken und weist eine Aktualisierung mit einem veralteten zurück. Es kennt zwei Formen der Aktualisierung, eine vollständige, die jedes ausgelassene Feld leert, und eine sparsame, die das nicht tut. Maesn holt den aktuellen Datensatz, trägt die Felder ein, die Sie gesendet haben, und gibt die vollständige Entität mit dem Token zurück, das QuickBooks erwartet. So senden Sie die Änderung, ohne zu leeren, was Sie nie angefasst haben.
Die Änderung blieb unter der Linie
2026 sind die QuickBooks-Webhooks auf das CloudEvents-Format gewechselt, und jede Integration, die die Nutzlast von Intuit direkt liest, musste umbauen, wie sie ein Event liest und weiterleitet. Was Maesn Ihnen übergibt, ist die eigene Event-Form. Der Umschlag darunter darf sich also ändern.
Beide Seiten, eine Implementierung
QuickBooks stellt für die Sandbox eigene Zugangsdaten aus, und Maesn führt sie als eigenes Zielsystem mit eigener Callback-URL. Eine Testverbindung und eine Live-Verbindung sind zwei Account-Keys gegen Code, den Sie nur einmal geschrieben haben.
In Ihrem Code kommen ein REST-Aufruf und ein Account-Key an. Teams gehen in Tagen live, und das System nach QuickBooks ist ein Konfigurationsschritt und kein zweites Projekt.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
Paywise hat manuelle Rechnungsimporte durch Integrationen ersetzt
Paywise treibt unbezahlte Rechnungen für Unternehmen ein, von der ersten Mahnung bis zur gerichtlichen Durchsetzung. Ihre Kunden haben diese Rechnungen früher von Hand hochgeladen, und die Liste der offenen Posten kommt jetzt aus dem Buchhaltungssystem, das jeder von ihnen ohnehin einsetzt.
“Unsere Kunden können ihre vorhandenen Werkzeuge sofort anbinden. Das erhöht die Nutzung und macht Maesn zu einem festen Bestandteil unserer Erfolgsstrategie.”
Drei Gründe, die QuickBooks-Schnittstelle über Maesn anzubinden
QuickBooks direkt anzubinden ist ein Projekt, das Sie abschließen können. Es durch Intuits Release-Zeitplan am Laufen zu halten, und danach das nächste System hinzuzunehmen, entscheidet über Ihre Roadmap.
Die QuickBooks-Arbeit bleibt hier
Die Realm-ID bei jeder Anfrage, das SyncToken hinter jeder Aktualisierung und die Webhook-Konfiguration auf App-Ebene sind das, was jede QuickBooks-Integration lösen muss. Gelöst wird es einmal, hier, für jeden Kunden, den Sie anbinden.
Tiefe, die Sie nachprüfen können
Das meiste, was Sie hier lesen können, meldet seine Änderung auch selbst. Der größte Teil der Abgleicharbeit ist also ein Abonnement und kein Zeitplan, den Sie pflegen. Was heute nicht freigeschaltet ist, ist auf Anfrage verfügbar.
Das nächste System kostet nichts
Sobald QuickBooks läuft, antwortet jedes andere unterstützte Buchhaltungs- und ERP-System auf derselben Schnittstelle. Ihre zweite Integration ist ein Konfigurationsschritt.
Der QuickBooks-Produktivzugang läuft über das Partnerprogramm
Die meisten Anbieter hören bei der API auf. Maesn übernimmt die technische Seite und die Beziehung, und bei QuickBooks ist die zweite kein letzter Schliff: Eine App erreicht Produktionsdaten, sobald sie durch das App Partner Program gegangen ist, und davor hat sie die Entwicklungsumgebung.
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 führt Sie durch die Prüfung, die Stufe, die Ihre Nutzung wirklich braucht, und den Marketplace-Eintrag, und zwar begleitend zum Bau statt danach.
- Builder
- Silver
- Gold
- Platinum
Was die Stufen trennt
Das Volumen der enthaltenen CorePlus-Aufrufe und die Monatsgebühr, dazu die Frage, ob ein Marketplace-Eintrag optional oder Pflicht ist. Gold und Platinum verlangen zusätzlich eine Mindestzahl aktiver Verbindungen. Builder ist die kostenlose Einstiegsstufe, und eine bestandene Prüfung ist die Voraussetzung für alle vier.
Core gegen CorePlus
Intuit stuft einen Aufruf nach Endpunkt und Methode ein. Core deckt die hineingehenden Daten ab, das Anlegen und Aktualisieren von Datensätzen, und wird nicht gezählt. CorePlus deckt die herausgehenden Daten ab und wird gegen Ihre Stufe gezählt. Nur erfolgreiche Aufrufe zählen, Sandbox-Aufrufe nicht. Diese Gebühren sind die von Intuit und werden unabhängig von Maesn berechnet.
Die App bleibt auf Ihr Unternehmen registriert. Die Prüfung, der Eintrag und die Stufe gehören also Ihnen. Maesn ist die Schicht dahinter und nicht der Name auf dem Zustimmungsdialog.
Maesn führt die QuickBooks-Prüfung und die Wahl der Stufe parallel zu Ihrer Integration.
Der QuickBooks-Realm kommt mit der Verbindung und bleibt hier
QuickBooks authentifiziert über OAuth, und die App, die Ihre Kunden freigeben, ist Ihre und nicht die von Maesn. Wissenswert ist, was der Ablauf mitbringen muss: QuickBooks adressiert eine Firma über ihre Realm-ID, die in die Anfrage-URL gehört, und sie ist zugleich die Einheit, gegen die Intuit die Ratenbegrenzungen zählt.
- OAuth
- Ihre eigene QuickBooks-App
Eine App, jeder Kunde. Maesn verwahrt die Zugangsdaten und hält Realm und Tokens dahinter.
- Ihre App-Zugangsdaten
- Client-ID und Secret werden einmal eingereicht und für jede Verbindung benutzt. QuickBooks stellt ein zweites Paar für die Sandbox aus, und Maesn hält beide als getrennte Zielsysteme auseinander statt als eine Verbindung mit einem Schalter.
- Der Realm und der Token-Zyklus
- Die Realm-ID der Firma, die Ihr Kunde angebunden hat, wird bei der Authentifizierung geklärt, bei der Verbindung gespeichert und an jede Anfrage gehängt. Das Access-Token dahinter wird ebenfalls hier erneuert, je Verbindung.
Ein Account-Key gehört zu genau einem Endnutzer und einem Zielsystem, und deshalb sind eine Sandbox-Verbindung und eine Produktionsverbindung zwei Schlüssel und nicht einer mit einem Kennzeichen. Wo der Schlüssel Sie erreicht, ist konfigurierbar: der übliche Redirect auf Ihre Callback-URL, ein signierter Callback, den Sie serverseitig prüfen können, oder ein Webhook-Event statt eines Redirects.
- 1
Ihr Kunde startet in Ihrem Produkt
Sie schicken ihn in den Ablauf, und Maesn öffnet den Zustimmungsbildschirm von Intuit. 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
QuickBooks kehrt zu Maesn zurück
Die Redirect-URI Ihrer App zeigt auf den Callback von Maesn. Der Code-Tausch und das erste Token passieren also hier statt in Ihrem Backend. Der Realm der Firma, die Ihr Kunde gewählt hat, kommt damit zurück und bleibt an der Verbindung.
- 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 QuickBooks ist das Protokoll die gewöhnliche Hälfte und das, was der Ablauf mitbringen muss, nicht. Unified Authentication hält das von Ihrer Seite fern: Der Redirect, der Token-Lebenszyklus und die Art, wie Ihnen der Account-Key übergeben wird, sind dort konfigurierbar und identisch, ganz gleich, welches System ein Kunde anbindet.
Neun QuickBooks-Ressourcen, und sechs Dinge, die ihnen zustoßen können
QuickBooks sendet native Events, und neun seiner Objekte erreichen Sie über Maesn mit sechs verschiedenen Dingen, die ihnen passieren können, und das ist das breiteste Event-Vokabular aller Systeme im Katalog. Maesn registriert das Abonnement je angebundenem Kunden und vereinheitlicht die Nutzlasten. Die Form, die Sie verarbeiten, ist damit bei jedem System identisch, das Sie anbinden.
Welche Ressourcen und welche dieser Typen aktiv sind, wird in Ihrer QuickBooks-App eingestellt, und diese Einstellung gilt für alle, die sie angebunden haben.
Die Einrichtung findet an zwei Stellen statt, und nur eine davon ist je Kunde. In Ihrer QuickBooks-App wählen Sie die Ressourcen und Event-Typen, gerichtet auf eine Callback-URL, die wir ausstellen, und das gilt für alle Nutzer der App auf einmal. Maesn registriert danach ein Abonnement je authentifizierter Verbindung. Ein Callback trägt also die Events eines Kunden und sonst nichts. Sie kommen als Array an, und jeder Eintrag nennt den Datensatz, um den es geht, es muss also nichts nachgeschlagen werden, bevor es verteilt werden kann.
Sechs Typen sind das breiteste Vokabular im Katalog, wo das nächste System vier veröffentlicht und die meisten bei angelegt, aktualisiert und gelöscht aufhören. Es bleibt ein Vokabular unter vielen, und deshalb läuft ein Event-Modell über den ganzen Katalog: Der Handler, den Sie für eine QuickBooks-Rechnung schreiben, funktioniert weiter für ein System, das nichts sendet und darunter abgefragt werden muss. Dort landet auch Intuits Wechsel auf den CloudEvents-Umschlag, nämlich bei dem, was Maesn parst, und nicht bei dem, was Ihr Handler liest.
Was QuickBooks vorab erwartet
QuickBooks stellt vier Dinge vor eine Integration, und alle lassen sich leichter einplanen als auf halber Strecke entdecken.
- Ein QuickBooks-Konto mit Administratorrechten
- Ein kostenloses Testkonto genügt, und es muss kein Konto sein, das Sie sonst benutzen. Es dient dazu, Ihre App und später Ihre Partnerschaft zu verwalten.
- Ihre eigene QuickBooks-App, von Ihnen registriert
- Sie legen sie im Entwicklerportal von Intuit unter der Option QuickBooks Online and Payments an, unter dem Namen Ihres Produkts, und diesen Namen lesen Ihre Kunden, wenn sie ihr Konto verknüpfen. Wählen Sie den Accounting-Scope, tragen Sie den Callback von Maesn als Redirect-URI ein und schicken Sie uns Client-ID und Secret.
- Eine bestandene Prüfung vor der Produktion
- Bis Sie QuickBooks App Partner sind, haben Sie die Entwicklungsumgebung von Intuit und nichts darüber hinaus. Die Prüfung ist die Voraussetzung für jede Stufe: ein von Intuit freigegebener Fragebogen, die Developer Terms of Service und die Anforderungen des App Partner Program.
- Eine Callback-URL von uns vor dem ersten Webhook
- Ressourcen und Event-Typen werden in Ihrer QuickBooks-App konfiguriert, und die Callback-URL, auf die diese Konfiguration zeigt, stellt Maesn aus. Fragen Sie sie an, während die App eingerichtet wird, und nicht an dem Tag, an dem Sie das erste Abonnement verdrahten.
Wir gehen die App-Einrichtung und die Prüfung mit Ihnen durch.
Eine Form für QuickBooks, und für das nächste System
QuickBooks hat die meisten Events in diesem Katalog, und seine eigene Abfragesprache ist bewusst schmal gehalten. Genau diese beiden hält eine gemeinsame Form aus Ihrem Code heraus.
Aktualisierungen enden bei zwei Objekten
Sechs Objekte lassen sich anlegen, und Aktualisierungen an Ort und Stelle decken nur Kunden und Lieferanten ab. Alles andere ist ein Anlegen. Ein Produkt, das Datensätze bearbeitet statt neue zu buchen, sollte diese Grenze also zuerst prüfen.
Eingangsrechnungen senden Events, bevor sie lesbar sind
Ein Event zu Eingangsrechnungen kommt nativ an, während das Lesen von Eingangsrechnungen zu den 108 Kombinationen gehört, die in der Matrix mit auf Anfrage gekennzeichnet sind. Auf Anfrage bedeutet nicht standardmäßig freigeschaltet und nicht etwa unverfügbar, fragen Sie den Lesezugriff also zusammen mit dem Event an.
Standardmäßig löscht kein Objekt
Für kein Objekt ist Löschen freigeschaltet. Die Buchhaltungspraxis erwartet Korrekturen und Stornos ohnehin als neue Belege, planen Sie sie also so und nicht um ein Löschen herum, das Sie erst anfragen müssten.
Was Sie lesen, kommt im gemeinsamen Common Data Model zurück, eine Rechnung aus QuickBooks hat also dieselbe Form wie eine Rechnung aus einem europäischen Buchhaltungssystem, und der Code, den Sie hier schreiben, ist der Code, den Sie für das nächste wiederverwenden.
Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen, was möglich ist.
