Dépannage

Pour tous les utilisateurs SpeakDo — certaines causes nécessitent l'intervention d'un administrateur Dolibarr, précisé au cas par cas ci-dessous.

Les erreurs les plus fréquentes, leur cause probable, et ce qu'il faut faire.

ℹ️ Un système de codes d'erreur stables (affichés directement dans l'application, avec un lien direct vers l'explication correspondante) est prévu mais pas encore disponible. En attendant, cette page est organisée par symptôme.

API REST non activée#

Symptôme : l'enrôlement d'un terminal (scan du QR code) échoue avant même d'arriver à l'association.

Cause : le module API/Web services REST de Dolibarr n'est pas activé sur ce tenant.

À faire : Configuration → Modules → API/Web services REST → Activer, puis relancer l'enrôlement.

Droits Dolibarr insuffisants#

Symptôme : une action échoue alors que la demande semblait correcte, ou une action que vous attendiez n'apparaît jamais possible.

Cause : SpeakDo applique strictement vos droits Dolibarr réels — ce que vous ne pouvez pas faire dans Dolibarr, vous ne pouvez pas le faire via SpeakDo.

À faire : vérifiez vos droits sur l'objet concerné directement dans Dolibarr (fiche utilisateur → permissions), ou demandez à votre administrateur de les ajuster.

QR code expiré#

Symptôme : le scan du QR code affiché dans Dolibarr échoue avec un message d'expiration.

Cause : le QR code d'enrôlement est à usage unique et de courte durée de vie, par sécurité.

À faire : rechargez l'onglet SpeakDo de votre fiche utilisateur dans Dolibarr pour générer un nouveau QR code, et scannez-le sans tarder.

Terminal révoqué#

Symptôme : l'application demande de ré-enrôler l'appareil alors qu'il fonctionnait auparavant.

Cause : un administrateur a révoqué ce terminal depuis Dolibarr (perte du téléphone, changement d'appareil, départ d'un collaborateur...).

À faire : refaites l'enrôlement (étapes 3-4 du démarrage rapide) si cette révocation n'était pas intentionnelle de votre part.

Client (ou objet) ambigu ou introuvable#

Symptôme : SpeakDo demande de préciser lequel des plusieurs résultats trouvés vous visez, ou indique n'avoir rien trouvé.

Cause : plusieurs tiers/objets correspondent au nom donné (ambiguïté réelle), ou aucun ne correspond exactement.

À faire : précisez un détail supplémentaire (ville, référence exacte) ou reformulez avec le nom exact tel qu'il apparaît dans Dolibarr.

Objet déjà validé#

Symptôme : une tentative de modification ou d'ajout de ligne sur un devis/une facture/une intervention échoue sans qu'aucun détail précis ne soit donné.

Cause : certaines actions (comme ajouter une ligne) n'ont de sens que sur un objet encore en brouillon — un objet déjà validé dans Dolibarr n'accepte plus ce type de modification.

À faire : vérifiez le statut réel de l'objet dans Dolibarr avant de retenter.

Proposition non confirmable / expirée#

Symptôme : cliquer sur Confirmer ou Annuler renvoie une erreur "proposition non confirmable".

Cause : cette proposition SpeakDo a déjà été traitée (confirmée ou annulée) précédemment, ou elle a expiré (les propositions ne restent en attente qu'un temps limité).

À faire : reformulez votre demande pour créer une nouvelle proposition.

Quota quotidien atteint#

Symptôme : un message indique que le budget journalier est atteint, avec une heure de réinitialisation.

Cause : chaque forfait dispose d'un volume d'utilisation quotidien. Il se réinitialise chaque jour à minuit UTC.

À faire : patientez jusqu'à la réinitialisation, ou passez à un forfait supérieur/une recharge ponctuelle depuis le menu de l'application — voir Crédits et abonnement.

Essai gratuit arrivé à expiration#

Symptôme : SpeakDo indique que l'essai gratuit est terminé et bloque les nouvelles demandes.

Cause : l'essai gratuit est borné à la fois par un volume de crédits et par une durée (le premier des deux seuils atteint met fin à l'essai).

À faire : choisissez un forfait depuis le menu de l'application pour continuer — voir Crédits et abonnement. L'historique et les propositions déjà en attente restent consultables/confirmables même après la fin de l'essai.

Serveur Dolibarr inaccessible#

Symptôme : les actions échouent avec un message d'indisponibilité de Dolibarr.

Cause : le serveur Dolibarr de votre tenant ne répond pas (maintenance, panne réseau, hébergeur indisponible).

À faire : réessayez après quelques minutes. Si le problème persiste, contactez votre administrateur Dolibarr — SpeakDo ne peut rien faire de plus qu'attendre que Dolibarr redevienne joignable, par conception (aucune donnée n'est dupliquée localement pour continuer à écrire hors ligne).

Certificat HTTPS invalide#

Symptôme : l'enrôlement ou une action échoue avec une erreur liée à l'URL ou au certificat de votre Dolibarr.

Cause : SpeakDo exige une connexion HTTPS valide vers votre Dolibarr, par sécurité — un certificat expiré, auto-signé ou mal configuré est refusé plutôt que d'être ignoré silencieusement.

À faire : faites vérifier/renouveler le certificat HTTPS de votre Dolibarr par votre hébergeur ou votre administrateur système.

Si aucun de ces cas ne correspond, utilisez Signaler un problème depuis le menu de l'application (☰), ou copiez les informations depuis Informations techniques avant de contacter le support — voir Confirmations et statuts pour mieux comprendre le déroulement d'une action, ou Contexte actif si l'erreur semble liée à une mauvaise cible.