Banktransaktionen landen in den Büchern, nicht in einer Datei
Eine Bankbewegung verlässt die Bank vollständig strukturiert und erreicht das Buchhaltungssystem als etwas, das jemand abgetippt hat. Maesn schreibt sie direkt in das System, das Ihr Kunde führt, in der Form, die dieses System annimmt.
- Betrag
- −1.284,00 EUR
- Beschreibung
- Rechnung 2026-0417
- Valutadatum
- 12.08.2026
- Gegenpartei
- noch nicht aufgelöst
Ein Posten, den ihr Buchhalter sehen, zuordnen und buchen kann, auf den angebundenen Systemen, die einen Weg dafür dokumentieren.
Bei der Bank ist die Bewegung strukturiert und bei der Buchung ist sie es nicht mehr
Niemand verliert die Daten. Sie werden unterwegs auseinandergenommen, von einem Schritt, den es nur gibt, weil die beiden Systeme nie miteinander verbunden wurden.
- Betrag
- − 1.284,00 EUR
- Beschreibung
- Rechnung 2026-0417
- Valutadatum
- 12.08.2026
- Referenz
- EREF+2026-0417
- Betrag
- − 1.284,00 EUR
- Beschreibung
- Rechnung 0417
- Valutadatum
- nicht übernommen
- Referenz
- nicht übernommen
- Herunterladen
- Übergeben
- Abtippen
- Buchen
Ein Auszugsexport behält meist mehr als eine abgetippte Buchung. So oder so haben die zwei Felder, auf denen eine automatische Zuordnung liefe, den weitesten Weg.
Über den Verzug beschwert sich der Endkunde. Eine Bewegung, die am Montag bei der Bank gebucht ist, steht in den Büchern, wenn jemand zum Export kommt, und bis dahin hinkt die Buchhaltung der Bank eine Woche hinterher. Diese Lücke ist keine Eigenschaft der Buchhaltung. Sie ist die Länge der Aufgabenliste von irgendjemandem.
Der teurere Posten ist, dass der Umweg je Kunde anfällt. Ein Anbieter, der Transaktionsdaten bewegt, kann sich nicht aussuchen, in welchem Buchhaltungssystem die Bewegung landen muss: das hat vor Jahren entschieden, wer die Bücher eingerichtet hat, und über einen Kundenbestand hinweg sind das ein Dutzend verschiedene Antworten. Direkt in jedes davon zu bauen heißt eine eigene Integration je System, jede mit ihrer eigenen Vorstellung davon, wie eine Bewegung heißt und welche Felder sie tragen muss, und jede altert nach ihrem eigenen Fahrplan.
Und die zwei Dinge, die die Bewegung bei der Ankunft brauchbar machen würden, fallen als Erstes weg. Die Bank kennt das Valutadatum und den Verwendungszweck; ein Auszugsexport behält beide meist, eine abgetippte Buchung meist nicht. Genau auf diesen zwei Feldern liefe später eine Zuordnung, und deshalb wird so viel Zuordnung am Ende nach Augenmaß gemacht.
Vier dokumentierte Wege ins Hauptbuch, und sie unterscheiden sich darin, was Sie vorher wissen müssen
Eine Bankbewegung kann in mehr als einer Form in ein Buchhaltungssystem gelangen. Welche Formen ein System annimmt, ist je System dokumentiert, und ebenso, was jede Form verlangt, bevor sie den Datensatz annimmt.
- Nichts über die Bewegung hinaus
POST /transactionsBetrag und Beschreibung sind auf jedem System dokumentiert, das diesen Weg veröffentlicht. Eine Gegenpartei wird auf einem davon verlangt und lässt sich auf zweien nicht einmal mitschicken.Systeme4 - Wem sie gehört
POST /bookingProposalsEin Feld für die Gegenpartei auf jedem System, das diesen Weg dokumentiert, und auf den meisten davon verlangt. Die, die es freistellen, sind DATEV Unternehmen Online, Lexware Office, sevdesk.Systeme10 - Welchen Beleg sie ausgleicht
POST /paymentsDer von Haus aus engere Weg: eine Zahlung wird gegen etwas gebucht, das bereits gestellt war.Systeme6 - Welches Konto, und welche Seite
POST /journalEntriesDas Konto wird auf fast jeder dokumentierten Liste verlangt. An dieser Stelle ist die Buchungsentscheidung bereits gefallen.Systeme10
Lesen Sie die letzte Spalte für sich, dann sehen die vier Wege aus wie vier Größen derselben Sache. Das sind sie nicht. Jedes System, das eine offene Transaktion annimmt, nimmt auch einen Buchungsvorschlag oder einen Buchungssatz an. Dieser Weg erhöht die Summe also nicht und wer ihn wählt, gewinnt überhaupt keine Abdeckung. Was er bringt, ist das eine, was die anderen drei nicht tun: eine Bewegung aufnehmen, die noch niemand zugeordnet hat.
Das dreht die Entwurfsfrage um. Sie lautet nicht, welcher Weg die meisten Systeme abdeckt, denn in diesem Maß landen sie am selben Punkt. Sie lautet, wie viel von der Bewegung Ihr Produkt vor dem Senden auflösen will. Lösen Sie nichts auf, schreiben Sie an die Systeme, die einen nicht zugeordneten Datensatz annehmen. Lösen Sie die Gegenpartei auf, öffnet sich der breiteste Weg, um den Preis, damit richtig liegen zu müssen. Lösen Sie Konto und Seite auf, buchen Sie keinen Feed mehr, sondern eine Buchung, und der Korrekturweg, falls Sie falsch lagen, gehört dem Buchhalter Ihres Kunden und nicht Ihnen. Die Formen selbst sind auf jedem System dieselben, dafür ist das Common Data Model da, und der Zugriff dahinter wird je Kunde einmal über einen Freigabeablauf erteilt.
Eine Bankbewegung wieder herauslesen
Es gibt kein GET /transactions in der ganzen Referenz. Über 208 Dokumentationsadressen hinweg ist der Schreib-Endpunkt der einzige Transaktions-Endpunkt, den es gibt, und die Bewegung geht damit hinein und kommt nie zurück.
Die Buchungen lesen und das Bankkonto herausgreifen
Buchungssätze sind lesbar, und das Konto sitzt auf der Zeile darin und nicht am Buchungssatz.
- Es gibt in der Anfrage keinen Kontenfilter. Das Filterobjekt am Lesezugriff trägt ein Änderungsdatum und sonst nichts, und ein Teil der dokumentierten Systeme veröffentlicht überhaupt keinen Filter. Das Bankkonto auszuwählen geschieht in Ihrem Produkt.
- Manche dokumentierten Antworten tragen überhaupt keine Zeilen (Exact Online, Fortnox, odoo). Das Konto, zu dem eine Bewegung gehört, liegt auf dieser Zeile, und auf diesen dreien lässt sich eine Bankbewegung deshalb von keiner anderen Buchung unterscheiden.
Die Richtung zählt hier mehr als bei den meisten Use Cases, denn das naheliegende Denkmodell ist falsch. Ein Feed klingt nach einem Strom, den man auch beobachten kann, und dieser ist keiner: es gibt überhaupt keinen Lese-Endpunkt für Transaktionen, nichts, was Sie schreiben, kommt also durch dieselbe Tür zurück. Lesen können Sie das Hauptbuch, und eine Bankbewegung im Hauptbuch ist eine Buchungszeile, die auf ein Bankkonto verweist.
Daraus folgen zwei Dinge, und beide gehören in einen Bauplan statt in eine spätere Überraschung. Ein einzelnes Bankkonto auszuwählen ist Arbeit, die Ihr Produkt nach dem Lesen leistet, und kein Parameter, den es mitschickt, wie viel Sie lesen und wie oft, ist also Ihre Entscheidung; paginierte, filterbare Lesezugriffe und die Aufträge, die manche Systeme stattdessen zurückgeben, machen diese Entscheidung günstig. Und wo eine Antwort keine Zeilen trägt, ist die Bewegung dort nicht zu finden, und das ist eine Tatsache je System, die man beim Onboarding prüft, und keine Regel, die man einmal anwendet. Wie ein teilweiser oder abgelehnter Schreibvorgang auf dem Hinweg aussieht, ist Unified Error Handling, und der Nachweis, was gesendet wurde, wenn ein Kunde eine Buchung hinterfragt, ist Logging und Monitoring.
Ein Schreibvorgang je Bewegung, und die passende Form wird für Sie gewählt
Der Wert liegt nicht darin, dass sich eine Bankbewegung buchen lässt. Er liegt darin, dass es aufhört, Ihr Problem zu sein, welche der vier Formen das System eines Kunden annimmt.
17nehmen eine Bankbewegung
über mindestens einen der vier dokumentierten Wege
10nehmen genau eine Form an
es gibt also je System eine richtige Antwort, und nur eine
7lassen Ihnen die Wahl
und selbst dort unterscheiden sich die Feldlisten je Weg
Das direkt zu bauen heißt, je System herauszufinden, welche Form es annimmt und worauf diese Form besteht, und dann mitzuhalten, wenn ein Hersteller es sich anders überlegt. Bei den meisten gibt es genau eine richtige Antwort, der Preis des Ratens ist also kein schwächerer Feed, sondern ein abgelehnter Schreibvorgang. Das ist die Arbeit, die diese Anbindung abnimmt: Ihr Produkt sendet eine Bewegung einmal, in einem Vokabular, und welcher Endpunkt daraus wird, entscheidet sich darunter.
Was sich dadurch in der Praxis ändert, ist, wann die Buchung existiert, und nicht, ob sie entstehen kann. Eine Bewegung kann an dem Tag in die Bücher kommen, an dem sie ausgeglichen wird, statt an dem Tag, an dem sich jemand an den Export erinnert, und die Person, die sie zuordnet, arbeitet weiter dort, wo sie das ohnehin tut. Es ändert auch, was Ihre Roadmap tragen muss: eine Anbindung zu pflegen statt einer je Buchhaltungssystem über einen Kundenstamm, den Sie nicht steuern.
Was mit der Bewegung ankommt, Feld für Feld
Auf dem Weg, der eine nicht zugeordnete Bewegung annimmt, steht hier, was jedes dieser Systeme dokumentiert. Lesen Sie es als Obergrenze und nicht als Plan.
amountDokumentiert auf4Die einzigen zwei Felder auf allen vierendescriptionDokumentiert auf460 Zeichen auf DATEV Unternehmen OnlinebookingDateDokumentiert auf3Das Datum, an dem das Hauptbuch sie buchtaccountIdDokumentiert auf3DATEV Unternehmen Online nennt es stattdessen accountNumbervalueDateDokumentiert auf2Das Datum, an dem die Bank sie ausgeführt hatreferenceDokumentiert auf2Worauf eine automatische Zuordnung laufen würdefilesDokumentiert auf1Der Beleg als Datei, auf DATEV Unternehmen Online
Die zwei Felder, die immer ankommen, sind der Betrag und eine Zeile Text. Alles, was eine Maschine entscheiden ließe, wozu die Bewegung gehört, ist dünner als das: die Bankreferenz auf ein paar davon, das Valutadatum auf ebenso wenigen und der Beleg als Datei auf noch weniger. Ein Produkt, das Bewegungen automatisch über die Referenz zuordnen will, plant für eine Teilmenge, und es ist besser, beim Onboarding zu wissen welche, als nach dem Livegang des ersten Kunden.
Das Datum lohnt zweimal gelesen zu werden, denn die Teilung verläuft genau entlang der Naht zwischen den zwei Welten. Die Bank weiß, wann sie ausgeführt hat; das Hauptbuch will wissen, wann es buchen soll. Manche dokumentieren das Buchungsdatum, manche das Valutadatum, und nur eines dokumentiert beide. Auf den übrigen fehlen weniger die Daten, als dass Ihr Produkt eine Entscheidung treffen und dabei konsequent bleiben muss, und das ist die Art von Inkonsequenz, die Monate später als ein Abgleich auftaucht, der nicht aufgeht. Die Gegenpartei hinter einer Bewegung mit dem im Gleichstand zu halten, was das Buchhaltungssystem schon führt, ist die Kunden- und Lieferantenstammdatensynchronisation.
Wo das in einem Bauvorhaben sitzt, ist meist die schwerere Frage, und sie beantworten Teams, die es schon getan haben, besser als eine Feldtabelle. Wie andere Produkte den Schreibvorgang gegen den Rest ihrer Integration gereiht haben, steht in den Case Studies.
Jedes Objekt, das ein Feed berührt, je System gezählt
Aus der Dokumentation des jeweiligen Systems statt aus einer Zusammenfassung, und die letzte Zeile gehört zur Antwort und ist keine Auslassung.
| Was Sie brauchen | Heute | Auf Anfrage | System kann es nicht |
|---|---|---|---|
| Buchungsvorschläge, schreiben | 10 | 17 | 2 |
| Buchungen, schreiben | 10 | 11 | 8 |
| Zahlungen, schreiben | 6 | 16 | 7 |
| Offene Transaktionen, schreiben | 4 | 18 | 7 |
| Buchungen, lesen | 11 | 11 | 7 |
| Bankkonten, als Stammdaten | 3 | 19 | 7 |
| Bewegungen, zurücklesen | 0 | 21 | 8 |
Der Abstand zwischen den Schreibzeilen und den Lesezeilen macht daraus eine Einbahnstraße. Das Schreiben ist gut abgedeckt, weil jedes Buchhaltungssystem etwas hereinlassen muss, und jedes von ihnen hat eine Meinung dazu, wie dieses Etwas heißt. Das Lesen ist dünn, weil eine Bankbewegung in diesem Modell überhaupt kein Objekt ist: sie ist eine Buchung, ein Vorschlag oder eine Zahlung, je nachdem, wie sie dorthin kam. Deshalb können sich auch zwei Seiten Endpunkte teilen und trotzdem verschieden zählen: die Zeilen, die sie brauchen, sind nicht dieselben.
Eine Vorsichtsregel zum Wortschatz. Das Objekt, das in der Dokumentation Transaction heißt, ist ein Auffangbecken für Datensätze, die nicht in die anderen Modelle passen, und keine Bankbewegung per Definition. Es ist der richtige Behälter für eine, und das Beispiel der Anfrage ist eine Kartenzahlung, aber der Name ist breiter als der Use Case, und nichts hier ist als Kontoauszugs-Feed zu lesen. Die Systeme, denen ein europäischer Anbieter auf diesen Wegen am häufigsten begegnet, lohnen sich vor dem Zuschnitt einzeln zu prüfen: DATEV Unternehmen Online, Lexware Office, sevdesk und Exact Online. Was die Anbindung behält und wie lange, steht auf der Sicherheitsseite.
Wir bringen die Bewegung ins Hauptbuch, Sie entscheiden, was sie bedeutet
Ein Feed ist die eine Hälfte einer Aufgabe. Die andere Hälfte ist die Zuordnung, und sie gehört der Seite, die das Geschäft hinter der Bewegung kennt.
- Der Schreibvorgang, in der Form jedes Systems
- Ein Wortschatz für den Datensatz
- Die Buchungen, zurückgelesen
- Die Feldgrenzen je System
- Woher die Bewegungen kommen
- Zu welchem Konto sie gehören
- Wie sie zugeordnet werden, wenn überhaupt
- Wann und wie oft Sie senden
Maesn ist nicht die Quelle der Bankdaten und bindet keine Bank an. Ob die Bewegungen aus einer eigenen Lizenz, von einem Kontoinformationsdienst, aus einem Kartenprogramm oder aus einem Kunden-Upload kommen, ist Ihre Seite der Grenze, und es ist die Seite, für die Ihre Kunden Sie bezahlen. An unserer Grenze endet die andere: diese Bewegung in das Buchhaltungssystem zu schreiben, das ein bestimmter Kunde führt, ohne dass Sie je System eine Anbindung bauen und pflegen.
Und darin steckt nirgends eine Abgleich-Engine. Zu entscheiden, dass eine Bewegung eine bestimmte Rechnung ausgleicht, und diese Entscheidung zurückzuschreiben, damit der offene Posten schließt, ist eine andere Aufgabe mit einer eigenen Seite: Zahlungsabgleich. Diese hier hört bei der Auslieferung auf, mit Absicht, denn ein Feed, der rät, ist schlechter als ein Feed, der unzugeordnet neben dem eigenen Werkzeug des Kunden ankommt. Ganze Hauptbücher zu lesen, um ein Unternehmen zu verstehen statt eine einzelne Bewegung zu platzieren, ist Finanzanalyse und Finanzplanung, und mit dem Ergebnis aller drei leben Finanzteams. Treibt ein Agent den Schreibvorgang statt Ihres eigenen Codes, bietet der MCP Server dieselben Wege an, und die Felder, die eine einzelne Installation erfunden hat, sind erreichbar, ohne auf das Wachstum des gemeinsamen Modells zu warten.
Häufige Fragen
In welche Systeme können wir Bankbewegungen buchen?
Erreicht ein anderer Weg mehr Systeme?
Müssen wir die Gegenpartei vor dem Senden bestimmen?
Können wir Bankbewegungen wieder herauslesen?
Können wir nur die Bewegungen eines einzelnen Bankkontos abfragen?
Zeigt uns jedes System die Buchungszeilen?
Kommen die Bankreferenz und das Valutadatum an?
Worin unterscheidet sich das von Ihrem Use Case zum Zahlungsabgleich?
Binden Sie die Bank für uns an?
Wird unterwegs etwas gespeichert?
Einmal bauen, auf der Unified API.
Sehen Sie, wie Banktransaktionen für Ihre Integration funktioniert, oder steigen Sie in die technische Referenz ein.











