Jahresabschluss.io
ENAnmeldenRegistrieren →

Mahnwesen automatisieren

Mahnwesen mit KI-Agent automatisieren

Ein KI-Agent kann Ihr Mahnwesen spürbar entlasten: Er ruft die offenen Debitoren-Posten über die REST-API ab, erkennt überfällige Forderungen und entwirft dazu passende Mahnungen. Die Freigabe und der Versand bleiben bei Ihnen — der Agent ist Ihr Werkzeug, nicht Teil unserer Software. So verbinden Sie eine überschaubare Lese-Scope-Anbindung mit Ihrer eigenen Versandlogik, ohne eine separate Mahn-Software einzuführen.

In der Software: Jahresabschluss.io führt die doppelte Buchführung nach SKR03 oder SKR04: Belege, Bankumsätze und Rechnungen werden laufend verbucht; die KI kontiert und bucht eindeutige Vorgänge innerhalb Ihrer Freigaben selbst.

Ihre Buchhaltung im Chat — mit dem KI-Programm, das Sie schon nutzen

Sie verbinden Ihr KI-Programm einmal mit Ihrer Buchhaltung bei jahresabschluss.io. Danach schreiben Sie, was zu tun ist.

  • Claude: Im Browser, in der App und auf dem Handy: In Claude einen Konnektor mit der Adresse https://jahresabschluss.io/mcp hinzufügen und bei jahresabschluss.io anmelden. Für die Claude-App auf Mac und Windows gibt es zusätzlich „Buchhaltung für Claude“ zum Doppelklicken.
  • ChatGPT: Im Browser: unter chatgpt.com/plugins eine eigene Verbindung mit derselben Adresse hinzufügen und bei jahresabschluss.io anmelden. Ob das in Ihrem Tarif geht und ob ChatGPT auch buchen darf, legt OpenAI fest.
  • Perplexity: Ab dem Pro-Tarif: unter „Plugins“ eine eigene Verbindung mit derselben Adresse anlegen und bei jahresabschluss.io anmelden.
  • Andere Programme: Codex, Claude Code, Cursor, GitHub Copilot, Gemini CLI und viele mehr verbinden sich mit einem Schlüssel, den Sie in der App erstellen.

Danach schreiben Sie zum Beispiel „Buche die neuen Belege“, „Schreib der Muster GmbH eine Rechnung“ oder „Wer hat noch nicht bezahlt?“. Das Programm erledigt es in Ihrer echten Buchhaltung — mit denselben Prüfungen wie in der App. Vor Rechnungen und Stornos holt es Ihr ausdrückliches Ja ein. Ans Finanzamt gesendet wird nur in der App, mit Ihrer Freigabe.

So läuft die Mahn-Routine ab

Vom lesenden Abruf bis zu Ihrer Freigabe — der Agent bereitet vor, Sie entscheiden.

Der Ablauf beginnt mit einem lesenden Aufruf: Der Agent ruft über die REST-API oder den MCP-Server die offenen Debitoren-Posten Ihrer Firma ab — jeweils mit Rechnungsdatum, Fälligkeit, Betrag und bereits erfassten Zahlungseingängen. Bereits ausgeglichene oder teilbezahlte Posten erkennt er dabei anhand des Restsaldos und lässt sie außen vor.

Anhand der Fälligkeiten sortiert der Agent die Posten nach Überfälligkeitsgrad und offenem Betrag. Er ordnet jeden Fall einer Mahnstufe zu — von der freundlichen Zahlungserinnerung bis zur zweiten Mahnung — und formuliert für jeden Kunden einen passenden Mahntext in Ihrem Ton.

Sie erhalten den Entwurf zur Freigabe: im Chat Ihres Clients, in einer Übersicht oder als Datei. Erst nach Ihrer Bestätigung verlässt die Mahnung Ihr Haus, und zwar über Ihren eigenen Versandkanal. Kein Schreibzugriff auf die Buchhaltung ist für diesen Kern nötig — der Agent liest, priorisiert und schlägt vor.

Lese-Scope trifft eigene Versandlogik

Was der Agent darf, und wo Ihre eigene Automatisierung übernimmt.

Lese-Scope genügt zum Entwerfen

Zum Lesen der offenen Posten und zum Formulieren der Mahnung reicht ein Schlüssel mit reinem Lese-Scope. Der Agent braucht keine Schreibrechte, um Fälligkeiten zu prüfen und Texte vorzubereiten — das minimiert die vergebene Berechtigung.

Versand über Ihren eigenen Kanal

Das eigentliche Verschicken übernehmen Sie — per E-Mail, Serienbrief oder einer Automatisierung in n8n, Make oder Zapier, die Ihr Agent ansteuert. Oder unsere API verschickt die Mahnung: create_dunning_notice (Recht write) erzeugt die nächste Mahnstufe, send_dunning_notice (eigenes Recht send) sendet sie nur an hinterlegte Adressen, mit Standardtext oder einer Ihrer Mail-Vorlagen.

Der Agent ist Ihr Werkzeug

Ob Claude Code, ein Custom GPT oder Cursor: Der Agent gehört Ihnen und läuft in Ihrer Umgebung. Er ist nicht Teil unserer Software, sondern spricht ausschließlich über den Bearer-Schlüssel mit Ihrer Buchhaltung.

Mahngebühren optional buchen

Wollen Sie Mahngebühren oder Verzugszinsen erfassen, geschieht das über den Schreib-Scope als reguläre Buchung — nachvollziehbar und GoBD-konform, wie jeder andere Buchungssatz auch. Mahnungen, die die API mit create_dunning_notice erzeugt, enthalten selbst keine Gebühren und Zinsen; die rechnet nur das Mahnwesen der App.

Anbindung per gehostetem MCP-Server

Der Weg ist die gehostete URL-Variante. Ein Befehl genügt, der Schlüssel wandert in den Authorization-Header, und Ihr Client kennt alle Werkzeuge, die der Scope freigibt — mit einem Lese-Schlüssel nur die lesenden.

claude mcp add --transport http --scope user buchhaltung \
  "$MCP_URL" --header "Authorization: Bearer jab_live_…"

GoBD bleibt jederzeit erzwungen

Auch wenn ein Agent im Spiel ist, bleiben die Grundsätze ordnungsmäßiger Buchführung unangetastet. Buchungen sind append-only: Einmal festgeschriebene Sätze werden nicht gelöscht, sondern über einen Storno korrigiert. Der Agent kann diese Regel nicht umgehen, egal wie eine Anweisung formuliert ist.

Jede schreibende Aktion läuft durch denselben Buchungskern wie die manuelle Erfassung — mit Festschreibung und der Prüfung Soll = Haben. Der lesende Blick auf die offenen Posten verändert dabei nichts an Ihren Daten.

Für das Mahnwesen heißt das doppelte Sicherheit: Die Priorisierung und der Mahnentwurf sind reine Leseoperationen, und eine tatsächlich gebuchte Mahngebühr bleibt dauerhaft und revisionssicher nachvollziehbar.

Eine Mahnstufen-Routine, die Sie steuern

Fünf Stellschrauben, mit denen Sie den Mahnlauf an Ihre Gepflogenheiten anpassen.

  • Priorisierung nach Tagen über Fälligkeit und offenem Betrag — die dringendsten Forderungen zuerst.
  • Mahnstufen von der Zahlungserinnerung über die erste bis zur zweiten Mahnung anhand Ihrer eigenen Fristen-Vorgaben.
  • Textbausteine in Ihrem Ton: höflich bei Stammkunden, bestimmter bei dauerhaft säumigen Kunden.
  • Optionale Verzugszinsen nach § 288 BGB, sofern Sie den Satz im Prompt hinterlegen.
  • Sammel-Übersicht aller fälligen Posten je Kunde, damit Teilzahlungen und Restsalden korrekt berücksichtigt werden.

Häufige Fragen

Braucht der Agent Schreibrechte für das Mahnwesen?

Für den Kern nicht. Das Abrufen der offenen Posten und das Entwerfen der Mahntexte gelingt mit einem reinen Lese-Scope. Schreibrechte brauchen Sie nur, wenn der Agent zusätzlich Mahngebühren oder Verzugszinsen als Buchung erfassen soll — und selbst dann läuft das durch die reguläre, festgeschriebene Buchungslogik mit der Prüfung Soll = Haben.

Verschickt Ihre API die Mahnungen automatisch?

Nein. Unsere API stellt die offenen Posten samt Fälligkeiten bereit; per E-Mail versendet sie nur Ausgangsrechnungen, mit dem eigenen Recht send und nur an hinterlegte Adressen. Mahnungen laufen über Ihren eigenen Kanal — etwa E-Mail oder eine Automatisierung in n8n, Make oder Zapier, die Ihr Agent ansteuert. So passen Anrede, Vorlage und Zeitpunkt zu Ihrem Haus.

Wie unterscheidet sich das vom reinen Prüfen offener Posten?

Das Prüfen offener Posten liefert Ihnen den Saldenstand je Kunde. Das Mahnwesen setzt einen Schritt darauf auf: Der Agent leitet aus Fälligkeit und Betrag eine Mahnstufe ab, formuliert den passenden Mahntext und legt ihn Ihnen zur Freigabe vor. Es geht also nicht nur um die Analyse, sondern um den fertigen Mahnentwurf.

Kann der Agent über die API einen Jahresabschluss oder eine Steuererklärung erstellen?

Nein. Die API arbeitet nur mit laufenden Buchhaltungsdaten. Sie bereiten damit saubere Zahlen vor, die später in der Anwendung zum Jahresabschluss oder zur E-Bilanz weiterverarbeitet werden. Die Erstellung oder Übermittlung dieser Abschlüsse oder einer Steuererklärung läuft niemals über die API.

Wie stellt der Agent sicher, dass er die richtige Firma bemahnt?

Die Gesellschaft wird aus dem Schlüssel abgeleitet, nicht als Parameter übergeben. Ein Schlüssel mit dem Präfix jab_live_ gehört zu genau einer Firma. Betreuen Sie mehrere Mandanten, legen Sie je Firma einen eigenen Schlüssel an — eine Verwechslung ist damit ausgeschlossen.

Welchen Client und welche Werkzeuge brauche ich?

Einen MCP-fähigen Client wie Claude Code, Claude Desktop oder Cursor — oder direkt HTTP-Aufrufe an die REST-API. Fürs Mahnwesen genügen die lesenden Werkzeuge für offene Posten und Stammdaten; ein Lese-Schlüssel reicht.

Vom selben Anbieter: Jahresabschluss nach HGB – der komplette Leitfaden auf jahresabschluss.io.