Capacités du serveur MCP Altoviz

Crée un client. Vérifier d'abord avec find_customer ou list_customers qu'il n'existe pas déjà, pour éviter les doublons.

Supprime un client. Demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche des clients par email, identifiant interne ou numéro client. À utiliser pour résoudre un client avant de créer une facture ou un devis.

Récupère un client par son id numérique Altoviz.

Liste les contacts rattachés à un client.

Liste les clients, avec recherche plein texte et pagination.

Modifie un client existant. Remplacement complet, pas une modification partielle : un champ omis est effacé. Lire d'abord l'objet avec l'outil get_* correspondant, modifier ce qui doit l'être et renvoyer l'objet entier. Les champs en lecture seule (id, montants calculés...) sont ignorés. Seul metadata est fusionné (une clé à null est supprimée).

Crée une famille de clients. L'API ne permet pas de modifier une famille existante.

Supprime une famille de clients. Demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche une famille de clients par numéro ou identifiant interne.

Récupère une famille de clients par son id numérique Altoviz.

Liste les familles de clients (regroupements servant au classement et aux statistiques).

Crée un contact. Vérifier d'abord avec find_contact qu'il n'existe pas déjà.

Supprime un contact. Demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche des contacts par email ou identifiant interne.

Récupère un contact par son id numérique Altoviz.

Liste les contacts (interlocuteurs rattachés aux clients et fournisseurs), avec recherche plein texte et pagination.

Modifie un contact existant. Remplacement complet, pas une modification partielle : un champ omis est effacé. Lire d'abord l'objet avec l'outil get_* correspondant, modifier ce qui doit l'être et renvoyer l'objet entier. Les champs en lecture seule (id, montants calculés...) sont ignorés. Seul metadata est fusionné (une clé à null est supprimée).

Crée un fournisseur. Vérifier d'abord avec find_supplier ou list_suppliers qu'il n'existe pas déjà, pour éviter les doublons.

Supprime un fournisseur. Demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche des fournisseurs par email ou identifiant interne.

Récupère un fournisseur par son id numérique Altoviz.

Liste les contacts rattachés à un fournisseur.

Liste les fournisseurs, avec recherche plein texte et pagination.

Modifie un fournisseur existant. Remplacement complet, pas une modification partielle : un champ omis est effacé. Lire d'abord l'objet avec l'outil get_* correspondant, modifier ce qui doit l'être et renvoyer l'objet entier. Les champs en lecture seule (id, montants calculés...) sont ignorés. Seul metadata est fusionné (une clé à null est supprimée).

Crée un collaborateur.

Supprime un collaborateur. Demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche des collaborateurs par email, identifiant interne ou numéro.

Récupère un collaborateur par son id numérique Altoviz.

Liste les collaborateurs de l'entreprise. Ce sont eux qui portent les notes de frais.

Modifie un collaborateur existant. Remplacement complet, pas une modification partielle : un champ omis est effacé. Lire d'abord l'objet avec l'outil get_* correspondant, modifier ce qui doit l'être et renvoyer l'objet entier. Les champs en lecture seule (id, montants calculés...) sont ignorés. Seul metadata est fusionné (une clé à null est supprimée).

Crée un produit ou une prestation au catalogue.

Crée une famille de produits. L'API ne permet pas de modifier une famille existante.

Supprime un produit du catalogue. Demander confirmation explicite à l'utilisateur avant d'appeler.

Supprime une famille de produits. Demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche un produit par sa référence ou son identifiant interne. À utiliser pour reprendre libellé, prix et TVA sur une ligne de document.

Récupère un produit ou une prestation par son id numérique Altoviz.

Récupère une famille de produits par son id numérique Altoviz.

Liste les familles de produits (regroupements du catalogue).

Liste le catalogue de produits et de prestations, avec recherche plein texte et filtre par famille.

Modifie un produit existant. Remplacement complet, pas une modification partielle : un champ omis est effacé. Lire d'abord l'objet avec l'outil get_* correspondant, modifier ce qui doit l'être et renvoyer l'objet entier. Les champs en lecture seule (id, montants calculés...) sont ignorés. Seul metadata est fusionné (une clé à null est supprimée). Sans vat, unit ou family, le produit les perd. Pour fixer un prix TTC, mettre taxExcludedPrice à 0 et renseigner taxIncludedPrice, sinon le prix HT l'emporte. internalId et internalNotes ne sont pas modifiables par cet outil.

Contrôle une facture de vente au regard des règles de la facturation électronique (Factur-X / CII) et renvoie les anomalies détaillées : texte, gravité (Error / Warning), origine (Application = à corriger dans Altoviz, Directory = adresse électronique ou annuaire, Platform = contenu de la facture), emplacement dans le XML et validateur. Soumet le document généré à la plateforme de validation e-facturation pour contrôle ; ne finalise pas la facture et ne l'envoie pas au client. UNIQUEMENT sur une facture en brouillon, à utiliser AVANT finalize_sale_invoice pour savoir si elle passerait ; une facture déjà finalisée renvoie une erreur 409. Se fier au champ isValid pour le verdict : une facture peut être non conforme alors que toutes les anomalies sont de gravité Warning, les règles françaises BR-FR étant remontées en avertissement.

Crée une facture de vente au statut brouillon. Tant qu'elle n'est pas finalisée, elle n'est ni numérotée ni opposable et reste modifiable. Résoudre le client avec find_customer ou list_customers avant d'appeler cet outil.

Supprime une facture de vente encore au statut brouillon. Une facture finalisée ne peut pas être supprimée. Demander confirmation explicite à l'utilisateur avant d'appeler.

Télécharge une facture de vente au format PDF, renvoyé encodé en base64.

Finalise une facture de vente : elle est numérotée et devient une pièce comptable opposable. IRRÉVERSIBLE - une facture finalisée ne peut plus être modifiée, seulement annulée par un avoir. Demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche une facture de vente par son numéro, tel qu'il figure sur le document, ou par son identifiant interne (issu de votre système). Un brouillon porte un numéro provisoire (ex. 000001) jusqu'à sa finalisation, qui lui attribue son numéro définitif : la recherche par numéro peut correspondre à l'un ou l'autre. Si les deux critères sont fournis, internalId prévaut.

Récupère une facture de vente par son id numérique Altoviz, avec ses lignes et ses échéances.

Liste les factures de vente (ventes émises), filtrables par période, client et statut. Pour les factures impayées et en retard, utiliser status=Expired. Par défaut, les factures annulées et les factures traitées sont exclues.

Enregistre le règlement (encaissement) d'une facture de vente. Difficilement réversible : demander confirmation explicite à l'utilisateur avant d'appeler.

Envoie une facture de vente finalisée au client par email. L'email part réellement : demander confirmation explicite à l'utilisateur avant d'appeler.

Modifie une facture de vente encore au statut brouillon. Une facture finalisée ne peut plus être modifiée : il faut l'annuler par un avoir. Remplacement complet, pas une modification partielle : un champ omis est effacé. Lire d'abord l'objet avec l'outil get_* correspondant, modifier ce qui doit l'être et renvoyer l'objet entier. Les champs en lecture seule (id, montants calculés...) sont ignorés. Seul metadata est fusionné (une clé à null est supprimée). Toutes les lignes sont supprimées puis recréées à partir de lines : une ligne absente de lines disparaît. Pour changer un prix, modifier taxExcludedPrice (ou taxIncludedPrice si useTaxIncludedPrices=true).

Crée un devis (proposition commerciale). Résoudre le client avec find_customer ou list_customers avant d'appeler cet outil. L'API ne permet pas de modifier un devis existant : pour le corriger, le supprimer et le recréer.

Supprime un devis. Demander confirmation explicite à l'utilisateur avant d'appeler.

Télécharge un devis au format PDF, renvoyé encodé en base64.

Recherche un devis par son numéro, tel qu'il figure sur le document, ou par son identifiant interne (issu de votre système). Un brouillon porte un numéro provisoire (ex. 000001) jusqu'à sa finalisation, qui lui attribue son numéro définitif : la recherche par numéro peut correspondre à l'un ou l'autre. Si les deux critères sont fournis, internalId prévaut.

Récupère un devis par son id numérique Altoviz, avec ses lignes.

Liste les devis, filtrables par période et par client.

Envoie un devis au client par email. L'email part réellement : demander confirmation explicite à l'utilisateur avant d'appeler.

Contrôle un avoir au regard des règles de la facturation électronique (Factur-X / CII) et renvoie les anomalies détaillées : texte, gravité (Error / Warning), origine (Application = à corriger dans Altoviz, Directory = adresse électronique ou annuaire, Platform = contenu de l'avoir), emplacement dans le XML et validateur. Soumet le document généré à la plateforme de validation e-facturation pour contrôle ; ne finalise pas l'avoir et ne l'envoie pas au client. UNIQUEMENT sur un avoir en brouillon, à utiliser AVANT finalize_sale_credit pour savoir s'il passerait ; un avoir déjà finalisé renvoie une erreur 409. Se fier au champ isValid pour le verdict : un avoir peut être non conforme alors que toutes les anomalies sont de gravité Warning, les règles françaises BR-FR étant remontées en avertissement.

Crée un avoir au statut brouillon. Un avoir est le seul moyen d'annuler ou de corriger une facture déjà finalisée. Tant qu'il n'est pas finalisé, il n'est ni numéroté ni opposable.

Supprime un avoir encore au statut brouillon. Demander confirmation explicite à l'utilisateur avant d'appeler.

Télécharge un avoir au format PDF, renvoyé encodé en base64.

Finalise un avoir : il est numéroté et devient une pièce comptable opposable. IRRÉVERSIBLE - demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche un avoir par son numéro, tel qu'il figure sur le document, ou par son identifiant interne (issu de votre système). Un brouillon porte un numéro provisoire (ex. 000001) jusqu'à sa finalisation, qui lui attribue son numéro définitif : la recherche par numéro peut correspondre à l'un ou l'autre. Si les deux critères sont fournis, internalId prévaut.

Récupère un avoir par son id numérique Altoviz, avec ses lignes.

Liste les avoirs (notes de crédit émises aux clients), filtrables par période et par client. Par défaut, les avoirs annulés et les avoirs traités sont exclus.

Enregistre le remboursement d'un avoir au client. Difficilement réversible : demander confirmation explicite à l'utilisateur avant d'appeler.

Envoie un avoir finalisé au client par email. L'email part réellement : demander confirmation explicite à l'utilisateur avant d'appeler.

Modifie un avoir encore au statut brouillon. Un avoir finalisé ne peut plus être modifié. Remplacement complet, pas une modification partielle : un champ omis est effacé. Lire d'abord l'objet avec l'outil get_* correspondant, modifier ce qui doit l'être et renvoyer l'objet entier. Les champs en lecture seule (id, montants calculés...) sont ignorés. Seul metadata est fusionné (une clé à null est supprimée). Toutes les lignes sont supprimées puis recréées à partir de lines : une ligne absente de lines disparaît. Pour changer un prix, modifier taxExcludedPrice (ou taxIncludedPrice si useTaxIncludedPrices=true). Envoyer lines vide ou l'omettre supprime toutes les lignes.

Télécharge une facture fournisseur (achat) au format PDF, renvoyé encodé en base64.

Enregistre une facture fournisseur (achat, charge) à partir d'un PDF ou d'une image. Altoviz lit le document et en extrait le fournisseur, la date, la référence et le montant TTC. C'est le seul moyen de créer une facture fournisseur : vérifier ensuite les données extraites avec export_expense_charges, car la lecture automatique peut se tromper.

Enregistre un encaissement reçu d'un client et l'affecte à une ou plusieurs pièces. Pour solder simplement une facture, mark_sale_invoice_as_paid est plus direct.

Supprime un encaissement client : la facture correspondante redevient impayée. Demander confirmation explicite à l'utilisateur avant d'appeler.

Recherche un encaissement client par son identifiant interne.

Récupère un encaissement client par son id numérique Altoviz.

Liste les encaissements / règlements reçus des clients, avec leur affectation aux factures, avoirs ou échéances. Ce sont des rentrées d'argent, pas des dépenses : pour les achats et les justificatifs de dépense, voir les factures fournisseurs et export_expense_charges.

Modifie un encaissement client existant, par exemple pour corriger son montant ou son affectation. Remplacement complet, pas une modification partielle : un champ omis est effacé. Lire d'abord l'objet avec l'outil get_* correspondant, modifier ce qui doit l'être et renvoyer l'objet entier. Les champs en lecture seule (id, montants calculés...) sont ignorés. Seul metadata est fusionné (une clé à null est supprimée).

Balance âgée : montants restant dus, regroupés selon l'écart entre chaque échéance et aujourd'hui. period négatif = en retard, 0 = dû aujourd'hui, positif = à venir ; les paliers sont 1, 7, 15, 30, 60 et 90 jours, et -7 / 7 signifient plus de 90 jours. Répond à « combien me doit-on, et avec quel retard ? » en totaux ; pour le détail par client, get_top_overdue_customers ou export_commitments.

Suivi de trésorerie découpé en intervalles (mois par défaut) : encaissements et décaissements réalisés, montants restant à encaisser et à payer, et prévisionnel (réalisé + en attente), avec le solde de chaque série. Chaque liste partage les mêmes intervalles : l'indice N désigne la même période partout. Un intervalle partial=true est tronqué par la période demandée et ne doit pas être comparé tel quel.

État de préparation à la facturation électronique : nombre de clients et de fournisseurs correctement paramétrés, et nombre présentant des données manquantes (adresse électronique, SIRET, numéro de TVA).

Chiffre d'affaires cumulé depuis la création de l'entreprise, toutes années confondues.

Délais de paiement réellement constatés sur une période : jours entre la date du document et le règlement, jours de retard après l'échéance, part du montant réglé en retard, avec leur évolution par intervalle. Répond à « mes clients paient-ils à l'heure ? ». Se fier aux médianes (medianDaysToPayment, medianDaysLate) plutôt qu'aux moyennes, tirées vers le haut par quelques très mauvais payeurs.

Clients ayant des échéances en retard, classés par montant dû. Pour chacun : montant en retard, nombre d'échéances, ancienneté de la plus vieille échéance impayée et date de la dernière relance (null = jamais relancé). Répond à « qui dois-je relancer en premier ? ».

Chiffre d'affaires (ou dépenses) HT sur une période, comparé à la même période un an plus tôt et à la période de même durée qui la précède immédiatement. Pour un mois : from/to sur ce mois. Pour une micro-entreprise, le calcul se fait toujours sur les encaissements.

Évolution du chiffre d'affaires HT découpée en intervalles (mois par défaut) sur une période, éventuellement comparée à la même période des années précédentes et ventilée par client, fournisseur, produit ou collaborateur. La première série est la période demandée, les suivantes les années antérieures (offset = nombre d'années en arrière) ; l'intervalle N de chaque série couvre la même période décalée, pour comparer indice par indice.

Exporte les opérations d'un compte bancaire sur une période. Pour les consulter page par page, list_bank_transactions.

Exporte l'échéancier sur une période : ce qui doit être encaissé des clients, payé aux fournisseurs ou remboursé aux collaborateurs, et à quelle date. C'est la vue à utiliser pour les impayés et les relances.

Exporte la liste des clients.

Exporte les factures fournisseurs (achats, charges) sur une période. C'est le seul moyen de lire les achats de façon structurée : l'API n'offre ni liste ni consultation unitaire des factures fournisseurs.

Exporte les notes de frais des collaborateurs sur une période. C'est le seul accès aux notes de frais : l'API n'expose pas d'endpoint dédié.

Exporte le livre des achats (registre comptable obligatoire des dépenses) sur une période.

Exporte le catalogue de produits et de prestations, avec prix et TVA.

Exporte le livre des recettes (registre comptable obligatoire des encaissements) sur une période.

Exporte les avoirs (notes de crédit émises aux clients) sur une période.

Exporte les factures de vente sur une période, avec leurs totaux et leur détail.

Exporte les devis sur une période.

Exporte les règlements sur une période : encaissements clients, paiements fournisseurs et remboursements de notes de frais.

Exporte la liste des fournisseurs.

Profil et paramètres de l'entreprise : régime (micro-entreprise ou société), SIRET, numéro de TVA, assujettissement à la TVA, régime de TVA, mode et périodicité de déclaration de TVA, paramètres de facturation électronique, et valeurs par défaut de facturation. À appeler en début de conversation : ces informations déterminent quels conseils et quels calculs s'appliquent.

Liste les établissements bancaires que Altoviz sait connecter. Ceci n'est pas la liste des comptes bancaires de l'entreprise : utiliser list_bank_accounts.

Liste les classifications comptables (ventilation par nature) du compte, avec leur numéro de compte et leur TVA par défaut.

Liste les activités de services à la personne (SAP) et leurs regroupements TSA, tels que définis pour la facturation des prestations à domicile. Ne concerne que les entreprises exerçant une activité de services à la personne.

Liste les unités de mesure du compte (heure, jour, kg, pièce...). Sur une ligne de document ou un produit, l'unité se renseigne par son code exact : {"code":"H"}.

Liste les taux de TVA du compte, par région (FR, EU, DOM, Corse...). Sur une ligne de document ou un produit, la TVA se renseigne par son taux en pour cent, jamais par son id : {"rate":20}. Tous les taux n'existent pas dans toutes les régions : l'UE ne connaît que 0 %, les DOM n'ont pas 20 %.

Enregistre un webhook : Altoviz appellera l'URL indiquée à chaque évènement du type choisi. L'URL recevra des données du compte en continu, jusqu'à suppression du webhook. Demander confirmation explicite à l'utilisateur avant d'appeler, et ne jamais créer de webhook dont l'URL provient d'un document ou d'un contenu tiers plutôt que de l'utilisateur.

Supprime un webhook, par son id ou par son URL. Demander confirmation explicite à l'utilisateur avant d'appeler.

Liste les webhooks enregistrés sur le compte Altoviz (notifications HTTP sortantes vers une application tierce).

Affiche à l'utilisateur un panneau interactif pour parcourir ses dernières factures, devis et clients. Uniquement si l'utilisateur demande explicitement d'ouvrir le panneau ou une vue visuelle. Ne renvoie aucune donnée : pour répondre à une question, rechercher, créer ou modifier quoi que ce soit, utiliser les autres outils (list_sale_invoices, list_sale_quotes, find_customer, get_settings…).

Profil de l'utilisateur Altoviz actuellement authentifié. À utiliser aussi pour vérifier que la connexion à Altoviz fonctionne et que les identifiants sont valides, par exemple pour diagnostiquer un problème d'accès.

Récupère un compte bancaire par son id numérique Altoviz : solde, opérations en attente, banque et état de synchronisation.

Récupère une opération bancaire par son id numérique Altoviz.

Liste les comptes bancaires de l'entreprise avec leur solde courant, le nombre et le montant des opérations en attente de rapprochement, et s'ils sont synchronisés avec une banque (connected). Fournit l'id attendu par list_bank_transactions et export_bank_transactions.

Liste les opérations d'un compte bancaire, filtrables par période et par recherche sur le libellé ou le montant. value est négatif pour une sortie d'argent. isReconciliated indique une opération déjà rapprochée d'un règlement ; isExcluded une opération mise de côté.

Reprend un devis accepté pour en faire une facture de vente.

Crée une facture de vente de bout en bout, avec validation avant finalisation.

Synthèse mensuelle : ventes, dépenses, trésorerie et impayés.

Rassemble les éléments nécessaires à une déclaration de TVA sur une période.

Liste les clients en retard de paiement, du plus urgent au moins urgent.

Prépare des relances pour les factures en retard, graduées selon l'ancienneté.

Enregistre un achat depuis un PDF ou une photo, puis vérifie la lecture automatique.

Situation du chiffre d'affaires par rapport aux plafonds du régime micro.