Zum Inhalt springen
Developer

Bankumsätze als CSV

Ihr übernehmt Bankumsätze aus einer CSV-Datei, die nicht im CAMT-Format vorliegt.

Format
CSV (Komma oder Semikolon), UTF-8
Rechte
Administrator, Schreibrecht Zahlungen
Beispieldateien
Bank_Umsaetze_beispiel_technisch.csv (technische Spaltennamen)
Bank_Umsaetze_beispiel_anwender.csv (deutsche Spaltennamen)

Kurz gesagt: Für Bankexporte, die nicht im CAMT-Format sind, übernimmt vynst die Umsätze, wenn die Datei die richtigen Spalten hat. Doppelte Buchungen werden erkannt und übersprungen.

Wofür ihr das braucht

Euer Onlinebanking exportiert die Umsätze als CSV, aber nicht im CAMT-Format. Mit diesem Import kommen die Umsätze trotzdem in vynst an.

Bevor ihr startet

  • Rechte: Administrator mit Schreibrecht für Zahlungen.
  • Vorher: Ist euer Export im CAMT-CSV-Format (Sparkasse), nehmt bitte den Import „Kontoauszug CAMT als CSV“.

Datei vorbereiten

  • Dateiname: Der Name muss .csv enthalten und mindestens eines von diesen Wörtern: Bank, Zahlungen, Transaktionen (Groß- und Kleinschreibung egal). Auch AFS_BANK_TRANSACTION_ passt.
  • Kopfzeile: Die folgenden Spalten müssen vorhanden sein, auch wenn einzelne Zellen leer sind:
Spalte in der Kopfzeile Alternativ erkannt
Buchungstag Buchdatum
Valutadatum Valuta
Betrag
Verwendungszweck Zweck
Buchungstext Buchungste
Beguenstigter/Zahlungspflichtiger Name
Kontonummer/IBAN Kto/IBAN A
BIC (SWIFT-Code) BLZ/BIC AG
Glaeubiger ID Gläubiger-
Kundenreferenz (End-to-End) Ende-zu-En
Sammlerreferenz Sammler-ID
  • Wichtig: Eine dieser Spalten darf nicht die letzte Spalte der Kopfzeile sein. Hinter jedem Namen muss ein Trennzeichen stehen.
  • Trennzeichen: Komma oder Semikolon. Steht Buchungstag oder Buchdatum mit Komma in der Kopfzeile, gilt Komma, sonst Semikolon.
  • Datum: 01.03.2026 oder 2026-03-01.
  • Beträge: 1.234,56 mit Komma als Dezimaltrenner.

Spalten für die Übernahme

Spalte Pflicht Inhalt
Buchungstag ja Datum der Buchung.
Betrag ja Betrag.
SH-Kennzei nein Kennzeichen S oder - macht den Betrag negativ, H oder + positiv. Andere Werte führen zu einem Fehler.
Verwendungszweck ja Name der Buchung. Ist die Spalte leer, werden Verwendungszweck 1 bis Verwendungszweck 14 zusammengesetzt.
Beguenstigter/Zahlungspflichtiger oder Name ja Name des Gegenübers.
Kontonummer/IBAN ja IBAN des Gegenübers.
Mandatsreferenz nein SEPA-Mandat.
Buchungstext nein Interne Beschreibung.
Kundenreferenz (End-to-End) nein Kennung zur Dublettenprüfung.
Sammlerreferenz nein Sammelreferenz.
Währung nein Währung. Auch: Waehrung, Währungskürzel.

Beispiel

Buchungstag;Valutadatum;Buchungstext;Verwendungszweck;Glaeubiger ID;Kundenreferenz (End-to-End);Sammlerreferenz;Beguenstigter/Zahlungspflichtiger;Kontonummer/IBAN;BIC (SWIFT-Code);Betrag;Waehrung;Mandatsreferenz;SH-Kennzei
01.09.2026;01.09.2026;LASTSCHRIFT;Beitrag 09/2026 Hartmann;DE98ZZZ09999999999;E2E-2026-0005;;Familie Hartmann;DE02120300000000202051;;12,50;EUR;M-1001;H
15.09.2026;15.09.2026;UEBERWEISUNG;Kursgebuehr Yoga 09/2026;;E2E-2026-0006;;Anna Beispiel;DE02500105170137075030;;8,00;EUR;;H
20.09.2026;20.09.2026;UEBERWEISUNG;Erstattung Kursgebuehr;;E2E-2026-0007;;Lena Hartmann;DE02120300000000202051;;5,00;EUR;;S

Beispieldateien: Bank_Umsaetze_beispiel_technisch.csv mit den technischen Spaltennamen, Bank_Umsaetze_beispiel_anwender.csv mit den deutschen Spaltennamen. Die Zeilen zeigen den Inhalt der technischen Datei.

So geht’s

  1. Export aus dem Onlinebanking laden und Kopfzeile prüfen (Spalten wie in der Tabelle oben).
  2. Abrechnung → Bank-Importe → Hinzufügen, Datei auswählen.
  3. Protokoll prüfen.
  4. Die Zuordnung läuft danach im Hintergrund.

Gut zu wissen

  • Bereits importierte Buchungen erkennt vynst und überspringt sie.
  • Ist das Kennzeichen S oder H gesetzt, schreibt den Betrag ohne zusätzliches Minus- oder Pluszeichen. Sonst wird der Betrag doppelt gedreht und wird 0.
  • Jede Datei erzeugt eine neue Gruppe in der Liste der Bank-Importe.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped missing Buchungstag Die Zeile hat kein Buchungsdatum. Darunter steht LINE-DATA. Zeile prüfen.
Error: skipped missing IBAN or Betrag IBAN oder Betrag fehlt. Zeile prüfen.
Error: skipped missing Zahlungspflichtiger Name des Gegenübers fehlt. Zeile prüfen.
Error: skipped missing Verwendungszweck Verwendungszweck fehlt. Zeile prüfen.
Error: skipped unknown Betrag prefix Das Kennzeichen ist weder S, H, - noch +. Kennzeichen korrigieren.
Error: skipped duplicate Buchung gibt es schon. Nichts tun.
Error: skipped empty line Leerzeile. Nichts tun.
Error: less then one line Keine Datenzeile. Datei prüfen.
FAILED: No matching processor found. Eine Pflichtspalte fehlt in der Kopfzeile oder ist die letzte Spalte. Kopfzeile nach der Liste oben prüfen.

Siehe auch