Skip to content
Developer

Invitations

Invite external persons to an offer, with name, contact details and a personal message.

Format
CSV (semicolon or comma)
Access rights
Write access to events
Example files
Einladungen_beispiel_technisch.csv (technical column names)
Einladungen_beispiel_anwender.csv (German column names)

In short: You enter persons who are not in the member list, and the course ID of the offer they are invited to. vynst creates an invitation for each row.

What you need this for

Some offers are aimed at guests, for example taster courses or trial sessions for interested people. These persons have no entry in the member list. With this import you take over the invitations from a list, for example from an Excel file from registration.

Before you start

  • You need the right Imports (menu item Import) and write access for events (Schreibrecht Veranstaltungen).
  • An administrator right is not required for this import.
  • The offer must already exist in vynst. Import it beforehand via the import Offers and courses (Angebote und Kurse). Enter the course ID from that table in the column EVENT_IDENTIFIER.

Prepare the file

  • Format: CSV with semicolon ; or comma , as separator. Excel files must be saved as CSV beforehand.
  • Header row: The first four columns are EVENT_INVITE_IDENTIFIER, EVENT_IDENTIFIER, FIRST_NAME and LAST_NAME, in this order. The header row may be enclosed in quotation marks if you separate with commas.
  • File name: It must contain .csv. Names such as Einladungen_Schnupperkurs.csv work well.

Columns

Column Required Content Example
Einladungsnummer (EVENT_INVITE_IDENTIFIER) yes (header row) The number of the invitation. Leave it empty for new invitations. empty
Kurs-ID (EVENT_IDENTIFIER) yes Course ID of the offer K-YOGA
Vorname (FIRST_NAME) yes First name (or LAST_NAME filled in) Anna
Nachname (LAST_NAME) yes Last name (or FIRST_NAME filled in) Beispiel
Geschlecht (GENDER) Gender, taken over as written weiblich
E-Mail (MAIN_EMAIL) Email address of the person. Also accepted: Email, E-Mail-Adresse. anna@example.org
Telefon (MAIN_PHONE) Phone number 0171 2345678
Website (MAIN_WEBSITE) Internet address. Also accepted: Webseite, Homepage. https://example.org
Nachricht (MESSAGE) personal message for the invitation Wir freuen uns auf dich.

Each row needs a course ID and at least one name. Without a course ID or without names, the row is skipped.

Example

The example file shows the technical column names. The file with the German column names uses the German names for email, phone and website and invites other guests.

EVENT_INVITE_IDENTIFIER;EVENT_IDENTIFIER;FIRST_NAME;LAST_NAME;GENDER;MAIN_EMAIL;MAIN_PHONE;MAIN_WEBSITE;MESSAGE
;K-YOGA;Sophie;Gast;weiblich;sophie.gast@example.org;0171 2345678;https://example.org;Schnupperstunde zum Start
;K-YOGA;Tom;Probe;männlich;tom.probe@example.org;;;

Example files: Einladungen_beispiel_technisch.csv with the technical column names, Einladungen_beispiel_anwender.csv with the German column names.

Sophie Gast and Tom Probe are invited to the offer K-YOGA. The column EVENT_INVITE_IDENTIFIER stays empty because these are new invitations. For Tom the message, phone and website are missing, which is allowed. The file with the German column names invites Lena Gast and Paul Probe. This way, both files create no duplicates if you import them one after the other.

How to proceed

  1. Open Settings → Import (Einstellungen → Import).
  2. Click Add (Hinzufügen) and select the file.
  3. Check the log for Error: lines. The rows with errors appear below it as LINE-DATA.

Good to know

  • Each row creates a new invitation. A second import of the same file therefore does not create duplicates, because vynst recognises an invitation as a duplicate and skips it.
  • An invitation to the same offer with the same first name, last name and gender counts as a duplicate. The same email address with the same name also counts as a duplicate.
  • This import does not change existing invitations. If you want to change an invitation, do it directly in vynst.
  • The message and the contact details are stored only in the invitation. A person is not created in the member list as a result.

When something does not work

Message in the log Meaning What to do
Error: skipped empty line An empty row was skipped. Nothing.
Error: skipped missing event or name Course ID or both names are missing. The row appears below as LINE-DATA. Complete the row and re-import only this row.
Error: skipped missing event vynst does not know the course ID. The row appears below as LINE-DATA. Check the course ID against the offer. If the offer is missing, import it first.
Error: not possible to update existing data yet The row already has an invitation number. Changing is not possible through this import. Empty the invitation number in the row if the person is to be invited again.
Found existing data: <Nummer> The invitation with this number exists in vynst. It remains unchanged. Nothing.
Error: skipped duplicate The person is already invited to this offer. The row appears below as LINE-DATA. Nothing, or delete the row if it is not needed.
Read: 12 rows This many rows were read. Nothing.
Error: less then one line The file contains no data row. Check whether the file is complete.
FAILED: No matching processor found. File name or header row does not match any import. Check the file name and the first four columns.

See also