Zum Inhalt springen
Developer

Mitgliedschaftsprodukt wechseln

Ihr tauscht bei vielen Mitgliedschaften ein Produkt gegen ein anderes aus, auf Wunsch ab einem Stichtag.

Format
CSV (Semikolon oder Komma), UTF-8
Rechte
Administrator, Schreibrecht CRM und Produkte
Beispieldatei
produktwechsel_beispiel_technisch.csv (herunterladen)

Kurz gesagt: Ihr nennt das bisherige und das neue Produkt. vynst ersetzt das alte Produkt in den passenden Mitgliedschaften durch das neue, auf Wunsch ab einem Datum.

Wofür ihr das braucht

Wenn ein Beitrag wechselt, zum Beispiel vom Standardbeitrag zu einem Sozialtarif, müssen die laufenden Mitgliedschaften umgestellt werden. Mit dieser Datei geschieht das in einem Durchgang, statt jede Mitgliedschaft von Hand zu bearbeiten.

Bevor ihr startet

  • Rechte: Ihr braucht die Rolle Administrator mit Schreibrecht für CRM und für Produkte.
  • Vorher importiert: Die alten und neuen Produkte müssen in vynst vorhanden sein, zum Beispiel über Produkte (einfach). Die betroffenen Mitgliedschaften müssen ebenfalls schon in vynst angelegt sein.
  • Sicherung: Der Import lässt sich nicht auf Knopfdruck zurücknehmen. Zieht vorher unter Einstellungen → Export einen Export der betroffenen Daten.

Datei vorbereiten

  • Dateiname: Die Datei muss .csv enthalten. Der Rest des Namens ist frei.
  • Kopfzeile: Die ersten beiden Spalten heißen genau LOG_BOOK_ENTRY_OLD_PRODUCT_IDENTIFIER und LOG_BOOK_ENTRY_NEW_PRODUCT_IDENTIFIER, in dieser Reihenfolge. Daran erkennt vynst die Datei.
  • Trennzeichen: Semikolon oder Komma. Nehmt dasselbe Zeichen in der ganzen Datei.
  • Datum: 01.09.2026 oder 2026-09-01.
  • Tipp: Eine Vorlage mit den Produkten, für die schon eine neue Version existiert, bekommt ihr als Export mit dem Dateinamen product_list_template_log_book_entry_product_change.csv. Die Nummern darin sind vynst-Nummern, die ihr nicht ändern müsst. Ihr ergänzt nur das Datum.

Spalten

Der Import nutzt nur diese Spaltennamen, eine andere Schreibweise erkennt vynst nicht.

Spalte Pflicht Inhalt Beispiel
LOG_BOOK_ENTRY_OLD_PRODUCT_IDENTIFIER ja Bisheriges Produkt, eure Produktnummer oder das Kürzel JUG
LOG_BOOK_ENTRY_NEW_PRODUCT_IDENTIFIER ja Neues Produkt, gleiche Schreibweise FAM
CHANGE_DATE nein Erster Tag mit dem neuen Produkt. Ohne Datum gilt der Wechsel ohne Zeitbezug. 01.09.2026
LOG_BOOK_ENTRY_ID nein vynst-Nummer eines bestimmten Mitgliedschaftseintrags. Dann ändert vynst nur diesen Eintrag. Leer lassen, wenn ihr die Nummer nicht kennt.
PERSON_ID nein Nur Einträge dieser Person. Die Schreibweise vorher mit dem inwendo-Team abstimmen. Leer lassen, wenn ihr nicht filtern wollt.
COMPANY_ID nein Nur Einträge dieses Kontos. Die Schreibweise vorher mit dem inwendo-Team abstimmen. Leer lassen, wenn ihr nicht filtern wollt.
AGE_FILTER nein Nur Personen mit diesem Alter. Mehrere Alter trennt ihr mit Semikolon. 18

Beispiel

Die technische Datei mit den Spaltennamen des Imports:

LOG_BOOK_ENTRY_OLD_PRODUCT_IDENTIFIER;LOG_BOOK_ENTRY_NEW_PRODUCT_IDENTIFIER;CHANGE_DATE;LOG_BOOK_ENTRY_ID;PERSON_ID;COMPANY_ID;AGE_FILTER
JUG;FAM;01.09.2026;;;;
ERW;FAM;01.01.2027;;;;
JUG;ERW;01.01.2028;;;;18

Beispieldatei: produktwechsel_beispiel_technisch.csv

Die ersten beiden Zeilen tauschen das Produkt in allen passenden Mitgliedschaften, ohne Filter. Die dritte Zeile wirkt nur auf Personen mit 18 Jahren. Die leeren Spalten LOG_BOOK_ENTRY_ID, PERSON_ID und COMPANY_ID bedeuten: kein Filter. Wenn nur einzelne Mitglieder betroffen sind, tragt dort die Werte ein.

So geht’s

  1. Öffnet Einstellungen → Import.
  2. Klickt auf Hinzufügen und wählt die Datei aus.
  3. Wartet, bis der Eintrag in der Liste grün ist. Die Liste aktualisiert sich selbst.
  4. Lest das Protokoll. Jede Zeile mit Error: wurde nicht übernommen.

Gut zu wissen

  • Was umgestellt wird: Das alte Produkt wird im Eintrag durch das neue ersetzt. Das gilt für den Beitrag, eine Ermäßigung, eine passive Mitgliedschaft und einen beitragsfreien Zeitraum, wenn dort das alte Produkt steht.
  • Mit Datum: Der alte Eintrag endet am Tag vor dem Datum. Ein neuer Eintrag mit dem neuen Produkt beginnt am Datum. Ein Eintrag, der erst nach dem Datum beginnt, bekommt einfach das neue Produkt. Ein Eintrag, der vor dem Datum endet, bleibt unverändert.
  • Erneuter Import: Dieselbe Datei dürft ihr nochmal hochladen. Schon umgestellte Einträge bleiben unverändert.
  • Ohne Filter: Fehlen Person, Konto, Alter und Eintrags-Nummer, betrifft eine Zeile alle passenden Mitgliedschaften im System. Prüft das vorher.
  • Danach: vynst aktualisiert im Hintergrund die Abos, die aus den Mitgliedschaften entstehen.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped missing product identifier Altes oder neues Produkt fehlt in der Zeile Beide Produktspalten ausfüllen
Error: skipped missing product in db Eines der Produkte ist in vynst nicht bekannt Nummer prüfen, Produkt zuerst importieren
Error: skipped missing logbook entry in db Die vynst-Nummer des Eintrags existiert nicht Nummer prüfen
Error: skipped empty line Leere Zeile Nichts tun oder die Zeile löschen
INFO: created 3 new entries Mit Datum sind 3 neue Einträge entstanden Nur zur Kontrolle
Read: 12 rows So viele Zeilen wurden gelesen Nichts tun
Error: less then one line Die Datei enthält keine Datenzeile Datei prüfen
FAILED: User missing rights to import. Euch fehlt ein Recht für CRM oder Produkte Administrator fragen

Siehe auch