Liste les fournisseurs actifs avec leurs données bancaires (IBAN, BIC, pays de banque) via get_suppliers

Liste les fournisseurs actifs avec leurs coordonnées bancaires complètes (IBAN, BIC, pays). Essentiel pour les vérifications de paiement et les audits de données bancaires.

↓ Télécharger le skill (.md)
85/100·📅 Hebdo·DébutantAP Manager
Fournisseursget_suppliers

🎯 But du skill

Liste les fournisseurs actifs avec leurs coordonnées bancaires complètes (IBAN, BIC, pays). Essentiel pour les vérifications de paiement et les audits de données bancaires.

📊 Ce que ça produit

Annuaire des fournisseurs actifs avec IBAN, BIC et pays de banque pour chacun.

Bénéfice

Avant

Export manuel du référentiel fournisseurs, tri et filtre dans Excel pour les données bancaires.

Après

Annuaire bancaire fournisseurs complet et filtrable en quelques secondes.



# Instructions

## Use case

Lister les fournisseurs actifs avec leurs données bancaires (IBAN, BIC, pays) pour préparer des paiements ou vérifier que les coordonnées sont complètes.

## Piège 1 — isArchived est un STRING, pas un boolean

Le paramètre `isArchived` de `get_suppliers` est un **enum STRING**, pas un boolean :
- Correct : `isArchived: "false"` (string)
- Incorrect : `isArchived: false` (boolean — ignoré ou erreur)

```json
{
  "companyId": "<COMPANY_ID>",
  "isArchived": "false",
  "sortBy": "name",
  "pageSize": 1
}
```

✅ **Bug résolu (vérifié le 2026-07-22, PR #3169)** : le tableau `accountPayable.supplierIds` (voir plus bas) qui pouvait faire dépasser la limite de taille de réponse même à `pageSize=1` (81 179 caractères observés) n'existe plus dans la réponse — testé en direct avec `pageSize=100` sur des fournisseurs partageant un compte AP consolidé, aucun dépassement. La pagination normale (`pageSize` 50-100) est de nouveau fiable sur ce type de compte.

## Champs bancaires disponibles

Chaque fournisseur retourne :

```json
{
  "iban": "FR7617518000010052347500017",
  "bic": "SPDKFRP2XXX",
  "bankCountry": "FR",
  "bankDetailsUpdatedAt": "2026-07-02T06:20:54.000Z",
  "bankDetailsUpdatedBy": "<userId>"
}
```

- `iban` : IBAN complet, ou `null` si non renseigné
- `bic` : Code BIC/SWIFT, ou `null`
- `bankCountry` : Pays de la banque (code ISO), peut être `null` **ou** `""` (chaîne vide) — les deux signifient "non renseigné"
- `bankDetailsUpdatedAt` : Date de la dernière mise à jour des coordonnées bancaires
- `bankDetailsUpdatedBy` : userId de la personne qui a mis à jour (pas le nom — faire une jointure avec `get_users` si nécessaire)

## Piège 2 — Pas de filtre "a un IBAN" / "n'a pas d'IBAN"

Il n'existe pas de filtre `hasIban=true` dans `get_suppliers`. Pour obtenir uniquement les fournisseurs **avec** IBAN :
→ Récupérer la liste complète et filtrer côté client :
```
fournisseurs avec IBAN = data.filter(s => s.iban && s.iban !== "")
fournisseurs sans IBAN = data.filter(s => !s.iban)
```

Le filtre `iban` existant est une **correspondance exacte** sur la valeur IBAN, pas un filtre "non null". Il sert à retrouver un fournisseur par son IBAN connu.

## Piège 3 — bankCountry inconsistant : null vs chaîne vide

Certains fournisseurs ont `bankCountry: ""` (chaîne vide), d'autres ont `bankCountry: null`. Les deux signifient "non renseigné". Toujours tester les deux :
```
!s.bankCountry  // couvre null ET ""
```

## Pagination — page-based (pas cursor)

`get_suppliers` utilise une pagination par **numéro de page** (contrairement à `get_payables` qui utilise un cursor) :
```json
{ "page": 1, "pageSize": 50 }
```
Vérifier `meta.pagination.hasNextPage` pour savoir s'il faut continuer.

## accountPayable — objet de consolidation

Certains fournisseurs partagent un `accountPayable` (même `id`, `generalAccountCode`) — plusieurs fiches fournisseur distinctes pointent vers la même entrée comptable (ex. : plusieurs sous-fournisseurs Stripe consolidés sous un même compte). Le tableau `supplierIds` qui accompagnait autrefois cet objet et causait le risque de dépassement de taille de réponse a été retiré de la réponse MCP (PR #3169, vérifié le 2026-07-22) — ce n'est donc plus une source de risque. Ce pattern est expliqué dans [[s14-factures-fournisseur-par-nom]].

## Exemples de prompts utilisateurs

- "Liste tous les fournisseurs actifs avec leur IBAN pour préparer les paiements de juillet"
- "Quels fournisseurs n'ont pas encore renseigné leur IBAN ?"
- "Quel est l'IBAN du fournisseur Getsafe GmbH ?"

Comment installer ce skill

/
  1. 1
    Télécharger le fichier s22-fournisseurs-actifs-iban.md via le bouton ci-dessus.
  2. 2
    Placer le fichier dans le répertoire .claude/ de votre projet (ou ~/.claude/ pour une installation globale).
    cp s22-fournisseurs-actifs-iban.md .claude/s22-fournisseurs-actifs-iban.md
  3. 3
    Utiliser dans Claude Codele skill est automatiquement découvert. Décrivez votre besoin en langage naturel et Claude appliquera les instructions du skill.
💡 Assurez-vous que le MCP Spendesk est configuré dans votre .claude/settings.json avec les outils get_suppliers.

Skills similaires

★ Top
95/100·🔍 Ponctuel·Expert

Audit de couverture MCP — Gap analysis automatisée

Sonde tous les outils MCP disponibles, re-évalue la couverture des 50 cas d'usages persona, détecte les nouveaux champs ou outils, et régénère le rapport d'analyse des gaps.

CFOControllerAP Manager
★ Top
89/100·🔍 Ponctuel·Intermédiaire

Skill Builder

Aide un client à transformer un besoin métier précis (contexte, contraintes, format de sortie souhaité) en un nouveau skill Claude sur mesure, prêt à l'emploi sur le MCP Spendesk

CFOControllerAP Manager
★ Top
88/100·🔍 Ponctuel·Débutant

MCP Product Tour

Visite guidée conversationnelle du MCP Spendesk — appels réels sur les données de l'utilisateur, adaptée à sa persona, puis recommandation des prochains skills à installer

CFOControllerAP Manager