Buchhaltungs-Schnittstelle fällt aus: Fehler bei Wiederholungen und Doppelbuchungen vermeiden
Kurz gesagt: Wenn die Buchhaltungsanbindung kurz ausfällt, entsteht der Schaden selten durch den Ausfall selbst, sondern durch die Reaktion darauf: Das Portal wiederholt blind und erzeugt dieselbe Rechnung zweimal, oder es verwirft den Vorgang still und niemand erfährt davon. Ein robustes Portal speichert jeden Auftrag zur Übergabe zuerst bei sich, versieht ihn mit einer eindeutigen Kennung, versucht die Übergabe mit wachsenden Pausen erneut und zeigt dem Büro an, was hängt. Wir gehen die fünf häufigsten Fehler durch und nennen jeweils die Korrektur. Welche Wiederholungsregeln und Ratenbegrenzungen ein Anbieter vorgibt, steht in seiner Dokumentation, Stand November 2026 etwa bei Lexoffice in der API-Beschreibung.
Warum Ausfälle normal sind
Jede Verbindung zwischen zwei Systemen kann scheitern: ein kurzer Netzfehler, eine Wartung beim Anbieter, eine Überlastung, ein abgelaufener Zugangsschlüssel. Das ist kein Mangel, sondern Alltag. Die Frage ist nur, ob das Portal damit umgehen kann. Ein erfundenes Beispiel: Ein Online-Kurs-Anbieter in Bern verschickt über sein Portal abends 40 Rechnungen. Die Buchhaltungsanbindung antwortet zehn Minuten lang nicht. Was dann passiert, entscheidet, ob am nächsten Morgen alles stimmt.
Fehler 1: Sofort und ohne Pause wiederholen
Ein Portal, das bei Misserfolg sofort erneut versucht, hämmert auf einen Dienst ein, der ohnehin Probleme hat. Viele Anbieter begrenzen die Zahl der Anfragen und sperren bei Überschreitung kurz. Die Korrektur sind wachsende Abstände: erst nach einer Minute, dann nach fünf, dann nach fünfzehn, mit einer Obergrenze der Versuche. Danach wandert der Vorgang in eine Liste "braucht Aufmerksamkeit".
Fehler 2: Keine Kennung, daher Doppelbuchung
Die klassische Falle: Das Portal sendet die Rechnung, der Anbieter legt sie an, aber die Antwort geht unterwegs verloren. Das Portal glaubt an einen Fehler und sendet erneut. Jetzt gibt es zwei Rechnungen. Die Korrektur heißt Idempotenz, und das ist weniger kompliziert, als es klingt: Jeder Vorgang erhält beim Anlegen im Portal eine eigene, unveränderliche Kennung. Vor jeder Wiederholung fragt das Portal, ob im Zielsystem schon ein Beleg mit dieser Kennung existiert, zum Beispiel über ein Referenzfeld. Unterstützt der Anbieter eine solche Kennung nicht direkt, trägt man sie in ein Freitextfeld ein und sucht danach.
Fehler 3: Fehlerhafte und vorübergehende Fehler gleich behandeln
Nicht jeder Fehler ist ein Ausfall. Eine Antwort "Dienst nicht erreichbar" ist vorübergehend, "Pflichtfeld fehlt" ist dauerhaft. Wiederholen hilft nur beim ersten. Die Korrektur ist eine Unterscheidung nach Art:
| Art | Beispiel | Reaktion |
|---|---|---|
| Vorübergehend | Zeitüberschreitung, Dienst nicht erreichbar | Später erneut versuchen |
| Begrenzung | Zu viele Anfragen | Länger warten, Takt senken |
| Dauerhaft | Ungültige Daten, unbekannter Kontakt | Nicht wiederholen, Büro informieren |
| Anmeldung | Schlüssel abgelaufen | Sofort melden, alle Übergaben anhalten |
Fehler 4: Das Büro erfährt nichts
Ein stilles Scheitern ist der schlimmste Fall. Drei Wochen später fällt auf, dass 14 Rechnungen nie in der Buchhaltung ankamen. Die Korrektur: Eine Übersicht im Portal mit Zählern, wie viele Vorgänge übergeben, wartend und fehlgeschlagen sind, plus eine Mail am Morgen, wenn etwas hängt. Die Mail sollte sagen, was zu tun ist, und nicht nur, dass etwas schiefging.
Fehler 5: Reihenfolge ignorieren
Manche Vorgänge hängen voneinander ab: Erst muss der Kontakt existieren, dann die Rechnung, dann die Zahlung. Wird die Rechnung wiederholt, bevor der Kontakt angekommen ist, entsteht ein weiterer Fehler. Die Korrektur: Abhängige Schritte laufen in einer festen Reihenfolge, und ein Schritt wartet auf den vorherigen. Bei einer Wiederholung startet das Portal beim fehlenden Schritt und nicht von vorn.
Die Warteschlange als Herzstück
Alle fünf Korrekturen laufen auf dasselbe Grundmuster hinaus: Das Portal speichert den Auftrag zur Übergabe als eigene Zeile mit Status. Mögliche Zustände sind "wartet", "wird gesendet", "übergeben", "wiederholt am", "braucht Aufmerksamkeit". Das Büro sieht diese Liste und kann einzelne Vorgänge erneut anstoßen oder abbrechen. Der Kunde dagegen merkt nichts, denn sein Kauf hängt nicht davon ab, ob die Buchhaltung im selben Moment antwortet.
Checkliste für das Gespräch mit dem Dienstleister
- [ ] Jeder Vorgang hat eine eigene Kennung, die bei Wiederholungen gleich bleibt
- [ ] Vor dem Wiederholen wird geprüft, ob der Beleg schon existiert
- [ ] Wiederholungen haben wachsende Abstände und eine Obergrenze
- [ ] Dauerhafte Fehler werden nicht wiederholt
- [ ] Das Büro sieht eine Liste hängender Vorgänge
- [ ] Es gibt eine tägliche Meldung bei Auffälligkeiten
- [ ] Ein Zugangsschlüssel läuft nicht unbemerkt ab, die Gültigkeit wird überwacht
Test, bevor es ernst wird
Lassen Sie den Dienstleister den Ausfall einmal absichtlich nachstellen: Verbindung trennen, drei Aufträge auslösen, Verbindung herstellen und prüfen, ob genau drei Belege entstehen. Wiederholen Sie den Test mit einem Fehler, bei dem die Antwort verloren geht, nicht die Anfrage. Wenn Sie zwei gleiche Rechnungen finden, haben Sie die Schwachstelle gefunden, bevor es ein Kunde tut.
Was der Kunde sehen soll
Auch wenn die Übergabe im Hintergrund hängt, sollte der Kunde nicht verunsichert werden. Seine Bestätigung nennt die Bestellung und die Rechnungsnummer des Portals, nicht die der Buchhaltung. Die Rechnung als PDF kann das Portal selbst erzeugen, falls das erlaubt ist, oder sie folgt, sobald die Übergabe geklappt hat. Ein Satz wie "Ihre Rechnung folgt in Kürze per Mail" ist ehrlicher und beruhigender als eine Fehlermeldung, die der Kunde nicht beheben kann.
Aufräumen nach einem Ausfall
Nach einem längeren Ausfall lohnt ein Abgleich: Die Zahl der Vorgänge im Portal wird mit der Zahl der Belege im Buchhaltungssystem für denselben Zeitraum verglichen. Stimmen sie nicht, hilft die Kennung, um die Abweichung zu finden. Dokumentieren Sie den Vorfall in zwei Sätzen, damit beim nächsten Mal jemand nachlesen kann, was geholfen hat.
Häufige Fragen
Muss das Portal auch bei Ausfall weiterverkaufen können?
In der Regel ja. Der Kunde sollte seinen Kauf abschließen können, die Übergabe an die Buchhaltung läuft danach im Hintergrund.
Wie lange darf eine Übergabe hängen?
Das entscheiden Sie fachlich. Für Rechnungen, die am Monatsende abgeschlossen werden, ist ein Tag meist die Grenze für eine Meldung.
Hilft ein Export als Datei als Notlösung?
Ja, als Rückfall. Wichtig ist, dass derselbe Vorgang nicht danach automatisch ein zweites Mal übergeben wird.
Wenn Ihr Portal Rechnungen verlässlich übergeben soll, prüfen wir gern gemeinsam mit Ihnen Wiederholungslogik und Fehleranzeige: Gespräch vereinbaren.