> For the complete documentation index, see [llms.txt](https://docs.abby.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.abby.fr/mcp/flux-de-travail.md).

# Flux de travail

Cette page décrit les flux de travail typiques pour les tâches les plus courantes avec le serveur MCP d'Abby. Chaque flux cite les outils décrits dans [Facturation](https://docs.abby.fr/mcp/facturation.md), [Déclarations URSSAF](https://docs.abby.fr/mcp/declarations-urssaf.md) et les règles de [Conventions](https://docs.abby.fr/mcp/conventions.md).

Dans tous les flux, un seul outil, `finalize-billing`, finalise une facture, un devis, un acompte ou un avoir. Il demande une confirmation : un premier appel renvoie un aperçu, et seul un second appel avec `confirm: true` finalise le document.

## Créer et envoyer une facture

```
get-customers → create-invoice → finalize-billing (aperçu) → finalize-billing (confirm) → send-invoice-by-email
```

1. **Identifier le client** : `get-customers` pour trouver le client à facturer
2. **Créer la facture** : `create-invoice` avec l'identifiant client et les lignes. La facture est créée en brouillon
3. **Voir l'aperçu** : `finalize-billing` sans `confirm` pour afficher le client et le montant, sans rien modifier
4. **Finaliser** : après l'accord de l'utilisateur, `finalize-billing` avec `confirm: true`. Le document reçoit son numéro définitif et n'est plus modifiable
5. **Envoyer par email** : `send-invoice-by-email` pour envoyer la facture au client

### Exemple

> "Crée une facture de 500€ pour Dupont SARL pour du développement web et envoie-la par email"

L'assistant IA va :

1. Chercher "Dupont SARL" dans les clients
2. Créer une facture avec une ligne "Développement web" à 50000 centimes
3. Demander l'aperçu de la finalisation et vous le montrer
4. Finaliser la facture après votre accord : elle reçoit son numéro
5. Envoyer la facture par email aux adresses indiquées

Pour le même scénario avec l'API REST, du brouillon au paiement, lisez [Facturer un client, du brouillon au paiement](https://docs.abby.fr/guides/facturer-un-client.md).

***

## Corriger un brouillon

Avant la finalisation, trois outils modifient un brouillon :

* `update-billing-lines` remplace toutes les lignes
* `update-billing-timeline` change la date d'émission, le délai de paiement ou l'échéance
* `update-billing-texts` change le titre, la note d'en-tête et la note de pied de page

Ces outils ne s'appliquent qu'aux brouillons. Pour annuler une facture finalisée, voir plus bas.

***

## Devis complet avec signature et acompte

```
create-estimate → finalize-billing → sign-estimate → create-advance → finalize-billing
```

1. **Créer le devis** : `create-estimate` avec les lignes détaillant la prestation
2. **Finaliser le devis** : `finalize-billing` (aperçu, puis `confirm: true`) pour obtenir un numéro de devis
3. **Signature** : `sign-estimate` quand le client accepte. N'appelez cet outil qu'avec son accord explicite
4. **Créer l'acompte** : `create-advance` en référençant le devis (pourcentage, ou montant fixe en centimes). Le devis doit être finalisé ou signé
5. **Finaliser l'acompte** : `finalize-billing` (aperçu, puis `confirm: true`) pour obtenir un numéro d'acompte

### Exemple

> "Fais un devis de 2000€ pour la refonte du site de Martin SAS avec un acompte de 30%"

L'assistant IA va :

1. Créer un devis avec une ligne "Refonte site web" à 200000 centimes
2. Finaliser le devis après votre accord : il reçoit son numéro
3. Après acceptation, marquer le devis comme signé
4. Créer un acompte de 30% (soit 600€)
5. Finaliser l'acompte après votre accord : il reçoit son numéro

Pour le même scénario avec l'API REST, lisez [Du devis à la facture, avec un acompte](https://docs.abby.fr/guides/devis-acompte-facture.md).

***

## Annuler une facture

```
cancel-invoice
```

1. **Annuler** : `cancel-invoice` avec l'identifiant de la facture finalisée

L'annulation **crée automatiquement un avoir** (note de crédit) associé à la facture. Cet outil n'a pas d'aperçu : il agit dès le premier appel, et l'action est irréversible. Demandez l'accord de l'utilisateur avant de l'appeler.

Pour la procédure avec l'API REST, lisez [Annuler une facture et émettre un avoir](https://docs.abby.fr/guides/emettre-un-avoir.md).

***

## Déclarer et payer l'URSSAF

```
get-turnover-estimations → complete-urssaf-declaration (aperçu) → complete-urssaf-declaration (exécution)
```

1. **Estimer le CA** : `get-turnover-estimations` pour obtenir le chiffre d'affaires estimé et les cotisations de la période en cours. Les montants de cet outil sont en euros
2. **Aperçu** : `complete-urssaf-declaration` sans `execute` pour voir le chiffre d'affaires, les cotisations estimées et l'échéance avant de soumettre
3. **Soumettre et payer** : après confirmation de l'utilisateur, `complete-urssaf-declaration` avec `execute: true` et, pour payer, `pay: true`

Le chiffre d'affaires déclaré est celui qu'Abby estime : on ne le passe pas en paramètre.

### Exemple

> "Déclare mon CA du trimestre à l'URSSAF et paie les cotisations"

L'assistant IA va :

1. Récupérer l'estimation du CA pour la période en cours
2. Afficher un aperçu : le chiffre d'affaires, les cotisations estimées et l'échéance, puis demander : "Voulez-vous soumettre ?"
3. Après confirmation, soumettre la déclaration et payer les cotisations

{% hint style="danger" %}
La déclaration URSSAF est une **action réelle** : avec `execute: true`, elle est transmise à l'URSSAF. Sans `execute: true`, l'outil ne renvoie qu'un aperçu. Il n'existe pas d'équivalent dans l'API REST publique.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.abby.fr/mcp/flux-de-travail.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
