Tankkarten-Import: Dateien hochladen und Import-Läufe verstehen
Überblick
Der Tankkarten-Import verarbeitet die Abrechnungsdateien Ihrer Tankkarten-Anbieter (z. B. DKV, UTA) und bucht die Transaktionen automatisch als Belege auf Ihre Fahrzeuge – inklusive Kilometerstands-Übernahme, Duplikatschutz und Prüfregeln. Auch Ladevorgänge von E-Fahrzeugen werden korrekt erkannt und als Elektro-Belege in kWh gebucht (Artikel 11).
Das Modul finden Sie im Navigationsmenü unter Tankkarten Import:
| Menüpunkt | Zweck |
|---|---|
Übersicht (/applications/fuelcard/tankimport) | Dashboard mit Kennzahlen |
Import-Läufe (…/runs) | Datei-Upload und Verlauf aller Läufe |
Freigabe-Warteschlange (…/review) | Manuelle Prüfung auffälliger Transaktionen |
Datei manuell hochladen
- Öffnen Sie Tankkarten Import → Import-Läufe.
- Laden Sie eine Datei hoch – unterstützt werden
.csv,.xmlund.json, maximal 50 MB. - Das Format wird automatisch erkannt (z. B. DKV-CSV) und in ein einheitliches Transaktionsformat übersetzt.
- Der Import-Lauf startet: Jede Zeile wird geprüft, gegen die Prüfregeln bewertet und entweder automatisch freigegeben oder in die Freigabe-Warteschlange gestellt.
- Freigegebene Transaktionen werden als Belege auf das jeweilige Fahrzeug (Zuordnung über das Kennzeichen) gebucht; der Fahrzeug-Kilometerstand wird aktualisiert.
Import-Läufe und Status
Jeder Lauf hat eine Detailansicht mit allen Datensätzen, deren Status und den ausgelösten Prüfregeln:
- Automatisch freigegeben – keine Auffälligkeiten, Beleg wurde gebucht
- Prüfung erforderlich – eine blockierende Regel hat angeschlagen → Freigabe-Warteschlange
- Duplikat übersprungen – die Transaktion wurde bereits in einem früheren Lauf gebucht (stabiler Import-Schlüssel); sie wird nicht doppelt gebucht
- Fehlgeschlagen – einzelne fehlerhafte Datensätze verhindern nicht den Rest des Laufs; sie können nach Korrektur über einen erneuten Lauf (Berechtigung
tankimport.adminbzw. WebAdmin) nachgezogen werden. Der ursprüngliche Lauf bleibt unverändert nachvollziehbar.
Häufige Fragen
Der Upload wird abgelehnt. Prüfen Sie Dateiendung (.csv/.xml/.json), Größe (max. 50 MB) und dass die Datei nicht leer ist.
Eine Transaktion findet ihr Fahrzeug nicht. Die Zuordnung läuft über das Kennzeichen. Prüfen Sie, ob das Kennzeichen in der Fahrzeugakte exakt so geschrieben ist wie in der Anbieterdatei.
Kann ich denselben Import versehentlich zweimal einspielen? Ja, aber ohne Folgen: Bereits gebuchte Transaktionen werden als Duplikate erkannt und übersprungen.