Zum Inhalt springen
Developer

Mitgliedschaftsprodukt beenden

Ihr beendet ein Produkt in vielen Mitgliedschaften, jeweils ab einem Stichtag.

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

Kurz gesagt: Ihr nennt das Produkt und den ersten Tag, an dem es nicht mehr gilt. vynst beendet das Produkt in den passenden Mitgliedschaften am Tag davor.

Wofür ihr das braucht

Wenn eine Beitragsart ausläuft, zum Beispiel ein Kursbeitrag zum Jahresende, müssen die Mitgliedschaften nicht mehr einzeln angepasst werden. Eine Datei erledigt das für alle betroffenen Einträge.

Bevor ihr startet

  • Rechte: Ihr braucht die Rolle Administrator mit Schreibrecht für CRM und für Produkte.
  • Vorher importiert: Das Produkt muss in vynst vorhanden sein, zum Beispiel über Produkte (einfach). Die Mitgliedschaften müssen schon 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 erste Spalte heißt LOG_BOOK_ENTRY_END_PRODUCT_IDENTIFIER, die zweite CHANGE_DATE. Die Spalte mit dem Datum muss also direkt hinter der Produktspalte stehen.
  • Trennzeichen: Semikolon oder Komma. Nehmt dasselbe Zeichen in der ganzen Datei.
  • Datum: 01.09.2026 oder 2026-09-01. Eine leere Zelle gilt als heute.

Spalten

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

Spalte Pflicht Inhalt Beispiel
LOG_BOOK_ENTRY_END_PRODUCT_IDENTIFIER ja Produkt, das endet, eure Produktnummer oder das Kürzel JUG
CHANGE_DATE ja, als zweite Spalte Erster Tag ohne dieses Produkt. Leer bedeutet heute. 01.01.2027
LOG_BOOK_ENTRY_ID nein vynst-Nummer eines bestimmten Eintrags. 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_END_PRODUCT_IDENTIFIER;CHANGE_DATE;LOG_BOOK_ENTRY_ID;PERSON_ID;COMPANY_ID;AGE_FILTER
JUG;01.01.2027;;;;
FAM;01.01.2028;;;;
YOGA;01.01.2027;;;;18

Beispieldatei: produktende_beispiel_technisch.csv

Die Zeile JUG;01.01.2027 bedeutet: Der Jugendbeitrag endet am 31.12.2026. Die zweite Zeile beendet das Produkt FAM ab dem 01.01.2028. Die dritte Zeile beendet das Yoga-Abo nur für Personen mit 18 Jahren ab dem 01.01.2027.

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.
  4. Lest das Protokoll. Jede Zeile mit Error: wurde nicht übernommen.

Gut zu wissen

  • Das Datum ist der erste Tag ohne Produkt. Der Eintrag endet am Tag davor.
  • Beginnt der Eintrag erst nach dem Datum, wird das Produkt aus dem Eintrag entfernt.
  • Endet der Eintrag schon vor dem Datum, bleibt er unverändert.
  • Leere Datumszelle: vynst beendet das Produkt ab heute. Kontrolliert, dass in jeder Zeile ein Datum steht, wenn ihr einen anderen Stichtag wollt.
  • Ohne Filter betrifft jede Zeile alle Mitgliedschaften, die das Produkt noch enthalten und zum Stichtag noch laufen.
  • 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 Die Produktspalte ist leer Produktnummer ausfüllen
Error: skipped missing product in db Das Produkt 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
Read: 3 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