Paramètres & configuration d'app

Personnalisez les intégrations, templates et la whitelabel d’un tenant

Gérez les paramètres spécifiques d’une application pour adapter son comportement, connecter des services (Pennylane, Teledec, Qonto) et appliquer un habillage whitelabel selon le hostname.

Cette page explique comment utiliser les paramètres et la configuration d’une app : connecter Pennylane, sauvegarder les réglages Teledec, gérer les templates (création, édition, suppression, choix par défaut), activer un override whitelabel pour un hostname alias et configurer Qonto selon les options disponibles. Suivez les étapes ci‑dessous pour faire ces opérations en toute sécurité.

Capacités principales

Connecter Pennylane

Soumettre le code d’autorisation Pennylane pour récupérer et stocker les tokens initiaux. Permet d’exporter la comptabilité vers Pennylane et d’actualiser automatiquement les tokens.

Intégration Qonto

Connecter un compte Qonto pour la synchronisation bancaire et les paiements. La nouvelle intégration supporte l’enregistrement d’un compte via un flux d’enregistrement, la réception de webhooks signés et la validation des messages entrants. Selon la configuration de l’app et du whitelabel, l’activation du flux Qonto/e‑invoicing peut être exposée ou masquée. Pour l’activer, ajouter les variables d’environnement Qonto (présentes dans .env.example) et vérifier la section ‘qonto’ dans config/services.php ; configurer également l’endpoint webhook dans le dashboard Qonto en pointant vers le chemin de webhook de l’app et en fournissant le secret webhook.

Configurer Teledec

Saisir et sauvegarder les paramètres Teledec (IBAN, BIC, email, mot de passe, jour limite). Les données sensibles sont chiffrées et stockées pour les déclarations TVA.

Gérer les templates

Lister, éditer, créer et supprimer templates (HTML/CSS). Choisir une template par défaut pour factures et devis.

Whitelabel / override

Appliquer un habillage et des réglages spécifiques en fonction du hostname alias. Utile pour partenaires et marques blanches. La configuration whitelabel peut maintenant définir des réglages de branding, activer/paramétrer un bandeau partenaire (partner_banner) et contrôler la priorité d’application des valeurs par rapport aux paramètres locaux de l’app. Selon l’entrée par hostname dans config/whitelabel.php, vous pouvez aussi définir le logo, la position du logo, des règles d’IP/whitelist et des redirections spécifiques.

Paramètres additionnels (flag d'expansion de fonctionnalités)

Lire et modifier des paramètres avancés pour une app, notamment le flag d’expansion de fonctionnalités (active des modules ou comportements supplémentaires). Ces paramètres peuvent être modifiés dans l’interface mais leur valeur effective peut être influencée par la configuration runtime. Note : la configuration whitelabel (config/whitelabel.php) peut désormais définir des valeurs de flags par hostname, forcer certains flags ou verrouiller des flags pour empêcher leur modification depuis l’interface. Elle peut aussi masquer ou désactiver des modules/pages (par exemple onboarding ou members) et bloquer des routes/endpoints spécifiques pour un hostname donné (clefs comme disabled_modules ou disabled_routes). Remarque importante : le paramètre accounting_start est géré au niveau de l’application (app). Il définit la date de début du périmètre comptable appliquée pour cette app et attend une valeur de type date au format ISO (YYYY-MM-DD). Cette valeur est utilisée pour les exports et le calcul des périodes comptables au niveau de l’app ; si elle n’est pas renseignée, le système peut tomber sur une valeur globale ou par défaut selon la configuration du tenant. Comme pour d’autres paramètres, un whitelabel ou une configuration runtime peut forcer ou remplacer cette valeur pour les sessions via un hostname donné.

Sécurité des données

Les tokens et mots de passe sont chiffrés à la sauvegarde et seuls les utilisateurs/autorisations protégés peuvent les modifier.

Contrôles administratifs

Actions protégées disponibles pour forcer un override, révoquer des connexions ou effacer des paramètres lorsque nécessaire.

How to use it

Étapes principales

1 — Connecter Pennylane

Où : Paramètres > Intégrations > Pennylane (ou menu “Services / Pennylane”).
Que faire : Cliquez sur “Connecter / Autoriser Pennylane” puis collez le code d’autorisation fourni par Pennylane (champ “auth_code”) si l’interface vous le demande.
- Remarque importante : si vous avez déclenché un export comptable et que la configuration Pennylane est manquante ou invalide, un modal d’avertissement s’affichera et proposera un lien direct “Configurer Pennylane”. Ce lien ouvre la section Paramètres > Intégrations > Pennylane de l’app (ou le panneau de configuration ciblé) pour coller le code d’autorisation et enregistrer les tokens sans devoir naviguer manuellement dans le menu. Après enregistrement, vous pouvez revenir à l’export ou relancer l’opération depuis le modal.
Ce qui se passe : Le système demande les tokens initiaux, enregistre le token d’accès, la date d’expiration et le refresh token dans les paramètres de l’app (chifrés). Un message de confirmation s’affiche si la connexion réussit.
Astuce : Si la connexion échoue, répétez l’opération depuis l’interface d’autorisation Pennylane et vérifiez l’heure du serveur (expiration).

2 — Rafraîchir ou révoquer les tokens Pennylane

Où : Même écran Pennylane dans Paramètres.
Que faire : Utilisez l’option “Rafraîchir le token” si disponible pour obtenir un nouveau token. Si la tentative échoue, choisissez “Déconnecter” puis reconnectez avec un nouveau code.
Ce qui se passe : Les anciens tokens sont remplacés ; si le rafraîchissement échoue, les tokens sont vidés et une reconnexion est nécessaire.

3 — Configurer Teledec (déclarations TVA)

Où : Menu Déclarations / TVA ou Paramètres > Services > Teledec.
Que faire : Remplissez les champs obligatoires : IBAN, BIC, adresse email de réception, mot de passe Teledec et jour limite de déclaration. Cliquez sur “Enregistrer”.
Ce qui se passe : Les données sensibles (mot de passe, identifiants) sont chiffrées et sauvegardées. Vous pouvez ensuite lancer la déclaration TVA depuis l’interface “Déclarer” ; si l’option “Déclarer après sauvegarde” est cochée, la déclaration se lance automatiquement après l’enregistrement.

4 — Lister et modifier les templates

Où : Paramètres > Templates (ou Design > Templates).
Que faire :
1. Dans la liste, sélectionnez la template à éditer.
2. Pour modifier : cliquez sur “Éditer”, modifiez le contenu HTML/CSS dans l’éditeur intégré (sélection de thème possible), choisissez en‑tête / pied / style dans les listes déroulantes, puis “Enregistrer”.
3. Pour créer : entrez un nom valide (caractères autorisés indiqués dans le formulaire) puis “Créer”.
4. Pour supprimer : sélectionnez la template et cliquez sur “Supprimer” — confirmez la suppression dans la boîte de dialogue (action irréversible).
Ce qui se passe : Les changements sont pris en compte immédiatement ; la génération de PDF utilisera la template choisie.

5 — Appliquer un template par défaut

Où : Pareil que la gestion des templates.
Que faire : Ouvrez la template souhaitée puis utilisez l’option “Appliquer par défaut” pour factures ou devis. Confirmez.
Ce qui se passe : Les nouveaux documents utiliseront la template par défaut ; les documents existants ne changent que si vous régénérez leur PDF.

6 — Activer / forcer un override whitelabel

Où : Paramètres de l’app ou console partenaire (champ “Hostname alias” ou section Whitelabel).
Que faire : Saisissez le hostname alias souhaité (ex. partner.exemple.com) dans le champ prévu, activez SSL si nécessaire, puis “Enregistrer”. Pour prévisualiser immédiatement l’override, utilisez l’action administrative “Forcer override” si disponible.
Ce qui se passe : Lorsqu’un utilisateur accède à l’app via ce hostname, la configuration whitelabel (couleurs, logo, textes, certains comportements) est appliquée à la volée. Le rendu de l’interface et certains comportements peuvent changer selon les réglages du whitelabel.
Remarques techniques : la configuration whitelabel (config/whitelabel.php) peut contenir des options par hostname pour :
- forcer des flags/features (clé force_flags : map flag→valeur) ;
- verrouiller des flags pour empêcher leur modification via l’UI (clé locked_flags : liste de flags) ;
- masquer ou désactiver des modules/pages (clé disabled_modules : liste, ex. [‘onboarding’,‘members’]) ;
- bloquer des routes/endpoints spécifiques (clé disabled_routes : liste de routes) ;
- définir des valeurs de branding (clé branding) incluant par exemple colors (primary, secondary, text), logo, position du logo et assets ;
- activer et paramétrer un bandeau partenaire (clé partner_banner) : champs usuels enabled (true|false), text, background_color, link et position (top|bottom) — ce bandeau s’affiche au‑dessus de l’interface pour signaler un partenariat ou une marque spécifique ;
- définir des règles d’IP/whitelist et des redirections propres au hostname ;
- contrôler si l’app locale peut écraser les valeurs whitelabel (allow_app_override : true|false) ;
- définir la stratégie de fusion des paramètres (merge_strategy : “merge” ou “replace”).
  Priorité et comportement :
- Les clefs qui forcent ou verrouillent des flags (force_flags / locked_flags) ont la plus haute priorité pour les flags et empêchent toute modification locale pour les sessions impactées.
- Les réglages de branding (couleurs, logo, position du logo, partner_banner) sont appliqués au rendu visuel ; selon allow_app_override et merge_strategy, certaines valeurs locales peuvent être fusionnées ou remplacées.
- merge_strategy=“merge” fusionne les objets/listes de configuration (utile pour ajouter des éléments sans tout remplacer) ; merge_strategy=“replace” remplace entièrement la valeur cible par celle définie dans le whitelabel.
  Ces options déterminent si une valeur sauvegardée dans l’app est seulement une préférence ou si elle est écrasée/forcée par le whitelabel pour les utilisateurs accédant via le hostname.
  Important : la désactivation d’un module (ex. onboarding ou members) supprime les éléments d’interface correspondants (menus, boutons, pages) pour les sessions via ce hostname et peut empêcher l’accès aux routes associées ; cette restriction est appliquée en runtime au niveau serveur/route et côté client. Pour rétablir l’accès, mettez à jour config/whitelabel.php (ou l’outil d’administration) puis réinitialisez l’override.
  L’override est évalué par hostname (host header) — un override configuré pour partner.exemple.com ne s’appliquera pas aux accès via une adresse IP directe. Pour qu’il s’applique, l’utilisateur doit charger l’application avec le hostname correspondant. Certains réglages whitelabel peuvent aussi imposer des redirections spécifiques ou des conditions d’accès basées sur le hostname et les adresses autorisées.

7 — Lire / modifier le flag d'expansion de fonctionnalités

Où : Paramètres > Avancé (ou section “Paramètres additionnels”) de l’app.
Que faire : Repérez le paramètre “Expansion de fonctionnalités” (ou “feature_expansion”) et basculez le commutateur selon votre besoin, puis “Enregistrer”. Selon les permissions, seule une personne avec droits administratifs peut modifier cette valeur.
Ce qui se passe : Ce flag active ou désactive des fonctionnalités supplémentaires au niveau de l’app. Attention : la valeur effective utilisée par l’application peut être différente de celle sauvegardée si une configuration runtime (par exemple le default config JSON pour le domaine courant ou un whitelabel override) force une valeur spécifique pour ce hostname. La configuration whitelabel peut soit fournir une valeur par défaut, soit forcer/locker une valeur — si le whitelabel force un flag ou le verrouille, l’interface n’autorisera pas le changement pour les utilisateurs accédant via ce hostname.
Remarque : certains forçages ou verrouillages peuvent aller au‑delà d’un simple flag et désactiver complètement des modules (par ex. onboarding ou members) ou bloquer des routes. Dans ce cas, l’interface ne proposera pas les actions liées et les requêtes vers les routes désactivées peuvent être rejetées côté serveur.
Astuce : Pour tester immédiatement l’effet d’un changement whitelabel, utilisez l’action administrative “Forcer override” au niveau du whitelabel/hostname ; pour revenir à l’état sans override, utilisez “Réinitialiser override” ou modifiez la configuration whitelabel.

8 — Vérifications et tests

Après chaque modification majeure (connexion Pennylane, enregistrement Teledec, application whitelabel, modification du flag d’expansion), testez : générez un PDF de facture, lancez une déclaration de test, ou ouvrez l’app via le hostname alias pour vérifier l’apparence et le comportement.
Vérifiez aussi la valeur du paramètre accounting_start (Paramètres > Avancé ou Paramètres > Comptabilité selon votre UI) : il détermine la date de début du périmètre comptable pour l’app et doit être au format ISO (YYYY-MM-DD). Si un whitelabel ou une configuration runtime force cette valeur, testez via le hostname correspondant.
Si un modal d’avertissement est apparu lors d’un export comptable indiquant qu’une configuration Pennylane est requise, cliquez sur le lien du modal pour ouvrir directement la section Paramètres > Intégrations > Pennylane, enregistrez les informations requises, puis relancez l’export depuis le modal ou l’écran d’export.
En cas de problème, consultez les messages d’erreur affichés par l’interface et répétez l’étape de configuration.

9 — Configurer et activer Qonto (nouveau)

Où : Paramètres > Intégrations > Qonto (ou Paramètres > Services > Qonto).
Pré-requis : les nouvelles variables d’environnement relatives à Qonto ont été ajoutées dans .env.example ; assurez-vous de les renseigner en production/staging. Les clefs usuelles à renseigner sont (exemples) :
- QONTO_ENABLED=true (active l’utilisation du client Qonto au niveau applicatif)
- QONTO_API_BASE_URI (ou QONTO_BASE_URI) : URI de l’API Qonto (sandbox/production selon votre usage)
- QONTO_CLIENT_ID et QONTO_CLIENT_SECRET : identifiants OAuth / client pour l’API Qonto
- QONTO_PRIVATE_KEY : clé privée utilisée pour certaines opérations (peut être fournie en contenu PEM multi‑ligne ou via un chemin selon l’infrastructure)
- QONTO_WEBHOOK_SECRET : secret partagé pour valider les webhooks entrants
  (Remarque : consultez votre .env.example et config/services.php pour les noms exacts et le format attendu dans votre version du dépôt.)
Que faire :
1. Renseignez les variables d’environnement nécessaires et mettez à jour config/services.php si vous avez une configuration spécifique (la clé ‘qonto’ doit être présente et correctement renseignée).
2. Déployez la configuration (php artisan config:cache) et redémarrez les workers/queues si besoin.
3. Dans le dashboard Qonto, configurez l’URL de webhook vers l’endpoint exposé par l’application (ex. /services/qonto/webhook ou le chemin correspondant à vos routes) et copiez le secret webhook dans QONTO_WEBHOOK_SECRET.
4. Si vous devez enregistrer un compte via le flux d’enregistrement, utilisez l’interface d’administration prévue pour lancer le flux d’enregistrement Qonto ; le système gère la durée de validité des inscriptions et lèvera une exception spécifique si l’enregistrement a expiré (voir logs / messages d’erreur).
Ce qui se passe : l’application instancie le client Qonto (selon config/services.php et les variables d’environnement), valide les webhooks entrants via le secret partagé et traite les événements (transactions, statuts) via le handler configuré. Les erreurs d’enregistrement (ex. inscription expirée) sont signalées et doivent être traitées en relançant le flux d’enregistrement.
Astuces et sécurité : conservez la clé privée et le secret webhook dans un stockage sécurisé (vault, secret manager) et évitez d’exposer ces valeurs dans les journaux. Après modification des variables d’environnement, pensez à redémarrer les workers et le cache de configuration pour que les services prennent en compte les nouvelles valeurs.

Bonnes pratiques

Avant de supprimer ou modifier une template importante, exportez ou copiez son contenu (sauvegarde). Pour les intégrations (Pennylane/Teledec), testez d’abord en environnement de staging et notez la date d’expiration des tokens pour planifier les rafraîchissements. Pour les whitelabels, documentez les flags forcés/verrouillés, les modules désactivés et les réglages de branding (couleurs, logo, partner_banner) dans config/whitelabel.php afin que l’équipe produit et les partenaires sachent quelles options sont contrôlées centralement. Pour Qonto : référencez les variables d’environnement ajoutées dans .env.example et vérifiez la section ‘qonto’ dans config/services.php ; configurez le webhook dans le dashboard Qonto et conservez le secret en lieu sûr. Si le flux Qonto/e‑invoicing est activé par configuration, vérifiez aussi que les réglages whitelabel ou de l’app n’empêchent pas son affichage dans l’interface d’administration.

Limites et règles importantes

Les valeurs sensibles (tokens Pennylane, mots de passe Teledec) sont chiffrées et ne peuvent être modifiées qu’avec des permissions protégées.
Si la tentative de rafraîchissement des tokens échoue, la connexion est révoquée et il faut reconnecter le service.
Le whitelabel override s’applique en runtime selon le hostname : il peut modifier l’apparence (couleurs, logo, bandeau partenaire) ET le comportement de l’application pour tous les utilisateurs qui utilisent ce hostname. Testez avant mise en production.
Les paramètres additionnels (ex. flag d’expansion de fonctionnalités) peuvent être lus et modifiés via l’interface, mais la valeur effective utilisée par l’application peut être écrasée par la configuration runtime (default config JSON ou whitelabel) pour le hostname courant. La configuration whitelabel peut désormais forcer ou verrouiller des flags — les flags verrouillés ne peuvent pas être changés depuis l’interface pour les sessions impactées.
Le whitelabel peut également masquer ou désactiver des modules/pages (par exemple onboarding ou members) et/ou bloquer des routes associées pour un hostname donné. Dans ce cas, les éléments de navigation et les pages sont retirés pour les utilisateurs qui se connectent via ce hostname et les accès aux endpoints désactivés peuvent être refusés côté serveur. Pour rétablir l’accès, mettez à jour config/whitelabel.php (ou l’outil d’administration central) puis réinitialisez l’override.
Les réglages de branding (couleurs, logo, position du logo, partner_banner) définis dans le whitelabel s’appliquent au rendu visuel ; selon allow_app_override et la stratégie merge_strategy, certaines valeurs locales peuvent être fusionnées ou remplacées. Le partner_banner, s’il est activé, s’affiche généralement en haut de l’interface (position configurable) et peut inclure un lien externe.
Selon la configuration par hostname dans config/whitelabel.php, l’accès peut aussi être limité par IP/whitelist ou redirection vers un autre host : vérifiez ces règles si l’override ne s’applique pas comme attendu.
Le paramètre accounting_start est stocké au niveau de l’app et définit la date de début du périmètre comptable (format attendu ISO YYYY-MM-DD). Veillez à le renseigner correctement pour vos exports comptables et tests ; un whitelabel ou la configuration runtime peut forcer ou remplacer cette valeur pour les sessions via un hostname donné.
La suppression d’une template est irrémédiable depuis l’interface ; veillez à sauvegarder.
Pour Qonto : assurez-vous que le secret webhook est correctement configuré et que l’endpoint webhook de votre application est accessible depuis Qonto. Les webhooks sont validés et rejetés si la signature ne correspond pas. En cas d’inscription expirée lors du flux d’enregistrement Qonto, une exception spécifique est levée (inscription expirée) — relancer le flux d’enregistrement est alors nécessaire. Si le flux Qonto/e‑invoicing est piloté par configuration, vérifiez que le tenant concerné n’est pas désactivé par le whitelabel ou par les paramètres de l’app.
Lors d’un export comptable, si la configuration Pennylane est requise mais absente ou incorrecte, le système affiche désormais un modal d’avertissement contenant un lien direct vers Paramètres > Intégrations > Pennylane pour cette app. Cliquer sur ce lien ouvre la section de configuration ciblée ; après enregistrement des informations demandées, vous pouvez relancer l’export depuis le modal ou depuis l’écran d’export. Tant que la configuration n’est pas complétée et enregistrée, l’export restera bloqué.

FAQ

Frequently Asked Questions

Besoin d'aide ?

Si vous rencontrez une erreur ou avez besoin d’assistance pour une intégration (Pennylane / Teledec) ou pour tester un whitelabel, contactez l’équipe support en indiquant l’app concernée et une capture d’écran.

Édition & Prévisualisation imprimée

Synchronisation & traitement des mouvements