FAQ

Questions générales

Le module modifie-t-il mes données ?

La partie analyse (tableau de bord, pages de détail) est en lecture seule : elle ne crée, ne modifie et ne supprime aucune donnée.

La partie conformité client peut modifier les données de vos tiers (SIREN, TVA, adresse, etc.) uniquement après validation manuelle par un administrateur. Chaque modification passe par un bac à sable et une piste d'audit complète. Aucune donnée n'est modifiée sans votre accord explicite.

Sur quelle période porte l'analyse des factures ?

L'analyse des factures porte sur les 12 derniers mois glissants à compter de la date de consultation du tableau de bord.

Le module fonctionne-t-il avec Dolibarr 16 ou 17 ?

Le module est compatible avec Dolibarr à partir de la version 11, grâce à un système de rétrocompatibilité intégré. Toutefois, la version 18.0 ou supérieure est recommandée pour bénéficier de toutes les vérifications.

Le module est-il limité à la France ?

Les vérifications de conformité (SIREN, SIRET, TVA intracommunautaire, chronologie de la numérotation) sont principalement orientées vers la réglementation française. Le module détecte néanmoins les clients de l'Union Européenne et hors UE dans la répartition géographique.

Score de conformité

Comment le score global est-il calculé ?

Le score global est une moyenne pondérée de quatre indicateurs :

• Infrastructure technique : 20 %
• Base clients : 30 %
• Produits : 20 %
• Factures : 30 %

Mon score est de 100 %, suis-je prêt pour la facturation électronique ?

Un score de 100 % signifie que vos données sont conformes selon les critères vérifiés par FxPreFlight. Vous devez encore installer un module de génération de factures électroniques (comme Factur-X) et tester la production effective de factures au format électronique.

Mon score est très bas, que faire en priorité ?

Concentrez-vous sur les indicateurs au rouge, dans cet ordre :

1. Infrastructure technique : vérifiez la configuration de votre société (SIRET, capital) et de votre module de facturation
2. Base clients : commencez par les clients les plus actifs (triés par nombre de factures)
3. Produits : ajoutez un taux de TVA aux produits en vente qui n'en ont pas
4. Factures : les problèmes de factures se corrigent souvent en corrigeant les fiches clients

Conformité client

Comment fonctionne l'envoi d'email aux clients ?

Depuis la page Conformité clients, vous sélectionnez les clients à contacter et cliquez sur Envoyer. Chaque client reçoit un email contenant un lien unique et temporaire vers un formulaire de mise à jour. Le client n'a pas besoin de compte Dolibarr.

Le client peut-il modifier n'importe quelle donnée ?

Non. Le formulaire affiche uniquement les champs manquants ou invalides pour ce client spécifique. Le client ne voit pas les données des autres tiers et ne peut pas accéder à d'autres informations de votre Dolibarr.

Que se passe-t-il si le client ne répond pas ?

Vous pouvez envoyer des relances depuis la page de conformité (jusqu'au nombre maximum configuré). Si le token a expiré, une relance crée automatiquement un nouveau lien.

Les données soumises sont-elles appliquées automatiquement ?

Non. Toutes les données soumises par les clients sont placées dans un bac à sable. Vous devez les valider manuellement (champ par champ ou en bloc) avant qu'elles soient appliquées dans Dolibarr. Vous pouvez aussi rejeter des modifications.

Où puis-je valider les soumissions ?

Deux options :

1. Page dédiée : Outils > FXPreFlight > Validation des soumissions
2. Fiche tiers : une bannière orange apparaît automatiquement sur la fiche du client quand des modifications sont en attente. Cliquez dessus pour ouvrir la popup de validation.

Comment fonctionne la détection automatique du type de tiers ?

Le module analyse les données existantes de chaque client :

• Si un SIREN, SIRET ou numéro de TVA est renseigné -> le client est identifié comme société
• Si le nom contient un mot-clé reconnaissable (SARL, SAS, EURL, ASSOCIATION, MAIRIE, etc.) -> société ou administration
• Si aucune information ne permet de trancher -> le type reste inconnu et sera demandé au client via le formulaire

Le lien envoyé au client est-il sécurisé ?

Oui. Le token est généré avec 128 caractères aléatoires, est à usage unique et expire après la durée configurée (14 jours par défaut). Un système de limitation de débit protège contre les tentatives de force brute.

Problèmes courants

Le module affiche "SIREN manquant" pour des clients étrangers

Le module vérifie la présence du SIREN uniquement pour les clients français. Pour les clients étrangers, c'est le numéro de TVA intracommunautaire qui est vérifié. Si votre client étranger n'a pas de code pays renseigné, le module peut le considérer comme français par défaut.

Corrigez le pays dans la fiche du tiers pour résoudre ce faux positif.

Des trous de numérotation sont détectés alors que mes factures se suivent

Le test de détection des trous de numérotation est expérimental. Il peut produire des faux positifs dans les cas suivants :

• Vous utilisez plusieurs séries de numérotation (préfixes différents)
• Vous avez changé de modèle de numérotation en cours d'année
• Des factures provisoires ont été supprimées avant validation
• Vos factures ont été validées dans un ordre différent de leur création (numérotation non chronologique)

Pour ce dernier cas, activez l'option "Forcer la date de facturation à la date de validation" du coeur de Dolibarr (Accueil > Configuration > Factures clients) : la date de la facture correspondra alors à sa date de validation, ce qui évite le réordonnancement.

Signalez les faux positifs à l'éditeur pour améliorer la détection.

L'analyse PDF affiche "Aucun fichier PDF trouvé"

Le module cherche les fichiers PDF dans le répertoire standard de Dolibarr (DOL_DATA_ROOT/facture/). Si vos factures sont stockées dans un emplacement personnalisé, les fichiers ne seront pas trouvés.

Vérifiez que les PDF de vos factures sont bien générés et stockés dans l'emplacement par défaut.

La page met du temps à charger

Le tableau de bord exécute de nombreuses requêtes d'analyse sur vos données. Si votre base contient un grand nombre de factures et de clients, le chargement peut prendre plusieurs secondes. C'est un comportement normal.

Je ne vois pas les boutons d'envoi d'email sur la page de conformité

Vérifiez que :

1. La page publique est activée dans la configuration du module (onglet Conformité)
2. Votre utilisateur dispose de la permission Envoyer des mails de conformité

La bannière de validation n'apparaît pas sur la fiche tiers

Vérifiez que :

1. Le module est bien activé (désactiver puis réactiver si vous venez de mettre à jour)
2. Votre utilisateur dispose de la permission Valider les données du sandbox
3. Il existe effectivement des soumissions en attente pour ce client

J'obtiens "Access to this page this way... is refused by CSRF protection"

Sur Dolibarr 21 et versions ultérieures, la constante MAIN_SECURITY_CSRF_WITH_TOKEN est passée à 2 par défaut (et à 3 sous Dolibarr 24). Ce paramètre durcit la protection contre les attaques CSRF et bloque les actions de modification qui ne passent pas un jeton de sécurité (token) dans l'URL ou le formulaire.

Le message d'erreur ressemble à :

Access to this page this way (POST method or GET with a sensible value for
'action' parameter) is refused by CSRF protection in main.inc.php.
Token not provided.

Cause : un lien ou un formulaire du module envoyait une action sensible sans inclure le jeton CSRF attendu par Dolibarr.

Actions concernées (corrigées à partir de la version 1.2.35) :

• Tableau de bord : activation/désactivation du contrôle de date postérieure
• Conformité clients : déduction des types de tiers, envoi d'email, envoi de relance
• Validation des soumissions : validation ou rejet d'un champ, validation en bloc d'un tiers
• Configuration : prévisualisation des documents

Que faire :

1. Mettez à jour le module vers la dernière version disponible
2. Videz le cache de votre navigateur et rechargez la page
3. Si le problème persiste, vérifiez dans Configuration > Sécurité que MAIN_SECURITY_CSRF_WITH_TOKEN est bien défini à une valeur supportée par votre version de Dolibarr

Vous n'avez pas à baisser le niveau de protection CSRF de votre Dolibarr : le module est compatible avec les niveaux 2 et 3.

Validations techniques

Quelles validations sont effectuées sur le SIREN ?

Le module vérifie que le SIREN comporte exactement 9 chiffres et que la clé de contrôle est valide selon l'algorithme de Luhn.

Quelles validations sont effectuées sur le numéro de TVA ?

Le module vérifie le format du numéro de TVA intracommunautaire français (clé composite à deux chiffres). Si la vérification VIES est activée, le numéro est également vérifié auprès du service de la Commission européenne.