Tous les outils de votre assistant IA, domaine par domaine
La liste complète de ce que votre assistant peut faire dans Calepio : consulter, préparer un brouillon ou, si vous l'y autorisez, finaliser, envoyer, encaisser ou supprimer.
Quand vous connectez un assistant, Calepio lui propose des outils : chacun fait une seule chose (lister vos factures, préparer un devis…). L'assistant choisit lui-même ceux qui servent votre demande. Cette page les liste tous ; elle est produite à partir de Calepio et suit donc chaque nouveauté.
- LectureConsulte vos données sans rien modifier. Disponible dès que le domaine est coché, même en accès « Lecture seule ».
- Brouillon ou fichePrépare un brouillon ou crée une fiche (client, dépense, tâche…). Demande l'accès « Lecture et brouillons ».
- Action sensibleFinaliser, envoyer, encaisser ou supprimer. Désactivée par défaut : vous seul l'activez, connexion par connexion, dans Paramètres › Assistants IA.
Un outil n'est proposé à l'assistant que si son domaine est coché pour la connexion (Paramètres > Assistants IA, bouton Modifier). Les actions sensibles restent invisibles pour l'assistant tant que vous ne les avez pas autorisées : voir Autoriser des actions sensibles.
Toujours disponibles
Proposés à tout assistant connecté, quels que soient les domaines cochés.
Aperçu du compte Calepio
LectureRenvoie l'entreprise de l'utilisateur (nom, SIRET, activité, régime de TVA, périodicité URSSAF), son abonnement Calepio (fonctions Pro verrouillées, signatures restantes), ses conditions de facturation par défaut (délais, moyens de paiement, mentions, relances, paiement en ligne) et les droits accordés à cet assistant.
Détails techniques
Nom de l'outil :
get_account_overviewRenvoie l'entreprise de l'utilisateur (nom, SIRET, activité, régime de TVA, périodicité URSSAF), son abonnement Calepio (fonctions Pro verrouillées, signatures restantes), ses conditions de facturation par défaut (délais, moyens de paiement, mentions, relances, paiement en ligne) et les droits accordés à cet assistant.
Recherche globale
LectureRecherche un texte (au moins 2 caractères) dans les fiches de l'utilisateur : clients et contacts (nom, prénom et nom, e-mail), documents (numéro comme F-2026-0042, titre ou nom du client), articles du catalogue, tâches, dépenses et fournisseurs.
Détails techniques
Nom de l'outil :
searchRecherche un texte (au moins 2 caractères) dans les fiches de l'utilisateur : clients et contacts (nom, prénom et nom, e-mail), documents (numéro comme F-2026-0042, titre ou nom du client), articles du catalogue, tâches, dépenses et fournisseurs. Renvoie au plus 5 résultats par famille, avec leur identifiant et leur lien. Seules les familles des domaines accordés à cet assistant sont cherchées. Les clients, contacts, articles et fournisseurs archivés sont exclus : list_clients, list_articles ou list_suppliers avec include_archived les retrouvent.
Paramètres : query (obligatoire)
Lister les notifications
LectureNotifications de l'utilisateur dans Calepio, de la plus récente à la plus ancienne : paiements reçus ou refusés, devis signés, refusés ou bientôt expirés, factures en retard et relances, échéances URSSAF et TVA, seuils de chiffre d'affaires, facturation électronique, annonces.
Détails techniques
Nom de l'outil :
list_notificationsNotifications de l'utilisateur dans Calepio, de la plus récente à la plus ancienne : paiements reçus ou refusés, devis signés, refusés ou bientôt expirés, factures en retard et relances, échéances URSSAF et TVA, seuils de chiffre d'affaires, facturation électronique, annonces. Par défaut les non lues encore d'actualité, pour répondre à « Quoi de neuf ? » ou « Qu'est-ce que je dois traiter ? ». Lecture seule : ne marque rien comme lu ni archivé. Seules les notifications des domaines accordés à cet assistant sont renvoyées, sans les catégories masquées par l'utilisateur.
Paramètres : status, level, limit
Facturation
Proposés si le domaine Facturation est coché pour la connexion (devis, factures, articles).
Créer un article du catalogue
Brouillon ou ficheAjoute un article ou une prestation au catalogue (nom, description, prix unitaire HT, unité), réutilisable dans les lignes de documents.
Détails techniques
Nom de l'outil :
create_articleAjoute un article ou une prestation au catalogue (nom, description, prix unitaire HT, unité), réutilisable dans les lignes de documents via article_id. Signale un article existant de même nom.
Paramètres : name (obligatoire), description, unit_price (obligatoire), unit, discount
Modifier un article du catalogue
Brouillon ou ficheModifie un article du catalogue : seuls les champs fournis changent.
Détails techniques
Nom de l'outil :
update_articleModifie un article du catalogue : seuls les champs fournis changent. Les documents existants gardent leurs lignes. « archived » archive (fonction Pro) ou restaure l'article : archivé, il n'est plus proposé dans l'éditeur ni utilisable comme article_id ; list_articles avec include_archived le retrouve.
Paramètres : article_id (obligatoire), expected_updated_at, name, description, unit_price, unit, discount, archived
Lister les articles du catalogue
LectureListe le catalogue d'articles et de prestations de l'utilisateur (nom, prix unitaire HT, unité), réutilisables comme lignes de devis ou de facture.
Détails techniques
Nom de l'outil :
list_articlesListe le catalogue d'articles et de prestations de l'utilisateur (nom, prix unitaire HT, unité), réutilisables comme lignes de devis ou de facture. Filtre par texte, trié par nom, paginé. Les articles archivés sont exclus, sauf avec include_archived.
Paramètres : query, include_archived, limit, cursor, response_format
Lister les documents
LectureListe les documents commerciaux : factures, factures d'acompte, devis, bons de commande et avoirs.
Détails techniques
Nom de l'outil :
list_documentsListe les documents commerciaux : factures, factures d'acompte, devis, bons de commande et avoirs. Filtres : types, statuts, client, période d'émission, factures en retard, texte (numéro, titre ou nom du client). Renvoie pour chacun le statut affiché dans Calepio, les totaux et le reste à encaisser. Paginé. Par défaut, brouillons et documents annulés sont inclus : pour un chiffre d'affaires facturé, filtrez statuses sur finalized, sent, partially_paid et paid (avoirs compris en négatif) ; pour le CA déclarable, préférez get_revenue_summary (encaissé).
Paramètres : types, statuses, client_id, contact_id, date_from, date_to, overdue_only, query, sort, include_archived, limit, cursor, response_format
Détail d'un document
LectureRenvoie un document complet (facture, acompte, devis, bon de commande ou avoir), désigné par son identifiant ou son numéro : destinataire, dates et période de prestation, lignes, totaux et TVA, mentions et conditions, notes privées, relances, acompte attendu, versements reçus, reste dû, mises en demeure, signature, commande rattachée, documents liés et lien vers Calepio.
Détails techniques
Nom de l'outil :
get_documentRenvoie un document complet (facture, acompte, devis, bon de commande ou avoir), désigné par son identifiant ou son numéro : destinataire, dates et période de prestation, lignes (avec leur line_id), totaux et TVA, mentions et conditions, notes privées, relances, acompte attendu, versements reçus, reste dû, mises en demeure, signature, commande rattachée, documents liés et lien vers Calepio.
Paramètres : document_id, number
Lien vers le PDF d'un document
LecturePour un document finalisé, renvoie un lien de téléchargement temporaire (5 minutes) vers son PDF archivé dans Calepio.
Détails techniques
Nom de l'outil :
get_document_pdf_linkPour un document finalisé, renvoie un lien de téléchargement temporaire (5 minutes) vers son PDF archivé dans Calepio. Un brouillon n'a pas encore de PDF : le lien renvoyé ouvre alors son aperçu dans l'éditeur.
Paramètres : document_id, number
Suivi de facturation d'un devis
LecturePour un devis ou un bon de commande : signature et options retenues, acompte attendu, documents déjà émis à partir de lui (acomptes, factures, situations, bons de commande), montant déjà facturé, reste à facturer HT et avancement des factures de situation.
Détails techniques
Nom de l'outil :
get_quote_billing_statusPour un devis ou un bon de commande : signature et options retenues, acompte attendu, documents déjà émis à partir de lui (acomptes, factures, situations, bons de commande), montant déjà facturé, reste à facturer HT et avancement des factures de situation.
Paramètres : document_id, number
Impayés et retards
LectureFactures et factures d'acompte émises qui restent à encaisser : total dû, part en retard, répartition par client, et pour chaque facture le reste dû, les jours de retard, les relances déjà envoyées et la prochaine relance automatique.
Détails techniques
Nom de l'outil :
get_receivablesFactures et factures d'acompte émises qui restent à encaisser : total dû, part en retard, répartition par client, et pour chaque facture le reste dû, les jours de retard, les relances déjà envoyées et la prochaine relance automatique. Triées du plus grand retard au plus petit, paginées.
Paramètres : client_id, contact_id, overdue_only, min_days_overdue, limit, cursor
Mises en demeure et notes de pénalités
LectureMises en demeure et notes de pénalités de retard déjà émises dans Calepio pour des factures impayées : numéro, date, facture et client concernés, jours de retard, principal, pénalités, indemnité de recouvrement et total réclamé.
Détails techniques
Nom de l'outil :
list_formal_noticesMises en demeure et notes de pénalités de retard déjà émises dans Calepio pour des factures impayées : numéro, date, facture et client concernés, jours de retard, principal, pénalités, indemnité de recouvrement et total réclamé. Les plus récentes d'abord, paginées. Leur création se fait dans Calepio (fiche de la facture).
Paramètres : invoice_id, invoice_number, client_id, contact_id, kind, issued_from, issued_to, limit, cursor
Lister les factures récurrentes
LectureListe les modèles de factures récurrentes (fonction Pro) : client, fréquence, prochaine émission, actif ou non, émission automatique, montant HT.
Détails techniques
Nom de l'outil :
list_recurring_invoicesListe les modèles de factures récurrentes (fonction Pro) : client, fréquence, prochaine émission, actif ou non, émission automatique, montant HT. Paginé.
Paramètres : active_only, limit, cursor, response_format
Valeurs par défaut d'un document
LectureRenvoie exactement les valeurs que Calepio appliquerait à un nouveau document si un champ était omis : dates, délai de paiement, moyens de paiement, mentions (TVA, pénalités, escompte, médiateur), accord du client, paiement en ligne, indemnité de recouvrement, relances, taux de TVA et nature comptable par défaut.
Détails techniques
Nom de l'outil :
get_document_defaultsRenvoie exactement les valeurs que Calepio appliquerait à un nouveau document si un champ était omis : dates, délai de paiement, moyens de paiement, mentions (TVA, pénalités, escompte, médiateur), accord du client, paiement en ligne, indemnité de recouvrement, relances, taux de TVA et nature comptable par défaut. Utile avant create_document_draft.
Paramètres : type (obligatoire)
Créer un brouillon de document
Brouillon ou ficheCrée un brouillon de facture, devis, bon de commande ou avoir avec tous les champs de l'éditeur Calepio (destinataire, dates, date ou période de prestation, lignes, mentions, conditions, accord du client, paiement en ligne, relances, acompte attendu).
Détails techniques
Nom de l'outil :
create_document_draftCrée un BROUILLON de facture, devis, bon de commande ou avoir avec tous les champs de l'éditeur Calepio (destinataire, dates, date ou période de prestation, lignes, mentions, conditions, accord du client, paiement en ligne, relances, acompte attendu). Tout champ omis prend la valeur par défaut de l'entreprise (voir get_document_defaults) ; les totaux sont toujours calculés par Calepio. Le brouillon n'a ni numéro ni valeur légale : l'utilisateur le vérifie et le finalise lui-même dans Calepio. Pour une facture d'acompte, utilisez create_deposit_invoice_draft ; pour un avoir sur une facture existante, create_credit_note_draft.
Paramètres : type (obligatoire), recipient (obligatoire), source_document_id, issue_date, due_date, payment_terms_days, delivery_date, service_period, buyer_reference, buyer_order_reference, title, show_title, header_notes, notes, terms, payment_methods, other_payment_methods, payment_delay_custom, late_penalty, discount_terms, mediator_mention, vat_mention, approval, use_online_payment, recovery_indemnity, reminders, global_discount, expected_deposit, lines (obligatoire)
Modifier un brouillon de document
Brouillon ou ficheModifie un brouillon existant (jamais un document finalisé) : seuls les champs fournis changent, avec les mêmes règles que l'éditeur (une nouvelle date d'émission décale l'échéance, etc.).
Détails techniques
Nom de l'outil :
update_document_draftModifie un BROUILLON existant (jamais un document finalisé) : seuls les champs fournis changent, avec les mêmes règles que l'éditeur (une nouvelle date d'émission décale l'échéance, etc.). Lignes, de préférence ciblées : « update_lines » modifie des lignes précises (line_id + champs à changer), « remove_line_ids » en retire, « add_lines » en ajoute à la fin ; les autres lignes restent intactes, y compris les déductions d'acompte. « lines » REMPLACE toutes les lignes : une ligne avec son line_id y garde ses réglages, une ligne sans line_id est nouvelle. Les line_id viennent de get_document ou du résultat de la dernière modification (ils changent à chaque enregistrement). Passez expected_updated_at (lu avec get_document) pour refuser la modification si le brouillon a changé entre-temps.
Paramètres : document_id (obligatoire), expected_updated_at, recipient, source_document_id, issue_date, due_date, payment_terms_days, delivery_date, service_period, buyer_reference, buyer_order_reference, title, show_title, header_notes, notes, terms, payment_methods, other_payment_methods, payment_delay_custom, late_penalty, discount_terms, mediator_mention, vat_mention, approval, use_online_payment, recovery_indemnity, reminders, global_discount, expected_deposit, update_lines, remove_line_ids, add_lines, lines
Notes privées d'un document
Brouillon ou ficheRemplace les notes privées d'un document, même finalisé : mémo interne jamais imprimé ni envoyé au client (ex. « Relancé par téléphone le 12/11, paiement promis vendredi »).
Détails techniques
Nom de l'outil :
update_document_private_notesRemplace les notes privées d'un document, même finalisé : mémo interne jamais imprimé ni envoyé au client (ex. « Relancé par téléphone le 12/11, paiement promis vendredi »). Le document lui-même ne change pas. Lisez les notes actuelles avec get_document pour les compléter plutôt que les écraser ; une chaîne vide les efface.
Paramètres : document_id, number, private_notes (obligatoire)
Dupliquer un document en brouillon
Brouillon ou ficheCrée un nouveau brouillon du même type à partir d'un document existant (brouillon ou finalisé) : contenu et conditions repris, dates remises à aujourd'hui, sans numéro.
Détails techniques
Nom de l'outil :
duplicate_document_as_draftCrée un nouveau brouillon du même type à partir d'un document existant (brouillon ou finalisé) : contenu et conditions repris, dates remises à aujourd'hui, sans numéro. Ajustez ensuite le brouillon avec update_document_draft (titre, dates, destinataire…). Les documents importés (imported dans list_documents) ne sont pas duplicables.
Paramètres : document_id, number
Transformer un devis en facture (brouillon)
Brouillon ou ficheCrée le brouillon de facture d'un devis ou d'un bon de commande finalisé : lignes reprises, acomptes déjà facturés déduits, lien avec le devis conservé.
Détails techniques
Nom de l'outil :
convert_quote_to_invoice_draftCrée le brouillon de facture d'un devis ou d'un bon de commande finalisé : lignes reprises (options retenues à la signature en ligne, sinon celles de include_option_ids), acomptes déjà facturés déduits, lien avec le devis conservé. Les autres factures déjà émises depuis le devis ne sont PAS déduites : refusé si le devis est entièrement facturé ; pour facturer un reliquat, préférez create_progress_invoice_draft (is_final). Vérifiez avec get_quote_billing_status.
Paramètres : document_id, number, include_option_ids
Créer un bon de commande depuis un devis (brouillon)
Brouillon ou ficheCrée le brouillon de bon de commande d'un devis finalisé : destinataire, lignes, conditions et mentions repris ; le bon de commande garde le lien avec le devis.
Détails techniques
Nom de l'outil :
convert_quote_to_purchase_order_draftCrée le brouillon de bon de commande d'un devis finalisé : destinataire, lignes (options retenues ou include_option_ids), conditions et mentions repris ; le bon de commande garde le lien avec le devis.
Paramètres : document_id, number, include_option_ids
Créer une facture d'acompte (brouillon)
Brouillon ou ficheCrée le brouillon d'une facture d'acompte sur un devis ou un bon de commande signé : un pourcentage ou un montant TTC, ventilé par taux de TVA au prorata du montant signé (options retenues comprises).
Détails techniques
Nom de l'outil :
create_deposit_invoice_draftCrée le brouillon d'une facture d'acompte sur un devis ou un bon de commande SIGNÉ : un pourcentage ou un montant TTC, ventilé par taux de TVA au prorata du montant signé (options retenues comprises). L'utilisateur la vérifie et la finalise dans Calepio ; elle sera déduite de la facture finale.
Paramètres : document_id, number, mode (obligatoire), value (obligatoire), description
Créer une facture de situation (brouillon)
Brouillon ou ficheCrée le brouillon d'une facture de situation (avancement) d'un devis finalisé : avancement cumulé global en %, ou par prestation.
Détails techniques
Nom de l'outil :
create_progress_invoice_draftCrée le brouillon d'une facture de situation (avancement) d'un devis finalisé : avancement cumulé global en %, ou par prestation (line_targets : line_id du devis → % cumulé). Les situations et acomptes précédents sont déduits ; is_final facture le reliquat. Voir get_quote_billing_status pour l'avancement actuel.
Paramètres : document_id, number, mode (obligatoire), target_percentage, line_targets, title, is_final, due_date
Créer un avoir (brouillon)
Brouillon ou ficheCrée le brouillon d'avoir d'une facture finalisée.
Détails techniques
Nom de l'outil :
create_credit_note_draftCrée le brouillon d'avoir d'une facture finalisée. Sans « amount » : avoir total, toutes les lignes reprises en négatif. Avec « amount » : avoir partiel d'une seule ligne (montant HT, motif dans « reason »), seule possibilité pour une facture importée d'un ancien logiciel. Refusé au-delà du montant de la facture déjà remboursé par des avoirs.
Paramètres : document_id, number, amount, reason, vat_rate
Créer un échéancier de factures (brouillons)
Brouillon ou ficheDécoupe un devis finalisé en 2 à 52 factures brouillons périodiques de montants égaux (la dernière absorbe l'arrondi), une par période de prestation : hebdomadaire, toutes les deux semaines ou mensuelle.
Détails techniques
Nom de l'outil :
create_billing_schedule_draftsDécoupe un devis finalisé en 2 à 52 factures BROUILLONS périodiques de montants égaux (la dernière absorbe l'arrondi), une par période de prestation : hebdomadaire, toutes les deux semaines ou mensuelle à partir de start_date.
Paramètres : document_id, number, count (obligatoire), frequency (obligatoire), start_date (obligatoire)
Préparer une facture récurrente
Brouillon ou fichePrépare un modèle de facture récurrente (fonction Pro) : libellé, client, fréquence, date de prochaine émission, notes et lignes.
Détails techniques
Nom de l'outil :
create_recurring_invoice_modelPrépare un modèle de facture récurrente (fonction Pro) : libellé, client, fréquence, date de prochaine émission, notes et lignes. Le modèle est toujours créé INACTIF : rien n'est émis tant que l'utilisateur ne l'a pas activé dans Calepio.
Paramètres : label (obligatoire), client_id, contact_id, frequency, next_run_date, notes, lines (obligatoire)
Modifier une facture récurrente inactive
Brouillon ou ficheModifie un modèle de facture récurrente inactif (seuls les champs fournis changent ; « lines » remplace toutes les lignes).
Détails techniques
Nom de l'outil :
update_recurring_invoice_modelModifie un modèle de facture récurrente INACTIF (seuls les champs fournis changent ; « lines » remplace toutes les lignes). Un modèle actif se modifie dans Calepio.
Paramètres : recurring_id (obligatoire), expected_updated_at, label, client_id, contact_id, frequency, next_run_date, notes, lines
Préparer l'envoi d'un document
Brouillon ou fichePrépare l'envoi d'un document par e-mail sans l'envoyer : Calepio enregistre destinataire, objet et message, et renvoie un lien qui ouvre le document avec la fenêtre « Envoyer par mail » déjà remplie ; l'utilisateur relit et envoie lui-même.
Détails techniques
Nom de l'outil :
prepare_document_emailPrépare l'envoi d'un document par e-mail SANS l'envoyer : Calepio enregistre destinataire, objet et message, et renvoie un lien (app_url) qui ouvre le document avec la fenêtre « Envoyer par mail » déjà remplie ; l'utilisateur relit et envoie lui-même. Pour un brouillon, le lien ouvre l'éditeur : l'e-mail préparé l'attend après la finalisation. Champs omis : le modèle d'e-mail de l'utilisateur et l'adresse du client. Remplace l'e-mail déjà préparé pour ce document.
Paramètres : document_id, number, to, subject, message, cc_self
Signaler un paiement reçu
Brouillon ou ficheSignale à l'utilisateur un paiement reçu sans l'enregistrer : Calepio crée une notification « Marquer F-2026-0042 payée ? » dont le bouton ouvre l'encaissement prérempli (montant, date, moyen) ; l'utilisateur vérifie puis valide.
Détails techniques
Nom de l'outil :
propose_paymentSignale à l'utilisateur un paiement reçu SANS l'enregistrer : Calepio crée une notification « Marquer F-2026-0042 payée ? » dont le bouton ouvre l'encaissement prérempli (montant, date, moyen) ; l'utilisateur vérifie puis valide. À utiliser quand l'utilisateur dit avoir reçu un virement, un chèque… Montant par défaut : le reste dû.
Paramètres : document_id, number, amount, paid_at, payment_method, note
Finaliser un document
Action sensibleFinalise un brouillon (devis, facture, acompte, avoir ou bon de commande) tel qu'il est enregistré : Calepio lui attribue le prochain numéro, fige le vendeur et le client, génère et scelle le PDF (Factur-X pour une facture), comme le bouton « Finaliser » de l'éditeur.
Désactivée par défaut · autorisation « Finaliser les documents »
Détails techniques
Nom de l'outil :
finalize_documentFinalise un BROUILLON (devis, facture, acompte, avoir ou bon de commande) tel qu'il est enregistré : Calepio lui attribue le prochain numéro, fige le vendeur et le client, génère et scelle le PDF (Factur-X pour une facture), comme le bouton « Finaliser » de l'éditeur. Irréversible : un document finalisé ne se modifie plus et ne se supprime plus. Action sensible (« Finaliser les documents »), activée par l'utilisateur dans Paramètres › Assistants IA : Une facture finalisée ne peut plus être modifiée ni supprimée : une erreur se corrige par un avoir.
Paramètres : document_id (obligatoire), confirmation_token
Envoyer un document par e-mail
Action sensibleEnvoie un document finalisé (facture, devis, avoir, bon de commande) par e-mail au client, PDF joint, comme la fenêtre « Envoyer par mail » de Calepio : même adresse d'expédition (celle de l'utilisateur ou de Calepio), mêmes quotas et règles anti-abus, lien de signature ou de paiement en ligne ajouté s'il y a lieu.
Désactivée par défaut · autorisation « Envoyer des e-mails à vos clients »
Détails techniques
Nom de l'outil :
send_document_emailEnvoie un document FINALISÉ (facture, devis, avoir, bon de commande) par e-mail au client, PDF joint, comme la fenêtre « Envoyer par mail » de Calepio : même adresse d'expédition (celle de l'utilisateur ou de Calepio), mêmes quotas et règles anti-abus, lien de signature ou de paiement en ligne ajouté s'il y a lieu. Sans to, subject ni message, reprend l'e-mail préparé avec prepare_document_email, sinon le modèle de l'utilisateur. Action sensible (« Envoyer des e-mails à vos clients »), activée par l'utilisateur dans Paramètres › Assistants IA : Un e-mail envoyé ne se rattrape pas : l'assistant écrit à vos clients en votre nom.
Paramètres : document_id, number, to, subject, message, cc_self, confirmation_token
Enregistrer un paiement
Action sensibleEnregistre un encaissement (total ou partiel, sans dépasser le reste dû) sur une facture ou une facture d'acompte finalisée, comme « Enregistrer un paiement » dans Calepio : la facture passe en payée ou partiellement payée et le montant entre dans le chiffre d'affaires encaissé (déclaration URSSAF).
Désactivée par défaut · autorisation « Enregistrer des paiements »
Détails techniques
Nom de l'outil :
record_paymentEnregistre un encaissement (total ou partiel, sans dépasser le reste dû) sur une facture ou une facture d'acompte finalisée, comme « Enregistrer un paiement » dans Calepio : la facture passe en payée ou partiellement payée et le montant entre dans le chiffre d'affaires encaissé (déclaration URSSAF). Pour seulement signaler un paiement à l'utilisateur, utilisez propose_payment. Action sensible (« Enregistrer des paiements »), activée par l'utilisateur dans Paramètres › Assistants IA : Un paiement enregistré par erreur fausse votre chiffre d'affaires déclaré.
Paramètres : document_id, number, amount, paid_at, payment_method, payment_reference, confirmation_token
Supprimer un brouillon
Action sensibleSupprime définitivement un brouillon (devis, facture, avoir, bon de commande non finalisé) ; le temps passé qui y était facturé redevient facturable.
Désactivée par défaut · autorisation « Supprimer »
Détails techniques
Nom de l'outil :
delete_document_draftSupprime définitivement un BROUILLON (devis, facture, avoir, bon de commande non finalisé) ; le temps passé qui y était facturé redevient facturable. Un document finalisé ne se supprime jamais (avoir ou annulation dans Calepio). Action sensible (« Supprimer »), activée par l'utilisateur dans Paramètres › Assistants IA : Une suppression est définitive : rien ne passe par une corbeille.
Paramètres : document_id (obligatoire), confirmation_token
Supprimer un article du catalogue
Action sensibleSupprime définitivement un article du catalogue.
Désactivée par défaut · autorisation « Supprimer »
Détails techniques
Nom de l'outil :
delete_articleSupprime définitivement un article du catalogue. Les documents déjà créés gardent leurs lignes. Pour seulement le retirer des choix, archivez-le (update_article, archived). Action sensible (« Supprimer »), activée par l'utilisateur dans Paramètres › Assistants IA : Une suppression est définitive : rien ne passe par une corbeille.
Paramètres : article_id (obligatoire), confirmation_token
Clients et contacts
Proposés si le domaine Clients et contacts est coché pour la connexion ().
Lister les clients
LectureListe les clients de l'utilisateur : entreprises (associations et administrations comprises) et contacts (interlocuteurs rattachés à une entreprise, ou particuliers).
Détails techniques
Nom de l'outil :
list_clientsListe les clients de l'utilisateur : entreprises (associations et administrations comprises) et contacts (interlocuteurs rattachés à une entreprise, ou particuliers). Filtre par texte (nom, e-mail, SIRET, ville), par type, archivés compris ou non. Trié par nom, paginé.
Paramètres : query, kind, include_archived, limit, cursor, response_format
Fiche client
LectureRenvoie la fiche complète d'un client : une entreprise ou un contact.
Détails techniques
Nom de l'outil :
get_clientRenvoie la fiche complète d'un client : une entreprise (`client_id`, avec ses interlocuteurs) ou un contact (`contact_id`, avec son entreprise éventuelle). Si le domaine Facturation est accordé, ajoute ses statistiques (CA, impayés en retard), ses 10 derniers documents et ses crédits disponibles (trop-perçu reporté).
Paramètres : client_id, contact_id
Créer une entreprise cliente
Brouillon ou ficheCrée une fiche client de type entreprise (associations et administrations comprises).
Détails techniques
Nom de l'outil :
create_clientCrée une fiche client de type entreprise (associations et administrations comprises). Pour une personne (particulier ou interlocuteur), utilisez create_contact. Signale un client existant de même nom ou SIRET.
Paramètres : name (obligatoire), email, phone, address_line, postal_code, city, country, siret, vat_number, notes, is_public_entity, chorus_service_code
Modifier une entreprise cliente
Brouillon ou ficheModifie une entreprise cliente : seuls les champs fournis changent (une chaîne vide efface la valeur).
Détails techniques
Nom de l'outil :
update_clientModifie une entreprise cliente : seuls les champs fournis changent (une chaîne vide efface la valeur). Les documents déjà finalisés gardent l'identité figée à leur émission. « archived » archive (fonction Pro) ou restaure l'entreprise ; list_clients avec include_archived retrouve une entreprise archivée.
Paramètres : client_id (obligatoire), expected_updated_at, name, email, phone, address_line, postal_code, city, country, siret, vat_number, notes, is_public_entity, chorus_service_code, archived
Créer un contact
Brouillon ou ficheCrée une personne : interlocuteur d'une entreprise ou particulier.
Détails techniques
Nom de l'outil :
create_contactCrée une personne : interlocuteur d'une entreprise (client_id) ou particulier (sans client_id). Au moins un prénom ou un nom est requis. Signale un contact existant de même e-mail ou de mêmes prénom et nom.
Paramètres : client_id, first_name, last_name, role, email, phone, address_line, postal_code, city, country, siret, vat_number
Modifier un contact
Brouillon ou ficheModifie un contact : seuls les champs fournis changent.
Détails techniques
Nom de l'outil :
update_contactModifie un contact : seuls les champs fournis changent (une chaîne vide efface la valeur, client_id null le détache de son entreprise). « archived » archive (fonction Pro) ou restaure le contact ; list_clients avec include_archived retrouve un contact archivé.
Paramètres : contact_id (obligatoire), expected_updated_at, client_id, first_name, last_name, role, email, phone, address_line, postal_code, city, country, siret, vat_number, archived
Supprimer une entreprise cliente
Action sensibleSupprime définitivement une entreprise cliente qui n'a aucun document.
Désactivée par défaut · autorisation « Supprimer »
Détails techniques
Nom de l'outil :
delete_clientSupprime définitivement une entreprise cliente qui n'a aucun document. Une entreprise avec des documents ne se supprime pas : archivez-la (update_client, archived). Action sensible (« Supprimer »), activée par l'utilisateur dans Paramètres › Assistants IA : Une suppression est définitive : rien ne passe par une corbeille.
Paramètres : client_id (obligatoire), confirmation_token
Supprimer un contact
Action sensibleSupprime définitivement un contact (particulier ou interlocuteur) qui n'a aucun document.
Désactivée par défaut · autorisation « Supprimer »
Détails techniques
Nom de l'outil :
delete_contactSupprime définitivement un contact (particulier ou interlocuteur) qui n'a aucun document. Un contact avec des documents ne se supprime pas : archivez-le (update_contact, archived). Action sensible (« Supprimer »), activée par l'utilisateur dans Paramètres › Assistants IA : Une suppression est définitive : rien ne passe par une corbeille.
Paramètres : contact_id (obligatoire), confirmation_token
Comptabilité
Proposés si le domaine Comptabilité est coché pour la connexion (chiffre d'affaires, URSSAF, dépenses).
Chiffre d'affaires et plafonds
LectureChiffre d'affaires d'une période (mois, trimestre, année ou dates libres) : encaissé (base de l'URSSAF et des plafonds micro, ventilé par nature) et facturé (factures émises moins avoirs), comparaison avec la même période de l'année précédente, et position de l'année face au plafond micro-entreprise et aux seuils de franchise de TVA.
Détails techniques
Nom de l'outil :
get_revenue_summaryChiffre d'affaires d'une période (mois, trimestre, année ou dates libres) : encaissé (base de l'URSSAF et des plafonds micro, ventilé par nature) et facturé (factures émises moins avoirs), comparaison avec la même période de l'année précédente, et position de l'année face au plafond micro-entreprise et aux seuils de franchise de TVA.
Paramètres : period, year, month, quarter, date_from, date_to
Déclaration URSSAF
LecturePrépare la déclaration de chiffre d'affaires URSSAF d'une période : CA encaissé à déclarer case par case, cotisations sociales estimées (ACRE, CFP, taxe pour frais de chambre, versement libératoire compris), fenêtre de déclaration et date limite.
Détails techniques
Nom de l'outil :
get_urssaf_declarationPrépare la déclaration de chiffre d'affaires URSSAF d'une période : CA encaissé à déclarer case par case, cotisations sociales estimées (ACRE, CFP, taxe pour frais de chambre, versement libératoire compris), fenêtre de déclaration et date limite. Sans paramètre : la déclaration ouverte en ce moment, sinon la prochaine. La périodicité (mensuelle ou trimestrielle) est celle de l'entreprise. Montants estimés : la déclaration se fait sur autoentrepreneur.urssaf.fr.
Paramètres : year, month, quarter
Prochaines échéances fiscales et sociales
LectureProchaines échéances de la micro-entreprise, de la plus proche à la plus lointaine : déclaration URSSAF, déclaration de TVA (si l'entreprise y est soumise), déclaration de revenus et CFE.
Détails techniques
Nom de l'outil :
get_upcoming_deadlinesProchaines échéances de la micro-entreprise, de la plus proche à la plus lointaine : déclaration URSSAF, déclaration de TVA (si l'entreprise y est soumise), déclaration de revenus et CFE.
Compte de résultat
LectureCompte de résultat d'une période (fonction Pro) : produits encaissés par nature de recette, charges par catégorie de dépense et résultat.
Détails techniques
Nom de l'outil :
get_income_statementCompte de résultat d'une période (fonction Pro) : produits encaissés par nature de recette, charges par catégorie de dépense et résultat. En franchise de TVA, les charges sont comptées TTC (TVA non récupérable).
Paramètres : period, year, month, quarter, date_from, date_to
Livre des recettes
LectureLivre des recettes : encaissements de factures (un versement peut donner une ligne par nature de recette et taux de TVA) et recettes saisies à la main, avec totaux de la période.
Détails techniques
Nom de l'outil :
list_recipesLivre des recettes : encaissements de factures (un versement peut donner une ligne par nature de recette et taux de TVA) et recettes saisies à la main, avec totaux de la période. Par défaut l'année en cours, du plus récent au plus ancien, paginé.
Paramètres : date_from, date_to, nature, source, limit, cursor
Registre des dépenses
LectureRegistre des achats et dépenses : filtres par période (défaut : l'année en cours), catégorie, fournisseur ou texte.
Détails techniques
Nom de l'outil :
list_expensesRegistre des achats et dépenses : filtres par période (défaut : l'année en cours), catégorie, fournisseur ou texte. Renvoie les totaux HT/TVA/TTC, la répartition par catégorie et les dépenses, de la plus récente à la plus ancienne, paginées. Les remboursements et avoirs des fournisseurs (refund) ont des montants négatifs : les totaux sont nets.
Paramètres : date_from, date_to, category, supplier_id, query, limit, cursor, response_format
Lister les fournisseurs
LectureListe les fournisseurs de l'utilisateur (entreprises ou particuliers) : nom, coordonnées, et en format détaillé SIRET, TVA, adresse et interlocuteur.
Détails techniques
Nom de l'outil :
list_suppliersListe les fournisseurs de l'utilisateur (entreprises ou particuliers) : nom, coordonnées, et en format détaillé SIRET, TVA, adresse et interlocuteur. Filtre par texte, trié par nom, paginé.
Paramètres : query, include_archived, limit, cursor, response_format
Enregistrer une dépense
Brouillon ou ficheAjoute une dépense au registre des achats : date, libellé, fournisseur, moyen de paiement et une ou plusieurs lignes ventilées par catégorie (HT et taux de TVA ; TVA et TTC calculés).
Détails techniques
Nom de l'outil :
create_expenseAjoute une dépense au registre des achats : date, libellé, fournisseur, moyen de paiement et une ou plusieurs lignes ventilées par catégorie (HT et taux de TVA ; TVA et TTC calculés). Avec kind = refund, enregistre un remboursement ou un avoir d'un fournisseur, déduit des achats (jamais une recette). Le justificatif s'ajoute ensuite dans Calepio.
Paramètres : kind, expense_date, label (obligatoire), supplier_id, supplier, payment_method, notes, lines (obligatoire)
Modifier une dépense
Brouillon ou ficheModifie une dépense : seuls les champs fournis changent.
Détails techniques
Nom de l'outil :
update_expenseModifie une dépense : seuls les champs fournis changent. « lines » modifie la ventilation ligne par ligne et doit compter autant de lignes que la dépense (voir list_expenses en format détaillé, même group_id) ; dans chaque ligne, un champ omis garde sa valeur. Montants positifs : un remboursement reste un remboursement, sauf si « kind » est fourni. Changer le nombre de lignes se fait dans Calepio.
Paramètres : expense_id (obligatoire), expected_updated_at, kind, expense_date, label, supplier_id, supplier, payment_method, notes, lines
Enregistrer une recette sans facture
Brouillon ou ficheAjoute au livre des recettes un encaissement sans facture Calepio (vente au comptoir, paiement d'une facture d'un ancien logiciel…) : date, client, référence, nature, moyen de paiement, montant HT et TVA.
Détails techniques
Nom de l'outil :
create_manual_recipeAjoute au livre des recettes un encaissement sans facture Calepio (vente au comptoir, paiement d'une facture d'un ancien logiciel…) : date, client, référence, nature, moyen de paiement, montant HT et TVA. Les encaissements de factures Calepio s'enregistrent sur la facture, dans l'app.
Paramètres : recipe_date, client, reference, nature, payment_method (obligatoire), amount_ht (obligatoire), vat_rate, notes
Modifier une recette sans facture
Brouillon ou ficheModifie une recette saisie à la main : seuls les champs fournis changent.
Détails techniques
Nom de l'outil :
update_manual_recipeModifie une recette saisie à la main (list_recipes, source manual) : seuls les champs fournis changent.
Paramètres : recipe_id (obligatoire), expected_updated_at, recipe_date, client, reference, nature, payment_method, amount_ht, vat_rate, notes
Créer un fournisseur
Brouillon ou ficheCrée une fiche fournisseur (entreprise ou particulier) : nom, nom commercial, SIRET, TVA, coordonnées, adresse, interlocuteur et notes.
Détails techniques
Nom de l'outil :
create_supplierCrée une fiche fournisseur (entreprise ou particulier) : nom, nom commercial, SIRET, TVA, coordonnées, adresse, interlocuteur et notes.
Paramètres : is_company, name (obligatoire), commercial_name, siret, vat_number, email, phone, address_line, address_line2, postal_code, city, country, contact_first_name, contact_last_name, contact_email, contact_phone, notes
Modifier un fournisseur
Brouillon ou ficheModifie une fiche fournisseur : seuls les champs fournis changent (une chaîne vide efface la valeur).
Détails techniques
Nom de l'outil :
update_supplierModifie une fiche fournisseur : seuls les champs fournis changent (une chaîne vide efface la valeur).
Paramètres : supplier_id (obligatoire), expected_updated_at, is_company, name, commercial_name, siret, vat_number, email, phone, address_line, address_line2, postal_code, city, country, contact_first_name, contact_last_name, contact_email, contact_phone, notes
Supprimer une dépense
Action sensibleSupprime définitivement une dépense du registre (et son justificatif s'il n'est plus utilisé).
Désactivée par défaut · autorisation « Supprimer »
Détails techniques
Nom de l'outil :
delete_expenseSupprime définitivement une dépense du registre (et son justificatif s'il n'est plus utilisé). Action sensible (« Supprimer »), activée par l'utilisateur dans Paramètres › Assistants IA : Une suppression est définitive : rien ne passe par une corbeille.
Paramètres : expense_id (obligatoire), confirmation_token
Productivité
Proposés si le domaine Productivité est coché pour la connexion (tâches, temps, commandes).
Lister les tâches
LectureListe les tâches de l'utilisateur.
Détails techniques
Nom de l'outil :
list_tasksListe les tâches de l'utilisateur. Catégories : all (toutes les tâches à faire), today (à faire aujourd'hui), upcoming (échéance à venir), overdue (en retard), no_date (sans échéance), completed (terminées). Filtres : statut (dont waiting = en attente du client), priorité, client, document, commande, texte. Renvoie aussi le nombre de tâches par catégorie. Paginé.
Paramètres : category, status, priority, client_id, contact_id, document_id, order_id, query, limit, cursor, response_format
Lister les temps passés
LectureListe les entrées de suivi du temps (chronomètre ou saisie) : libellé, durée, tarif, montant facturable HT, commande et tâche liées, déjà facturées ou non.
Détails techniques
Nom de l'outil :
list_time_entriesListe les entrées de suivi du temps (chronomètre ou saisie) : libellé, durée, tarif, montant facturable HT, commande et tâche liées, déjà facturées ou non. Filtres : période, commande, tâche, non facturées seulement. Renvoie les totaux (durée, montant, reste à facturer). Paginé, du plus récent au plus ancien.
Paramètres : date_from, date_to, order_id, task_id, unbilled_only, limit, cursor, response_format
Tableau de suivi des commandes
LectureTableau de suivi des commandes (kanban), le suivi commercial de Calepio (opportunités, affaires, projets) : colonnes avec leur nombre de cartes et leur montant total, puis les commandes (titre, colonne, client, montant, échéance, documents rattachés).
Détails techniques
Nom de l'outil :
list_ordersTableau de suivi des commandes (kanban), le suivi commercial de Calepio (opportunités, affaires, projets) : colonnes avec leur nombre de cartes et leur montant total, puis les commandes (titre, colonne, client, montant, échéance, documents rattachés). Filtres : colonne, client, texte. Paginé.
Paramètres : column_id, client_id, contact_id, query, limit, cursor, response_format
Créer une tâche
Brouillon ou ficheAjoute une tâche à la liste de l'utilisateur : titre (seul champ obligatoire), description, échéance (date et heure), priorité, statut, répétition, et liens facultatifs vers un client, un document ou une commande.
Détails techniques
Nom de l'outil :
create_taskAjoute une tâche à la liste de l'utilisateur : titre (seul champ obligatoire), description, échéance (date et heure), priorité, statut, répétition, et liens facultatifs vers un client, un document ou une commande.
Paramètres : title (obligatoire), description, due_date, due_time, priority, order_id, status, client_id, contact_id, document_id, close_with_document, recurrence, recurrence_interval
Modifier une tâche
Brouillon ou ficheModifie une tâche (seuls les champs fournis changent : statut, liens, répétition…) ou la marque terminée / à faire avec « done ».
Détails techniques
Nom de l'outil :
update_taskModifie une tâche (seuls les champs fournis changent : statut, liens, répétition…) ou la marque terminée / à faire avec « done ». null retire un lien.
Paramètres : task_id (obligatoire), expected_updated_at, title, description, due_date, due_time, priority, order_id, status, client_id, contact_id, document_id, close_with_document, recurrence, recurrence_interval, done
Saisir du temps passé
Brouillon ou ficheEnregistre du temps passé (saisie manuelle, pas de chronomètre) : libellé, jour du travail, durée en minutes, unité et tarif de facturation, commande et tâche liées.
Détails techniques
Nom de l'outil :
create_time_entryEnregistre du temps passé (saisie manuelle, pas de chronomètre) : libellé, jour du travail, durée en minutes, unité et tarif de facturation, commande et tâche liées. Le temps se facture ensuite avec bill_time_entries_to_draft, au client de la commande liée.
Paramètres : label (obligatoire), duration_minutes (obligatoire), unit, unit_price, order_id, task_id, date
Modifier du temps passé
Brouillon ou ficheModifie une entrée de temps (seuls les champs fournis changent).
Détails techniques
Nom de l'outil :
update_time_entryModifie une entrée de temps (seuls les champs fournis changent). Refusé pendant qu'un chronomètre tourne. Une entrée déjà facturée ne modifie pas la facture.
Paramètres : entry_id (obligatoire), expected_updated_at, label, duration_minutes, unit, unit_price, order_id, task_id, date
Facturer du temps passé (brouillon)
Brouillon ou ficheTransforme des entrées de temps non facturées d'un même client (celui de leur commande liée) en lignes de facture : nouveau brouillon de facture, ou ajout à un brouillon existant du même client.
Détails techniques
Nom de l'outil :
bill_time_entries_to_draftTransforme des entrées de temps non facturées d'un même client (celui de leur commande liée) en lignes de facture : nouveau BROUILLON de facture, ou ajout à un brouillon existant du même client (target_draft_id). Regroupement : une ligne par entrée (libellé et jour du travail), par tâche, par jour ou une seule ligne. Les entrées sont marquées facturées ; le brouillon se complète ensuite avec update_document_draft (titre, notes…), sans casser ce lien.
Paramètres : entry_ids (obligatoire), grouping, vat_rate, target_draft_id
Créer une commande
Brouillon ou ficheAjoute une carte au tableau de suivi des commandes, le suivi commercial de Calepio (opportunité, affaire, projet, pipeline) : titre, colonne (la première par défaut), client, montant HT, échéance, notes et documents rattachés (devis, factures…).
Détails techniques
Nom de l'outil :
create_orderAjoute une carte au tableau de suivi des commandes, le suivi commercial de Calepio (opportunité, affaire, projet, pipeline) : titre, colonne (la première par défaut), client, montant HT, échéance, notes et documents rattachés (devis, factures…).
Paramètres : title (obligatoire), column_id, client_id, contact_id, amount, due_date, notes, document_ids
Modifier une commande
Brouillon ou ficheModifie une commande du tableau de suivi (seuls les champs fournis changent).
Détails techniques
Nom de l'outil :
update_orderModifie une commande du tableau de suivi (seuls les champs fournis changent) ; column_id la déplace en fin de colonne ; link_document_ids / unlink_document_ids rattachent ou détachent des documents (devis, factures…, même finalisés).
Paramètres : order_id (obligatoire), expected_updated_at, title, column_id, client_id, contact_id, amount, due_date, notes, link_document_ids, unlink_document_ids
Supprimer une tâche
Action sensibleSupprime définitivement une tâche ; une tâche créée automatiquement par Calepio n'est pas recréée.
Désactivée par défaut · autorisation « Supprimer »
Détails techniques
Nom de l'outil :
delete_taskSupprime définitivement une tâche ; une tâche créée automatiquement par Calepio n'est pas recréée. Pour une tâche terminée, préférez update_task (statut fait). Action sensible (« Supprimer »), activée par l'utilisateur dans Paramètres › Assistants IA : Une suppression est définitive : rien ne passe par une corbeille.
Paramètres : task_id (obligatoire), confirmation_token
Supprimer du temps passé
Action sensibleSupprime définitivement une entrée de temps passé non facturée.
Désactivée par défaut · autorisation « Supprimer »
Détails techniques
Nom de l'outil :
delete_time_entrySupprime définitivement une entrée de temps passé non facturée. Action sensible (« Supprimer »), activée par l'utilisateur dans Paramètres › Assistants IA : Une suppression est définitive : rien ne passe par une corbeille.
Paramètres : time_entry_id (obligatoire), confirmation_token
Sous chaque outil, Détails techniques montre la description que lit l'assistant et ses paramètres. C'est utile si vous utilisez Claude Code ou si vous voulez comprendre une réponse de l'assistant.
Cet article vous a aidé ?
Articles connexes
Pas encore de compte ? Calepio est gratuit pour démarrer : devis et factures illimités.
Créer mon compte gratuit