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
.csventhalten. Der Rest des Namens ist frei. - Kopfzeile: Die ersten beiden Spalten heißen genau
LOG_BOOK_ENTRY_OLD_PRODUCT_IDENTIFIERundLOG_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.2026oder2026-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
- Öffnet Einstellungen → Import.
- Klickt auf Hinzufügen und wählt die Datei aus.
- Wartet, bis der Eintrag in der Liste grün ist. Die Liste aktualisiert sich selbst.
- 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
- Wechsel vom Kinder- zum Erwachsenenbeitrag
- Mitgliedschaftsprodukt beenden
- Produkte (einfach)
- Preise aktualisieren
- Daten importieren