# 09. VARIABLES DE SUBSTITUTION
# 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é :
```php
$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 l'option est utilisée
#### **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)
- **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