Aller au contenu
edoobox Docs

Recherchez une tâche ou un sujet, par exemple facture ou liste d’attente.
Essayer gratuitement 7 jours d’essai sans engagement
Menu
Essayer gratuitement 7 jours d’essai sans engagement

Toutes les variables de remplacement pour les e-mails et les PDF

Recherche directe : Filtrer les variables de remplacement par modèle et par groupe. La référence contient également les contextes de modèles d'abonnement, de relance, de billet et de modèles personnalisés.

Toutes les variables de remplacement pour les e-mails et les PDF
AVariante linguistique du modèleBVariables de remplacement du modèle actuelCGroupe de variables de remplacement RéservationDObjet avec variables de remplacement pour l'offre et le créneau horaireEMessage avec variables de remplacement pour les participants et la réservation

Les variables de remplacement associent un modèle d'e-mail ou de PDF aux données du processus en cours. Lors de l'envoi, edoobox remplace par exemple ##UserFirstname##, ##OfferName## ou ##InvoiceNumber## par les valeurs de la personne, de la réservation, de la facture ou de l'événement concerné.

La règle essentielle est la suivante : la sélection de variables de remplacement du modèle ouvert constitue la liste de référence pour ce contexte. Tous les modèles ne disposent pas des données d’offre, de réservation, de facture ou de billet. Une variable de remplacement correctement écrite peut donc rester vide dans un autre modèle.

Insérer les variables de remplacement en toute sécurité

  1. Ouvrez sous Paramètres → E-mail → Modèles exactement l'e-mail ou la pièce jointe PDF que vous souhaitez modifier.

  2. Choisissez d'abord la langue. Les variables de remplacement restent les mêmes, le texte environnant est géré par langue.

  3. Insérez l'entrée via le menu Variables de remplacement. Vous évitez ainsi les fautes de frappe et ne voyez que les groupes prévus pour ce modèle.

  4. Ne modifiez pas la casse, les soulignements, les crochets et les doubles dièses.

  5. Générez un aperçu et effectuez en plus une procédure de test réelle. L'aperçu utilise des données de démonstration et ne couvre pas entièrement les données de client vides ou spéciales.

Ne copiez pas les blocs sans vérification entre les modèles : une confirmation de réservation dispose de données différentes d’une facture, d’une relance, d’un fichier ICS ou d’un message manuel. Copiez les blocs complexes uniquement si les variables de remplacement nécessaires figurent aussi dans le menu du modèle cible.

Groupes de variables de remplacement communs

L'éditeur V2 classe les valeurs disponibles en Modèle actuel, Réservation, Offre, Participants et Organisation. Les groupes affichés dépendent du modèle.

GroupeVariables de remplacement communes actuelles
Organisation##CompanyName##, ##CompanyContactPerson##, ##Shortcuts##, ##Street##, ##ZipCode##, ##ZipCity##, ##CompanyCountry##, ##Phone##, ##WebsiteURL##, ##Femail##
Offre##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## à 3, ##LessonBooking##, ##OfferCurrency##
Réservation##BookingNumber##, ##BookingDate##, ##BookingAmountNegative##, ##BookingAmountPositive##, ##UserAccessURL##, ##UserAnnulmentURL##, ##EventReservationJsonLD##
Participant##Title1##, ##Title2##, ##UserFullName## ainsi que les champs de participants standard et personnalisés visibles dans le compte.

##Title1## et ##Title2## génèrent une salutation adaptée à la forme d'appel enregistrée. Pour les nouveaux modèles, utilisez de préférence ces variables de remplacement de forme d'appel plutôt que des formulations fixes pour Madame ou Monsieur.

Champs standard et champs de participants personnalisés

Pour les champs standard visibles, edoobox génère notamment ##UserSalutation##, ##UserFirstname##, ##UserLastname##, ##UserStreet##, ##UserZipcode##, ##UserTown##, ##UserPhone##, ##UserEmail##, ##UserCountry##, ##UserLanguage## et ##UserCompany##.

Les champs personnalisés des participants reçoivent le préfixe User. Les espaces et caractères spéciaux sont supprimés, sans traduction. Mitgliedernummer devient ##UserMitgliedernummer## ; ältere Nummer devient techniquement ##UserltereNummer##, car le caractère ä est supprimé. Choisissez donc toujours la variable de remplacement dans le menu au lieu de la deviner d’après le nom du champ.

Seuls les champs de participants visibles dans la structure de données du compte sont inclus dans la sélection. Une valeur vide entraîne une place vide dans la sortie ; pour les champs facultatifs, construisez une alternative appropriée avec IF.

Confirmation de réservation, Booking.pdf, billet et ICS

ModèleValeurs importantes spécifiques au modèle
E-mail de confirmationTitleName, UserAccess, LoginURL, plusieurs variantes de OfferAllBookedModules, OfferAllBookedOffers avec NoPrice et NoOfferNumber ainsi que MobileWalletTickets et les URL de portefeuille individuelles.
Booking.pdf InscriptionBookingTime, DateNow, BookingPart avec des attributs tels que Gender, DurationDaysHours, DistinctDays, NoPrices, NetAmountAndVATAdded, NoUsers, NoTime, NoWeekDays et NoWeekDay ; ainsi que l'adresse de facturation, BookingTemplateType et OfferAllBookedOffers.
Booking.pdf Liste d’attenteCorrespond largement à Booking.pdf, contient en plus Watermark ; un billet ou une confirmation de réservation normale ne doit pas en être dérivé.
Ticket.pdfTicketCode, TicketNumber, TicketNumberTotal, TicketPriceCategory, variables de remplacement de portefeuille et variantes de code-barres telles que TicketDataMatrix*120px*P.
Fichier ICS des séancesDateDescription, PlaceLat, PlaceLong, PlaceName, PlaceAddress, StartDate, EndDate, StartTime, EndTime.

Les attributs entre crochets s’écrivent à l’intérieur des doubles dièses. Vous pouvez combiner plusieurs attributs séparés par des virgules, par exemple ##OfferAllBookedOffers[NoPrice,NoOfferNumber]##. Pour plus de détails sur la variable de remplacement de la liste des factures, consultez Modifier Rechnung.pdf.

Facture et paiement

Les modèles de facture et de paiement possèdent leurs propres variables de remplacement pour le justificatif, le montant, les informations de paiement et la référence de réservation. Utilisez pour le modèle classique Rappel de paiement e-mail uniquement des valeurs que son menu de variables de remplacement propose réellement.

Ne devinez pas entre les modèles : Les variables de remplacement de modèles antérieurs ou différents ne doivent pas être reprises sans vérification dans le rappel de paiement. Le menu de variables de remplacement du modèle spécifiquement modifié fait toujours foi.

Liste d'attente, MustPay et liste de demande

  • E-mail de demande de liste d'attente : ##WaitinglistOfferName## et ##BookingURL##.

  • MustPay finaliser l'inscription : ##UserName##, ##UserEmail##, ##BookingURL## et ##DeleteURL##.

  • E-mail de liste de demande : ##OfferlistFeedbackURL##, ##OfferlistValidityDate##, ##OfferlistSecondMailExists## et ##OfferlistSecondMailNumber##.

  • Rappel et refus de liste de demande : URL de retour d'information et date de validité.

  • Booking.pdf Liste de demandes : associe les valeurs de la liste de demandes aux valeurs appropriées de Booking.pdf et à Watermark.

Annulation, présence et certificat

ModèleValeurs importantes spécifiques au modèle
Annulation demandée / Confirmation d'annulationCancellationRules, CancellationFeeAmount, CancellationFeeOpenAmount, CancellationFeeStatus, CancellationRefundAmount, CancellationRefundInfo, CancellationInvoiceInfo, CancellationRequestDate, CancellationRequestReason.
Confirmation de présence / Notification d'absenceVisitingTimesPercent, VisitingTimesHourMinute, OfferTotalTime, DateNow et VisitingTimesNumber0 jusqu'à 7.
Zertifikat.pdfEn plus, CertificateValidationUrl, CertificateValidationQR, CertificateNumber, LeaderSignature et les variantes de OfferAllBookedOffers.

Balises, balises de valeur, conditions et boucles

Certaines variables puissantes sont utilisées manuellement dans des conditions ou des boucles et n'apparaissent pas dans chaque liste de variables de remplacement normale :

  • OfferTags contient les noms des balises associées à l'offre actuelle. Utilisez-le avec IN ou NOTIN.

  • UserTags contient les tags standard actifs de la personne, issus des réservations qui ne sont pas sur liste d’attente, des tags gérés directement dans le profil utilisateur et des associations SAML.

  • ##Tag[InternerCode]## affiche la valeur enregistrée d'une balise d'offre portant exactement ce nom. Plusieurs valeurs sont affichées séparées par des virgules.

  • {EACH?BookingUsers} répète un bloc pour les participants à la réservation. Les variables ##Id##, ##Salutation##, ##Firstname##, ##Lastname##, ##Email## et ##Pricecategory## y sont disponibles.

  • {EACH?OfferLeaders} répète un bloc pour les personnes responsables. Selon le contenu requis, les variables ##name##, ##leaderemail##, ##leadername##, ##leaderavatar## et ##leaderavatarurl## sont disponibles.

La syntaxe, les opérateurs et des exemples prêts à l’emploi se trouvent dans Personnaliser les modèles d’e-mail avec IF et EACH. En revanche, les conditions positives et négatives liées aux tags d’une offre déterminent qui peut réserver. Elles sont distinctes de l’affichage de OfferTags ou de UserTags.

Variables de remplacement dans un e-mail manuel

Un message manuel destiné à un profil de participant sélectionné peut utiliser des champs de participant visibles et des civilités. La boîte de dialogue V2 sélectionne les destinataires parmi les participants, les administrateurs ou les offres existants ; il ne s'agit pas d'une expédition librement adressable à des saisies d'adresses arbitraires. Un message destiné à un profil d'administrateur ne possède pas automatiquement les mêmes champs de participant.

Lorsque vous sélectionnez une offre, les participants correspondants sont identifiés et les données de l’offre peuvent être disponibles. Cela ne fournit pas automatiquement un numéro de réservation précis ni des données de facturation. Pour ces données, utilisez l’action d’envoi d’e-mail du processus de réservation ou de facturation concerné. Les étapes sont décrites dans Envoyer des e-mails manuels aux profils et aux offres.

Les exemples pratiques expliquent L'encadrement du cours, la signature et le logo supplémentaire dépendant du cours, Les domaines thématiques en tant que valeurs d'offre distinctes et un Certificat de participation pour l'employeur ou les congés de formation. Utilisez à cet effet les valeurs standard respectivement décrites et les balises d'offre gérées par vous-même.

Liste de contrôle pour les modifications

  • Pour chaque modèle, tester un cas avec des champs optionnels remplis et un cas avec des champs optionnels vides.

  • En cas de plusieurs langues, générer chaque variante linguistique séparément.

  • Vérifier les réservations groupées impliquant une ou plusieurs personnes ainsi que des catégories de prix différentes.

  • Comparer les états impayé, partiellement payé et annulé des factures.

  • Pour les balises, tester un cas correspondant et un cas non correspondant ; contrôler exactement l'orthographe et la valeur de la balise.

  • Dans la boîte d’envoi, vérifier l’objet, les destinataires, le contenu et les pièces jointes.

Exemple d'application : réservation groupée avec des personnes et des tarifs

Une entreprise inscrit plusieurs employés. Dans Booking.pdf, {EACH?BookingUsers} répertorie le nom, l'adresse e-mail et la catégorie de prix pour chaque personne. Dans Rechnung.pdf, ##InvoiceListing[User,PricecategoryDetail]## affiche la même affectation pour la comptabilité.

Exemple d'application : webinaire avec une valeur de balise

L'offre possède la balise normale Format avec la valeur Teams et la balise Zugangslink avec une URL de démonstration. La confirmation affiche ##Tag[Format]## et ##Tag[Zugangslink]##. Une condition IF n'affiche ce bloc que si OfferTags contient la balise attendue.

Exemple d'application : certificat avec validation

Un prestataire ajoute le numéro de certificat, le code QR de validation, la signature du responsable et le pourcentage de présence dans Zertifikat.pdf. Deux personnes de test, l’une avec une présence suffisante et l’autre avec une présence insuffisante, permettent de vérifier le bon fonctionnement conjoint du certificat, de la notification d’absence et du lien de validation.

Utiliser la référence pour votre modèle

La référence en fin de page contient toutes les entrées définies du catalogue de modèles ainsi que les boucles, conditions de balise et variantes de format supplémentaires utilisées. Recherchez un nom comme Membership, Dunning, BookingPart ou TicketBookedSchedule, puis choisissez le modèle concerné. Les entrées restent lisibles même sans JavaScript.

Les champs de participants propres au compte et les modèles créés par vous-même sont issus de votre configuration. Leurs noms concrets complets sont affichés dans votre éditeur. Un champ standard n'est proposé que s'il est visible dans la structure de données des participants. Un contexte dans la référence signifie que le modèle concerné peut utiliser ces données ; un message individuel peut néanmoins contenir des valeurs vides.

Abonnements et relances

Le rappel de renouvellement d’abonnement possède ses propres valeurs pour le nom, la validité, les utilisations restantes, le début du renouvellement, le prix, la devise, la taxe, la date de résiliation et les liens d’action personnels. Il dispose des données du participant et de l’organisation, sans contexte général d’offre ou de réservation. Le guide de l’e-mail d’abonnement explique chacune des 13 valeurs d’abonnement et les liens facultatifs.

Le système de relance utilise des modèles propres pour le rappel de paiement, la relance et la relance par courrier (PDF). Les valeurs Dunning… comprennent notamment le niveau de relance, la référence, l'échéance de paiement, le montant dû, les frais de relance, le montant total, le lien de paiement et les réservations concernées. Le rappel de paiement manuel classique utilise en revanche les valeurs Account… de son propre modèle. Choisissez le processus approprié dans la référence avant de reprendre les contenus.

Concevoir de manière ciblée les listes, le portefeuille et les champs de date

Vous trouverez les variantes et combinaisons détaillées pour les blocs de réservation, les listes de dates, les billets, le portefeuille et les factures dans Variantes de variables de remplacement pour les réservations, les billets et les factures. Les champs de date personnalisés peuvent, par exemple, être formatés avec ##UserGeburtsdatum[d.m.Y]## ; la condition est qu'un champ de participant de type Date soit visible. Voir Formater les champs de date des participants.

Les coordonnées des responsables de cours peuvent être affichées avec ##Teacher_first_module_email## pour la première séance concernée, ou avec ##leaderemail## dans {EACH?OfferLeaders}. Un responsable sans adresse e-mail reste dans la liste et produit une valeur vide pour cette adresse.

Afficher les valeurs des tags portant des noms adaptés

Pour ##Tag[Name]##, la syntaxe d'attribut prend en charge les lettres latines A–Z/a–z, les chiffres, les espaces ainsi que le tiret bas, les deux-points, la barre oblique, le point et le trait d'union. Utilisez par exemple Zugangslink ou Interner_Code pour de tels tags de sortie. Un tréma, un et commercial ou des crochets dans le nom du tag ne correspondent pas à cette syntaxe.

Les virgules séparent plusieurs noms de tags : ##Tag[Plattform,Zugangslink]## regroupe les valeurs existantes. Une virgule n'est donc pas un composant distinctif d'un seul nom de tag de sortie. Les noms dans une condition OfferTags IN constituent une vérification de liste séparée.

Générer un code promotionnel personnel

Ouvrez la campagne promotionnelle souhaitée et copiez intégralement la variable de remplacement ##Promotion[…]## affichée dans sa vue d'ensemble. Elle contient l'identifiant de votre propre campagne. Lors de l'évaluation, un nouveau code actif est généré pour cette campagne. Il ne s'agit pas d'une variable de remplacement destinée à afficher simplement une vente de bon existante.

Utilisez la notation actuelle de votre campagne et non un identifiant inventé. Une nouvelle évaluation ou un aperçu peuvent également générer de nouveaux codes. Vérifiez le processus avec une campagne de démonstration prévue à cet effet. Les notations antérieures ##PROMOCODE*…## sont des variantes de compatibilité et ne sont pas nécessaires pour les nouveaux contenus.

Guides associés

Textes supplémentaires dans les réservations multi-offres

Pour les confirmations et les certificats avec un contexte multi-offres, ##OfferConfirmationTextMultiOffers1##, ##OfferConfirmationTextMultiOffers2## et ##OfferConfirmationTextMultiOffers3## existent en plus. Ils regroupent les textes supplémentaires correspondants des offres sélectionnées. Utilisez ces valeurs spéciales uniquement dans le flux multi-offres approprié et vérifiez une réservation avec plusieurs offres. Les informations individuelles sur les offres sont toujours émises via OfferConfirmationText1 à 3.
Cookies et confidentialité
Nécessaires

Pour la sécurité, la navigation, les formulaires et le fonctionnement technique du site.

Toujours actifs
Politique de confidentialité