Skip to content
Developer

Change membership product

You swap one product for another in many memberships, optionally from a reference date.

Format
CSV (semicolon or comma), UTF-8
Access rights
Administrator, write access to CRM and products
Example file
produktwechsel_beispiel_technisch.csv (download)

In short: You name the previous and the new product. vynst replaces the old product with the new one in the matching memberships, optionally from a date.

What you need this for

When a fee changes, for example from the standard fee to a social tariff, the ongoing memberships must be switched over. With this file, this happens in one pass, instead of editing each membership by hand.

Before you start

  • Rights: You need the role Administrator with write access for CRM and for products.
  • Imported beforehand: The old and new products must exist in vynst, for example via Products (simple). The affected memberships must also already exist in vynst.
  • Backup: The import cannot be undone at the click of a button. Before you start, export the affected data under Settings → Export (Einstellungen → Export).

Prepare the file

  • File name: The file must contain .csv. The rest of the name is free.
  • Header row: The first two columns are called exactly LOG_BOOK_ENTRY_OLD_PRODUCT_IDENTIFIER and LOG_BOOK_ENTRY_NEW_PRODUCT_IDENTIFIER, in this order. vynst recognises the file by these.
  • Separator: Semicolon or comma. Use the same character throughout the file.
  • Date: 01.09.2026 or 2026-09-01.
  • Tip: A template with the products for which a new version already exists is available as an export with the file name product_list_template_log_book_entry_product_change.csv. The numbers in it are vynst numbers that you do not need to change. You only add the date.

Columns

The import uses only these column names. vynst does not recognise any other spelling.

Column Required Content Example
LOG_BOOK_ENTRY_OLD_PRODUCT_IDENTIFIER yes Previous product, your product number or the short code JUG
LOG_BOOK_ENTRY_NEW_PRODUCT_IDENTIFIER yes New product, same spelling FAM
CHANGE_DATE no First day with the new product. Without a date, the change applies without a time reference. 01.09.2026
LOG_BOOK_ENTRY_ID no vynst number of a specific membership entry. Then vynst changes only this entry. Leave empty if you do not know the number.
PERSON_ID no Only entries of this person. Agree the spelling with the inwendo team beforehand. Leave empty if you do not want to filter.
COMPANY_ID no Only entries of this account. Agree the spelling with the inwendo team beforehand. Leave empty if you do not want to filter.
AGE_FILTER no Only persons of this age. Separate several ages with a semicolon. 18

Example

The technical file with the column names of the import:

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

Example file: produktwechsel_beispiel_technisch.csv

The first two rows swap the product in all matching memberships, without a filter. The third row only affects persons aged 18. The empty columns LOG_BOOK_ENTRY_ID, PERSON_ID and COMPANY_ID mean: no filter. If only individual members are affected, enter the values there.

How to proceed

  1. Open Settings → Import (Einstellungen → Import).
  2. Click Add (Hinzufügen) and select the file.
  3. Wait until the entry in the list is green. The list updates itself.
  4. Read the log. Every row with Error: was not taken over.

Good to know

  • What is switched: The old product is replaced by the new one in the entry. This applies to the fee, a reduction, a passive membership and a fee-free period, if the old product is there.
  • With a date: The old entry ends on the day before the date. A new entry with the new product starts on the date. An entry that only starts after the date simply receives the new product. An entry that ends before the date remains unchanged.
  • Repeated import: You may upload the same file again. Entries that have already been switched remain unchanged.
  • Without a filter: If person, account, age and entry number are all missing, a row affects all matching memberships in the system. Check this beforehand.
  • Afterwards: vynst updates the subscriptions that result from the memberships in the background.

When something does not work

Message in the log Meaning What to do
Error: skipped missing product identifier The old or new product is missing in the row Fill in both product columns
Error: skipped missing product in db One of the products is not known in vynst Check the number, import the product first
Error: skipped missing logbook entry in db The vynst number of the entry does not exist Check the number
Error: skipped empty line Empty row Nothing to do, or delete the row
INFO: created 3 new entries With a date, 3 new entries were created For checking only
Read: 12 rows This many rows were read Nothing to do
Error: less then one line The file contains no data row Check the file
FAILED: User missing rights to import. You lack a right for CRM or products Ask an administrator

See also