REST API & DATEV Export

Wer ernsthaft mit Rechnungen arbeitet, will irgendwann raus aus dem manuellen Klickbetrieb. Zahlen sollen automatisch in die eigene Software fließen, der Steuerberater soll die Buchungen ohne Abtippen bekommen, und andere Systeme sollen mitbekommen, wenn eine Rechnung bezahlt wurde. Genau dafür bündelt dieses Werkzeug drei Bausteine: eine REST API, ausgehende Webhooks und den DATEV-Export.

Die REST API ist scoped, also mit fein abgestuften Berechtigungen. Du erstellst API-Schlüssel und vergibst gezielt Rechte: "Verkauf lesen" (sales:read) für den Abruf von Rechnungen, Kunden, Artikeln und Zahlungen, "Verkauf schreiben" (sales:write) zum Anlegen von Entwürfen, Festschreiben und Buchen von Zahlungen, sowie "Webhooks verwalten" (webhooks:manage) für die Webhook-Abos. Jeder Schlüssel zeigt seinen Präfix, wann er zuletzt genutzt wurde, und lässt sich jederzeit widerrufen. So bleibt ein Integrationsschlüssel für ein Buchhaltungstool auf genau die Rechte beschränkt, die es braucht.

Ausgehende Webhooks liefern Ereignisse in Echtzeit an deine eigene URL. Wird eine Rechnung festgeschrieben oder eine Zahlung erfasst, schickt das System eine signierte Nachricht an deinen Endpunkt. Die Signatur per HMAC erlaubt dir, die Echtheit jeder Zustellung zu prüfen, sodass niemand gefälschte Ereignisse einschleusen kann. Damit reagierst du automatisch auf Geschäftsvorfälle, statt zu pollen.

Der DATEV-Export ist das Herzstück für die Zusammenarbeit mit dem Steuerberater. Aus deinen Rechnungen eines Zeitraums erzeugt das Werkzeug einen DATEV-kompatiblen Buchungsstapel im EXTF-Format, den deine Kanzlei direkt in DATEV Kanzlei-Rechnungswesen importieren kann. Du gibst Berater-Nummer (sieben Ziffern), Mandanten-Nummer (fünf Ziffern), den Beginn des Wirtschaftsjahres und den Kontenrahmen an - SKR03 oder SKR04 - und der Export mappt Erlöskonten und Debitoren nach den kanonischen Regeln.

Die Validierung ist streng, weil DATEV streng ist. Berater- und Mandantennummer müssen exakt die richtige Ziffernzahl haben, das Enddatum muss nach dem Startdatum liegen. Kleine Fehler beim Format führen sonst später zu Importproblemen in der Kanzlei - besser, das Werkzeug fängt sie sofort ab, mit klaren Meldungen statt kryptischer DATEV-Fehler.

Dieses Werkzeug richtet sich an alle, die ihre Buchhaltung skalieren wollen: Selbstständige mit vielen Rechnungen, kleine Unternehmen mit eigenem Tooling und alle, die ihren Steuerberater glücklich machen wollen. Zusammen mit dem API-Spielplatz zum Ausprobieren der Endpunkte und den Skripten zur Weiterverarbeitung wird daraus eine Automatisierungskette, die manuelle Buchhaltungsarbeit deutlich reduziert.