# 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](https://speakdo.fr/integrations/) du site. Pour tester SpeakDo avec votre instance ERPNext, écrivez à [hello@speakdo.fr](mailto: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](/fr/catalogue/compatibilite-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.