Ajouter Fidly à votre IA
Dans votre assistant IA, ajoutez un connecteur personnalisé (aussi appelé serveur MCP) avec cette URL :Écran de consentement
La page affiche :- le nom que l’assistant se donne — choisi par l’assistant, il ne prouve donc pas son identité ;
- l’adresse vers laquelle vous serez renvoyé après votre décision
(
claude.ai,chatgpt.com,localhostpour une application de bureau…). Vérifiez que c’est celle de votre assistant ; - un avertissement quand Fidly ne reconnaît pas l’assistant. Ne l’autorisez que si vous avez vous-même ajouté Fidly à cet assistant.
Droits
Les droits d’une connexion fonctionnent comme ceux d’un client d’API : pour chaque ressource, chaque action — créer, lire, modifier, supprimer — est autorisée ou non. L’assistant ne voit que les outils que ses droits permettent.- Avec lire les documents seul, un document montre le nom de sa relation et rien d’autre d’elle. Trouver une relation par son nom demande lire les relations.
- Modifier les documents permet d’envoyer un document sur Peppol, ce qui est irréversible.
- Les droits sans outil pour l’instant (comptes bancaires, journaux, identités visuelles, toute suppression) sont aujourd’hui sans effet ; ils s’appliqueront quand des outils arriveront, sans reconnexion.
- Une connexion travaille toujours sur les données réelles de votre entreprise : pas de sandbox pour les connexions IA.
Révoquer une connexion
Les connexions IA apparaissent dans la liste des accès API de votre entreprise dans Fidly, avec leur nom, l’utilisateur qui les a autorisées et leur dernière activité. Une connexion reste active jusqu’à sa révocation, même si l’assistant ne sert plus. Révoquer prend effet immédiatement : la requête suivante de l’assistant est refusée. Changer les droits : un outil dont le droit est retiré est refusé dès l’appel suivant de l’assistant ; un outil dont le droit est ajouté apparaît quand l’assistant relit sa liste d’outils, en pratique dans une nouvelle conversation. Pour vous reconnecter après une révocation, ajoutez à nouveau la connexion depuis votre assistant.Outils
Non disponibles via l’IA : la suppression, l’import de documents, les pièces jointes, les comptes bancaires, les journaux et
les identités visuelles.
Relations par leur nom
Partout où un outil prend une relation, l’assistant peut donner son identifiant ou son nom. Quand plusieurs relations correspondent à un nom, l’outil renvoie les candidates (identifiant, nom, numéro de TVA) et l’assistant vous demande laquelle.Totaux
search_documents, summarize_documents et relation_overview comptent par
sens : ventes (factures et notes de crédit de vente) et achats (factures et
notes de crédit d’achat), qu’ils soient émis dans Fidly ou reçus. Dans tout total :
- les notes de crédit sont soustraites ;
- les proformas, les autres documents et les documents supprimés ou masqués en comptabilité ne sont pas comptés ;
- les montants sont donnés par devise ;
- « en retard » signifie échéance passée et montant encore dû.
search_documents renvoie jusqu’à 50 documents par appel, du plus récent au plus
ancien ; ses sums portent sur tous les résultats, par sens et par devise.
summarize_documents couvre au plus 366 jours par appel. Groupé par relation, il
renvoie les 20 plus grosses relations par devise, puis une ligne par devise qui
additionne le reste (key: "others", libellé « Other relations (N) »).
Détail d’un document
get_document renvoie le document comme l’API, sans ses pièces jointes. Sa
relation n’est donnée que par son identifiant et son nom (relation_id,
relation_name).
get_document_file renvoie un lien de téléchargement du PDF du document, ou de son
XML Peppol avec format: "xml". Le lien est valable 15 minutes et fonctionne pour
quiconque le détient ; passé ce délai, l’assistant en demande un nouveau. Un
document qui vient d’être créé ou corrigé n’a son fichier que quelques instants
plus tard.
Créer un document
create_document crée par défaut une facture de vente, et une proforma seulement
si vous demandez un brouillon ou une proforma. Il prend la relation, les lignes
(article, quantité, prix unitaire, code TVA…) et, en option, la date d’émission,
les conditions de paiement, le journal, le numéro de commande, la référence
acheteur et la devise.
Le document est numéroté à la création. Il ne peut être supprimé
que s’il est le dernier de sa séquence, n’a pas été envoyé, n’est pas passé en
comptabilité et n’est lié à rien ; dès qu’une autre facture le suit, une erreur se
corrige par une note de crédit. Rien n’est envoyé, et le PDF est produit quelques
instants plus tard.
Corriger un document
update_document prend l’identifiant du document et seulement les champs à changer
(changes), sous la forme de la modification de document de l’API. Les lignes
envoyées remplacent toutes les lignes : pour en ajouter une, l’assistant relit
le document et renvoie toutes ses lignes avec la nouvelle. Les montants sont
recalculés, le numéro ne change pas et le PDF est régénéré quelques instants plus
tard.
Un document envoyé (mail ou Peppol) ou passé en comptabilité ne peut plus être
corrigé : une note de crédit le corrige. Le type et le journal ne changent jamais.
Envoyer un document
send_document envoie sur Peppol un document émis dans Fidly. L’assistant a pour
consigne de vous demander confirmation d’abord : un document envoyé ne peut plus
être corrigé ni supprimé. L’envoi est asynchrone : l’outil répond
{"status": "handed_over", "document": …} quand l’envoi est accepté, et le statut
Peppol du document change une fois le réseau passé.
Créer et corriger une relation
create_relation prend la relation sous la forme de la création de relation de
l’API (relation : type, nom ou prénom, adresse avec son pays…). Une entreprise
dont le numéro de TVA, l’identifiant ou l’adresse électronique est déjà porté par
une autre relation est refusée, avec l’identifiant de cette relation.
update_relation prend la relation (identifiant ou nom) et seulement les champs à
changer (changes) ; le type de la relation ne peut pas changer.