# 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](/fr/demarrage-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](/fr/credits-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](/fr/credits-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](/fr/confirmations) pour mieux comprendre le déroulement d'une action, ou [Contexte actif](/fr/contexte-actif) si l'erreur semble liée à une mauvaise cible.