maesn
Use Case

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.

Eine Bewegung, wie die Bank sie hat
Betrag
−1.284,00 EUR
Beschreibung
Rechnung 2026-0417
Valutadatum
12.08.2026
Gegenpartei
noch nicht aufgelöst
ein Schreibvorgang, vier Wege
Im Hauptbuch Ihres Kunden

Ein Posten, den ihr Buchhalter sehen, zuordnen und buchen kann, auf den angebundenen Systemen, die einen Weg dafür dokumentieren.

Diese Software-Teams vertrauen uns
HubSpotTipaltiPaywiseRallyQredNordhealthFindityFintoClockinHEROHolviLanes & PlanesAgicapHubSpotTipaltiPaywiseRallyQredNordhealthFindityFintoClockinHEROHolviLanes & PlanesAgicap
Das Problem

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.

Wie die Bank sie hat
Betrag
− 1.284,00 EUR
Beschreibung
Rechnung 2026-0417
Valutadatum
12.08.2026
Referenz
EREF+2026-0417
Nachdem sie abgetippt ist
Betrag
− 1.284,00 EUR
Beschreibung
Rechnung 0417
Valutadatum
nicht übernommen
Referenz
nicht übernommen
  1. Herunterladen
  2. Übergeben
  3. Abtippen
  4. 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.

Wie Maesn das löst

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 hinausPOST /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örtPOST /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 ausgleichtPOST /paymentsDer von Haus aus engere Weg: eine Zahlung wird gegen etwas gebucht, das bereits gestellt war.Systeme6
  • Welches Konto, und welche SeitePOST /journalEntriesDas Konto wird auf fast jeder dokumentierten Liste verlangt. An dieser Stelle ist die Buchungsentscheidung bereits gefallen.Systeme10
Aus der Dokumentation je System gelesen, und ein System kann in mehr als einer Zeile stehen.

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.

Was Sie nicht können

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.

Was Sie stattdessen können

Die Buchungen lesen und das Bankkonto herausgreifen

Buchungssätze sind lesbar, und das Konto sitzt auf der Zeile darin und nicht am Buchungssatz.

Die zwei Dinge, die vor der Planung zu prüfen sind
  • 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.

Was Sie bekommen

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

Aus derselben Dokumentation je System gelesen wie die Tabelle darüber.

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.

Die Eckdaten

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.

Auf dem Weg über die offene Transaktion: DATEV Unternehmen Online, Exact Online, Lexware Office, sevdesk
  • amountDokumentiert auf4Die einzigen zwei Felder auf allen vieren
  • descriptionDokumentiert auf460 Zeichen auf DATEV Unternehmen Online
  • bookingDateDokumentiert auf3Das Datum, an dem das Hauptbuch sie bucht
  • accountIdDokumentiert auf3DATEV Unternehmen Online nennt es stattdessen accountNumber
  • valueDateDokumentiert auf2Das Datum, an dem die Bank sie ausgeführt hat
  • referenceDokumentiert auf2Worauf eine automatische Zuordnung laufen würde
  • filesDokumentiert auf1Der Beleg als Datei, auf DATEV Unternehmen Online
Von den Systemen, die diesen Weg dokumentieren, aus ihren eigenen Feldlisten gelesen. Nur Lexware Office dokumentiert beide Daten, und auf den übrigen ist der Unterschied zwischen dem Zeitpunkt, zu dem die Bank eine Bewegung ausgeführt hat, und dem, zu dem das Hauptbuch sie bucht, deshalb eine Entscheidung Ihres Produkts und keine Angabe, die es mitträgt.

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.

Abdeckung

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.

Über die 30+ angebundenen Systeme
Was Sie brauchenHeuteAuf AnfrageSystem kann es nicht
Buchungsvorschläge, schreiben10172
Buchungen, schreiben10118
Zahlungen, schreiben6167
Offene Transaktionen, schreiben4187
Buchungen, lesen11117
Bankkonten, als Stammdaten3197
Bewegungen, zurücklesen0218
Die ersten vier Zeilen sind die vier Wege hinein, und ein System kann in mehr als einer davon stehen. Darunter sitzt, was sich zurücklesen lässt: die Buchungen und die Bankkonten als Stammdaten. Die letzte Zeile ist die, die am härtesten zu lesen ist, denn sie bleibt auf null: Bewegungen lassen sich über diese Anbindung überhaupt nicht lesen, und deshalb bietet nichts auf dieser Seite an, Ihnen einen Auszug zu zeigen.

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.

Wo die Grenze verläuft

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.

Maesn liefert
  • Der Schreibvorgang, in der Form jedes Systems
  • Ein Wortschatz für den Datensatz
  • Die Buchungen, zurückgelesen
  • Die Feldgrenzen je System
Ihrem Produkt gehört
  • 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.

Banktransaktionen FAQ

Häufige Fragen

In welche Systeme können wir Bankbewegungen buchen?

Ein Teil der angebundenen Systeme nimmt eine Bankbewegung über mindestens einen dokumentierten Weg an. Welcher Weg funktioniert, hängt vom System ab und nicht von Ihrer Vorliebe: der Endpunkt für offene Transaktionen ist auf DATEV Unternehmen Online, Exact Online, Lexware Office, sevdesk dokumentiert, und Buchungsvorschläge, Buchungssätze und Zahlungen je auf ihrer eigenen Menge. Die meisten Systeme bieten genau einen der vier an, die praktische Frage beim Onboarding ist also nicht, ob das System eines Kunden abgedeckt ist, sondern welche Form es will.

Erreicht ein anderer Weg mehr Systeme?

Nein, und das lohnt sich vor dem Bau zu wissen. Jedes System, das eine offene Transaktion annimmt, nimmt auch einen Buchungsvorschlag oder einen Buchungssatz an, dieser Weg erhöht die Summe also nicht und gewinnt überhaupt keine Abdeckung. Was er bringt, ist, dass er eine Bewegung annimmt, die noch niemand zugeordnet hat. Die anderen Wege erreichen in Summe dieselbe Menge und wollen je etwas vorher entschieden haben: wer die Gegenpartei ist, welcher Beleg ausgeglichen wird, oder welches Konto und welche Seite. Die Wahl geht darum, was Ihr Produkt weiß, und nie darum, wie weit es kommt.

Müssen wir die Gegenpartei vor dem Senden bestimmen?

Auf den meisten Wegen ja. Der Weg über den Buchungsvorschlag trägt auf jedem System, das ihn dokumentiert, ein Feld für die Gegenpartei, und auf einigen verlangt er es. Der Weg über die offene Transaktion ist die Ausnahme und der Grund, aus dem es diesen Use Case eigenständig gibt: auf manchen Systemen, die diesen Weg dokumentieren, lässt sich eine Gegenpartei gar nicht mitschicken, die Bewegung landet dort also unzugeordnet, und der Buchhalter ordnet sie dort zu, wo er diese Arbeit ohnehin macht.

Können wir Bankbewegungen wieder herauslesen?

Nein. Es gibt in der ganzen Referenz keinen Lese-Endpunkt für Transaktionen, eine Bewegung, die über diese Anbindung geschrieben wurde, kommt also nicht über sie zurück. Lesbar sind die Buchungen: Buchungssätze, mit dem Konto auf der Zeile im Buchungssatz. Bankkonten selbst sind als Stammdaten auf bexio, Lexware Office, sevdesk lesbar, und das ist die Kontenliste und nicht ihre Bewegungen.

Können wir nur die Bewegungen eines einzelnen Bankkontos abfragen?

Nicht in der Anfrage. Das Filterobjekt am Lesezugriff auf Buchungssätze trägt ein Änderungsdatum und sonst nichts, und ein Teil der dokumentierten Systeme veröffentlicht überhaupt keinen Filter. Das Konto sitzt auf der einzelnen Buchungszeile, ein einzelnes Bankkonto auszuwählen heißt also, das Geänderte zu lesen und die Zeilen auf Ihrer Seite herauszugreifen. Das ist eine Entwurfsentscheidung, die sich früh zu treffen lohnt, denn sie legt fest, wie viel Sie lesen und wie oft.

Zeigt uns jedes System die Buchungszeilen?

Nein, und das ist die schärfste Grenze auf dieser Seite. Von den Systemen, die ihre Antwort auf Buchungssätze Feld für Feld dokumentieren, geben die meisten die Positionen zurück und diese nicht: Exact Online, Fortnox, odoo. Das Konto, zu dem eine Bewegung gehört, liegt auf dieser Zeile. Wo die Zeilen fehlen, lässt sich eine Bankbewegung in den Buchungen überhaupt nicht bestimmen, was die Abdeckungszahl in der Überschrift auch nahelegt.

Kommen die Bankreferenz und das Valutadatum an?

Seltener als der Betrag. Auf dem Weg über die offene Transaktion sind der Betrag und die Beschreibung auf jedem System dokumentiert, das diesen Weg veröffentlicht, das Buchungsdatum auf den meisten, und die Bankreferenz und das Valutadatum auf weniger. Nur Lexware Office dokumentiert beide Daten, überall sonst entscheidet also Ihr Produkt über den Unterschied zwischen dem Zeitpunkt, zu dem die Bank eine Bewegung ausgeführt hat, und dem, zu dem das Hauptbuch sie bucht, statt dass der Datensatz ihn trägt. Ein Feed, der über die Bankreferenz zuordnet, ist ein Feed für ein paar Systeme.

Worin unterscheidet sich das von Ihrem Use Case zum Zahlungsabgleich?

Dadurch, ob die Zuordnung schon stattgefunden hat. Beim Zahlungsabgleich geht es um eine Zahlung, die Sie einer Rechnung bereits zugeordnet haben, und darum, diese Zuordnung zurückzuschreiben, damit der offene Posten schließt. Bei Banktransaktionen geht es darum, die Bewegung überhaupt in die Bücher zu bringen, bevor jemand weiß, wozu sie gehört. Beide teilen sich Endpunkte und beantworten entgegengesetzte Hälften derselben Tagesarbeit, und ein Produkt, das beides tut, baut es meist als zwei Abläufe.

Binden Sie die Bank für uns an?

Nein. Woher die Bewegungen kommen, ist Ihre Seite: Ihre eigene Banklizenz, ein Kontoinformationsdienst, ein Kartenprogramm oder ein Kunden-Upload. Maesn ist das andere Ende, die ERP- und Buchhaltungssysteme, die Ihre Kunden führen, und der Wert liegt darin, dass Sie in eine Form schreiben statt in eine Integration je System, das Ihre Kunden gerade einsetzen.

Wird unterwegs etwas gespeichert?

Nein. Die Bewegung wird hier nicht gelagert. Sie wird normalisiert, in das System geschrieben, das Ihr Kunde freigegeben hat, und ist dann weg. Was danach bleibt, liegt in seinen Büchern, unter seiner Kontrolle und seinen Aufbewahrungsregeln, und genau dort erwartet ein Prüfer es zu finden.

Einmal bauen, auf der Unified API.

Sehen Sie, wie Banktransaktionen für Ihre Integration funktioniert, oder steigen Sie in die technische Referenz ein.