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` — attention, `null` ne prouve pas l'absence de coordonnées bancaires : numéro de compte, routing number et sort code (fournisseurs hors IBAN) ne sont jamais renvoyés
- `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 Code — le 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

Auditer la couverture du MCP

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

Créer un skill sur mesure

Transforme un besoin métier précis en un nouveau skill Claude sur mesure, prêt à l'emploi sur le MCP Spendesk.

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

Découvrir le MCP Spendesk en deux minutes

Visite guidée conversationnelle du MCP Spendesk avec de vrais appels sur les données de l'utilisateur, adaptée à sa persona.

CFOControllerAP Manager

Interested in AI Agent services or Custom Integrations?