Suivre le cash réellement décaissé

# Cash flow réel — date de règlement, pas date facture

## Le piège à éviter

`spendesk_analyze_spend` (payables) répond à "combien on doit / a dépensé", basé sur `payableDate` — la date du document. Pour un reporting de trésorerie ou une mise à jour investisseurs, c'est **la mauvaise date** : une facture datée du 5 du mois peut être réglée le 28, ou le mois suivant. `spendesk_analyze_settlements` répond à la vraie question — quand l'argent a effectivement bougé (`clearedAt`, la date de compensation du mouvement).

Les deux vues divergent réellement, pas juste en théorie. Exemple observé sur un compte réel :

| Vue | Mai 2026 | Juin 2026 | Juillet 2026 |
|---|---|---|---|
| `spendesk_analyze_spend` (date facture) | 120 870,00 € | 17 639,94 € | 22 980,88 € |
| `spendesk_analyze_settlements` (date règlement) | — | 264 436,47 € | 32 729,75 € |

Un CFO qui lit uniquement la vue payables sous-estime largement la sortie de cash réelle de juin.

## Appel

```json
{
  "tool": "spendesk_analyze_settlements",
  "params": {
    "companyId": "<companyId>",
    "fromDate": "2026-06-01",
    "toDate": "2026-06-30",
    "groupBy": ["month", "type"]
  }
}
```

`fromDate`/`toDate` filtrent sur `clearedAt`, pas sur la date d'export comptable. Toujours grouper par `type` en plus de `month` — sinon le total net mélange les entrées (`refund`, `cashReturn`, `chargeback`, négatives) avec les sorties (`payment`, `reimbursement`, `advance`, positives), ce qui peut donner un total net petit ou négatif même avec un volume brut élevé.

## Résultat observé

```
{"key":"2026-06","amount":{"formatted":"EUR 264436.47"},"count":27,
 "breakdown":[
   {"key":"payment","amount":{"formatted":"EUR 264304.23"},"count":23},
   {"key":"reimbursement","amount":{"formatted":"EUR 132.24"},"count":4}
 ]}
```

Le montant est déjà en devise fonctionnelle (`billingAmount` sommé côté serveur) — jamais sommer `amount` (devise de la transaction d'origine) sur plusieurs devises.

## Quand utiliser laquelle des deux vues

| Besoin | Tool |
|---|---|
| "Combien on doit / a dépensé sur la période" (vue comptable) | `spendesk_analyze_spend` |
| "Combien de cash est réellement sorti / rentré" (vue trésorerie) | `spendesk_analyze_settlements` |
| Rapprochement bancaire | `get_settlements` (enregistrements individuels) |

## Limite à mentionner

Un settlement `state=exported` = ce mouvement de cash a été exporté vers la compta — indépendant du `bookkeepingStatus` de la payable liée. Ne pas confondre les deux (voir `s39-settlements-vs-gl-export`).

## Exemples de prompts utilisateur

- "Fais-moi un point trésorerie réel par mois, pas basé sur les dates de facture"
- "Quel est le cash sorti sur juin, en excluant les remboursements ?"
- "Compare la vue payables et la vue règlement réel sur le dernier trimestre"