Voir les impayés d'un fournisseur

# Instructions

## Use case

Identifier toutes les factures en retard d'un fournisseur donné, réparties par bucket de retard (1-30, 31-60, 61-90, 90+ jours).

## Étape 1 — Trouver l'ID du fournisseur

`spendesk_get_due_invoices` retourne les factures avec `supplier: "Nom du fournisseur"` (un nom, pas un ID). Pour filtrer par fournisseur, il faut d'abord résoudre le nom en ID :

```json
// get_suppliers
{
  "companyId": "<COMPANY_ID>",
  "search": "Vaultspeed"
}
```

→ Récupérer `data[0].id` → ex. `"t0tiu752i9bms9"`

## Étape 2 — Aging filtré par fournisseur

```json
// spendesk_get_due_invoices
{
  "companyId": "<COMPANY_ID>",
  "filters": {
    "supplierIds": ["t0tiu752i9bms9"]
  },
  "includeUpcoming": true,
  "limit": 20
}
```

### Paramètres disponibles dans filters

| Paramètre | Type | Description |
|-----------|------|-------------|
| `supplierIds` | `string[]` | Filtre par un ou plusieurs fournisseurs |
| `costCenterIds` | `string[]` | Filtre par cost center |
| `currencies` | `string[]` | Filtre par devise (ex. `["EUR", "GBP"]`) |
| `minAmount` | `number` | Montant minimum (décimal) dans la devise fonctionnelle, comparé au montant brut de la facture et non au reste à payer |

### Options

- `includeUpcoming: true` → ajoute un bucket "Not yet due" (factures pas encore échues)
- `limit` → nombre maximum de factures par bucket (défaut 10, max 50)
- `asOfDate` → date de référence (défaut = aujourd'hui, format `YYYY-MM-DD`)

## Structure du résultat

```json
{
  "summary": {
    "asOfDate": "2026-07-06",
    "totalOverdueAmount": { "amount": 81986, "currency": "EUR", "precision": 2 },
    "totalOverdueCount": 2,
    "oldestInvoiceDaysOverdue": 301
  },
  "data": {
    "upcoming": { "label": "Not yet due", "count": 0, "invoices": [] },
    "buckets": [
      { "label": "1-30 days",  "count": 0, "invoices": [] },
      { "label": "31-60 days", "count": 0, "invoices": [] },
      { "label": "61-90 days", "count": 0, "invoices": [] },
      { "label": "90+ days",   "count": 2, "invoices": [
        {
          "id": "a7f1c327-...",
          "supplier": "Vaultspeed",
          "amount": { "amount": 13548, "currency": "GBP", "precision": 2 },
          "currency": "GBP",
          "invoiceNumber": "CB-CN-202509-1142",
          "invoiceDueDate": "2025-09-08",
          "costCenter": "Revenue",
          "daysOverdue": 301
        }
      ]}
    ]
  }
}
```

## Piège 1 — Le résumé est en EUR, les factures en devise native

`summary.totalOverdueAmount` est exprimé dans la devise fonctionnelle, à lire dans `summary.currency` (EUR sur cet exemple, à ne pas supposer), mais chaque `invoice.amount` est dans la devise originale de la facture. Sur cet exemple :
- Vaultspeed : 135.48 GBP (facture en livres)
- eau de paris : 663.79 EUR (facture en euros)

→ Ne pas sommer les `invoice.amount` entre factures en devises différentes. Utiliser `summary.totalOverdueAmount` pour le total converti.

## Piège 2 — Lookup inverse nom → ID obligatoire

`spendesk_get_due_invoices` ne retourne pas les IDs fournisseurs dans la réponse — uniquement le nom (`supplier: "Vaultspeed"`). Pour utiliser le filtre `supplierIds`, il faut **nécessairement** passer par `get_suppliers(search=nom)` d'abord.

## Piège 3 — Uniquement invoicePurchase toPay

`spendesk_get_due_invoices` ne couvre que les **factures fournisseurs** (`invoicePurchase`) avec `paymentStatus = toPay`. Sont exclus :
- Notes de frais
- Achats carte
- Factures entièrement payées (les factures partiellement payées restent incluses), avoirs, et factures sans date d'échéance

## Cas d'usage avancés

**Plusieurs fournisseurs simultanément :**
```json
{ "filters": { "supplierIds": ["t0tiu752i9bms9", "b3E3B8t2s5"] } }
```

**Factures en retard + à venir pour un fournisseur :**
```json
{ "filters": { "supplierIds": ["t0tiu752i9bms9"] }, "includeUpcoming": true }
```

**⚠️ `asOfDate` passé : ce n'est pas un aging historique**
```json
{ "asOfDate": "2026-06-30" }
```
Une date passée ne reconstitue pas l'aging d'une clôture : l'outil vieillit, par rapport à cette date, les factures qui ont encore un solde impayé **aujourd'hui**, aux soldes d'aujourd'hui. Les factures payées (ou partiellement payées) depuis sont exclues ou réduites, et celles enregistrées après cette date avec une échéance antérieure sont incluses. Ne pas présenter le résultat comme l'aging de fin de mois.

## Exemples de prompts utilisateurs

- "Quelles sont les factures en retard de Vaultspeed ?"
- "Montre-moi les factures impayées depuis plus de 60 jours pour nos fournisseurs Marketing"
- "Y a-t-il des factures en retard de plus de 90 jours pour eau de paris ?"