> 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/facturation.md).

# Facturation

Les outils de facturation permettent de gérer l'ensemble du cycle de vie des documents : factures, devis, bons de commande, acomptes et avoirs. Cette page décrit 21 outils.

{% hint style="warning" %}
Tous les montants envoyés et lus sont exprimés en **centimes** (100 € = 10000). Les dates passées à l'outil `update-billing-timeline` sont des timestamps Unix en **secondes**. Consultez les [conventions](https://docs.abby.fr/mcp/conventions.md) pour plus de détails.
{% endhint %}

Pour voir ces outils enchaînés sur un cas complet, lisez [Flux de travail](https://docs.abby.fr/mcp/flux-de-travail.md). Pour faire la même chose avec l'API REST, lisez [Facturer un client, du brouillon au paiement](https://docs.abby.fr/guides/facturer-un-client.md).

## Consultation

### `get-billings`

Récupère les documents de facturation avec pagination et filtres. Les documents sont triés par date croissante : la première page contient les plus anciens. Les documents de test sont exclus.

**Paramètres**

| Paramètre    | Type      | Requis | Description                                                                           |
| ------------ | --------- | ------ | ------------------------------------------------------------------------------------- |
| `page`       | number    | Non    | Numéro de page, à partir de 1 (défaut : 1)                                            |
| `limit`      | number    | Non    | Résultats par page, de 1 à 100 (défaut : 10)                                          |
| `type`       | string\[] | Non    | Types : `invoice`, `estimate`, `advance`, `asset`, `purchase_order`                   |
| `state`      | string\[] | Non    | États : `draft`, `finalized`, `signed`, `refused`, `paid`                             |
| `search`     | string    | Non    | Recherche par numéro, titre ou nom client                                             |
| `customerId` | string    | Non    | Filtrer par identifiant client                                                        |
| `archived`   | boolean   | Non    | Filtrer par statut d'archivage                                                        |
| `late`       | boolean   | Non    | Uniquement les documents en retard                                                    |
| `rangeFrom`  | string    | Non    | Début de la plage de dates, au format `YYYY-MM-DD` (jour entier, fuseau Europe/Paris) |
| `rangeTo`    | string    | Non    | Fin de la plage de dates, au format `YYYY-MM-DD` (jour entier, fuseau Europe/Paris)   |
| `rangeType`  | string    | Non    | Champ de date : `emittedAt`, `dueAt`, `createdAt` ou `updatedAt`                      |

Le filtre de dates ne s'applique que si `rangeType` est fourni avec `rangeFrom` ou `rangeTo`.

**Réponse**

```json
{
  "total": 42,
  "page": 1,
  "limit": 10,
  "totalPages": 5,
  "hasNextPage": true,
  "hasPrevPage": false,
  "billings": [
    {
      "id": "string",
      "type": "invoice",
      "number": "FA-2025-001",
      "title": "string",
      "state": "finalized",
      "emittedAt": "…",
      "customer": {
        "id": "string",
        "name": "Dupont SARL",
        "email": "contact@dupont.fr"
      },
      "totalAmountWithTax": 12000,
      "totalAmountWithoutTax": 10000,
      "currencyCode": "EUR",
      "archived": false,
      "createdAt": "…",
      "updatedAt": "…",
      "dueAt": "…",
      "paidAt": null,
      "remainingAmountWithTax": 12000,
      "remainingAmountWithoutTax": 10000
    }
  ]
}
```

Les derniers champs dépendent du type de document. L'exemple montre une facture : `dueAt`, `paidAt`, `remainingAmountWithTax` et `remainingAmountWithoutTax`. Un acompte a `dueAt` et `paidAt`. Un avoir a `dueAt` et `refundAt`. Un devis ou un bon de commande a `validUntil`, `signedAt` et `refusedAt`.

**Scope** : `billing:read`

***

### `get-billing-by-id`

Récupère le détail complet d'un document par son identifiant. Inclut les lignes, totaux, informations client, mentions légales, ventilation TVA, informations de paiement et pièces jointes.

**Paramètres**

| Paramètre   | Type   | Requis | Description             |
| ----------- | ------ | ------ | ----------------------- |
| `billingId` | string | Oui    | Identifiant du document |

**Scope** : `billing:read`

***

### `get-billing-statistics`

Récupère les statistiques de facturation : compteurs et montants par état (brouillon, en retard, en attente, payé, finalisé, signé, refusé).

**Paramètres**

| Paramètre | Type      | Requis | Description                                                                                                    |
| --------- | --------- | ------ | -------------------------------------------------------------------------------------------------------------- |
| `type`    | string\[] | Non    | Filtrer par type(s) : `invoice`, `estimate`, `advance`, `asset`, `purchase_order`. Sans filtre, tous les types |

**Scope** : `billing:read`

***

### `get-last-invoices`

Récupère les 10 factures les plus récentes de l'entreprise, sans paramètre. Pour filtrer ou paginer, utilisez `get-billings` avec `type: ["invoice"]`.

**Paramètres** : aucun.

**Réponse**

```json
{
  "total": 42,
  "page": 1,
  "limit": 10,
  "invoices": [
    {
      "id": "string",
      "number": "FA-2025-001",
      "title": "string",
      "state": "finalized",
      "emittedAt": "…",
      "dueAt": "…",
      "paidAt": null,
      "customer": { "id": "string", "name": "Dupont SARL", "email": "contact@dupont.fr" },
      "totalAmountWithTax": 12000,
      "totalAmountWithoutTax": 10000,
      "remainingAmountWithTax": 12000,
      "remainingAmountWithoutTax": 10000,
      "currencyCode": "EUR",
      "createdAt": "…",
      "updatedAt": "…"
    }
  ]
}
```

Les documents de test sont exclus.

**Scope** : `billing:read`

***

### `get-customers`

Récupère les clients facturables (contacts et organisations) avec pagination et recherche. Retourne l'identifiant client nécessaire pour `create-invoice` et `create-estimate`.

**Paramètres**

| Paramètre | Type   | Requis | Description                                  |
| --------- | ------ | ------ | -------------------------------------------- |
| `page`    | number | Non    | Numéro de page, à partir de 1 (défaut : 1)   |
| `limit`   | number | Non    | Résultats par page, de 1 à 100 (défaut : 50) |
| `search`  | string | Non    | Recherche par nom ou email                   |

**Réponse**

```json
{
  "total": 15,
  "page": 1,
  "limit": 50,
  "totalPages": 1,
  "hasNextPage": false,
  "hasPrevPage": false,
  "customers": [
    {
      "id": "string",
      "legacyId": "string",
      "displayName": "Dupont SARL",
      "firstname": null,
      "lastname": null,
      "name": "Dupont SARL",
      "commercialName": "Dupont & Fils",
      "siret": "12345678901234",
      "vatNumber": "FR12345678901",
      "emails": ["contact@dupont.fr"],
      "phoneNumber": "string",
      "currency": "string",
      "language": "string",
      "billingAddress": {
        "line1": "string",
        "line2": "string",
        "zipCode": "string",
        "city": "string",
        "country": "string"
      },
      "isContact": false,
      "isOrganization": true,
      "contactId": null,
      "organizationId": "string"
    }
  ]
}
```

Le champ `id` est celui à passer en `customerId`. Pour la différence entre contact et organisation, voir [Clients](https://docs.abby.fr/mcp/clients.md).

**Scope** : `billing:read`

***

### `download-billing-document`

Télécharge un document au format PDF. Retourne une URL de téléchargement temporaire valide 7 jours.

**Paramètres**

| Paramètre         | Type    | Requis | Description                                              |
| ----------------- | ------- | ------ | -------------------------------------------------------- |
| `billingId`       | string  | Oui    | Identifiant du document                                  |
| `withAttachments` | boolean | Non    | Inclure les pièces jointes dans le PDF (défaut : `true`) |

**Réponse**

```json
{
  "success": true,
  "downloadUrl": "https://...",
  "filename": "FA-2025-042.pdf",
  "expiresIn": "7 days",
  "billingId": "string"
}
```

**Scope** : `billing:read`

***

## Création

### `create-invoice`

Crée une facture en brouillon avec des lignes de facturation. Le brouillon n'a pas encore de numéro : utilisez `finalize-billing` pour l'obtenir.

**Paramètres**

| Paramètre    | Type           | Requis | Description                                                                                                                                                                                   |
| ------------ | -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `customerId` | string         | Oui    | Identifiant client (depuis `get-customers`)                                                                                                                                                   |
| `lines`      | array          | Oui    | Au moins une ligne (voir [schéma des lignes](#schema-des-lignes))                                                                                                                             |
| `locale`     | string         | Non    | Langue du document : `fr`, `en`, `de`, `it`, `nl`, `pt` ou `es`. Par défaut, la langue du client, puis la configuration de facturation. Changer la valeur par défaut demande l'offre Business |
| `discount`   | object         | Non    | Remise globale (voir [remise](#remise))                                                                                                                                                       |
| `title`      | string ou null | Non    | Titre du document. Demande l'offre Start ; sans elle, le titre est ignoré et le document est quand même créé                                                                                  |
| `headerNote` | string ou null | Non    | Note d'en-tête (HTML). Omise, elle reprend la configuration de facturation ; `null` l'efface                                                                                                  |
| `footerNote` | string ou null | Non    | Note de pied de page (HTML). Même règle que `headerNote`                                                                                                                                      |

**Scope** : `billing:write`

***

### `create-estimate`

Crée un devis ou un bon de commande en brouillon.

**Paramètres**

| Paramètre                           | Type           | Requis | Description                                                                   |
| ----------------------------------- | -------------- | ------ | ----------------------------------------------------------------------------- |
| `customerId`                        | string         | Oui    | Identifiant client                                                            |
| `lines`                             | array          | Oui    | Au moins une ligne (voir [schéma des lignes](#schema-des-lignes))             |
| `estimateType`                      | string         | Non    | `estimate` (devis) ou `purchase_order` (bon de commande). Défaut : `estimate` |
| `locale`                            | string         | Non    | Même règle que pour `create-invoice`                                          |
| `discount`                          | object         | Non    | Remise globale (voir [remise](#remise))                                       |
| `title`, `headerNote`, `footerNote` | string ou null | Non    | Mêmes règles que pour `create-invoice`                                        |

**Scope** : `billing:write`

***

### `create-advance`

Crée un acompte en brouillon à partir d'un devis ou d'un bon de commande.

**Paramètres**

| Paramètre    | Type   | Requis | Description                                                                         |
| ------------ | ------ | ------ | ----------------------------------------------------------------------------------- |
| `estimateId` | string | Oui    | Identifiant du devis ou du bon de commande                                          |
| `mode`       | string | Non    | `percentage` ou `amount` (défaut : `percentage`)                                    |
| `value`      | number | Non    | Pourcentage (30 = 30 %) ou montant en **centimes** selon le mode. Sans valeur, 30 % |

{% hint style="info" %}
Le devis doit être à l'état `finalized` ou `signed`. Sinon, l'outil répond `success: false` et ne crée rien.
{% endhint %}

**Scope** : `billing:write`

***

### `create-asset`

Crée un avoir (note de crédit) en brouillon.

**Paramètres**

| Paramètre           | Type   | Requis | Description                                 |
| ------------------- | ------ | ------ | ------------------------------------------- |
| `billingCustomerId` | string | Non    | Identifiant client (depuis `get-customers`) |
| `opportunityId`     | string | Non    | Identifiant de l'opportunité                |

{% hint style="info" %}
Au moins un des deux paramètres (`billingCustomerId` ou `opportunityId`) doit être fourni.
{% endhint %}

Pour annuler une facture finalisée en une seule étape, utilisez plutôt `cancel-invoice`.

**Scope** : `billing:write`

***

## Modification d'un brouillon

Ces outils ne s'appliquent qu'aux documents à l'état `draft`.

### `update-billing-lines`

Met à jour les lignes d'un document en brouillon. **Remplace toutes les lignes existantes.**

**Paramètres**

| Paramètre   | Type   | Requis | Description                                                                   |
| ----------- | ------ | ------ | ----------------------------------------------------------------------------- |
| `billingId` | string | Oui    | Identifiant du document brouillon                                             |
| `lines`     | array  | Oui    | Nouvelles lignes, au moins une (voir [schéma des lignes](#schema-des-lignes)) |
| `discount`  | object | Non    | Remise globale (voir [remise](#remise))                                       |

**Scope** : `billing:write`

***

### `update-billing-timeline`

Met à jour les dates d'un brouillon : date d'émission, délai de paiement ou échéance, date de livraison, date de validité d'un devis. Cet outil s'applique aux factures, devis, bons de commande et avoirs. Il ne s'applique pas aux acomptes.

**Paramètres**

| Paramètre       | Type            | Requis               | Description                                                                                                                             |
| --------------- | --------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `billingId`     | string          | Oui                  | Identifiant du document brouillon                                                                                                       |
| `paymentDelay`  | string          | Oui                  | Délai de paiement (voir ci-dessous)                                                                                                     |
| `customDueDate` | integer         | Selon `paymentDelay` | Échéance, en timestamp Unix en **secondes**. Obligatoire avec `paymentDelay: "other"`, interdite sinon                                  |
| `emittedAt`     | integer         | Non                  | Date d'émission, en timestamp Unix en secondes. Omise, la date actuelle est conservée                                                   |
| `deliveryDate`  | integer ou null | Non                  | Date de livraison, en timestamp Unix en secondes. `null` l'efface. Omise, la valeur actuelle est conservée                              |
| `expiredAt`     | integer         | Non                  | Date de fin de validité, en timestamp Unix en secondes. Concerne les devis et bons de commande. Omise, la valeur actuelle est conservée |

Valeurs de `paymentDelay` : `at_reception`, `end_of_month`, `seven_days`, `ten_days`, `fifteen_days`, `thirty_days`, `thirty_days_end_of_month`, `forty_five_days`, `forty_five_days_end_of_month`, `sixty_days`, `sixty_days_end_of_month`, `ninety_days`, `ninety_days_end_of_month`, `one_hundred_and_twenty_days`, `other`.

Pour fixer une échéance précise, envoyez `paymentDelay: "other"` avec `customDueDate`.

**Réponse**

```json
{
  "success": true,
  "message": "Billing timeline updated successfully.",
  "billing": {
    "id": "string",
    "type": "invoice",
    "state": "draft",
    "emittedAt": "…",
    "dueAt": "…",
    "paymentDelay": "thirty_days",
    "deliveryDate": null,
    "expiredAt": null
  }
}
```

**Scope** : `billing:write`

***

### `update-billing-texts`

Met à jour le titre, la note d'en-tête et la note de pied de page d'un brouillon (facture, devis, bon de commande, acompte ou avoir). Seuls les champs envoyés changent : un champ omis est conservé, `null` l'efface. Il faut envoyer au moins un des trois champs.

**Paramètres**

| Paramètre    | Type           | Requis | Description                                                                                   |
| ------------ | -------------- | ------ | --------------------------------------------------------------------------------------------- |
| `billingId`  | string         | Oui    | Identifiant du document brouillon                                                             |
| `title`      | string ou null | Non    | Titre. Demande l'offre Start. Il n'apparaît sur le PDF que si l'affichage du titre est activé |
| `headerNote` | string ou null | Non    | Note d'en-tête (HTML)                                                                         |
| `footerNote` | string ou null | Non    | Note de pied de page (HTML)                                                                   |

**Réponse**

```json
{
  "success": true,
  "message": "Billing texts updated successfully.",
  "billing": {
    "id": "string",
    "type": "invoice",
    "state": "draft",
    "title": null,
    "headerNote": "<p>…</p>",
    "footerNote": null
  }
}
```

Si le document n'est plus à l'état `draft`, l'outil répond `success: false` avec l'état courant.

**Scope** : `billing:write`

***

## Finalisation

### `finalize-billing`

Finalise un document en brouillon (facture, devis, bon de commande, acompte ou avoir) et lui attribue un numéro définitif. **Le document ne peut plus être modifié après finalisation.** Pour annuler une facture finalisée, utilisez `cancel-invoice`, qui crée un avoir.

Un seul outil finalise tous les types de documents. Il fonctionne en deux étapes, pour qu'une finalisation ne se fasse jamais sans validation :

1. **Aperçu** (`confirm` absent ou `false`) : l'outil ne modifie rien. Il renvoie `preview: true`, un message `CONFIRMATION REQUIRED` qui indique le client et le montant, et un résumé du document (type, état, client, total, devise, dates).
2. **Confirmation** (`confirm: true`) : l'outil finalise définitivement le document et renvoie son numéro.

Si le document n'est pas à l'état `draft`, ou si son type n'est pas géré, l'outil répond `success: false` sans rien changer.

**Paramètres**

| Paramètre   | Type    | Requis | Description                                                  |
| ----------- | ------- | ------ | ------------------------------------------------------------ |
| `billingId` | string  | Oui    | Identifiant du document brouillon                            |
| `confirm`   | boolean | Non    | `true` pour finaliser. Sans confirmation, retourne un aperçu |

{% hint style="warning" %}
Montrez l'aperçu à l'utilisateur et attendez son accord avant d'appeler l'outil avec `confirm: true`. La finalisation est irréversible.
{% endhint %}

{% hint style="info" %}
La finalisation d'une facture ou d'un acompte avec TVA est réservée aux abonnements Abby Plus et supérieurs. Sans cette offre, l'outil renvoie un message d'erreur, le document reste en brouillon, et réessayer ne change rien.
{% endhint %}

**Scope** : `billing:write`

***

## Actions

### `send-invoice-by-email`

Envoie un document par email avec le PDF en pièce jointe.

**Paramètres**

| Paramètre   | Type      | Requis | Description                                         |
| ----------- | --------- | ------ | --------------------------------------------------- |
| `billingId` | string    | Oui    | Identifiant du document                             |
| `emails`    | string\[] | Oui    | Adresses email valides (1 à 10 destinataires)       |
| `subject`   | string    | Oui    | Objet de l'email (255 caractères maximum)           |
| `content`   | string    | Oui    | Corps de l'email (HTML supporté)                    |
| `inCopy`    | boolean   | Non    | Envoyer une copie à l'expéditeur (défaut : `false`) |

**Scope** : `billing:write`

***

### `duplicate-billing`

Duplique un document existant en nouveau brouillon. Peut optionnellement convertir vers un autre type.

**Paramètres**

| Paramètre    | Type   | Requis | Description                                                                                 |
| ------------ | ------ | ------ | ------------------------------------------------------------------------------------------- |
| `documentId` | string | Oui    | Identifiant du document à dupliquer                                                         |
| `targetType` | string | Non    | Type cible : `invoice`, `estimate`, `purchase_order`. Si absent, duplique dans le même type |

**Scope** : `billing:write`

***

### `cancel-invoice`

Annule une facture finalisée et **crée automatiquement un avoir**. Action irréversible.

**Paramètres**

| Paramètre   | Type   | Requis | Description                         |
| ----------- | ------ | ------ | ----------------------------------- |
| `invoiceId` | string | Oui    | Identifiant de la facture finalisée |

**Réponse**

```json
{
  "success": true,
  "message": "Invoice cancelled successfully. A credit note (avoir) has been created.",
  "cancelledInvoice": {
    "id": "string",
    "number": "FA-2025-042",
    "state": "finalized",
    "customer": { "id": "string", "name": "Dupont SARL", "email": "contact@dupont.fr" },
    "canceledAt": "…"
  },
  "asset": {
    "id": "string",
    "number": "AV-2025-003",
    "state": "finalized",
    "total": {
      "amountWithoutTax": 10000,
      "amountWithTax": 12000,
      "vatAmount": 2000
    },
    "currency": "EUR",
    "emittedAt": "…"
  }
}
```

L'annulation ne crée pas d'état `cancelled` : la facture garde son état (`finalized` dans l'exemple) et reçoit une date `canceledAt`. Elle n'est pas archivée. Pour la procédure avec l'API REST, voir [Annuler une facture et émettre un avoir](https://docs.abby.fr/guides/emettre-un-avoir.md).

**Scope** : `billing:write`

***

### `sign-estimate`

Marque un devis finalisé comme signé ou accepté par le client. N'appelez cet outil qu'avec l'accord explicite du client.

**Paramètres**

| Paramètre    | Type   | Requis | Description                   |
| ------------ | ------ | ------ | ----------------------------- |
| `estimateId` | string | Oui    | Identifiant du devis finalisé |

**Scope** : `billing:write`

***

### `refuse-estimate`

Marque un devis finalisé comme refusé par le client.

**Paramètres**

| Paramètre    | Type   | Requis | Description                   |
| ------------ | ------ | ------ | ----------------------------- |
| `estimateId` | string | Oui    | Identifiant du devis finalisé |

**Scope** : `billing:write`

***

### `archive-billing`

Archive un document. Les documents archivés sont masqués des listes actives mais conservés.

**Paramètres**

| Paramètre    | Type   | Requis | Description             |
| ------------ | ------ | ------ | ----------------------- |
| `documentId` | string | Oui    | Identifiant du document |

**Scope** : `billing:write`

***

### `unarchive-billing`

Restaure un document archivé dans les listes actives.

**Paramètres**

| Paramètre    | Type   | Requis | Description                     |
| ------------ | ------ | ------ | ------------------------------- |
| `documentId` | string | Oui    | Identifiant du document archivé |

**Scope** : `billing:write`

***

## Schéma des lignes <a href="#schema-des-lignes" id="schema-des-lignes"></a>

Les outils `create-invoice`, `create-estimate` et `update-billing-lines` partagent le même schéma de lignes :

| Paramètre      | Type   | Requis | Description                                                                                                                                                                                                                                                                              |
| -------------- | ------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `designation`  | string | Oui    | Nom du produit ou service                                                                                                                                                                                                                                                                |
| `unitPrice`    | number | Oui    | Prix unitaire en **centimes**                                                                                                                                                                                                                                                            |
| `quantity`     | number | Non    | Quantité (défaut : 1)                                                                                                                                                                                                                                                                    |
| `quantityUnit` | string | Non    | Unité, en minuscules (défaut : `unit`). Valeurs listées sous le tableau                                                                                                                                                                                                                  |
| `type`         | string | Non    | Type, en minuscules : `service_delivery`, `sale_of_goods`, `commercial_or_craft_services`, `sale_of_manufactured_goods`, `disbursement` (défaut : `service_delivery`)                                                                                                                    |
| `vatCode`      | string | Non    | Code TVA : `fr_20`, `fr_10`, `fr_5_5`, `fr_2_1`, `fr_8_5`, `fr_0`, `fr_not_applicable`, `fr_eu` (Union européenne), `fr_non_eu` (hors UE). Les codes internes comme `FR_2000` sont aussi acceptés. Omis, le code vient du produit du catalogue ou de la politique de TVA de l'entreprise |
| `description`  | string | Non    | Description détaillée                                                                                                                                                                                                                                                                    |
| `reference`    | string | Non    | Référence produit                                                                                                                                                                                                                                                                        |
| `productId`    | string | Non    | Identifiant produit du catalogue                                                                                                                                                                                                                                                         |

Valeurs de `quantityUnit` : `unit`, `gram`, `hour`, `day`, `week`, `fixed_rate`, `year`, `character`, `line`, `license`, `article`, `month`, `kilogram`, `kilometer`, `liter`, `batch`, `meter`, `square_meter`, `cubic_meter`, `linear_meter`, `person`, `ton`, `word`, `page`, `leaflet`, `paragraph`, `minute`, `overnight_stay`. Les produits du [Catalogue](https://docs.abby.fr/mcp/catalogue.md) utilisent les mêmes unités et les mêmes types.

## Remise <a href="#remise" id="remise"></a>

Le paramètre `discount` est un objet à deux champs :

| Champ    | Type   | Description                                                                                    |
| -------- | ------ | ---------------------------------------------------------------------------------------------- |
| `mode`   | string | `PERCENTAGE` pour un pourcentage, `AMOUNT` pour un montant fixe                                |
| `amount` | number | Avec `PERCENTAGE`, le pourcentage (10 = 10 %). Avec `AMOUNT`, des **centimes** (100 € = 10000) |

## Scopes requis

| Outil                                                                                                                                                                                                                                                                                                            | Scope           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| `get-billings`, `get-billing-by-id`, `get-billing-statistics`, `get-last-invoices`, `get-customers`, `download-billing-document`                                                                                                                                                                                 | `billing:read`  |
| `create-invoice`, `create-estimate`, `create-advance`, `create-asset`, `update-billing-lines`, `update-billing-timeline`, `update-billing-texts`, `finalize-billing`, `send-invoice-by-email`, `duplicate-billing`, `cancel-invoice`, `sign-estimate`, `refuse-estimate`, `archive-billing`, `unarchive-billing` | `billing:write` |


---

# 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/facturation.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.
