---
name: s07-depenses-brutes-sans-credit-notes
scenario: S07
description: Calculer les dépenses brutes par type en excluant explicitement les avoirs (creditNote) et remboursements
tags: [spend-analysis, credit-note, payable-type, reporting, gotcha]
when_to_use: Quand on veut le total réel des dépenses sans que les avoirs viennent sous-estimer le résultat
risk: P0 — creditNote a un montant négatif : l'inclure dans le total réduit silencieusement le montant affiché (-6,5% observé sur compte démo)
---

# Instructions — Dépenses brutes par type (avec exclusion creditNote)

## ⚠️ Règle critique

`spendesk_analyze_spend` inclut les `creditNote` par défaut. Leur montant est **négatif** — ils réduisent le `summary.totalAmount`.

Sur un compte de démonstration observé : `creditNote` représentait **-6,5% du total** (-58 950 EUR sur 910 699 EUR).
Idem pour `cardRefund` : montants négatifs (-0,1%).

**Pour les dépenses brutes** : exclure `creditNote` et `cardRefund` via le filtre `payableTypes`.
**Pour les dépenses nettes** : les inclure (c'est le comportement par défaut).

## Étape 1 — Identifier la compagnie et la période

Appelle `list_companies` pour le `companyId`. Définir `fromDate` et `toDate` (YYYY-MM-DD, max 366 jours).

## Étape 2a — Dépenses BRUTES (hors avoirs)

Appelle `spendesk_analyze_spend` avec :
```json
{
  "groupBy": ["payableType"],
  "fromDate": "...",
  "toDate": "...",
  "filters": {
    "payableTypes": ["invoicePurchase","mileageAllowance","perDiemAllowance",
                     "singleCardPurchase","physicalCardPurchase",
                     "multiUseCardPurchase","subscription","expenseClaim"]
  }
}
```
→ `creditNote` et `cardRefund` exclus → `summary.totalAmount` = dépenses brutes

## Étape 2b — Dépenses NETTES (avec avoirs)

Appelle `spendesk_analyze_spend` sans filtre `payableTypes`.
→ `summary.totalAmount` inclut les avoirs (valeur comptable nette)

## Étape 3 — Comparer et présenter

Présenter les deux totaux :
- Dépenses brutes : X EUR
- Avoirs et remboursements : -Y EUR  
- Dépenses nettes : X - Y EUR

Par type :
| Type | Montant | Part |
|------|---------|------|
| invoicePurchase | ... | 93.1% |
| subscription | ... | 9.7% |
| ... | | |
| creditNote | -... | -6.5% |

## Exemple de prompt

- "Quelles sont nos dépenses brutes en juin 2026 ?"
- "Montre-moi le total des dépenses par type ce mois-ci, en excluant les avoirs"