Aller au contenu
Novadesko Documentation
Français
Ouvrir l'application

Référence des outils

Les 34 outils du serveur MCP Novadesko : consultation, préparation, envoi et confirmation, avec leurs paramètres et la fonctionnalité d'abonnement requise.

Cette liste est générée depuis le registre d'outils de Novadesko. Les schémas sont stricts : un paramètre inconnu, un type faux ou une valeur hors liste est refusé. Une fonctionnalité non incluse dans l'offre de l'entreprise renvoie un refus qui indique l'offre minimale et son prix.

Consultation (read)

OutilParamètres (* obligatoire)Fonctionnalité requiseRôle
get_companyaucunaucuneProfil de l'entreprise connectée, abonnement, add-ons actifs et portées accordées. À appeler en premier.
search_partieskind* customer | supplier
q string
page integer
Gestion des clients si kind = customerRecherche des clients ou fournisseurs.
get_partykind* customer | supplier
id* integer
Gestion des clients si kind = customerFiche complète d'un client ou fournisseur : coordonnées, vérifications (TVA, 30 bis, Peppol), derniers documents.
search_documentstype receipt | invoice | proforma | order | credit_note | estimate | purchase
q string
paid boolean
page integer
from string
to string
aucuneRecherche de documents (devis, bons de commande, factures, reçus, notes de crédit, achats).
get_documentdocument_id* integeraucuneDétail d'un document : lignes, montants, statut, Peppol, synchronisation comptable, liens.
list_productsq string
page integer
aucuneProduits et services du catalogue.
get_revenuefrom string
to string
compare previous_year | previous_period | none
group_by month | none
aucuneChiffre d'affaires sur une période (factures + reçus non convertis, moins les notes de crédit), comparaison et détail mensuel.
get_topfrom string
to string
kind customers | products
limit integer
aucuneMeilleurs clients ou produits sur une période.
get_unpaid_invoicesaucunaucuneFactures impayées : reste dû, retard, relances déjà envoyées.
get_remindersdocument_id integerRelances de paiementRéglages et historique des relances (e-mail et SMS).
get_sms_creditsaucunaucuneCrédits SMS restants.
get_peppol_statusaucunaucuneStatut Peppol : identifiant, demande d'activation, documents reçus et envoyés, validations, erreurs. Lecture seule.
get_accounting_sync_statusfrom stringaucuneDocuments synchronisés, en attente ou en erreur avec WinAuditor, WinBooks Connect, Horus et les autres intégrations comptables.
get_bank_sync_statusaucunaucuneBankSync : comptes, dernière synchronisation, transactions non rapprochées. Lecture seule.
get_import_mailboxaucunaucuneBoîte mail d'import automatique : adresse, mails reçus, documents importés ou en erreur.
get_document_settingsaucunaucuneParamètres de documents : conditions générales, mentions, en-têtes et pieds de page, logo.
get_business_insightstopic* accounting | vat | bank | purchases | transactions | monthly_averages | fixed_charges | projections | payment_plans | credits | leases | vehicles | social_contributions | tax_estimation | stock | naceselon topic (tableau plus bas)Analyses de gestion calculées par Novadesko (mêmes chiffres que Nova AI), selon le sujet choisi.
list_pending_actionsaucunaucuneAperçus en attente de confirmation dans cette conversation.
searchquery* stringaucuneRecherche transversale (clients, fournisseurs, documents). Renvoie des identifiants à lire avec fetch. (MCP seulement)
fetchid* stringaucuneLit un résultat de search (customer:ID, supplier:ID ou document:ID). (MCP seulement)

Préparation (write)

OutilParamètres (* obligatoire)Fonctionnalité requiseRôle
prepare_party_createkind* customer | supplier
company string
first_name string
last_name string
email string
phone string
address string
postal_code string
city string
country_code string
vat_number string
iban string
is_individual boolean
Gestion des clients si kind = customerAperçu de création d'un client ou fournisseur (contrôles VIES, article 30 bis, Peppol). N'enregistre rien.
prepare_party_updatekind* customer | supplier
id* integer
changes* object
Gestion des clients si kind = customerAperçu de modification d'une fiche client ou fournisseur. N'enregistre rien.
prepare_document_createtype* estimate | order | invoice | receipt | credit_note | proforma
customer_id* integer
date string
due_date string
object string
notes string
parent_document_id integer
lines* array<object>
selon type : Facturation, Bons de commande (order), Reçus (receipt)Aperçu PDF d'un nouveau devis, bon de commande, facture, reçu, proforma ou note de crédit. Le numéro légal est attribué à la confirmation.
prepare_document_updatedocument_id* integer
date string
due_date string
object string
notes string
lines array<object>
aucuneAperçu PDF de modification d'un document modifiable (non verrouillé, non transmis via Peppol). lines remplace toutes les lignes.
prepare_document_convertdocument_id* integer
to_type* order | invoice | credit_note
selon to_typeAperçu de conversion : devis vers commande ou facture ; commande, reçu ou proforma vers facture ; facture vers note de crédit.
prepare_document_importdata* object
file_name* string
file_base64* string
accept_inconsistencies boolean
aucuneAperçu d'import d'une facture d'achat lue par l'IA, avec le fichier en base64 (pièce jointe conservée). Contrôle des totaux et de la TVA, aucun crédit OCR consommé. (MCP seulement)
prepare_settings_updateterms_html string
legal_notice_html string
footer array<object>
header array<object>
aucuneAperçu (PDF pour les conditions générales) de mise à jour des conditions générales, mentions légales, en-têtes et pieds de page.
prepare_paymentdocument_id* integer
amount* number
date string
payment_type* string
notes string
aucuneAperçu de l'enregistrement d'un paiement sur une facture, un reçu ou un achat : montant, date, mode de paiement (ex. banktransfert, cash, bankcard).
prepare_peppol_requestrequest* activate | disable | deleteActivation PeppolAperçu d'une demande Peppol traitée par l'équipe Novadesko : activation, désactivation ou suppression. N'envoie jamais de document via Peppol.
prepare_support_ticketsubject* string
message* string
aucuneAperçu d'un ticket au support Novadesko, créé au nom de l'utilisateur après sa confirmation.

Objet ligne de lines : kind (product | text), product_id, name, description, quantity, unit_price_ht, vat_rate, discount_pct, html. Les prix sont hors TVA, vat_rate en pour cent. Type text : bloc HTML simple filtré par liste blanche.

Envoi (send)

OutilParamètres (* obligatoire)Fonctionnalité requiseRôle
prepare_emailkind* customer | supplier
party_id* integer
to string
subject* string
body_html* string
aucuneAperçu d'un e-mail à un client ou fournisseur, uniquement vers une adresse de sa fiche.
prepare_reminderdocument_id* integer
channel* email | sms | both
subject string
message string
sms_message string
Relances de paiement (+ Envoi de SMS si channel = sms ou both)Aperçu d'une relance de facture impayée par e-mail, SMS ou les deux (crédits SMS vérifiés).

Exécution

OutilParamètres (* obligatoire)Fonctionnalité requiseRôle
confirm_actionconfirmation_token* stringaucuneExécute une action préparée, uniquement après accord explicite de l'utilisateur sur l'aperçu. Jeton à usage unique. (MCP seulement)
cancel_actionconfirmation_token* stringaucuneAnnule un aperçu en attente. (MCP seulement)

Sujets de get_business_insights

topicContenuFonctionnalité requise
accountingcompte de résultat et bilan provisoires, caisseRapports détaillés
vatTVA due ou à récupérer, périodesGestion de la TVA
banktrésorerie bancaire et liaisons BankSyncaucune
purchasesachats, fournisseurs et catégories de dépensesaucune
transactionsencaissements du mois par mode de paiementaucune
monthly_averageschiffre d'affaires et dépenses moyens sur 12 moisaucune
fixed_chargescharges fixes récurrentesaucune
projectionsprojections financières et seuil de rentabilitéaucune
payment_plansplans de paiementPlans de paiement
creditscrédits en coursCrédits
leasesbaux locatifs et loyersBaux locatifs
vehiclesvéhicules et coût véhiculeCarnet de route
social_contributionscotisations socialesCotisations sociales
tax_estimationestimation fiscaleEstimation fiscale
stockstock réelGestion de stock
naceactivités BCE (codes NACE)aucune

Types de documents

estimate, order, invoice, receipt, credit_note, proforma, purchase (achats, lecture seule).

Voir aussi