Fehlercodes

Diese Status-Strings erscheinen im UI, in Meldungen und Toasts. Hier stehen Ursache, Folge und die konkreten Schritte zur Behebung.

EXPORT_BLOCKED

Ursache: Der DATEV-Export ist durch ein Integritäts-Gate blockiert. Geprüft werden offene Ausnahmen (Bestellungen oder Zahlungen mit Status PENDING/EXCEPTION in der Periode) sowie Bestellungen ohne EUR-Betrag.

Folge: Es wird kein DATEV-EXTF erzeugt. Die Anforderung wird mit dem Code EXPORT_BLOCKED und einer Liste der Probleme abgewiesen.

Lösung:

1. Öffnen Sie Klären (/exceptions) und klären Sie alle offenen Ausnahmen.
2. Prüfen Sie Bestellungen ohne EUR-Betrag — meist eine Fremdwährung ohne Umrechnung (siehe FX_UNCONVERTED).
3. Schließen Sie anschließend die Periode und starten Sie den Export erneut.

Siehe DATEV-EXTF-Validierung.

FX_UNCONVERTED

Ursache: Eine Bestellung in Fremdwährung hat noch keine EUR-Umrechnung.

Folge: Die Bestellung lässt sich nicht buchen; sie erscheint als Ausnahme und kann EXPORT_BLOCKED auslösen.

Lösung:

1. Schlagen Sie den EUR-Kurs des Transaktionstags nach (z. B. EZB-Referenzkurs).
2. Rechnen Sie den Betrag um.
3. Tragen Sie den EUR-Betrag per Korrigiert annehmen ein.

NEEDS_COUNTERPART

Ursache: Eine Quelldatei wurde hochgeladen, aber die dazugehörige Gegenquelle fehlt noch — etwa eine Auszahlung ohne die passende Bank-CSV als Gegenbuchung.

Folge: Die Datei kann nicht vollständig abgestimmt werden. Sie erscheint als bernsteinfarbene Karte im Bereich Klären bzw. Importe.

Lösung:

1. Laden Sie die fehlende Gegenquelle für dieselbe Periode hoch (z. B. die Bank-CSV).
2. Die Abstimmung läuft automatisch erneut; die Karte verschwindet, sobald das Gegenstück vorliegt.

Welche Quelle das Gegenstück welcher Auszahlung ist, zeigt Unterstützte Quellen.

PARSE_ERROR

Ursache: Eine hochgeladene CSV konnte nicht gelesen werden — falsche Spaltenköpfe, beschädigte Datei oder ein während der Verarbeitung hängengebliebener Lauf.

Folge: Die Datei wird mit Status PARSE_ERROR markiert; ihre Zeilen fließen nicht in die Abstimmung ein.

Lösung:

1. Öffnen Sie die Datei in der Importliste und sehen Sie die Fehlerdetails ein.
2. Exportieren Sie die Quelle erneut, ohne die Spaltenköpfe zu verändern.
3. Laden Sie die korrigierte CSV erneut hoch (UTF-8 empfohlen).

DUPLICATE

Ursache: Dieselbe Datei (identischer Inhalt, gleicher Hash) wurde bereits hochgeladen.

Folge: Der erneute Upload wird abgewiesen (HTTP 409). Es entsteht kein doppelter Datensatz — KanzleiSynchron verweist auf die bereits vorhandene Datei.

Lösung:

• Das ist in der Regel kein Fehler, sondern ein Schutz vor Doppelbuchung. Prüfen Sie, ob die ursprüngliche Datei bereits verarbeitet wurde.
• Soll es sich um neue Daten handeln, exportieren Sie den aktuellen Zeitraum neu — eine inhaltlich veränderte Datei hat einen anderen Hash und wird akzeptiert.

Verwandte Seiten

• Glossar — Kurzdefinitionen aller Status.
• Importe (Uploads) — Upload-Ablauf und Fehlerbehandlung.
• FAQ