Zum Inhalt springen
Developer

SEPA-Lastschriftdaten

Ihr hinterlegt IBAN, Mandat und Kontoinhaber je Abrechnungskonto und stellt auf Lastschrift um.

Format
CSV (Komma oder Semikolon), UTF-8
Rechte
Administrator, Schreibrecht Kontakte (CRM)
Beispieldateien
AFS_SEPA_beispiel_technisch.csv (technische Spaltennamen)
AFS_SEPA_beispiel_anwender.csv (deutsche Spaltennamen)

Kurz gesagt: Die Datei trägt Bankverbindung und SEPA-Mandat in bestehende Abrechnungskonten ein. Ist die Lastschrift aktiviert und die Bankverbindung vollständig, stellt vynst die Zahlungsart auf Lastschrift um.

Wofür ihr das braucht

Lastschriften funktionieren nur, wenn das Konto eine gültige IBAN, eine Mandatsreferenz und ein Mandatsdatum hat. Diese Daten kommen über diese Datei in vynst.

Bevor ihr startet

  • Recht: Administrator mit Schreibrecht für Kontakte (CRM).
  • Vorher: Die Abrechnungskonten müssen importiert sein. Die Kontonummer in dieser Datei muss genau der Nummer aus dem Kontenimport entsprechen.
  • Sicherung: Vor dem Import einen Export der Konten ziehen (Einstellungen → Export). Bestehende Bankdaten werden überschrieben.
  • Große Dateien: Ab 4000 Zeilen teilt vynst die Datei in Pakete zu je 1000 Zeilen auf.

Datei vorbereiten

  • Dateiname: Der Name muss AFS_SEPA_ enthalten, zum Beispiel AFS_SEPA_konten.csv.
  • Kopfzeile: Eine Kontonummer, die IBAN und die Mandatsreferenz müssen vorkommen. Die übrigen Spalten sind optional.
  • Trennzeichen: Komma oder Semikolon, in der ganzen Datei gleich.
  • Datum: 01.01.2020 oder 2020-01-01.
  • Zeichensatz: UTF-8.

Spalten

Spalte Pflicht Inhalt Beispiel
Kontonummer (COMPANY_IDENTIFIER) ja Nummer des Abrechnungskontos wie beim Kontenimport. Auch: ACCOUNT_IDENTIFIER, Abrechnungskontonummer, Mitglieds-Nr., Adressnummer. K-1001
IBAN (PAYMENT_IBAN) ja Bankkonto des Zahlers. Auch: IBAN_Nr. DE02120300000000202051
Mandatsreferenz (PAYMENT_MANDATE) ja Nummer des SEPA-Mandats. Auch: SEPA-Mandatsreferenz, Mandatsref, MandatNr. M-1001
Mandatsdatum (PAYMENT_MANDATE_SIGN_DATE) nein Datum der Unterschrift. Auch: Mandatsreferenz gültig ab, Mandat gültig von, SEPA-Mandatsdatum. Fehlt es, obwohl das Gültig-bis in der Zukunft liegt, nimmt vynst das Anlagedatum des Kontos. 01.01.2020
Gültig bis (PAYMENT_MANDATE_VALID_UNTIL_DATE) nein Auch: Mandat gültig bis, Mandatsreferenz gültig bis. Ende der Gültigkeit des Mandats. Fehlt die Spalte oder ist sie leer, wird ein bisheriges Ende entfernt. 31.12.2030
BIC (PAYMENT_BIC) nein Auch: Swift BIC, BIC_Nr. Ist die Bank über die IBAN bekannt, übernimmt vynst die BIC aus der Bankdatenliste. BYLADEM1001
Bank (PAYMENT_INSTITUTION) nein Name der Bank. Auch: Bankname, Bankbezeichnung. Beispielbank
Kontoinhaber (PAYMENT_OWNER) nein Auch: Inhaber, Zahler, Kontoinh. (Vor-/Nachname). Anna Beispiel
IMPORT_IDENTIFIER_PREFIX nein Vorsatz für die interne Kennung des Kontos. Standard ist AFS_CSV_. AFS_CSV_
Lastschrift aktivieren (PAYMENT_SEPA_ACTIVATE) nein Mit ja (auch 1 oder true) stellt vynst die Zahlungsart auf Lastschrift um, wenn die Bankverbindung vollständig ist. Auch: SEPA-Lastschrift aktivieren, Bankverfahren. ja

Beispiel

COMPANY_IDENTIFIER;PAYMENT_IBAN;PAYMENT_MANDATE;PAYMENT_MANDATE_SIGN_DATE;PAYMENT_MANDATE_VALID_UNTIL_DATE;PAYMENT_BIC;PAYMENT_INSTITUTION;PAYMENT_OWNER;PAYMENT_SEPA_ACTIVATE;IMPORT_IDENTIFIER_PREFIX
K-1001;DE02120300000000202051;M-1001;01.01.2020;31.12.2030;BYLADEM1001;Beispielbank;Lena Hartmann;ja;AFS_CSV_
K-1003;DE02500105170137075030;M-1003;01.01.2021;31.12.2030;INGDDEFFXXX;Beispielbank;Anna Beispiel;ja;AFS_CSV_

Beispieldateien: AFS_SEPA_beispiel_technisch.csv mit den technischen Spaltennamen, AFS_SEPA_beispiel_anwender.csv mit den deutschen Spaltennamen.

So geht’s

  1. Konten exportieren, als Sicherung speichern.
  2. Datei mit den Bankdaten erstellen, Kontonummern wie im Kontenimport.
  3. Einstellungen → Import → Hinzufügen, Datei auswählen.
  4. Im Protokoll nach Error: suchen und nur die übersprungenen Zeilen korrigieren.

Gut zu wissen

  • Ein erneuter Import aktualisiert dieselben Konten, es entstehen keine Doppelten.
  • Eine leere Zelle bei der IBAN löscht die gespeicherte IBAN.
  • Die Zahlungsart ändert sich nur, wenn die Lastschrift mit ja aktiviert ist und IBAN, BIC, Mandat und Mandatsdatum vollständig sind.
  • Konten, die nicht gefunden werden, bekommen eine Fehlerzeile.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped missing identifier Die Kontonummer fehlt in einer Zeile. Darunter steht die Zeile als LINE-DATA. Kontonummer ergänzen.
Error: company not found Zu dieser Kontonummer gibt es kein Konto. Darunter steht die Zeile als LINE-DATA. Kontonummer mit dem Kontenimport abgleichen.
Error: skipped empty line Leerzeile wurde übersprungen. Nichts tun.
Info: split into N files Die Datei wurde in Pakete geteilt. Nichts tun, die Pakete erscheinen als eigene Einträge.
Error: less then one line Die Datei enthält keine Datenzeile. Datei prüfen.
FAILED: No matching processor found. Dateiname mit AFS_SEPA_ oder die Kopfzeile fehlt. Dateiname und Spalten der Kopfzeile prüfen.

Siehe auch