Documentation SpeakDo speakdo.fr

SpeakDo pour ERPNext

L'intégration ERPNext est plus récente que l'intégration Dolibarr ; elle est en prise en charge initiale. L'application SpeakDo, les confirmations, les profils et les assistants IA fonctionnent de la même façon ; ce qui diffère, c'est le module installé dans l'ERP et la liste des actions disponibles.

Le module compagnon#

Le module compagnon speakdo_erpnext est une application Frappe, installée dans votre instance ERPNext par son administrateur. Il sert à :

  • configurer l'intégration SpeakDo dans ERPNext ;
  • gérer les paramètres de connexion avec le middleware SpeakDo ;
  • permettre l'enrôlement des utilisateurs par QR code ;
  • fournir au middleware les informations nécessaires : état des terminaux, droits de l'utilisateur.

Il n'héberge pas le moteur conversationnel et ne réimplémente pas les fonctions d'ERPNext. Ce n'est pas une application mobile : l'application utilisée sur le terrain est la PWA SpeakDo.

Installation#

Le module compagnon n'a pas encore de version publique. Il sera publié, avec sa compatibilité ERPNext/Frappe vérifiée, sur la page SpeakDo pour ERPNext du site. Pour tester SpeakDo avec votre instance ERPNext, écrivez à hello@speakdo.fr en précisant vos versions d'ERPNext et de Frappe.

Configuration#

Depuis ERPNext, le module rattache votre instance à SpeakDo : il déclare l'adresse de l'instance et établit une liaison signée avec le middleware. Cette liaison est propre à votre instance ; elle ne peut pas être déplacée vers une autre adresse sans une nouvelle installation.

Enrôlement#

Chaque utilisateur ERPNext associe son téléphone par un QR code temporaire. Au moment de l'association, le module compagnon transmet au middleware un accès propre à cet utilisateur (jeton d'API ERPNext) : les actions sont ensuite exécutées avec ses droits ERPNext. Aucun mot de passe n'est saisi dans l'application. Sans accès exploitable, l'association est refusée.

Compatibilités#

Les actions liées à ERPNext, leurs limites et les actions sans équivalent sont listées sur Compatibilité ERPNext, page générée à partir du code de SpeakDo.

En résumé : recherches (clients, projets, tickets, événements, devis, commandes, factures, interventions en lecture), consultation de fiches et gestion des tâches sont liées ; les liaisons sont vérifiées sur les définitions officielles d'ERPNext 15 et couvertes par des tests automatisés.

Limites connues#

  • Validation en conditions réelles en cours : aucune exécution sur une instance ERPNext réelle n'est encore documentée.
  • Interventions : la fiche d'intervention SpeakDo (lignes datées, durée, passage en facture) n'a pas d'équivalent dans ERPNext. Les visites de maintenance (Maintenance Visit) sont consultables, mais la création et la facturation d'interventions sont refusées.
  • Factures : une facture ERPNext n'est payée que par un règlement (Payment Entry) ; SpeakDo ne la marque jamais « payée » directement.
  • Prospects et fournisseurs : sous ERPNext, ce sont des documents distincts des clients ; la recherche de tiers ne couvre que les clients.
  • Assistants IA : la connexion MCP est validée avec Dolibarr ; elle n'est pas encore annoncée comme validée avec ERPNext.
  • Une action liée n'est proposée que si votre instance expose le document correspondant et si les droits de l'utilisateur le permettent.