Zahlungen
CSV-Import (Kontoauszug)
Der CSV-Import liest Kontoauszüge der Bank ein und legt daraus Zahlungsdatensätze an. Die Funktion ist nur verfügbar, wenn das Feature CSV-Import für den Verein aktiviert ist.
Nur Administratoren und Vorstandsmitglieder haben Zugriff. Das Feature CSV-Import muss unter Administration → Funktionen aktiviert sein.
#Unterstütztes Format
| Eigenschaft | Wert |
|---|---|
| Trennzeichen | ;, ,, Tabulator oder | — wird automatisch erkannt, per Vorlage festgelegt oder manuell überschrieben |
| Zeichenkodierung | Automatisch erkannt: UTF-8, ISO-8859-1, Windows-1252, ISO-8859-15, ISO-8859-2 |
| Pflichtfelder | Datum, Verwendungszweck, Betrag, Absender / Zahlungsbeteiligter |
| Kopfzeile | Wird automatisch in den ersten 20 Zeilen gesucht (Vorspann-Zeilen wie bei ING oder Comdirect werden übersprungen) |
| Spaltennamen | Pro Verein konfigurierbar — siehe Spaltenzuordnung konfigurieren |
#Spaltenzuordnung konfigurieren
Jede Bank exportiert CSV-Dateien mit eigenen Spaltennamen. Die Zuordnung pflegen Sie einmalig unter Administration → Vereinseinstellungen → Allgemein auf der Karte CSV-Import (Zahlungen).
Die Karte zeigt die aktuell gewählte Bank-Vorlage sowie die vier zugeordneten Spaltennamen für Datum, Verwendungszweck, Betrag und Absender. Über Bearbeiten öffnet sich das Konfigurations-Flyout.
#Bank-Vorlage auswählen
Im Flyout wählen Sie unter Bank-Vorlage Ihre Bank aus. Die Vorlagen sind in zwei Gruppen aufgeteilt:
| Gruppe | Bedeutung |
|---|---|
| Bestätigt | Mapping ist mit mindestens einem echten Musterexport geprüft. |
| Mit Einschränkung (⚠) | Format ist bekannt, hat aber Eigenheiten (z. B. Absender im Buchungstext, mehrere Exportprofile). Beim Auswählen erscheint ein gelber Hinweistext mit dem konkreten Vorbehalt. |
Derzeit ausgelieferte Vorlagen:
| Gruppe | Vorlagen |
|---|---|
| Bestätigt | GLS Bank, Sparkasse (CSV-CAMT), DKB (ab 2023), DKB (Legacy), ING, N26, Volksbank / VR-Bank, Volksbank VR-Profi (Legacy) |
| Mit Einschränkung | Commerzbank, Deutsche Bank, Postbank, Comdirect, Targobank |
Wenn Ihre Bank nicht in der Liste steht, wählen Sie — Benutzerdefiniert — und tragen die Spaltennamen von Hand ein. Die gespeicherte Konfiguration bleibt dabei an Ihren Verein gebunden — andere Vereine werden nicht beeinflusst.
#Spaltennamen
Unterhalb der Vorlage sind vier Pflichtfelder sichtbar:
| Feld | Beschreibung |
|---|---|
| Spalte Datum | Buchungs- oder Valutadatum in der CSV |
| Spalte Verwendungszweck | Freitext / Beschreibung der Buchung |
| Spalte Betrag | Betragsspalte (Vorzeichen im Betrag oder separat — siehe Soll/Haben unten) |
| Spalte Absender / Zahlungsbeteiligter | Name des Absenders / Empfängers |
Beim Wählen einer Vorlage werden diese vier Felder automatisch vorbelegt. Einzelne Einträge können danach angepasst werden — etwa wenn Ihre Bank eine abweichende Spaltenbezeichnung verwendet.
#Erweitert (Trennzeichen, Kodierung, Kopfzeile, Soll/Haben)
Der Bereich Erweitert ist optional. Im Normalfall erkennt der Import diese Werte automatisch.
| Feld | Wann setzen? |
|---|---|
| Trennzeichen | Nur setzen, wenn die automatische Erkennung mehrdeutig ist. Auswahl: Semikolon, Komma, Tabulator, Pipe. |
| Zeichenkodierung | Nur setzen, wenn Umlaute fehlerhaft dargestellt werden (z. B. M�ller statt Müller). Auswahl: UTF-8, ISO-8859-1, Windows-1252. |
| Kopfzeile ab Zeile | Nur setzen, wenn die Datei mehrere Metadatenzeilen vor der Kopfzeile enthält (typisch bei ING und Comdirect). |
| Spalte Soll/Haben | Nur setzen, wenn das Vorzeichen in einer separaten Spalte steht — Werte S (Soll, Belastung) bzw. H (Haben, Einnahme). Wird ausschließlich von der Vorlage Volksbank VR-Profi (Legacy) vorbelegt. |
#Testdatei hochladen
Unter Testdatei hochladen (optional) können Sie eine CSV-Datei probeweise gegen die aktuellen Einstellungen parsen lassen. Die ersten drei geparsten Zeilen werden in einer Vorschautabelle (Datum · Zweck · Betrag · Absender) angezeigt — so lässt sich vor dem Speichern prüfen, ob die Spaltennamen korrekt sind.
- Maximale Dateigröße: 2 MB.
- Die Testdatei wird nach der Vorschau verworfen — es werden keine Zahlungen angelegt.
- Bei Fehlern (z. B. nicht erkannte Kopfzeile) erscheint ein roter Hinweis mit Angabe der Ursache.
Klicken Sie abschließend auf Speichern, um die Zuordnung zu sichern.
#Import-Ablauf
- Klicken Sie in der Zahlungsübersicht auf CSV Import.
- Wählen Sie die CSV-Datei Ihres Kontoauszugs aus und klicken Sie auf Importieren.
- Die Prüftabelle erscheint mit allen erkannten Zeilen.
- Korrigieren Sie einzelne Zeilen bei Bedarf direkt in der Tabelle (Datum, Beschreibung, Parzelle, Betrag).
- Klicken Sie pro Zeile auf Speichern oder verwenden Sie Alle speichern, um alle verbleibenden Zeilen auf einmal anzulegen.
- Nicht benötigte Zeilen entfernen Sie mit Verwerfen.
Achtung: Nicht gespeicherte Zeilen gehen beim Neuladen der Seite verloren. Speichern oder verwerfen Sie alle Zeilen, bevor Sie die Seite verlassen.
#Fallback bei nicht erkannten Dateien
Kann die automatische Erkennung eine hochgeladene Datei nicht eindeutig einordnen, erscheint oberhalb der Prüftabelle ein gelber Hinweis mit der konkreten Ursache:
| Meldung | Bedeutung |
|---|---|
| Das Trennzeichen konnte nicht eindeutig erkannt werden | Mehrere Trennzeichen liefern gleich plausible Zeilen. Wählen Sie das passende Zeichen manuell aus und klicken Sie Erneut versuchen. |
| Die Zeichenkodierung konnte nicht erkannt werden | Datei liefert keine klare Kodierung zurück. Wählen Sie UTF-8, ISO-8859-1 oder Windows-1252. |
| Die Kopfzeile wurde in der Datei nicht gefunden | Die in den Einstellungen hinterlegten Spaltennamen kommen in der Datei nicht vor. Der Hinweis verlinkt direkt zu den Einstellungen, damit Sie die Zuordnung anpassen können. |
Die hier gewählten Werte gelten nur für diesen Upload. Sie überschreiben die gespeicherte Zuordnung nicht. Wenn derselbe Fallback bei jedem Import auftritt, hinterlegen Sie Trennzeichen und Kodierung dauerhaft im Konfigurations-Flyout (Abschnitt Erweitert).
Zusätzlich lässt sich die fehlgeschlagene Datei über Neue Datei hochladen verwerfen, um einen neuen Versuch zu starten.
#Automatische Zuordnung
| Regel | Beschreibung |
|---|---|
| Beschreibung enthält „Pacht" | Kategorie Pacht wird automatisch gesetzt |
Parzellenkennung im Verwendungszweck (z. B. Parz 42) |
Parzelle wird automatisch zugeordnet |
| Absendername matcht ein Mitglied | Mitglied und ggf. dessen aktuelle Parzelle werden automatisch gesetzt |
#Absender-Erkennung bei „Buchungstext"-Banken
Bei den Vorlagen Commerzbank und Comdirect steht der Absendername nicht in einer eigenen Spalte, sondern eingebettet im Buchungstext (z. B. ÜBERWEISUNGSGUTSCHRIFT MAX MUELLER Pachtzahlung Parzelle 42). Für diese Fälle durchsucht der Import den gesamten Buchungstext nach Vor- und Nachnamen aller Mitglieder — inklusive Umlaut-Normalisierung (Müller = MUELLER).
- Wird genau ein Mitglied gefunden, wird die Zeile zugeordnet.
- Werden mehrere Mitglieder mit demselben Nachnamen gefunden (z. B. zwei Müllers, ohne eindeutigen Vornamen im Buchungstext), bleibt die Zeile unzugeordnet. Sie können das Mitglied in der Prüftabelle manuell setzen.
Alle automatischen Zuordnungen können vor dem Speichern manuell korrigiert werden.
Alle importierten Zeilen werden als Einnahmen (is_debit = false) angelegt, da es sich um eingegangene Bankgutschriften handelt. Bei Vorlagen mit Soll/Haben-Spalte bestimmt der Spaltenwert die Richtung (S → Belastung, H → Einnahme).