Analyser les demandes de carte

# Analyse des demandes de carte (avant dépense)

## Ce que ce tool couvre — et ce qu'il ne couvre pas

`spendesk_analyze_requests` ne couvre QUE les demandes de carte : `single_purchase`, `subscription`, `multi_use_card`, `multi_use_card_top_up`, `multi_use_card_end_date_change`, `card_load`. **Il ne couvre ni les demandes de facture fournisseur, ni les notes de frais/remboursements** — ce sont des objets séparés. Ne jamais présenter ses totaux comme "toutes les demandes" de l'entreprise.

C'est une vue d'intention (avant dépense réelle) — pour la dépense déjà engagée, utiliser `spendesk_analyze_spend`.

## Appel

```json
{
  "tool": "spendesk_analyze_requests",
  "params": {
    "companyId": "<companyId>",
    "fromDate": "2026-06-01",
    "toDate": "2026-08-31",
    "groupBy": ["type"]
  }
}
```

`fromDate`/`toDate` filtrent sur `createdAt` (date de création de la demande), pas la date d'approbation ni la date de disponibilité de la carte.

## Résultat observé

```
{"summary":{"totalCount":14,"totalAmount":{"formatted":"EUR 15097.00"},"totalAverageAmount":{"formatted":"EUR 1078.36"}},
 "data":[
   {"key":"Subscription card","amount":{"formatted":"EUR 11296.00"},"count":6,"averageAmount":{"formatted":"EUR 1882.67"}},
   {"key":"Single purchase card","amount":{"formatted":"EUR 3301.00"},"count":7,"averageAmount":{"formatted":"EUR 471.57"}},
   {"key":"Multi-use card","amount":{"formatted":"EUR 500.00"},"count":1,"averageAmount":{"formatted":"EUR 500.00"}}
 ]}
```

Les clés affichées sont des libellés lisibles ("Subscription card"), pas les slugs bruts (`subscription`) — ne jamais réafficher un slug brut à l'utilisateur si un libellé existe.

## Piège demandes supprimées

Les demandes supprimées dans Spendesk ne sont pas exclues : elles restent comptées, sans marqueur, dès que leur état correspond — y compris les demandes d'un collaborateur retiré de la société. Même avec `filters.state`, un total « en attente » ou « approuvé » peut donc surestimer la charge réelle : le préciser quand on cite ce chiffre. Même limite sur `get_requests`.

## Piège devise

Grouper par `currency` garde les montants en devise fonctionnelle : une ligne `"USD"` est le total en devise fonctionnelle des demandes soumises en USD, **pas** un total en USD. Ne jamais réétiqueter un montant avec la devise de sa clé de groupe.

## Exemples de prompts utilisateur

- "Combien de demandes de carte ce trimestre, par type ?"
- "Quel est le montant moyen d'une demande de carte à usage unique ?"
- "Compare le volume de demandes de cartes subscription vs cartes ponctuelles sur les 3 derniers mois"