E-Commerce-Anbindung

E-Commerce-Buchhaltung mit KI-Agent

Ein Onlineshop oder Marktplatz erzeugt Ausgangsrechnungen und Zahlungseingänge im Minutentakt — viel zu viele, um sie von Hand ins Konto zu übertragen. Mit unserer offenen REST-API und dem MCP-Server binden Sie Ihren eigenen KI-Agenten an die Buchhaltung an: Er liest die Bestell- und Zahlungsdaten aus Ihrem Shop, legt die Ausgangsrechnungen als Buchungen an und prüft, welche Posten noch offen sind. Der Agent ist dabei Ihr Werkzeug — Claude Code, ein Custom GPT, n8n oder ein eigenes Skript — und nicht Teil unserer Software. Sie behalten den Schlüssel, den Scope und die volle GoBD-Sicherheit.

Der Auslöser: Shop und Marktplatz statt Schuhkarton

Im Onlinehandel entsteht Buchungsstoff dort, wo verkauft wird: im Shop-System und auf den Marktplätzen. Jede Bestellung ist eine Ausgangsrechnung, jede Auszahlung ein Zahlungseingang, jede Plattform-Abrechnung ein Bündel aus Erlösen, Gebühren, Erstattungen und Gutschriften. Wer das monatlich von Hand in die Buchhaltung überträgt, tippt hunderte gleichförmige Belege ab und verliert genau die Übersicht, auf die es ankommt.

Genau hier setzt ein KI-Agent an. Er zieht die Daten aus Ihrer Verkaufsquelle — ob Shopify, WooCommerce, Amazon, eBay oder Etsy — und schreibt sie über die API strukturiert in Ihre Bücher. Aus einem Export-Marathon wird ein Ablauf, der so oft läuft, wie Sie ihn anstoßen: täglich, wöchentlich oder zum Monatsabschluss. Das Ziel ist banal und wirkungsvoll zugleich — kein Abtippen mehr, und trotzdem ein prüffestes Journal.

Was Ihr Agent aus dem Verkauf in die Buchhaltung bringt

Der E-Commerce-Fall dreht sich um vier wiederkehrende Aufgaben. Ihr Agent erledigt sie auf Ihrem echten Kontenrahmen und Journal — nicht in einer Zwischentabelle.

Ausgangsrechnungen anlegen

Der Agent legt für jede Bestellung oder Sammel-Abrechnung eine Ausgangsrechnung als Buchung an — mit Rechnungsnummer, Datum, Betrag und dem passenden Erlöskonto. Das ist der Kern des E-Commerce-Falls: Umsätze landen als saubere Buchungssätze im Journal, statt in einer CSV-Datei zu versauern.

Marktplatz-Abrechnungen zerlegen

Eine Amazon- oder eBay-Auszahlung ist selten ein einzelner Betrag: Sie enthält Erlöse, Plattformgebühren, Erstattungen und Werbekosten. Ihr Agent zerlegt die Abrechnung in einzelne Buchungssätze und bucht jede Position auf das richtige Konto — die typische E-Commerce-Fleißarbeit, die von Hand am meisten Zeit frisst.

Retouren sauber stornieren

Rücksendungen und Gutschriften gehören zum Onlinehandel wie der Verkauf selbst. Der Agent bucht sie nicht als negative Erfindung, sondern über einen ordnungsgemäßen Storno — die ursprüngliche Ausgangsrechnung bleibt erhalten, der Vorgang bleibt nachvollziehbar. Löschen ist auch für den Agenten technisch ausgeschlossen.

Plattform-Auszahlungen zuordnen

Eine Marktplatz-Auszahlung trifft oft gesammelt für viele Bestellungen auf dem Bankkonto ein. Der Agent liest die importierten Bankzeilen und schlägt vor, welche offenen Rechnungen die Auszahlung deckt — so schließt sich der Kreis vom Verkauf über die Rechnung bis zum Zahlungseingang, ohne Programmwechsel.

Ihr Agent, nicht unsere Software

Wichtig zur Einordnung: Der KI-Agent ist Ihr Werkzeug, nicht ein Bestandteil unserer Buchhaltung. Wir liefern die offene REST-API und den MCP-Server als Andockpunkt; welchen Agenten Sie davorsetzen, entscheiden Sie. Beliebte Clients sind Claude Code, Claude Desktop, ein Custom GPT oder ChatGPT mit Actions, Cursor sowie Automatisierungs-Software wie n8n, Make oder Zapier. Auch ein selbst geschriebener Agent mit LangChain funktioniert.

Diese Werkzeuge gehören Ihnen und laufen unter Ihrem Konto beim jeweiligen Anbieter. Unsere Software basiert auf keinem dieser Dienste — sie stellt lediglich die Schnittstelle bereit, an die Ihr Agent seine Aufrufe schickt. Der Agent liest also die Bestelldaten aus Ihrem Shop und schreibt in Ihre Bücher; wir sorgen dafür, dass jeder Schreibzugriff durch denselben geprüften Buchungskern läuft wie eine Eingabe von Hand.

In zwei Zeilen verbunden

Der bequemste Weg führt über den gehosteten MCP-Server: Sie melden ihn mit einem Befehl bei einem MCP-fähigen Client an, der Schlüssel wandert in den Authorization-Header. Ein npm-Paket (@jahresabschluss/buchhaltung-mcp) ist noch nicht veröffentlicht — die gehostete URL-Variante ist derzeit der verlässliche Weg. Ohne MCP spricht Ihr Agent dieselben Funktionen direkt über die REST-API an.

# Buchhaltung als MCP-Server anmelden (gehostet, per URL)
claude mcp add --transport http buchhaltung \
  "$MCP_URL" --header "Authorization: Bearer jab_live_…"

14 Werkzeuge, ein Schlüssel, GoBD erzwungen

  • Vierzehn MCP-Werkzeuge stehen bereit: zehn lesende (Stammdaten, Geschäftsjahre, Kontenrahmen, Journal, Saldenliste, offene Posten, Rechnungen, Bankzeilen …) und vier schreibende (Buchung anlegen, Storno sowie Ein- und Ausgangsrechnung).
  • Jeder Schlüssel beginnt mit jab_live_ und wird nur als Hash gespeichert — Sie sehen ihn genau einmal beim Anlegen.
  • Ein Schlüssel steht für genau ein Unternehmen. Die Firma wird aus dem Schlüssel abgeleitet und nie als Parameter übergeben; fremde Bücher sind darüber technisch nicht erreichbar.
  • Sie vergeben den Scope: read für einen Agenten, der nur auswerten soll, read + write erst, wenn er wirklich Ausgangsrechnungen und Umsätze buchen muss.
  • GoBD bleibt in jeder Buchung erzwungen: Buchungen sind append-only und werden festgeschrieben, korrigiert wird per Storno statt Löschen, und Soll muss gleich Haben sein. Auch der Agent kann diese Regeln nicht umgehen — gerade bei tausenden gleichförmigen Shop-Buchungen der entscheidende Schutz.

Grenzen: eine Buchhaltungs-Schnittstelle, kein Steuer-Autopilot

Die Schnittstelle deckt genau die Buchhaltung ab — Buchungen, Rechnungen, offene Posten, Auswertungen. Sie ist kein Steuer-Autopilot: Ihr Agent erstellt oder übermittelt darüber keine E-Bilanz, keinen Jahresabschluss und keine Steuererklärung. Er bereitet die Zahlen vor, die später im Programm zum Abschluss werden; dieser Schritt passiert bewusst in der App, nicht über die API.

Auch die umsatzsteuerliche Würdigung bleibt Sache Ihres Agenten und Ihres Steuerberaters. Der Agent bucht auf das Erlös- und Umsatzsteuerkonto, das er mitgibt — etwa für OSS-relevante EU-Fernverkäufe oder steuerfreie Ausfuhren; die API führt die Buchung aus, trifft aber keine steuerliche Entscheidung für Sie. Gerade im grenzüberschreitenden Onlinehandel bleibt die fachliche Verantwortung damit dort, wo sie hingehört.

Häufige Fragen

Wie bucht mein Agent die Bestellungen aus dem Shop?

Der Agent liest die Bestell- und Zahlungsdaten aus Ihrer Verkaufsquelle und legt über die API für jede Bestellung oder Sammel-Abrechnung eine Ausgangsrechnung als Buchungssatz an — mit Betrag, Datum und Erlöskonto. Ob er einzeln je Bestellung oder gebündelt je Marktplatz-Abrechnung bucht, steuern Sie über die Anweisung an den Agenten.

Wie behandelt der Agent Retouren und Gutschriften?

Rücksendungen und Erstattungen bucht der Agent über einen ordnungsgemäßen Storno, nicht durch nachträgliches Ändern oder Löschen der ursprünglichen Rechnung. Die Erstbuchung bleibt erhalten, der Storno verweist darauf — so bleibt der Vorgang GoBD-konform nachvollziehbar, auch wenn im Onlinehandel viele Retouren zusammenkommen.

Erkennt der Agent bezahlte und noch offene Bestellungen?

Ja. Er ruft die offenen Posten der Debitoren ab und gleicht sie gegen die importierten Bankzeilen ab. Damit sehen Sie jederzeit, welche Umsätze bereits bezahlt sind und welche noch offen — die Basis für Mahnwesen und Monatsabschluss. Buchen kann er das Ergebnis nur mit write-Scope; mit einem read-Schlüssel wertet er ausschließlich aus.

Muss ich das npm-Paket installieren?

Nein. Das npm-Paket @jahresabschluss/buchhaltung-mcp ist noch nicht veröffentlicht. Der verlässliche Weg ist der gehostete MCP-Server: Sie melden ihn per URL mit einem Befehl an, es ist nichts zu installieren. Alternativ spricht Ihr Agent die REST-API direkt an — beide Wege nutzen denselben Schlüssel und dasselbe Regelwerk.

Kann der Agent aus meinen Umsätzen die E-Bilanz oder Steuererklärung erstellen?

Nein. Die Schnittstelle ist auf die Buchhaltung begrenzt. Der Agent bucht Umsätze, Rechnungen und Zahlungen und bereitet damit die Zahlen vor; einen Jahresabschluss, eine E-Bilanz oder eine Steuererklärung erzeugt oder übermittelt er darüber nicht. Dieser Abschluss-Schritt findet im Programm statt, nicht über die API.

Bucht der Agent die Umsatzsteuer für EU-Verkäufe korrekt?

Der Agent bucht auf das Erlös- und Umsatzsteuerkonto, das er selbst mitgibt. Die steuerliche Einordnung — etwa OSS-Fernverkäufe, innergemeinschaftliche Lieferungen oder steuerfreie Ausfuhren — treffen Sie und Ihr Steuerberater; die API führt die Buchung aus, entscheidet aber nicht über den Steuersatz.

Kommt mein Agent an die Bücher anderer Firmen?

Nein. Ein Schlüssel gehört zu genau einem Unternehmen, das aus dem Schlüssel abgeleitet und nie als Parameter mitgeschickt wird. Selbst wenn Sie mehrere Shops über verschiedene Gesellschaften betreiben, braucht jede Gesellschaft ihren eigenen jab_live_-Schlüssel.