Diagnostics

La page de diagnostic rassemble en un seul écran tout ce qui permet de comprendre pourquoi une synchronisation ne se passe pas comme prévu : état de la dernière synchronisation automatique, horloge du serveur, droits des utilisateurs, et incohérences de données avec, quand c'est possible, un bouton de correction.

Accès

La page n'a pas d'onglet dans la configuration du module. Vous l'ouvrez :

• par son adresse, custom/doliscan/admin/diags.php à la suite de l'adresse de votre Dolibarr (si le module est installé dans custom/, ce qui est le cas habituel) ;
• par le lien Ouvrir la page de diagnostic des droits du bandeau qui apparaît dans l'onglet 2. Administrateur lorsque des permissions manquent.

Elle est réservée aux super administrateurs : sans le module Multicompany, tout administrateur Dolibarr ; avec Multicompany, uniquement un administrateur rattaché à toutes les entités. L'administrateur d'une seule société est refusé.

Les actions de cette page sont tracées dans le journal système de Dolibarr (syslog).

Bandeaux d'alerte

En haut de page, deux alertes peuvent apparaître :

• Version du module incohérente : les fichiers du module ne correspondent pas à la version enregistrée en base. Désactivez puis réactivez le module pour appliquer les mises à jour.
• Tâche planifiée en retard ou désactivée : la synchronisation automatique ne tourne plus. Un lien ouvre la fiche de la tâche planifiée si vous avez le droit de consulter les tâches planifiées.

État de la dernière synchronisation automatique

Cette section affiche :

Tant que la tâche planifiée n'a jamais tourné, la page indique qu'aucun rapport n'est disponible.

Lancer la synchronisation maintenant

Le bouton Lancer la synchronisation maintenant exécute immédiatement ce que fait la tâche planifiée :

1. vérification de la connexion du compte administrateur ;
2. envoi des projets vers DoliSCAN s'ils ont été modifiés ;
3. synchronisation de tous les comptes, seulement si la dernière synchronisation réussie date de plus de 23 heures ;
4. téléchargement des justificatifs manquants.

[!NOTE] Si la dernière synchronisation réussie date de moins de 23 heures, l'étape 3 est sautée et le rapport l'indique. Pour resynchroniser un compte précis sans attendre, utilisez le bouton de synchronisation de sa fiche (voir la page Utilisation).

Constante de synchronisation partagée entre entités

Sur une installation multi-sociétés, un ancien défaut pouvait enregistrer la date de dernière synchronisation pour toutes les entités à la fois. Une seule entité se synchronisait alors, et les autres attendaient indéfiniment le délai de 23 heures. Si la page détecte ce cas, elle affiche un avertissement et le bouton Supprimer la constante globale (corrige le bug). Ce bouton ne touche à aucune donnée : chaque entité retrouve simplement sa propre date de synchronisation.

Horloge du serveur (NTP)

La page compare l'heure de votre serveur à une heure de référence :

Une horloge décalée fait considérer les jetons d'accès comme expirés et provoque des erreurs d'authentification. Faites corriger l'heure du serveur (synchronisation NTP) par votre hébergeur, puis rechargez la page.

Cette vérification utilise le canal annexe décrit dans la page Divers. Si vous l'avez désactivé, le résultat reste indéterminé.

Droits des utilisateurs DoliSCAN

L'import automatique ne dépend pas des droits de l'utilisateur porteur du compte. En revanche, les actions manuelles (valider, annuler, rouvrir une note) et les objets créés à son nom en dépendent.

Permissions du module présentes en base

Lorsqu'une mise à jour du module ajoute une permission, Dolibarr ne l'enregistre qu'à l'activation du module. Tant qu'elle n'est pas enregistrée, personne ne peut l'obtenir, pas même un administrateur. La page liste les permissions manquantes et propose le bouton Réinstaller les permissions du module, qui les enregistre et les accorde aux administrateurs, sans désactiver le module ni perdre la configuration.

Droits par compte DoliSCAN

Un tableau liste chaque compte DoliSCAN (200 au maximum) avec les droits qui manquent à son utilisateur Dolibarr :

Chaque droit manquant est accompagné de la raison pour laquelle il sert, en rouge s'il est indispensable, en orange s'il est conseillé. Le bouton Permissions ouvre la page standard des permissions de l'utilisateur, où vous accordez les droits. Un compte rattaché à un utilisateur Dolibarr supprimé est signalé.

Contrôles de cohérence

Les contrôles 1 à 7 portent sur toutes les entités, le contrôle 8 sur l'entité courante. Le résumé en bas de page totalise les incohérences trouvées.

1. Factures fournisseurs avec un tiers d'une autre entité

Une facture fournisseur dont le fournisseur appartient à une autre société. Si un fournisseur actif portant exactement le même nom existe dans la société de la facture, un bouton Corriger propose de remplacer le fournisseur de la facture par celui-ci.

Une fenêtre de confirmation nomme la facture, l'ancien et le nouveau fournisseur avant tout changement. L'ancien fournisseur n'est conservé que dans le journal système : notez-le si vous voulez pouvoir revenir en arrière.

2 à 5. Contrôles en lecture seule

Ces contrôles listent les incohérences sans proposer de correction :

• 2. notes DoliSCAN liées à une note de frais Dolibarr d'une autre entité ;
• 3. notes de frais dont l'auteur appartient à une autre entité ;
• 4. lignes de factures fournisseurs dont le produit appartient à une autre entité ;
• 5. comptes DoliSCAN dont l'utilisateur appartient à une autre entité.

Les utilisateurs rattachés à toutes les entités ne sont pas signalés par les contrôles 3 et 5. Ces incohérences viennent en général de modifications manuelles en base : corrigez-les depuis les fiches concernées.

6. Notes de frais orphelines

Un ancien défaut de déduplication (lié au fuseau horaire) créait une nouvelle note de frais brouillon à chaque synchronisation. Ce contrôle liste les notes de frais brouillon qui ne sont plus rattachées à DoliSCAN, alors qu'une autre note du même auteur et de la même période l'est. Pour chacune, la page indique le nombre de lignes, dont les lignes ajoutées à la main (en rouge s'il y en a).

Le bouton Supprimer, après confirmation, supprime définitivement la note orpheline, ses lignes et ses pièces jointes. Les lignes DoliSCAN sont reconstruites sur la note active à la synchronisation suivante, mais les lignes ajoutées à la main sont perdues : la confirmation le rappelle lorsqu'il y en a. La suppression est refusée si la note n'est plus en brouillon ou s'il n'existe pas de note active pour la même période.

Les notes orphelines vides sont déjà supprimées automatiquement pendant l'import : cette section ne montre que celles qui contiennent encore des lignes.

7. Notes de frais brouillon avec un total erroné

Un ancien défaut insérait les lignes de carburant des véhicules de tourisme sans recalculer le total de la note. Le bouton Recalculer les totaux, après confirmation, recalcule le total des notes brouillon concernées à partir de leurs lignes. Aucune ligne n'est ajoutée ni supprimée.

8. Lignes de carburant dont le HT et la TVA sont inversés

Par exemple, un plein de 60 EUR à 20 % enregistré avec 10 EUR HT et 50 EUR de TVA au lieu de 50 EUR HT et 10 EUR de TVA. Le montant remboursé était juste, seule la TVA récupérable était fausse.

Le bouton Corriger le HT et la TVA, après confirmation, rétablit les bonnes valeurs sur les notes brouillon et recalcule leur total, sans changer le TTC. Les notes déjà validées sont listées pour mémoire mais jamais modifiées : voyez-les avec votre comptable.

Rattrapage des doublons

Le bouton Rattrapage des doublons (frais manquants) en haut de page ouvre la page de rattrapage.