--- title: "Configuration" weight: 20 description: "Paramétrage du module FxPreFlight : seuil de taille PDF, options de contrôle et configuration de la conformité client." --- # Configuration ## Accès à la configuration La page de configuration est accessible depuis **Accueil > Configuration > Modules > FxPreFlight**, onglet **Réglages**. Seuls les administrateurs Dolibarr ont accès à cette page. ![Page de configuration du module FxPreFlight avec le seuil de taille PDF](screenshots/configuration-setup.webp) ## Paramètres disponibles ### Seuil d'alerte taille PDF | Paramètre | Description | |-----------|-------------| | **FXPREFLIGHT_PDF_SIZE_THRESHOLD** | Taille en Ko au-delà de laquelle un fichier PDF de facture est considéré comme trop volumineux. Valeur par défaut : 200 Ko. Plage : 50 à 1000 Ko. | Les plateformes de dépôt de factures électroniques (Chorus Pro, etc.) peuvent refuser ou surfacturer les fichiers trop volumineux. Ce seuil permet d'identifier les factures dont le PDF dépasse la limite recommandée. Pour modifier la valeur, ajustez le champ puis enregistrez. ## Contrôle des dates de factures Le tableau de bord principal propose une option pour activer le contrôle des dates postérieures. Cette option utilise la constante native Dolibarr `INVOICE_CHECK_POSTERIOR_DATE`. Lorsqu'elle est activée, Dolibarr empêche de valider une facture dont la date est antérieure à la dernière facture validée. Cela évite les incohérences de chronologie dans la numérotation. L'activation et la désactivation se font directement depuis le tableau de bord FxPreFlight, dans la section **Configuration Module**. > **Attention** : L'activation de cette option n'a pas d'effet rétroactif. Elle ne corrige pas les incohérences existantes, mais empêche d'en créer de nouvelles. > **Note importante sur l'audit fxpreflight** : ce module audite **toujours** la chronologie des factures déjà présentes en base, **indépendamment** de l'état de cette option Dolibarr. La constante `INVOICE_CHECK_POSTERIOR_DATE` n'est **pas** utilisée comme filtre par fxpreflight -- elle n'est affichée que comme une recommandation de configuration. Ainsi, même si vous activez l'option, lancez l'audit, puis la désactivez, les anomalies historiques restent visibles dans le rapport. ## Constante FACTURE_DEPOSITS_ARE_JUST_PAYMENTS Le module vérifie que la constante Dolibarr `FACTURE_DEPOSITS_ARE_JUST_PAYMENTS` n'est **pas** activée. Cette constante, lorsqu'elle est active, empêche la gestion correcte des factures d'acompte en tant que vraies factures, ce qui pose problème pour la facturation électronique. Si cette constante est activée dans votre Dolibarr, le tableau de bord affiche un statut rouge sur cette ligne. Pour la désactiver, rendez-vous dans **Accueil > Configuration > Autre** et supprimez la constante. ## Mention "TVA non applicable, art. 293 B du CGI" Si votre société n'est **pas** assujettie à la TVA (auto-entrepreneur, micro-entreprise en franchise en base, association non lucrative, etc.), la loi française impose de faire figurer sur chaque facture la mention : > TVA non applicable, art. 293 B du CGI La ligne **Mention de franchise de TVA** du tableau de bord n'apparaît que si votre société est déclarée non assujettie : case **Non assujetti à la TVA** cochée dans **Accueil > Configuration > Société/Organisation**, encadré **Gestion de la TVA**, et pays France. ### Avec un modèle PDF standard : rien à faire Les deux modèles de factures livrés avec Dolibarr, **Sponge** et **Crabe**, impriment la mention tout seuls dès que la case est cochée. Le texte imprimé est : > \* TVA non applicable art-293B du CGI (ou sa variante association pour une structure loi 1901). Vous n'avez donc **rien à saisir** : le tableau de bord affiche la ligne en vert avec le nom du modèle qui produit la mention. ### Avec un modèle personnalisé : à vérifier Si vos factures sont générées par un modèle ODT ou par un modèle PDF tiers, le module ne peut pas savoir ce que ce modèle imprime. Il cherche alors la mention dans les textes qui atterrissent réellement sur la facture, dans cet ordre : 1. Le **texte libre des factures** (**Accueil > Configuration > Modules > Factures**, champ *Texte libre en bas de page*, constante `FACTURE_FREE_TEXT`) -- c'est le champ effectivement imprimé en pied de facture. 2. La **note** de la société (`MAIN_INFO_SOCIETE_NOTE`) et les notes publique / privée, conservées en repli car un modèle personnalisé peut les reprendre. Si la mention n'y figure nulle part, le tableau de bord affiche un avertissement orange rappelant le nom du modèle concerné, et le bouton ouvre la configuration du module Factures. > **Attention** : la note de la société n'est imprimée sur aucun PDF standard. Y écrire la mention fait taire l'alerte mais ne l'ajoute pas à vos documents. Pour un modèle personnalisé, utilisez le texte libre des factures. La détection accepte toutes les formulations courantes : `293 B`, `293B`, `293-B`, `art. 293 B du CGI`, ou simplement `TVA non applicable`, insensible à la casse et quelle que soit la ponctuation. ## Configuration de la conformité client La page de configuration de la conformité est accessible depuis **Accueil > Configuration > Modules > FxPreFlight**, onglet **Conformité**. ### Page publique de mise à jour | Paramètre | Description | Défaut | |-----------|-------------|--------| | **Activer la page publique** | Active le formulaire public permettant aux clients de mettre à jour leurs informations via un lien sécurisé. Tant que cette option est désactivée, aucun email ne peut être envoyé et le formulaire public est inaccessible. | Désactivé | | **URL personnalisée de la page publique** | Adresse à laquelle vos clients atteignent le formulaire, si vous ne souhaitez pas diffuser l'adresse de votre Dolibarr. Laisser vide pour utiliser l'URL de votre Dolibarr. | Vide | | **Durée de validité des tokens** | Nombre de jours pendant lesquels le lien envoyé au client reste valide. Passé ce délai, le lien expire et le client doit en demander un nouveau. | 14 jours | | **Nombre maximum de relances** | Nombre maximum de rappels pouvant être envoyés à un même client pour un même formulaire. | 3 | Sous ces paramètres, la configuration affiche l'URL réellement utilisée dans les emails, avec l'indication de sa provenance : URL personnalisée ou URL par défaut de votre Dolibarr. #### Publier le formulaire sur une autre adresse Par défaut, le lien envoyé au client pointe vers votre Dolibarr, par exemple `https://dolibarr.mon-entreprise.fr/custom/fxpreflight/public/update.php?token=xxx`. Cette adresse révèle donc à vos clients où se trouve votre Dolibarr. Si vous placez un proxy inverse devant votre Dolibarr, ou si vous publiez le formulaire sur un domaine dédié, renseignez l'adresse complète du point d'entrée dans le paramètre **URL personnalisée de la page publique**. Le token est ajouté automatiquement à la fin. Exemples de valeurs acceptées : * `https://maj.mon-entreprise.fr/formulaire` -- si votre proxy réécrit le chemin * `https://maj.mon-entreprise.fr` -- si le formulaire est servi à la racine du domaine * `https://proxy.mon-entreprise.fr/custom/fxpreflight/public/update.php` -- si le proxy conserve le chemin d'origine L'adresse doit commencer par `http://` ou `https://`, comporter un nom de domaine et ne pas contenir de paramètre (`?` ou `#`). Une valeur non conforme est refusée à l'enregistrement, et tant qu'aucune adresse valide n'est enregistrée le module continue d'utiliser l'URL de votre Dolibarr. Le réglage vaut pour le lien envoyé par email et pour les liens internes de la page elle-même (changement de langue, bouton de correction, envoi du formulaire). Vous n'avez donc rien à ajuster côté page publique si votre proxy sert le formulaire sous un chemin différent. > **Attention** : c'est à vous de mettre en place la redirection côté hébergement. Le module ne fabrique pas l'accès, il se contente d'écrire l'adresse que vous indiquez. Vérifiez que l'adresse renseignée aboutit bien sur le formulaire avant d'envoyer des emails à vos clients. > **Note sur la limitation de débit** : derrière un proxy inverse, toutes les requêtes arrivent avec l'adresse IP du proxy. La protection anti-force brute décrite plus bas compte alors les tentatives du proxy et non celles de chaque visiteur. Si vous utilisez un proxy, configurez votre Dolibarr pour lire l'adresse réelle transmise par celui-ci (en-tête `X-Forwarded-For`), sinon la limite de 10 tentatives par heure sera atteinte bien plus vite que prévu. ### Limitation de débit | Paramètre | Description | Défaut | |-----------|-------------|--------| | **Tentatives max par IP/heure** | Nombre maximum de tentatives avec un token invalide depuis une même adresse IP en une heure. Protection contre les attaques par force brute. | 10 | ### Vérifications API externes Ces options activent les vérifications automatiques lors de la validation des données soumises par les clients. | Paramètre | Description | Défaut | |-----------|-------------|--------| | **Vérification VIES** | Vérifie la validité du numéro de TVA intracommunautaire auprès du service VIES de la Commission européenne. | Activé | | **Vérification Sirene** | Vérifie l'existence et la validité du SIREN/SIRET auprès de l'API Sirene de l'INSEE. | Activé | | **Vérification BAN** | Vérifie la cohérence de l'adresse postale auprès de la Base Adresse Nationale (France uniquement). | Activé | > **Note** : Si un service externe est temporairement indisponible, la vérification est signalée en orange (indéterminée) plutôt qu'en rouge. Cela n'empêche pas la validation manuelle par l'administrateur. ## Permissions Le module définit trois permissions spécifiques pour la conformité client : | Permission | Description | |------------|-------------| | **Envoyer des mails de conformité** | Permet d'envoyer des emails de mise à jour et des relances aux clients non conformes | | **Valider les données du sandbox** | Permet de valider ou rejeter les données soumises par les clients | | **Consulter la piste d'audit** | Permet d'accéder à l'historique des actions de conformité | Ces permissions sont configurables depuis **Accueil > Configuration > Utilisateurs & Groupes > Permissions**. ## Page À propos L'onglet **À propos** de la configuration affiche les informations du module : version, éditeur et description.