maesn
Use Case

Debitorenbuchhaltung beginnt vor der Rechnung

Plattformen für die Debitorenbuchhaltung brauchen eine tiefe Anbindung in beide Richtungen, um Kunden, Konten, Journale, Abgrenzungen, Steuersätze und offene Posten korrekt abzubilden. Maesn trägt diese Abläufe über Dutzende ERP- und Buchhaltungssysteme, ohne dass Sie jede Anbindung einzeln bauen.

Eine Forderung, zwei Hälftenbeide Richtungen
Ihr Produkt
  • Die Rechnung, die Sie gestellt haben
  • Die Zahlung, die Sie erfasst haben
eine Form, in beide Richtungen
Ihr Hauptbuch
  • Der Kunde, wie ihre Bücher ihn nennen
  • Das Konto, auf das sie bucht
  • Der Steuersatz, der gilt

Sechs der acht dokumentierten Schritte betreffen die rechte Seite und nicht die Rechnung.

Diese Software-Teams vertrauen uns
HubSpotTipaltiPaywiseRallyQredNordhealthFindityFintoClockinHEROHolviLanes & PlanesAgicapHubSpotTipaltiPaywiseRallyQredNordhealthFindityFintoClockinHEROHolviLanes & PlanesAgicap
Die Voraussetzung

Forderungen zu buchen heißt vor allem, die richtigen Daten zur Zuordnung zu haben

Kundendaten, Kontenrahmen, Dimensionen und Steuersätze aus dem Buchhaltungssystem Ihres Kunden lesen, als Grundlage für eine präzise Zuordnungslogik in Ihrem System: die Voraussetzung für korrekte Buchungen zurück ins Buchhaltungssystem.

Was Sie zuerst lesen
/contactsKunden zugeordnet
/accountsDas Hauptbuch
/taxRatesGenutzte Steuerschlüssel
/dimensionsKlassen, Abteilungen
Was Ihr Produkt entscheidet
  • Auf welchem Konto eine Forderung landet
  • Ob die Steuer gesetzt oder gewählt wird
  • Regeln mit Bedingung je Abteilung
  • Überschreiben im Moment der Übertragung
Dann schreiben Sie, auf einem von drei Wegen
Option 1POST /invoices
Option 2POST /bookingProposals
Option 3POST /payments
Und danach bleibt es aktuellDer Parameter lastModified wirkt auf jedem GET-Endpunkt, und das Geänderte zu erkennen ist damit ein Filter und kein Abgleich, den Sie bauen.

Der erste Schritt ist gar kein Aufruf, er ist ein anderer Use Case. Der Leitfaden beginnt damit, den Kontaktabgleich einzurichten, damit der Kunde in Ihrer Datenbank und der Kunde in der Buchhaltungsplattform Ihres Nutzers nachweislich dieselbe Partei sind. Das ist keine Bürokratie. Eine Forderung, die auf einen fast doppelten Kundendatensatz gebucht wird, ist die Art Fehler, die niemandem auffällt, bis ein Kontoauszug herausgeht, und dann kostet sie jemanden einen Nachmittag. Diese Arbeit hat ihre eigene Seite, die Synchronisation von Kunden- und Lieferantenstammdaten.

Danach kommen die Strukturen: das Sachkonto, auf das die Rechnung bucht, die verwendeten Steuersätze, und die Dimensionen, die ihre Einrichtung erwartet, falls sie welche nutzen. Nichts davon liegt in Ihrem Produkt, alles unterscheidet sich je Kunde, und jede dieser Stellen macht aus einer sonst korrekten Rechnung eine Korrektur. Besonders die Steuersätze sind weniger einheitlich, als sie aussehen, und das ist ein Thema für sich unter Steuerautomatisierung.

Erst dann taucht die Rechnung auf, und an diesem Punkt ist die interessante Frage nicht mehr, wie man sie sendet. Sie lautet, welchen der dokumentierten Wege sie nehmen soll.

Wie Maesn das löst

Eine Anbindung, die die Struktur liest und die Forderung zurückschreibt

Dieselben Objekte unter denselben Namen auf jedem angebundenen System, in beide Richtungen, damit die Zuordnung, die Ihre Nutzer einmal einrichten, weiter funktioniert, wenn der nächste Kunde auf einer anderen Plattform ankommt.

Die Lesezugriffe kommen in einer normalisierten Form an, und erst das macht den Schritt der Kategorisierung überhaupt baubar. Sie holen die Konten, die Sätze und die Dimensionen, Sie zeigen sie in Ihrer eigenen Oberfläche, und Ihre Nutzer entscheiden, wie ihre Forderungen darauf abgebildet werden. Die Dokumentation ist ungewöhnlich konkret darin, wie weit das gehen kann: ein einzelnes Sachkonto aus einer Auswahlliste, bedingte Regeln der Art if Department = IT, use Account A, oder eine Wahl im Moment der Übertragung, die die gespeicherte Konfiguration überschreibt. Diese Logik gehört Ihrem Produkt. Was es von der Anbindung braucht, ist, dass die Optionen echt und aktuell sind.

Beim Zurückschreiben zählt die Richtung. Eine Forderung ist Geld, das Ihrem Kunden zusteht, sie bucht also als Rechnung und Zahlung auf einen Kundendatensatz und nicht als Spiegelbild auf der Verbindlichkeitsseite. Diese Unterscheidung geht in einer Integrationsschicht leicht verloren, die beide als Belege mit Beträgen behandelt, und sie ist der Grund, warum die Verbindlichkeitsseite eine eigene Seite hat und nicht einen Absatz auf dieser.

Der Kundendatensatz selbst ist das stärkste Glied der Kette, was günstig ist, da der Ablauf dort beginnt. Er ist auf den meisten angebundenen Systemen lesbar und auf fast ebenso vielen schreibbar, und beide Seiten in Übereinstimmung zu halten ist damit keine Sonderfähigkeit, die Sie je System prüfen müssen. Die Authentifizierung dafür ist ein Ablauf, den Ihr Kunde einmal freigibt, welches System er auch nutzt.

Was Sie bekommen

Vier Wege, auf denen eine Forderung ins Hauptbuch gelangt

Die Rechnung anlegen

Die Rechnung entsteht in Ihrem Produkt, und sie kommt deshalb als echter Beleg im Hauptbuch an, mit Ihren Entscheidungen daran.

Sie sendenPOST /invoices
Sie liefernKonto, Satz, Dimensionen

Die gestellte hochladen

Die Rechnung besteht bereits anderswo, und sie wird deshalb zur Buchung vorgelegt, statt ein zweites Mal gestellt zu werden.

Sie sendenPOST /bookingProposals
Sie bekommeneinen Vorgang zum Buchen

Die Zahlung darauf

Ein eigener Schritt nach beiden Wegen, und der, den man gegen die Systeme der eigenen Kunden prüft.

Sie sendenPOST /payments
Sie liefernden Ausgleich

Der Buchungssatz

Der tiefste Weg, und er verlangt von Ihrem Produkt die fertige Buchung. Hier werden auch Rückstellungen und Abgrenzungen ausgedrückt.

Sie sendenPOST /journalEntries
Sie lieferndie vollständige Buchung

Welchen der vier ein Produkt für die Debitorenbuchhaltung nutzt, hängt vom konkreten Anwendungsfall ab: wo die Rechnung entsteht, ob die Kategorisierung Ihrem Produkt gehört, und ob neben dem Beleg auch das Geld im Hauptbuch erscheinen muss. Die meisten Produkte brauchen mit der Zeit mehr als einen davon, und die Anbindung ändert sich dabei nicht.

Dabei helfen wir, statt es einem Probebau zu überlassen. Es hängt außerdem vom System vor Ihnen ab: Lexware Office und Xero nehmen beide der ersten zwei, dort ist die Wahl also wirklich Ihre, während DATEV Unternehmen Online Buchungsvorschläge nimmt, und das ist die Form des deutschen Ablaufs: Belege werden in die Umgebung des Steuerberaters eingereicht, um gebucht zu werden, sie werden dort nicht ausgestellt. Sagen Sie uns, auf welchen Systemen Ihre Kunden sind, und wir sagen Ihnen, welche Wege auf jedem verfügbar sind.

Die Zahlung gegen den offenen Posten auszugleichen ist die benachbarte Aufgabe, beschrieben unter Zahlungsabgleich, und wo ein System Events aussendet, verkürzen Webhooks die Schleife zwischen dem Eingang des Geldes und dem Wissen Ihres Produkts davon.

Beleg

Plattformen für Forderungen laufen bereits auf dieser Anbindung

Zwei veröffentlichte Kundenkategorien, und die zweite ist das, was passiert, wenn eine Forderung aufhört, eine Forderung zu sein.

Ein Kunde in dieser Kategorie
Debtist
Debtist, ein SaaS für Debitorenmanagement, läuft auf dieser API.

Debitorenmanagement ist dieser Use Case unter einem anderen Namen, und damit ist es die nächstliegende veröffentlichte Kategorie, die Maesn dazu hat.

Was danach kommt
Paywise
Paywise, ein SaaS für das Forderungsmanagement, baut auf derselben Anbindung.

Eine Forderung, die unbezahlt bleibt, wird ein Inkassofall, und das ist eine Plattform, die dieselben Objekte aus demselben Hauptbuch liest.

Paywise hat die ganze Geschichte erzählt, auch das, was sich nach der Integration geändert hat.

Die zwei sitzen an verschiedenen Punkten derselben Linie. Debitorenmanagement ist dieser Use Case unter einem anderen Namen, und Inkasso ist das, was aus dem unbezahlten Rest wird. Beide brauchen dieselben Dinge aus dem Hauptbuch des Gläubigers, und das ist das Argument für eine Anbindung statt einer je Ablauf, und das Inkasso-Ende davon ist unter dem Forderungsmanagement beschrieben.

Die Eckdaten

Abdeckung bei Forderungen, Objekt für Objekt

Zuerst der dokumentierte Ablauf, dann die zwei Objekte, die man hier erwarten könnte und auf die man sich nicht verlassen sollte. Gezählt aus der Dokumentation des jeweiligen Systems, und was heute unterstützt wird, steht getrennt von dem, was nur auf Anfrage verfügbar ist.

Über die 30+ angebundenen Systeme
Was Sie brauchenHeuteAuf AnfrageSystem kann es nicht
Kundendatensätze, lesen2027
Kundendatensätze, schreiben1649
Kontenrahmen, lesen1982
Steuersätze, lesen12143
Rechnungen, schreiben10172
Buchungsvorschläge, schreiben10172
Zahlungen, schreiben6167
Zahlungsbedingungen, lesen21413
Offene Posten, als Objekt2234
Der Kopf der Tabelle ist der dokumentierte Ablauf, und dort ist dieser Use Case stark: der Kundendatensatz ist das am besten abgedeckte Objekt des ganzen Modells, beim Lesen wie beim Schreiben. Die letzten zwei Zeilen stehen hier, weil die Seite, die sie ersetzen, sie zugesagt hat. Zahlungsbedingungen und offene Posten stehen heute je bei kaum einem System, und deshalb baut hier auf keinem von beiden etwas auf. Für offene Rechnungen ist der dokumentierte Weg die Rechnungsliste mit einem Filter auf Zahlungsstatus oder Fälligkeitsdatum, und der wird weit breiter unterstützt.

Die Form dieser Tabelle ist die Form des Use Cases: sie ist genau dort am stärksten, wo der Ablauf beginnt, beim Kundendatensatz. Das erlaubt einem Produkt, seinen Nutzern einen funktionierenden Forderungsabgleich zuzusagen statt eines funktionierenden Forderungsabgleichs auf vier namentlich genannten Systemen.

Die letzten zwei Zeilen verdienen ihren Platz dadurch, dass sie schwach sind. Die Seite, die diese ersetzt, nannte Zahlungsbedingungen und offene Posten unter den Objekten, die sie korrekt abbildet, und bei je kaum einem System war das mehr, als die Daten hergaben. Wo ein System eine Forderungsstruktur führt, für die das gemeinsame Modell kein Feld hat, ist am Modell vorbeizugreifen dokumentiert, und die stückweise Auffrischung, die das alles aktuell hält, arbeitet wie auf jedem anderen Listen-Endpunkt.

Wo die Grenze verläuft

Wir liefern die Struktur, Ihre Nutzer entscheiden die Zuordnung

In diesem Use Case ist die Grenze ungewöhnlich klar, weil die Dokumentation die Logik der Kategorisierung selbst in Ihrem Produkt verortet und das auch sagt.

Was Maesn liefert
  • Der Kunde, in beide Richtungen
  • Konten, Sätze und Dimensionen
  • Zwei Wege für die Rechnung
  • Die Zahlung, zurückgeschrieben
Was Ihr Produkt bleibt
  • Welches Konto eine Forderung trifft
  • Die Regeln Ihrer Nutzer
  • Wann übertragen wird
  • Wie Ihre Mahnung aussieht

Alles links ist die Anbindung bei dem, was eine Anbindung tun soll: dieselben Objekte, unter denselben Namen, auf welchem System Ihr Kunde auch läuft, in beide Richtungen. Das ist der Teil, der sonst eine Anbindung je Buchhaltungsplattform wäre, jede mit eigener Authentifizierung, eigenen Feldnamen und einer eigenen Meinung darüber, was ein Kundendatensatz enthält.

Alles rechts ist Ihr Produkt, und der Leitfaden sagt ausdrücklich, dass das Absicht ist. Er gibt Ihnen die Konten, die Sätze und die Dimensionen und sagt dann, die Geschäftslogik werde von Ihrer Anwendung abhängen. Ob eine Forderung auf ein einzelnes Sachkonto oder auf eine bedingte Regel abgebildet wird, ob Ihre Nutzer das im Moment der Übertragung überschreiben können, und wann eine Übertragung überhaupt stattfindet, sind Produktentscheidungen mit den Buchhaltungsgepflogenheiten Ihrer Kunden dahinter. Eine Schicht, die sie für Sie beantwortete, riete an der Absicht eines Buchhalters herum.

Eine Eigenschaft gehört hierher und nicht auf die Sicherheitsseite. Anfragen werden verarbeitet, wie sie eintreffen, und was Maesn behält, ist der Nachweis, dass eine Übertragung stattgefunden hat, und nicht die übertragenen Daten. Für ein Produkt, das Kunden- und Umsatzdaten anderer Firmen verarbeitet, ist weniger davon zu halten leichter zu verteidigen. Der lastModified-Filter auf den Lese-Endpunkten ist das, was Aktualität billig macht, ohne eine Kopie irgendeines Hauptbuchs zu halten.

Wer zuerst bemerkt, dass eine Forderung altert, sind Finanzteams, bevor es irgendwen sonst erreicht.

Debitorenbuchhaltung FAQ

Häufige Fragen

Wo fängt eine Integration für die Debitorenbuchhaltung tatsächlich an?

Nicht bei der Rechnung. Der dokumentierte Ablauf beginnt damit, zuerst den Use Case für den Kontaktabgleich umzusetzen, damit der Kunde in Ihrer Datenbank und der Kunde in der Buchhaltungsplattform Ihres Nutzers derselbe Kunde sind. Eine Forderung, die auf den falschen Datensatz gebucht wird, ist keine Forderung, sondern ein Abgleichsproblem mit einem Datum darauf.

Wie kommt die Rechnung in das Buchhaltungssystem?

Über einen von mehreren dokumentierten Wegen, und sie sind gleichrangig und nicht erste Wahl und Rückfallebene. Entsteht die Rechnung in Ihrem Produkt, legen Sie sie im System des Kunden an. Wurde sie bereits auf einer anderen Plattform angelegt, verweist der Leitfaden stattdessen auf Buchungsvorschläge, und dann kommt sie als etwas an, das zu buchen ist, und nicht als frischer Beleg. Die Zahlung und der Buchungssatz sind nach beidem eigene Wege.

Was brauchen wir, bevor wir überhaupt buchen können?

Die eigene Buchhaltungsstruktur des Kunden, und das ist der Teil, den Ihr Produkt nicht führt. Das Sachkonto, auf das die Rechnung bucht, die verwendeten Steuersätze und, wo nötig, die Dimensionen, die seine Einrichtung erwartet. Das sind Lesezugriffe, sie gehören zu den besser abgedeckten Objekten des Modells, und sie falsch zu treffen ist das, was aus einer automatischen Buchung später eine Korrektur von Hand macht.

Entscheiden unsere Nutzer, wie Vorgänge kategorisiert werden?

So ist es gedacht, und die Dokumentation sagt es ungewöhnlich deutlich. Sie zeigen die Konten, Sätze und Dimensionen, die Sie gelesen haben, und Ihre Nutzer legen die Zuordnung fest: ein einzelnes Konto für alles, Regeln mit Bedingung der Art wenn Abteilung gleich IT, dann Konto A, oder eine Wahl im Moment der Übertragung, welche die Konfiguration überschreibt. Die Geschäftslogik gehört Ihnen; die Daten, auf denen sie arbeitet, liefert eine Anbindung.

Können wir auch die Zahlung buchen oder nur die Rechnung?

Beides, und die Zahlung ist nach beiden Schreibwegen ein eigener dokumentierter Schritt. Es lohnt sich zu wissen, dass Zahlungen auf weniger Systemen unterstützt werden als Rechnungen, und ein Produkt, das darauf angewiesen ist, die Zahlung zu schreiben und nicht nur die Rechnung, sollte das gegen die Systeme prüfen, die seine eigenen Kunden nutzen.

Sie erwähnen keine Buchungssätze. Warum nicht?

Weil der Leitfaden zur Debitorenbuchhaltung es nicht tut. Er dokumentiert Rechnungen, Buchungsvorschläge und Zahlungen als den Weg, auf dem eine Forderung ins Hauptbuch kommt. Buchungssätze sind der Schreibweg eines anderen dokumentierten Ablaufs, nämlich des für Buchungen, und sie sind auch das, was der Zahlungsabgleich schreibt. Sie hier zu nennen klänge nach mehr Enterprise und beschriebe einen Weg, den dieser Use Case nicht nimmt.

Was ist mit Zahlungsbedingungen und offenen Posten?

Das sind echte Objekte im Modell, und beide gibt heute kaum ein angebundenes System heraus, diese Seite baut deshalb auf keinem von beiden etwas auf. Für offene Rechnungen ist der dokumentierte Weg die Rechnungsliste, gefiltert nach Zahlungsstatus oder Fälligkeitsdatum, und der wird weit breiter unterstützt. Wenn Sie die eigene Struktur für Zahlungsbedingungen eines bestimmten Systems brauchen, ist das ein Gespräch über dieses System und keine Eigenschaft des Modells.

Wie halten wir die Daten aktuell, ohne alles neu zu lesen?

Der letzte Schritt des Leitfadens ist genau das. Jeder GET-Endpunkt nimmt einen Filter auf das Änderungsdatum, ein geplanter Lauf fragt also nur nach dem, was sich seit dem vorherigen Lauf geändert hat, statt ganze Listen zu vergleichen, und wo ein System Ereignisse sendet, verkürzen Webhooks die Schleife weiter. Das ist derselbe Mechanismus, den die übrige API nutzt, und kein Sonderfall für Forderungen.

Mit welchen Systemen funktioniert das?

Die Kundenstammdaten sind die stärkste Zeile des ganzen Modells, auf den meisten angebundenen Systemen lesbar und auf fast ebenso vielen schreibbar, und das zählt, weil der Ablauf dort beginnt. Rechnungen schreiben auf zehn und Buchungsvorschläge auf zehn, und die zwei Wege ins Hauptbuch sind damit gleich breit. Die Tabelle auf dieser Seite zeigt jedes Objekt einzeln, statt zu mitteln, denn ein Durchschnitt würde die Zeile verbergen, von der Ihr Produkt abhängt.

Entscheidet Maesn, welches Konto und welcher Steuersatz genommen wird?

Nein. Maesn liefert die Konten, Sätze und Dimensionen, die das System des Kunden veröffentlicht, in einer Form, und schreibt zurück, was Ihr Produkt entschieden hat. Auf welches Konto eine Forderung gehört, welcher Satz für sie gilt und wann sie übertragen wird, sind die Regeln Ihres Produkts und davor oft die Regeln des Steuerberaters Ihres Kunden.

Einmal bauen, auf der Unified API.

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