Zum Inhalt springen
edoobox Docs

Suchen Sie nach einer Aufgabe oder einem Thema, z. B. Rechnung oder Warteliste.
Kostenlos testen 7 Tage unverbindlich testen
Menü
Kostenlos testen 7 Tage unverbindlich testen

Alle Platzhalter für E-Mails und PDFs

Direkt nachschlagen: Platzhalter nach Vorlage und Gruppe filtern. Die Referenz enthält auch Abo-, Mahn-, Ticket- und eigene Vorlagenkontexte.

Alle Platzhalter für E-Mails und PDFs
ASprachvariante der VorlageBPlatzhalter der aktuellen VorlageCPlatzhaltergruppe BuchungDBetreff mit Angebots- und TerminplatzhalternENachricht mit Teilnehmer- und Buchungsplatzhaltern

Platzhalter verbinden eine E-Mail- oder PDF-Vorlage mit den Daten des aktuellen Vorgangs. Beim Versand ersetzt edoobox beispielsweise ##UserFirstname##, ##OfferName## oder ##InvoiceNumber## durch die Werte der betreffenden Person, Buchung, Rechnung oder Veranstaltung.

Die wichtigste Regel lautet: Die Platzhalterauswahl der geöffneten Vorlage ist die verbindliche Liste für diesen Kontext. Nicht jede Vorlage kennt Angebot, Buchung, Rechnung oder Ticket. Ein korrekt geschriebener Platzhalter kann deshalb in einer anderen Vorlage leer bleiben.

Platzhalter sicher einfügen

  1. Öffnen Sie unter Einstellungen → E-Mail → Vorlagen genau die E-Mail oder den PDF-Anhang, den Sie bearbeiten möchten.

  2. Wählen Sie zuerst die Sprache. Platzhalter bleiben gleich, der umgebende Text wird pro Sprache gepflegt.

  3. Fügen Sie den Eintrag über das Menü Platzhalter ein. Dadurch vermeiden Sie Tippfehler und sehen nur die Gruppen, die für diese Vorlage vorgesehen sind.

  4. Verändern Sie Gross-/Kleinschreibung, Unterstriche, eckige Klammern und Doppelrauten nicht.

  5. Erzeugen Sie eine Vorschau und führen Sie zusätzlich einen echten Testvorgang aus. Die Vorschau verwendet Demodaten und deckt leere oder besondere Kundendaten nicht vollständig ab.

Nicht blind zwischen Vorlagen kopieren: Eine Buchungsbestätigung besitzt andere Daten als eine Rechnung, Mahnung, ICS-Datei oder manuelle Nachricht. Kopieren Sie komplexe Blöcke nur, wenn die benötigten Platzhalter auch im Zielmenü vorhanden sind.

Gemeinsame Platzhaltergruppen

Der V2-Editor ordnet verfügbare Werte in Aktuelle Vorlage, Buchung, Angebot, Teilnehmer und Organisation. Welche Gruppen erscheinen, hängt von der Vorlage ab.

GruppeAktuelle gemeinsame Platzhalter
Organisation##CompanyName##, ##CompanyContactPerson##, ##Shortcuts##, ##Street##, ##ZipCode##, ##ZipCity##, ##CompanyCountry##, ##Phone##, ##WebsiteURL##, ##Femail##
Angebot##OfferName##, ##OfferNumber##, ##OfferURL##, ##OfferURLTagFilter##, ##MinimumMember##, ##MaximumMember##, ##RegisteredMember##, ##OfferStartDate##, ##OfferStartTime##, ##OfferEndDate##, ##OfferEndTime##, ##OfferStartendDate##, ##WeekNumber##, ##Deadline##, ##OfferType##, ##OfferTypes##, ##OfferStatus##, ##Room_first_module##, ##Location_first_module##, ##Teacher_first_module##, ##Teacher_first_module_email##, ##OfferConfirmationText1## bis 3, ##LessonBooking##, ##OfferCurrency##
Buchung##BookingNumber##, ##BookingDate##, ##BookingAmountNegative##, ##BookingAmountPositive##, ##UserAccessURL##, ##UserAnnulmentURL##, ##EventReservationJsonLD##
Teilnehmer##Title1##, ##Title2##, ##UserFullName## sowie die im Konto sichtbaren Standard- und eigenen Teilnehmerfelder.

##Title1## und ##Title2## erzeugen eine zur gespeicherten Anrede passende Begrüssung. Verwenden Sie für neue Vorlagen bevorzugt diese Anrede-Platzhalter statt fest eingebauter Formulierungen für Frau oder Herr.

Standardfelder und eigene Teilnehmerfelder

Für sichtbare Standardfelder erzeugt edoobox unter anderem ##UserSalutation##, ##UserFirstname##, ##UserLastname##, ##UserStreet##, ##UserZipcode##, ##UserTown##, ##UserPhone##, ##UserEmail##, ##UserCountry##, ##UserLanguage## und ##UserCompany##.

Eigene Teilnehmerfelder erhalten den Präfix User. Leerzeichen und Sonderzeichen werden entfernt, nicht übersetzt. Aus Mitgliedernummer wird ##UserMitgliedernummer##; aus ältere Nummer wird technisch ##UserltereNummer##, weil ä entfernt wird. Wählen Sie den Platzhalter deshalb immer im Menü, statt ihn aus dem Feldnamen zu erraten.

Nur Teilnehmerfelder, die in der Datenstruktur des Kontos sichtbar sind, werden in die Auswahl aufgenommen. Ein leerer Wert führt in der Ausgabe zu einer leeren Stelle; bauen Sie bei optionalen Feldern mit IF eine passende Alternative.

Buchungsbestätigung, Booking.pdf, Ticket und ICS

VorlageWichtige vorlagenspezifische Werte
Bestätigungs-MailTitleName, UserAccess, LoginURL, mehrere Varianten von OfferAllBookedModules, OfferAllBookedOffers mit NoPrice und NoOfferNumber sowie MobileWalletTickets und die einzelnen Wallet-URLs.
Booking.pdf AnmeldungBookingTime, DateNow, BookingPart mit Attributen wie Gender, DurationDaysHours, DistinctDays, NoPrices, NetAmountAndVATAdded, NoUsers, NoTime, NoWeekDays und NoWeekDay; dazu Rechnungsadresse, BookingTemplateType und OfferAllBookedOffers.
Booking.pdf WartelisteEntspricht weitgehend Booking.pdf, enthält zusätzlich Watermark; ein Ticket oder eine normale Buchungsbestätigung darf daraus nicht abgeleitet werden.
Ticket.pdfTicketCode, TicketNumber, TicketNumberTotal, TicketPriceCategory, Wallet-Platzhalter und Barcodevarianten wie TicketDataMatrix*120px*P.
Termine ICS-DateiDateDescription, PlaceLat, PlaceLong, PlaceName, PlaceAddress, StartDate, EndDate, StartTime, EndTime.

Attribute in eckigen Klammern werden innerhalb der Doppelrauten geschrieben. Mehrere Attribute sind kommagetrennt möglich, beispielsweise ##OfferAllBookedOffers[NoPrice,NoOfferNumber]##. Weitere Details zum Rechnungslisten-Platzhalter finden Sie unter Rechnung.pdf bearbeiten.

Rechnung und Zahlung

Rechnungs- und Zahlungsvorlagen besitzen eigene Platzhalter für Beleg, Betrag, Zahlungsangaben und Buchungsbezug. Verwenden Sie für die klassische Vorlage Zahlungserinnerung Mail nur Werte, die deren Platzhalter-Menü tatsächlich anbietet.

Nicht zwischen Vorlagen raten: Platzhalter aus früheren oder anderen Vorlagen dürfen nicht ungeprüft in die Zahlungserinnerung übernommen werden. Massgebend ist immer das Platzhalter-Menü der konkret bearbeiteten Vorlage.

Warteliste, MustPay und Anfrageliste

  • Warteliste Anfrage Mail: ##WaitinglistOfferName## und ##BookingURL##.

  • MustPay Anmeldung abschliessen: ##UserName##, ##UserEmail##, ##BookingURL## und ##DeleteURL##.

  • Anfrage-Liste Mail: ##OfferlistFeedbackURL##, ##OfferlistValidityDate##, ##OfferlistSecondMailExists## und ##OfferlistSecondMailNumber##.

  • Anfrage-Liste Erinnerung und Absage: Feedback-URL und Gültigkeitsdatum.

  • Booking.pdf Anfrageliste: kombiniert Anfragelistenwerte mit den passenden Booking.pdf-Werten und Watermark.

Stornierung, Präsenz und Zertifikat

VorlageWichtige vorlagenspezifische Werte
Stornierung beantragt / StornobestätigungCancellationRules, CancellationFeeAmount, CancellationFeeOpenAmount, CancellationFeeStatus, CancellationRefundAmount, CancellationRefundInfo, CancellationInvoiceInfo, CancellationRequestDate, CancellationRequestReason.
Besuchsbestätigung / Nicht-Besuchs-MitteilungVisitingTimesPercent, VisitingTimesHourMinute, OfferTotalTime, DateNow und VisitingTimesNumber0 bis 7.
Zertifikat.pdfZusätzlich CertificateValidationUrl, CertificateValidationQR, CertificateNumber, LeaderSignature und Varianten von OfferAllBookedOffers.

Tags, Wert-Tags, Bedingungen und Schleifen

Einige leistungsfähige Variablen werden manuell in Bedingungen oder Schleifen verwendet und erscheinen nicht in jeder normalen Platzhalterliste:

  • OfferTags enthält die Namen der am aktuellen Angebot verknüpften Tags. Verwenden Sie es mit IN oder NOTIN.

  • UserTags enthält wirksame normale Tags der Person aus nicht als Warteliste geführten Buchungen, direkt am Benutzer gepflegten Tags und SAML-Zuordnungen.

  • ##Tag[InternerCode]## gibt den gespeicherten Wert eines Angebotstags mit diesem exakten Namen aus. Mehrere Werte werden kommasepariert ausgegeben.

  • {EACH?BookingUsers} wiederholt einen Block für Buchungsteilnehmende. Darin stehen ##Id##, ##Salutation##, ##Firstname##, ##Lastname##, ##Email## und ##Pricecategory## zur Verfügung.

  • {EACH?OfferLeaders} wiederholt einen Block für Leitungspersonen. Je nach benötigtem Inhalt stehen ##name##, ##leaderemail##, ##leadername##, ##leaderavatar## und ##leaderavatarurl## bereit.

Syntax, Operatoren und einsatzfertige Beispiele stehen unter E-Mail-Vorlagen mit IF und EACH individualisieren. Positive und negative Tag-Bedingungen eines Angebots steuern dagegen, wer buchen darf; sie sind nicht dasselbe wie die Ausgabe von OfferTags oder UserTags.

Platzhalter in einer manuellen E-Mail

Eine manuelle Nachricht an ein ausgewähltes Teilnehmerprofil kann sichtbare Teilnehmerfelder und Anreden verwenden. Der V2-Dialog wählt Empfänger aus vorhandenen Teilnehmern, Admins oder Angeboten; er ist kein frei adressierbarer Versand an beliebig eingetippte Adressen. Eine Nachricht an ein Adminprofil besitzt nicht automatisch dieselben Teilnehmerfelder.

Bei Auswahl eines Angebots werden dessen passende Teilnehmer aufgelöst und Angebotsdaten können verfügbar sein. Eine konkrete Buchungsnummer oder Rechnungsdaten entstehen dadurch nicht automatisch. Verwenden Sie dafür die E-Mail-Aktion des entsprechenden Buchungs- oder Rechnungsprozesses. Die Schritte erklärt Manuelle E-Mails an Profile und Angebote senden.

Die praktischen Beispiele erklären Kursleitung, Signatur und kursabhängiges Zusatzlogo, Themenbereiche als eigene Angebotswerte und einen Teilnahmenachweis für Arbeitgeber oder Bildungsurlaub. Verwenden Sie dafür die jeweils erläuterten Standardwerte und selbst gepflegten Angebotstags.

Prüfplan für Änderungen

  • Je Vorlage einen Fall mit gefüllten und einen mit leeren optionalen Feldern testen.

  • Bei mehreren Sprachen jede Sprachvariante separat erzeugen.

  • Bei Sammelbuchungen eine und mehrere Personen sowie unterschiedliche Preiskategorien prüfen.

  • Bei Rechnungen offenen, teilweise bezahlten und stornierten Zustand vergleichen.

  • Bei Tags einen passenden und einen nicht passenden Fall testen; Schreibweise und Tagwert exakt kontrollieren.

  • Im Postausgang Betreff, Empfänger, Inhalt und Anhänge prüfen.

Anwendungsbeispiel: Sammelbuchung mit Personen und Tarifen

Eine Firma meldet mehrere Mitarbeitende an. In Booking.pdf listet {EACH?BookingUsers} Name, E-Mail und Preiskategorie pro Person. In Rechnung.pdf zeigt ##InvoiceListing[User,PricecategoryDetail]## dieselbe Zuordnung für die Buchhaltung.

Anwendungsbeispiel: Webinar mit Tagwert

Das Angebot besitzt den normalen Tag Format mit dem Wert Teams und den Tag Zugangslink mit einer Demo-URL. Die Bestätigung gibt ##Tag[Format]## und ##Tag[Zugangslink]## aus. Eine IF-Bedingung zeigt diesen Block nur, wenn OfferTags den erwarteten Tag enthält.

Anwendungsbeispiel: Zertifikat mit Validierung

Ein Anbieter ergänzt Zertifikatsnummer, Validierungs-QR, Leitungssignatur und Anwesenheitsprozent in Zertifikat.pdf. Zwei Testpersonen mit ausreichender und ungenügender Präsenz zeigen, ob Zertifikat, Nicht-Besuchs-Mitteilung und Validierungslink korrekt zusammenspielen.

Die Referenz für Ihre Vorlage verwenden

Die Referenz am Seitenende enthält alle fest definierten Einträge des Vorlagenkatalogs sowie die zusätzlich belegten Schleifen, Tagbedingungen und Formatvarianten. Suchen Sie nach einem Namen wie Membership, Dunning, BookingPart oder TicketBookedSchedule und wählen Sie danach die betreffende Vorlage. Die Einträge bleiben auch ohne JavaScript lesbar.

Kontoeigene Teilnehmerfelder und selbst angelegte Vorlagen entstehen aus Ihrer Konfiguration. Deren vollständige konkrete Namen zeigt Ihr Editor. Ein Standardfeld wird nur angeboten, wenn es in der Teilnehmer-Datenstruktur sichtbar ist. Ein Kontext in der Referenz bedeutet, dass die betreffende Vorlage diese Daten verwenden kann; eine einzelne Nachricht kann trotzdem leere Werte enthalten.

Abonnemente und Mahnwesen

Die Abo-Verlängerungserinnerung besitzt eigene Werte für Name, Gültigkeit, Restnutzungen, Verlängerungsbeginn, Preis, Währung, Steuer, Kündigungsdatum und persönliche Aktionslinks. Sie hat Teilnehmer- und Organisationsdaten, aber keinen allgemeinen Angebots- oder Buchungskontext. Die Anleitung zur Abo-Mail erklärt jeden der 13 Abo-Werte und optionale Links.

Das Mahnungswesen verwendet eigene Vorlagen für Zahlungserinnerung, Mahnung und Mahnung Post (PDF). Die Dunning…-Werte umfassen unter anderem Mahnstufe, Referenz, Zahlungsziel, offenen Betrag, Mahngebühr, Gesamtbetrag, Zahlungslink und betroffene Buchungen. Die klassische manuelle Zahlungserinnerung verwendet dagegen die Account…-Werte ihrer eigenen Vorlage. Wählen Sie in der Referenz den passenden Prozess, bevor Sie Inhalte übernehmen.

Listen, Wallet und Datumsfelder gezielt gestalten

Die detaillierten Varianten und Kombinationen für Buchungsblöcke, Terminlisten, Tickets, Wallet und Rechnungen finden Sie in Platzhaltervarianten für Buchungen, Tickets und Rechnungen. Eigene Datumsfelder lassen sich beispielsweise mit ##UserGeburtsdatum[d.m.Y]## formatieren; Voraussetzung ist ein sichtbares Teilnehmerfeld vom Typ Datum. Siehe Teilnehmer-Datumsfelder formatieren.

Leitungskontakte können mit ##Teacher_first_module_email## für den ersten relevanten Termin oder mit ##leaderemail## innerhalb von {EACH?OfferLeaders} ausgegeben werden. Eine Leitung ohne E-Mail bleibt in der Liste und liefert für die Adresse einen leeren Wert.

Tagwerte mit geeigneten Namen ausgeben

Bei ##Tag[Name]## unterstützt die Attributschreibweise lateinische Buchstaben A–Z/a–z, Ziffern, Leerzeichen sowie Unterstrich, Doppelpunkt, Schrägstrich, Punkt und Bindestrich. Verwenden Sie für solche Ausgabetags beispielsweise Zugangslink oder Interner_Code. Ein Umlaut, ein kaufmännisches Und oder eckige Klammern im Tagnamen passen nicht zu dieser Schreibweise.

Kommas trennen mehrere Tagnamen: ##Tag[Plattform,Zugangslink]## führt vorhandene Werte zusammen. Ein Komma ist deshalb kein eindeutiger Bestandteil eines einzelnen Ausgabetagnamens. Die Namen in einer OfferTags IN-Bedingung sind eine getrennte Listenprüfung.

Persönlichen Promotionscode erzeugen

Öffnen Sie die gewünschte Promotionskampagne und übernehmen Sie aus deren Übersicht den angezeigten Platzhalter ##Promotion[…]## vollständig. Er enthält die Kennung Ihrer eigenen Kampagne. Beim Auswerten wird ein neuer aktiver Code für diese Kampagne erzeugt. Er ist kein Platzhalter zum blossen Anzeigen eines bereits bestehenden Gutscheinverkaufs.

Verwenden Sie die aktuelle Schreibweise aus Ihrer Kampagne und keine erfundene Kennung. Auch eine erneute Auswertung oder Vorschau kann neue Codes erzeugen. Prüfen Sie den Ablauf mit einer dafür vorgesehenen Demo-Kampagne. Die älteren Schreibweisen ##PROMOCODE*…## sind Kompatibilitätsvarianten und werden für neue Inhalte nicht benötigt.

Verwandte Anleitungen

Zusatztexte in Multi-Angebotsbuchungen

Für Bestätigungen und Zertifikate mit Multi-Angebotskontext existieren zusätzlich ##OfferConfirmationTextMultiOffers1##, ##OfferConfirmationTextMultiOffers2## und ##OfferConfirmationTextMultiOffers3##. Sie führen die entsprechenden Zusatztexte der ausgewählten Angebote zusammen. Verwenden Sie diese Spezialwerte nur im passenden Multi-Angebotsablauf und prüfen Sie eine Buchung mit mehreren Angeboten. Einzelne Angebotsinformationen werden weiterhin über OfferConfirmationText1 bis 3 ausgegeben.
Cookies & Datenschutz
Notwendig

Für Sicherheit, Navigation, Formulare und den technischen Betrieb der Website.

Immer aktiv
Datenschutzerklärung