Syntaxe
Les variables dynamiques utilisent des doubles accolades :{{variable.name}}. Elles extraient les données du dossier client, du devis ou des lignes d’articles associés au document.
Catégories de variables courantes :
{{customer.*}}— Informations client (nom, e-mail, adresse, champs personnalisés){{quote.*}}— Détails du devis (numéro, total, sous-total, statut, dates){{product.*}}— Détails des lignes produits (nom, quantité, prix, remise){{user.*}}— Informations sur le commercial ou le responsable (nom, e-mail, titre, téléphone){{company.*}}— Détails de votre entreprise (nom, adresse, URL du logo)
Les noms de variables sont sensibles à la casse. Utilisez le format exact affiché dans le panneau de référence des variables.
Insérer une variable dans un modèle de contrat
1
Ouvrir l'éditeur de modèle de contrat
Dans le menu latéral gauche, cliquez sur Content → Contract Models, puis sélectionnez le modèle de contrat que vous souhaitez modifier, ou créez-en un nouveau.
2
Positionner votre curseur
Cliquez à l’endroit où vous souhaitez que la variable apparaisse dans le corps du document.
3
Insérer la variable
Tapez
{{ pour ouvrir le sélecteur de variables, ou saisissez manuellement le nom complet de la variable, par exemple {{customer.name}}. Sélectionnez la variable dans la liste ou appuyez sur Entrée pour confirmer.4
Prévisualiser le résultat
Cliquez sur [BUTTON LABEL] pour voir comment la variable s’affiche avec des données d’exemple.
5
Enregistrer le modèle de contrat
Cliquez sur Save pour appliquer vos modifications.
Formater les variables
Vous pouvez appliquer des modificateurs de format pour contrôler l’affichage des variables.Formatage des dates
Ajoutez un modificateur de format après le nom de la variable :{{quote.created_date | date: "MM/DD/YYYY"}}→ 12/31/2024{{quote.expiry_date | date: "MMMM D, YYYY"}}→ December 31, 2024
Formatage des nombres
Formatez les valeurs monétaires et décimales :{{quote.total | currency}}→ $10,000.00{{product.quantity | number: 2}}→ 1,234.56
Logique conditionnelle
Affichez ou masquez du contenu en fonction des valeurs des variables :La logique conditionnelle avancée et les boucles requièrent une syntaxe spécifique. Contactez le support pour des besoins de formatage personnalisé.
Utiliser des variables dans les modèles d’e-mail
Vous pouvez insérer des variables dynamiques dans les lignes d’objet et le corps des e-mails lors de la configuration des notifications automatisées ou des e-mails de devis. Accédez à [MENU PATH] et sélectionnez le modèle d’e-mail. Utilisez la même syntaxe{{variable.name}} dans les champs d’objet ou de corps.
Référence des variables courantes
Étapes suivantes
Lorsque vous publiez un devis ou générez un contrat, Qwoty remplace toutes les variables par les données réelles issues des dossiers associés. Si une variable référence un champ sans valeur, elle s’affiche comme vide, sauf si vous configurez une valeur de remplacement.Résolution des problèmes
La variable s'affiche comme {{customer.name}} au lieu de la valeur réelle
La variable s'affiche comme {{customer.name}} au lieu de la valeur réelle
Le nom de la variable est peut-être mal orthographié ou le champ n’existe pas. Vérifiez le panneau de référence des variables pour la syntaxe correcte. Assurez-vous que le dossier client contient des données dans ce champ.
La date s'affiche dans le mauvais format
La date s'affiche dans le mauvais format
Ajoutez un modificateur de format de date :
{{quote.created_date | date: "MM/DD/YYYY"}}. Vérifiez que la chaîne de format correspond aux jetons de date pris en charge.La variable apparaît vide dans le document généré
La variable apparaît vide dans le document généré
Le champ référencé est vide dans le dossier source. Ajoutez une valeur par défaut à l’aide de la syntaxe conditionnelle ou renseignez le champ avant de générer le document.
Les variables de champs personnalisés ne fonctionnent pas
Les variables de champs personnalisés ne fonctionnent pas
Les variables de champs personnalisés peuvent utiliser une syntaxe différente, comme
{{custom.field_name}} ou {{customer.custom_field_name}}. Consultez votre administrateur ou le panneau de référence des variables pour les conventions de nommage des champs personnalisés. En lien
Créer un modèle de contrat
Créez des modèles de contrat avec des variables et une mise en forme
Configurer les modèles d'e-mail
Configurez des e-mails automatisés avec du contenu dynamique
Champs personnalisés
Ajoutez des champs personnalisés aux devis et aux clients
Générer des contrats
Créez des contrats définitifs à partir de devis approuvés