Dateiimport automatisieren: sechs Fehlerbilder und Abwehr

Wenn im Mittelstand über Schnittstellen gesprochen wird, denken die meisten an Programmierschnittstellen, an Zugangsdaten und an ein Projekt mit Lastenheft. Der Alltag sieht anders aus. Ein erheblicher Teil des Datenaustauschs zwischen Systemen läuft über Dateien: eine Liste im Netzwerkordner, ein Ablageort auf einem Übertragungsserver, ein Anhang in einem Sammelpostfach. In den Digitalisierungsbefragungen von Bitkom taucht der fehlende Datenaustausch zwischen Systemen regelmäßig als Hemmnis auf (Bitkom). Die Datei ist die stille Antwort darauf, die niemand als Projekt geführt hat.

Typischerweise ist der Ablauf vor Jahren entstanden, weil zwei Systeme miteinander sprechen sollten und keine Zeit für mehr war. Jemand hat eine Ausgabe eingerichtet, jemand anders eine Einlesefunktion, und seitdem läuft es. Das Wissen darüber, welche Spalte was bedeutet, steckt in den Köpfen von ein oder zwei Personen. Eine Dokumentation gibt es selten, eine Absprache über das Format meist gar nicht. Genau das macht den Ablauf verletzlich: Er funktioniert, solange sich auf keiner Seite etwas ändert.

Der entscheidende Unterschied zu einer Bildschirmmaske ist die fehlende Rückmeldung. Wer im Auftragssystem ein Pflichtfeld leer lässt, bekommt eine Meldung. Wer eine Datei mit falschem Trennzeichen liefert, bekommt keine. Im schlechteren Fall bricht die Verarbeitung ab, und niemand merkt es. Im schlechtesten Fall bricht sie nicht ab, sondern schreibt Unsinn in das Zielsystem: Bestände auf null, Preise um den Faktor tausend verschoben, Datumswerte im falschen Monat. Ein Import ohne Rückmeldung ist kein Import ohne Fehler, sondern ein Import ohne Wissen über Fehler.

Eine Textdatei mit getrennten Werten sieht einfach aus, ist aber kein einheitlich definiertes Format. Es gibt Semikolon und Komma als Trennzeichen, Anführungszeichen als Textbegrenzer, unterschiedliche Regeln für Anführungszeichen innerhalb eines Textes und mehrere Konventionen für den Zeilenumbruch. Ändert das liefernde System nach einem Update seine Voreinstellung, ist die Datei formal noch eine Textdatei, für die empfangende Seite aber eine andere.

Der Zeichensatz ist noch tückischer, weil er sich nicht an der Struktur zeigt, sondern nur am Inhalt. Wird eine Datei in einer westeuropäischen Kodierung geschrieben und als UTF-8 gelesen, verwandeln sich Umlaute in Ersatzzeichen. Die Verarbeitung läuft durch, die Spalten stimmen, und trotzdem findet später niemand mehr die Artikel mit Umlaut im Namen. Solche Fehler wandern still in Stammdaten und tauchen Wochen später als vermeintliche Suchprobleme wieder auf.

Drei Änderungen auf einmal, alle unangekündigt: anderes Trennzeichen, verlorene führende Null in der Artikelnummer, anderes Datumsformat. Ein Import, der das Trennzeichen aus dem Dateivertrag liest und die Kopfzeile prüft, weist diese Datei ab und meldet den Grund. Ein Import, der einfach am Komma trennt, weil das früher funktioniert hat, legt zwei neue Artikel mit den Nummern 41 und 42 an.

Der wirksamste Einzelschritt kostet keine Programmierung, sondern eine Seite Text. Ein Dateivertrag hält fest, wie die Datei aussieht, wer sie liefert, wann sie kommt und was passiert, wenn sie nicht kommt. Er wird von beiden Seiten bestätigt und liegt dort, wo ihn auch jemand findet, der heute noch nicht im Unternehmen ist. In Projekten zur Datenintegration ist dieses Dokument regelmäßig der Punkt, an dem sich die eigentlichen Missverständnisse zeigen: Zwei Abteilungen meinen mit derselben Spaltenbezeichnung unterschiedliche Dinge.

Der Dateiname verdient dabei mehr Aufmerksamkeit, als er üblicherweise bekommt. Ein Name mit festem Muster und enthaltenem Datum, etwa bestand-2026-06-04.csv, macht doppelte Lieferungen, Lücken und verspätete Nachlieferungen auf einen Blick erkennbar. Ein Name ohne Datum, der bei jeder Lieferung überschrieben wird, vernichtet genau diese Information.

Für die Ablage haben sich drei Ordner bewährt. Der Eingangsordner nimmt die Datei unverändert entgegen. Nach erfolgreicher Verarbeitung wandert sie in einen Archivordner, üblicherweise nach Jahr und Monat gegliedert. Wird sie abgewiesen, landet sie im Fehlerordner, zusammen mit einer kleinen Textdatei, die den Grund der Ablehnung enthält. Diese Aufteilung hat einen unscheinbaren, aber großen Vorteil: Der Zustand des Imports ist ohne Werkzeug sichtbar. Wer in den Fehlerordner schaut, sieht sofort, ob und wo etwas hängt.

Das Protokoll ist die zweite Hälfte. Eine Zeile je Lauf mit Zeitstempel, Dateiname, Prüfsumme, Zeilenzahl, Ergebnis und Grund einer Ablehnung genügt für den Betrieb. Der IT-Grundschutz des Bundesamts für Sicherheit in der Informationstechnik führt Protokollierung als eigenen Baustein und verlangt unter anderem, dass Protokolldaten zweckgebunden erhoben, vor unbefugtem Zugriff geschützt und nach festgelegten Fristen gelöscht werden (BSI). Für einen Dateiimport heißt das vor allem: keine personenbezogenen Inhalte im Protokoll, sondern Kennzahlen über den Lauf.

Ob die Rohdatei selbst aufbewahrt werden muss und wie lange, hängt davon ab, ob sie steuerlich oder handelsrechtlich relevante Aufzeichnungen enthält. Bei Bewegungsdaten aus der Warenwirtschaft oder bei Belegdaten ist das regelmäßig der Fall, bei einer reinen Bestandsliste zur Anzeige nicht unbedingt. Diese Einordnung ist eine fachliche Frage und gehört im Einzelfall in die Abstimmung mit der steuerlichen Beratung; die technische Seite muss lediglich sicherstellen, dass die Ablage die getroffene Entscheidung abbilden kann. Wer das Archiv erst nach einer Betriebsprüfung einführt, hat den ungünstigsten Zeitpunkt erwischt.

Die Frage wird oft als Glaubensfrage geführt, ist aber eine Abwägung. Eine Programmierschnittstelle liefert Daten in kürzeren Abständen, ermöglicht gezielte Abfragen und gibt unmittelbare Rückmeldung über Erfolg oder Misserfolg. Sie setzt allerdings voraus, dass beide Systeme dauerhaft erreichbar sind, dass Zugangsdaten gepflegt und erneuert werden und dass jemand auf Versionswechsel des Anbieters reagiert. Fällt eine Seite aus, braucht es Wiederholungslogik und eine Warteschlange, sonst gehen Vorgänge verloren.

Daraus folgt eine unspektakuläre Empfehlung: Ein Dateiimport mit sauberer Fehlerbehandlung ist einer schlecht gebauten Programmierschnittstelle vorzuziehen. Er ist überschaubar, hinterlässt Belege, lässt sich gefahrlos wiederholen und funktioniert auch dann, wenn ein System für zwei Stunden nicht erreichbar ist. Erst wenn die fachliche Anforderung eine Rückmeldung in Sekunden verlangt, wird die Programmierschnittstelle zur richtigen Wahl. Die Entscheidung trifft man am besten nach einer nüchternen Prozessanalyse und nicht nach der Frage, was moderner klingt.

Für die Einordnung: Eine Bestandsaufnahme der vorhandenen Übergaben mit Bewertung und Reihenfolge beginnt bei 1.900 Euro netto, die Umsetzung einer einzelnen Übergabe mit Prüfkette, Ablage, Protokoll und Meldung bei 4.900 Euro netto. Die Spanne nach oben hängt weniger von der Technik ab als von der Zahl der Sonderfälle im Fachbereich. Ein Import, dessen Regeln auf eine Seite passen, ist in wenigen Tagen fertig; einer mit zwölf Ausnahmen für einzelne Kundengruppen nicht. Die aktuellen Ansätze stehen auf der Seite Preise.

Der zweite Kostenblock ist der Betrieb, und er wird häufiger unterschätzt als der Bau. Eine Übergabe muss beobachtet werden, Formate ändern sich mit Updates der beteiligten Systeme, Ansprechpartner wechseln. Eine laufende Betreuung beginnt bei 190 Euro netto im Monat und umfasst die Überwachung der Läufe, die Bearbeitung von Meldungen und die Anpassung bei Formatänderungen. Wer das nicht extern vergibt, sollte die Aufgabe zumindest intern benennen: Ein Import ohne zuständige Person ist ein Import mit ungewisser Zukunft.