Préparer le reporting mensuel de direction

# Reporting mensuel de direction

## Principe

Quatre blocs, quatre outils, **quatre bases différentes**. La valeur du reporting tient à ne pas les mélanger : chaque chiffre est présenté avec sa base.

| Bloc | Outil | Base |
|------|-------|------|
| Trésorerie disponible | `get_wallet_summary` | Solde du wallet à l'instant (cache court) |
| Dépenses engagées | `spendesk_analyze_spend` | Payables, à la date du document, TTC |
| Cash réellement sorti | `spendesk_analyze_settlements` | Règlements, à la date de compensation |
| Factures en retard | `spendesk_get_due_invoices` | Factures impayées, à aujourd'hui |

Avant tout appel, annoncer les dates exactes utilisées (ex. « du 2026-09-01 au 2026-09-30 »).

## Bloc 1 — Trésorerie

```json
{ "tool": "get_wallet_summary", "params": {} }
```

Trois chiffres à ne jamais confondre : `totalAmount` (solde du wallet), `totalAllocatedAmount` (déjà engagé sur des cartes et virements planifiés), `totalAvailableAmount` (ce qui reste à dépenser). Pour « peut-on couvrir X », utiliser `totalAvailableAmount`, et toujours nommer le chiffre cité.

## Bloc 2 — Dépenses engagées du mois

```json
{
  "tool": "spendesk_analyze_spend",
  "params": {
    "fromDate": "2026-09-01", "toDate": "2026-09-30",
    "groupBy": ["costCenter"], "compareWithPreviousPeriod": true, "limit": 10
  }
}
```

⚠️ Piège vérifié en direct : la « période précédente » est la fenêtre **de même durée juste avant**, pas le mois calendaire précédent. Pour septembre (30 jours), la comparaison a porté sur le **2 au 31 août**, et le 1er août est resté hors champ. Lire `summary.previousPeriod.period` et l'afficher tel quel. Pour une vraie comparaison mois calendaire contre mois calendaire, faire un second appel sur le mois précédent.

Autres points :
- `amountChange` vaut `null` quand la période précédente est à zéro : écrire « pas de base de comparaison », pas « +0 % ».
- `summary.totalOutstandingAmount` donne le reste à payer sur ces dépenses.
- Refaire l'appel avec `groupBy: ["supplier"]` pour le top fournisseurs.
- Les avoirs sont inclus et viennent en déduction ; exclure `creditNote` dans `filters.payableTypes` pour une dépense brute.

## Bloc 3 — Cash réellement sorti

```json
{
  "tool": "spendesk_analyze_settlements",
  "params": { "fromDate": "2026-09-01", "toDate": "2026-09-30", "groupBy": ["type"] }
}
```

Le total est **net et signé** : paiements, remboursements et avances en positif, remboursements reçus et rétrofacturations en négatif. Regrouper par `type` pour séparer les sens.

Ce chiffre ne se rapproche pas du bloc 2 : une facture de septembre peut être payée en octobre. Présenter les deux côte à côte, sans les soustraire.

## Bloc 4 — Factures en retard

```json
{ "tool": "spendesk_get_due_invoices", "params": { "includeLineItems": false } }
```

Renvoie les tranches 1-30, 31-60, 61-90 et 90+ jours, avec `summary.totalOverdueAmount` et `oldestInvoiceDaysOverdue`. Ne couvre que les factures fournisseurs impayées (pas les notes de frais ni les cartes).

- Ne pas passer une date passée dans `asOfDate` pour « l'aging de fin de mois » : ce n'est pas un aging historique.
- Si `scheduledTransfersAmount.scheduledInvoicesAmount` du bloc 1 vaut 0, aucune facture n'a été déduite du disponible : comparer le retard au disponible en entier.

## Format de sortie recommandé

```
Reporting de direction — <mois> (<dates exactes>)

1. Trésorerie      Disponible : X EUR (solde Y, engagé Z)
2. Dépenses        Engagé : X EUR — vs <période précédente exacte> : ±N %
                   Top centres de coûts / top fournisseurs
3. Cash sorti      Net : X EUR (paiements A, remboursements B)
4. Retards         X EUR sur N factures, la plus ancienne à J jours

Points d'attention : 3 lignes maximum, chacune avec un chiffre.
```

## Limites à dire dans le reporting

- Pas de budget : le MCP ne lit pas les budgets. Pour un écart au budget, l'utilisateur fournit les chiffres.
- Une société à la fois : sur une connexion multi-entités, répéter les quatre blocs par entité et ne jamais additionner des devises différentes.
- Les dépenses carte récentes peuvent manquer au bloc 2 tant qu'elles ne sont pas devenues des payables.

## Résultat observé (compte démo, septembre 2026)

Disponible EUR 97 300,29 (solde EUR 98 900,00, engagé EUR 1 599,71). Dépenses engagées EUR 25 834,90 sur 2 payables, un seul centre de coûts, comparaison sans base (période précédente à zéro). Cash sorti net EUR 10 613,50 en 2 paiements. Retards EUR 19 095,67 sur 11 factures, toutes à plus de 90 jours.

## Exemples de prompts utilisateur

- "Prépare mon reporting de direction pour septembre"
- "Donne-moi la synthèse du mois : trésorerie, dépenses, cash sorti et retards fournisseurs"
- "Même reporting pour l'entité allemande"