Auditer les données fournisseurs

# Audit des fiches fournisseurs

## But

Contrôler que les fiches des fournisseurs actifs sont complètes avant une campagne de paiement : coordonnées bancaires, adresse, identifiants légaux. Repérer les fournisseurs incomplets qui ont des factures à payer, et les coordonnées bancaires modifiées récemment.

Ce skill ne fait que lire. Compléter une fiche demande l'outil `update_supplier` (permission « Manage suppliers », en Beta) ou l'application Spendesk.

## Ce que la fiche contient — et ce qu'elle ne contient pas

| Disponible | Champ |
|------------|-------|
| Coordonnées bancaires | `iban`, `bic`, `bankCountry` |
| Dernière modification bancaire | `bankDetailsUpdatedAt`, `bankDetailsUpdatedBy` |
| Adresse | `address` (ligne, ville, code postal, pays) |
| Identifiants légaux | `legalName`, `registrationNo`, `vatNo` |
| Compte fournisseur | `accountPayable` (absent si aucun compte actif) |

⚠️ Deux limites à dire dans le rapport :

- **Un IBAN vide ne prouve pas l'absence de coordonnées bancaires.** Numéro de compte, code banque et titulaire (comptes hors zone IBAN, Royaume-Uni ou États-Unis par exemple) ne sont jamais renvoyés. Écrire « IBAN non renseigné », pas « paiement impossible ».
- **Il n'y a pas d'email ni de contact** sur la fiche : ce point ne peut pas être audité.

## Étape 1 — Lister les fournisseurs actifs

```json
{ "tool": "get_suppliers", "params": { "isArchived": "false", "pageSize": 100 } }
```

- Le paramètre est `isArchived`, une chaîne (`"false"`), pas `status`.
- Paginer avec `page` tant que `hasNextPage` est `true`. Si une page échoue pour cause de réponse trop volumineuse, réduire `pageSize` et signaler les fiches non lues plutôt que de les ignorer.

## Étape 2 — Contrôler la complétude

Pour chaque fournisseur :

| Contrôle | Verdict |
|----------|---------|
| `iban` et `bic` renseignés | ✅ / « IBAN non renseigné » |
| `address.country` et `address.city` renseignés | ✅ / « Adresse incomplète » |
| `vatNo` ou `registrationNo` renseigné | ✅ / « Identifiant légal manquant » |
| `accountPayable` présent | ✅ / « Sans compte fournisseur » |
| `bankCountry` différent de `address.country` | « À vérifier » (pas une anomalie en soi) |

## Étape 3 — Croiser avec les factures à payer

Pour les fournisseurs sans IBAN :

```json
{
  "tool": "get_payables",
  "params": { "filters": { "operator": "and", "subfilters": [
    { "field": "supplier", "operator": "=", "value": ["<supplierId>", "<supplierId>"] },
    { "field": "paymentStatus", "operator": "=", "value": ["toPay"] }
  ] } }
}
```

Un fournisseur sans IBAN avec des factures `toPay` est **prioritaire**. Lire le reste à payer dans `outstandingAmount`, pas dans `amount`.

## Étape 4 — Coordonnées bancaires modifiées récemment

Lire `bankDetailsUpdatedAt` : c'est la date de la dernière modification des coordonnées bancaires, distincte de `updatedAt` (toute modification de la fiche). Signaler les modifications des 7 derniers jours, avec `bankDetailsUpdatedBy` résolu en nom : c'est le contrôle anti-fraude au virement.

Signaler aussi les fournisseurs créés depuis moins de 30 jours (`createdAt`) qui ont déjà une facture à payer.

## Rapport

```
Audit fournisseurs — <date du jour> (N fiches actives lues)

🔴 Prioritaires : IBAN non renseigné et factures à payer — N fournisseurs, X EUR
🟡 Incomplets : adresse, identifiant légal ou compte fournisseur manquant — N
🟠 Coordonnées bancaires modifiées depuis 7 jours — N (à valider avec le fournisseur)
🟢 Nouveaux fournisseurs avec facture à payer — N
```

## Limites à dire

- Ne jamais modifier des coordonnées bancaires sans confirmation écrite du fournisseur.
- Les données fournisseurs sont en cache jusqu'à 24 heures : une fiche corrigée à l'instant peut encore apparaître incomplète.

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

Sur les deux premières fiches actives lues : aucune n'avait d'IBAN, de BIC ni d'adresse ; une seule avait un compte fournisseur et un pays de banque. Aucune ne portait de date de modification bancaire.

## Exemples de prompts
- "Quels fournisseurs ont des données incomplètes et des factures à payer ?"
- "Audit complet de mon référentiel fournisseurs"
- "Y a-t-il des coordonnées bancaires modifiées récemment que je dois valider ?"