Skip to main content

VARIABLES DE SUBSTITUTION

1.QU'EST-CE QU'UNE VARIABLE DE SUBSTITUTION ?

Les variables de substitution sont des balises spéciales que vous pouvez insérer dans vos documents (PDF, emails, modèles) et qui seront automatiquement remplacées par les vraies valeurs lors de la génération.

=> Le module InfraS2Bridge ajoute des variables spécifiques pour inclure les liens de paiement et QR codes dans vos communications.

2.VARIABLES DISPONIBLES

Variable

Description

Résultat

__BRIDGE_PAYMENT_LINK__

URL complète du lien de paiement Bridge

https://pay.bridge...

__BRIDGE_PAYMENT_QR__

Image QR code encodée en base64

Image QR intégrée

⚠ Respect de la casse : Les variables doivent être écrites exactement comme indiqué, avec les doubles underscores et en MAJUSCULES.

3.UTILISATION DANS LES EMAILS

Configuration

Menu : Accueil → Configuration → Emails → Modèles

  1. Sélectionnez le modèle d'email pour les factures
  2. Modifiez le contenu
  3. Ajoutez les variables dans le corps du message
  4. Sauvegardez

Exemple d'email

Objet : Facture __REF__ - Montant __TOTAL_TTC__

Bonjour __THIRDPARTY_NAME__,

Veuillez trouver ci-joint votre facture n° __REF__ d'un montant de __TOTAL_TTC__.

Pour régler cette facture en ligne, cliquez sur le lien suivant : __BRIDGE_PAYMENT_LINK__ Ou scannez ce QR code avec votre smartphone : __BRIDGE_PAYMENT_QR__

Cordialement,
__MYCOMPANY_NAME__

4.UTILISATION DANS LES MODÈLES PDF

Modèles ODT

Si vous utilisez des modèles ODT pour vos factures :

  1. Ouvrez votre modèle ODT avec LibreOffice
  2. Insérez les variables dans le document
  3. Pour le lien : écrivez simplement __BRIDGE_PAYMENT_LINK__
  4. Pour le QR : insérez __BRIDGE_PAYMENT_QR__
  5. Sauvegardez le modèle ODT
  6. Placez-le dans htdocs/install/doctemplates/

Modèles PHP personnalisés

Si vous développez un modèle PDF personnalisé :

$substitutionarray = getCommonSubstitutionArray($langs, 0, null, $object);
complete_substitutions_array($substitutionarray, $langs, $object);

// Les variables Bridge sont automatiquement disponibles
$paymentLink = $substitutionarray['__BRIDGE_PAYMENT_LINK__'];
$qrCode = $substitutionarray['__BRIDGE_PAYMENT_QR__'];

5.CAS PARTICULIERS

Facture sans lien Bridge

Situation : La facture n'a pas de lien de paiement (montant trop faible, mode différent, etc.)

Comportement : Les variables sont remplacées par une chaîne vide (rien n'apparaît)

Lien révoqué

Situation : Le lien a été révoqué après l'envoi de l'email

Comportement : Le lien reste affiché mais redirige vers une page "Lien expiré" sur Bridge

Facture déjà payée

Situation : La facture est payée mais le lien existe encore

Comportement : Le lien s'affiche mais Bridge affiche "Déjà payé" si utilisé

6.BONNES PRATIQUES

  • Testez vos modèles avec une facture test avant envoi massif
  • Ajoutez un texte explicatif autour des variables pour guider le client
  • Proposez plusieurs options : lien cliquable ET QR code
  • Indiquez les moyens alternatifs (virement, chèque) au cas où
  • Vérifiez l'affichage des QR codes dans les PDFs générés
  • N'oubliez pas que les variables ne fonctionnent que si un lien existe
Back to top