Zum Inhalt springen
Developer

Produkte (einfach)

Ihr legt Beitragsprodukte mit wenigen Angaben an oder aktualisiert sie über dieselbe Produktnummer.

Format
CSV (Semikolon oder Komma), UTF-8
Rechte
Administrator, Schreibrecht Produkte
Beispieldateien
AFS_PRODUCT_beispiel_technisch.csv (technische Spaltennamen)
AFS_PRODUCT_beispiel_anwender.csv (deutsche Spaltennamen)

Kurz gesagt: Eine Tabelle mit Produktnummer, Name und Preis genügt. Gleiche Nummern aktualisieren vorhandene Produkte, neue Nummern legen Produkte an.

Wofür ihr das braucht

Zum Start eurer Beiträge in vynst braucht ihr oft nicht alle Einstellungen eines Produkts. Diese Datei übernimmt die wichtigsten Angaben. Für alle Einstellungen gibt es den Import Produkte (vollständig).

Bevor ihr startet

  • Rechte: Ihr braucht die Rolle Administrator mit Schreibrecht für Produkte.
  • Optional vorher importiert: Sparten, wenn ihr die Sparten-ID mitgebt. Angebote und Räume, wenn ihr sie verknüpfen wollt. Konten, wenn ihr eine Kontonummer mitgebt.
  • Sicherung: Der Import lässt sich nicht auf Knopfdruck zurücknehmen. Zieht vorher unter Einstellungen → Export einen Export der Produkte.

Datei vorbereiten

  • Dateiname: Muss AFS_PRODUCT_ und .csv enthalten, zum Beispiel AFS_PRODUCT_beitraege.csv.
  • Kopfzeile: Produktnummer, Name und Preis müssen vorkommen. Keine dieser Spalten darf die letzte Spalte sein.
  • Trennzeichen: Semikolon oder Komma. Nehmt dasselbe Zeichen in der ganzen Datei.
  • Preise: Standard ist der Punkt als Dezimaltrenner, also 12.50. Mit der Spalte PRICE_FORMAT und dem Wert de sind auch 12,50 und 1.234,50 erlaubt.
  • Datum: Dieser Import braucht kein Datum.

Spalten

Spalte Pflicht Inhalt Beispiel
Produkt-ID (PRODUCT_IDENTIFIER) ja Eure Nummer des Produkts. Auch erlaubt: Produkt ID, Produkt. ERW
Produktname (PRODUCT_NAME) ja Name, der auf Rechnungen steht. Auch erlaubt: Produkt Name. Erwachsene
Preis (PRICE) für die Erkennung nötig Festpreis. Eine leere Zelle lässt den Preis eines bestehenden Produkts unverändert. Auch erlaubt: Preis in €, FIXED_PRICE. 12.00
Bruttopreis (PRICE_BRUTTO) oder Nettopreis (PRICE_NETTO) Alternative zum Preis Eine dieser Spalten setzt den Preis und die Preisart. Auch erlaubt: Preis (brutto), Bruttopreis, Preis (netto), Nettopreis.
Preisart (PRICE_TYPE, Preisart) nein Brutto oder Netto, gilt für die Spalte Preis. Auch erlaubt: priceType. Brutto
PRICE_FORMAT nein de, wenn Preise mit Komma geschrieben sind. Standard ist en. Auch erlaubt: NUMBER_FORMAT. en
Einkaufspreis (BUYING_PRICE) nein Einkaufspreis. Auch erlaubt: Einkaufs-Preis, Einkaufspreis in €. 6.50
Abrechnungsart (BILLING_TYPE) nein subscription für wiederkehrende Beiträge, fixed für einmalige Beträge. Auch erlaubt: billingType. subscription
Abrechnungsintervall (RECURRENCE) nein 1 month, 3 month, 6 month oder 1 year. Auch monatlich, quartalsweise, halbjährlich und jährlich werden erkannt. Auch erlaubt: Abrechnungszeitraum. 1 month
RECURRENCE_MERGE_MODE nein Auswahl, wenn mehrere Intervalle angegeben sind. Standard ist MIN. MIN
Sparten-ID (UNIFIED_CATEGORY_IDENTIFIER) nein Sparte aus dem Sparten-Import. Mehrere Sparten trennt ihr mit |~|. Auch erlaubt: Sparte, Kategorie-ID. FB
COMPANY_IDENTIFIER nein Konto, über das das Produkt läuft K-1001
IMPORT_IDENTIFIER_PREFIX nein Vorsatz für die interne Kennung des Produkts. Standard ist AFS_CSV_. AFS_CSV_
Interne Beschreibung (INTERNAL_DESCRIPTION) nein Beschreibung nur für euch. Auch erlaubt: Interne-Beschreibung. Standardbeitrag Erwachsene
Externe Beschreibung (EXTERNAL_DESCRIPTION) nein Beschreibung für Mitglieder. Ist sie leer, wird der Produktname verwendet. Auch erlaubt: Beschreibung. Monatsbeitrag für Erwachsene
ACCESS_TAG_IDENTIFIERS nein Zugriffsmarken, mehrere mit |~| trennen. Eine leere Zelle entfernt alle Zugriffsmarken.
CONDITION_ACCESS_TAG_IDENTIFIER nein Zugriffsmarke als Bedingung
CONDITION_FREE_LOGIC nein Bedingung für die Beitragsfreiheit. Leer entfernt sie.
BASE_EVENT_IDENTIFIER nein Angebot, zu dem das Produkt gehört. Angebote werden später importiert, daher ist die Spalte hier leer.
BASE_BOOKABLE_IDENTIFIER nein Raum, zu dem das Produkt gehört. Räume werden später importiert, daher ist die Spalte hier leer.

Beispiel

PRODUCT_IDENTIFIER;PRODUCT_NAME;PRICE;PRICE_TYPE;PRICE_FORMAT;BUYING_PRICE;BILLING_TYPE;RECURRENCE;RECURRENCE_MERGE_MODE;UNIFIED_CATEGORY_IDENTIFIER;COMPANY_IDENTIFIER;IMPORT_IDENTIFIER_PREFIX;INTERNAL_DESCRIPTION;EXTERNAL_DESCRIPTION;ACCESS_TAG_IDENTIFIERS;CONDITION_ACCESS_TAG_IDENTIFIER;CONDITION_FREE_LOGIC;BASE_EVENT_IDENTIFIER;BASE_BOOKABLE_IDENTIFIER
ERW;Erwachsene;12.00;Brutto;en;6.50;subscription;1 month;MIN;FB;K-1001;AFS_CSV_;Standardbeitrag Erwachsene;Monatsbeitrag für Erwachsene;;;;;
JUG;Jugend;8.00;Brutto;en;4.00;subscription;1 month;MIN;FB-JUG;K-1003;AFS_CSV_;Beitrag Jugend bis 17 Jahre;Monatsbeitrag für Jugendliche;;;;;
FAM;Familie;25.00;Brutto;en;12.50;subscription;1 month;MIN;;;AFS_CSV_;Familienbeitrag;Monatsbeitrag für Familien;;;;;

Beispieldateien: AFS_PRODUCT_beispiel_technisch.csv mit den technischen Spaltennamen, AFS_PRODUCT_beispiel_anwender.csv mit den deutschen Spaltennamen.

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

  • Erneuter Import: Eine bekannte Produktnummer aktualisiert das Produkt. Eine neue Nummer legt ein neues Produkt an.
  • Sparten: Ist die Sparten-Spalte in der Datei vorhanden, ersetzt vynst die Sparten des Produkts. Eine leere Zelle entfernt alle Sparten.
  • Leere Zellen bei Name und Produktnummer führen zu einer übersprungenen Zeile. Bei anderen Feldern bleibt der bisherige Wert eines bestehenden Produkts erhalten.
  • Komma im Preis ohne PRICE_FORMAT: Steht 12,50 in der Datei und fehlt die Spalte PRICE_FORMAT mit de, liest vynst nur den Teil vor dem Komma.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped missing identifier or name Produktnummer oder Name fehlt. Darunter steht die Zeile als LINE-DATA. Beide Angaben ausfüllen
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: No matching processor found. Dateiname oder Kopfzeile passen zu keinem Import AFS_PRODUCT_ im Dateinamen und die Spaltennamen prüfen
FAILED: User missing rights to import. Euch fehlt das Recht für Produkte Administrator fragen

Siehe auch