Zum Inhalt springen
Developer

Zahlungen

Ihr übernehmt Zahlungen zu Konten, Personen und Sparten aus einer CSV-Datei.

Format
CSV (Komma oder Semikolon), UTF-8
Rechte
Schreibrecht Kontakte (CRM)
Beispieldatei
zahlungen_beispiel_technisch.csv (herunterladen)

Kurz gesagt: Jede Zeile ist eine Zahlung mit Betrag, Konto, Person und Sparte. Die Datei legt neue Zahlungen an. Trifft eine Zeile eine schon vorhandene Zahlung mit gleichem Konto, gleicher Person, gleichem Datum, Betrag, Notiz und gleicher Richtung, aktualisiert sie diese Zahlung.

Wofür ihr das braucht

Zahlungen aus eurem bisherigen Programm sollen in vynst vorliegen, damit Konten und Personen einen vollständigen Zahlungsverlauf haben.

Bevor ihr startet

  • Rechte: Schreibrecht für Kontakte (CRM). Ein Administratorrecht ist hier nicht nötig.
  • Vorher: Konten, Personen und Sparten sollten schon in vynst sein. Unbekannte Nummern führen sonst zu Zahlungen ohne Verknüpfung.
  • Erneut hochladen: Eine Datei, die schon einmal importiert wurde, bucht die Zahlungen nicht doppelt. Die vorhandenen Zahlungen werden aktualisiert.
  • Sicherung: Vor dem Import einen Export ziehen (Einstellungen → Export).

Datei vorbereiten

  • Dateiname: Der Name muss .csv enthalten.
  • Kopfzeile: Die ersten fünf Spalten stehen in dieser Reihenfolge: TRANSACTION_BRUTTO_VALUE, COMPANY_IDENTIFIER, PERSON_IDENTIFIER, UNIFIED_CATEGORY_IDENTIFIER, DATE.
  • Trennzeichen: Komma oder Semikolon. Mit Komma beginnt die Kopfzeile mit TRANSACTION_BRUTTO_VALUE,.
  • Beträge: Schreibt Beträge mit Komma, zum Beispiel 12,50. Mit Punkt als Dezimaltrenner und ohne Angabe von PRICE_FORMAT liest vynst 12.50 richtig. Bei Komma-Beträgen setzt ihr PRICE_FORMAT auf de.
  • Datum: 2026-03-01 oder 01.03.2026.

Spalten

Spalte Pflicht Inhalt Beispiel
TRANSACTION_BRUTTO_VALUE ja Betrag der Zahlung (Brutto). 12,50
COMPANY_IDENTIFIER ja Konto, zu dem die Zahlung gehört. Über die Kontonummer. K-1001
PERSON_IDENTIFIER ja Person, zu der die Zahlung gehört. 1001
UNIFIED_CATEGORY_IDENTIFIER ja in der Kopfzeile Sparte der Zahlung. Darf leer sein. FB
DATE ja Datum der Zahlung. 01.03.2026
NOTE nein Bezeichnung der Zahlung. Jahresbeitrag 2026
PAYMENT_TYPE nein Name der Zahlungsart, genau wie in vynst. Lastschrift
CURRENCY nein Währung. Standard ist €. €
INCOMING nein ja, wenn es ein Zahlungseingang ist. Sonst nein. ja
AUTO nein ja, wenn die Zahlung automatisch erzeugt wurde. nein
PRICE_FORMAT nein de für Beträge mit Komma, en für Punkt. Standard ist en. de

Beispiel

TRANSACTION_BRUTTO_VALUE;COMPANY_IDENTIFIER;PERSON_IDENTIFIER;UNIFIED_CATEGORY_IDENTIFIER;DATE;NOTE;PAYMENT_TYPE;CURRENCY;INCOMING;AUTO;PRICE_FORMAT
12,50;K-1001;AFS_CSV_1001;FB;01.09.2026;Beitrag 09/2026;Lastschrift;€;ja;nein;de
8,00;K-1003;AFS_CSV_1003;TUR;15.09.2026;Kursgebühr 09/2026;Lastschrift;€;ja;nein;de

Beispieldatei: zahlungen_beispiel_technisch.csv mit allen Spalten.

So geht’s

  1. Datei mit der Kopfzeile oben erstellen.
  2. Einstellungen → Import → Hinzufügen, Datei auswählen.
  3. Im Protokoll prüfen, wie viele Zeilen gelesen wurden.

Gut zu wissen

  • Erneuter Import: Eine Zeile, die einer vorhandenen Zahlung entspricht (gleiches Konto, Person, Datum, Betrag, Notiz und Richtung), aktualisiert diese Zahlung. Das Protokoll meldet die Anzahl mit Info:. Dabei überschreibt der Import Zahlungsart, Währung, Automatik-Kennzeichen und Sparte. Vorsicht bei Zahlungen, die ihr von Hand erfasst habt und die genauso aussehen: Sie werden ebenfalls aktualisiert.
  • Gleiche Zeilen in einer Datei: Zwei gleiche Zeilen in derselben Datei ergeben zwei Zahlungen. Sie gelten nicht als Dublette.
  • Geänderte Angaben: Ändert sich der Betrag, das Datum, die Notiz oder die Richtung, legt der Import eine neue Zahlung an.
  • Zeilen ohne Betrag, Konto oder Person werden ohne Meldung übersprungen.
  • Ist das Konto oder die Person nicht bekannt, entsteht die Zahlung ohne diese Verknüpfung, ohne Meldung.
  • INCOMING steuert, ob die Zahlung eingehend ist. Das Vorzeichen des Betrags bestimmt es nicht.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped empty line Leerzeile. Nichts tun.
Read: N rows Anzahl gelesener Zeilen. Mit eurer Zeilenzahl vergleichen.
Info: N payments were already imported and only updated So viele Zeilen trafen eine vorhandene Zahlung und haben sie nur aktualisiert. Nichts tun. Bei einem ersten Import prüfen, ob die Zahlungen schon vorher erfasst waren.
Error: less then one line Keine Datenzeile. Datei prüfen.
FAILED: No matching processor found. Die Kopfzeile beginnt nicht mit den fünf Spalten in der richtigen Reihenfolge. Kopfzeile prüfen.
FAILED: An unexpected Error occurred. Ein Datum konnte nicht gelesen werden. Die Zeilen davor sind schon gespeichert. Das Datum in der genannten Zeile prüfen und nur den Rest importieren.

Siehe auch