Filtre les fournisseurs créés ou mis à jour récemment avec createdAfter/updatedAfter dans get_suppliers

Filtre les fournisseurs créés ou mis à jour récemment dans Spendesk via createdAfter/updatedAfter. Utile pour les workflows de validation de nouveaux fournisseurs et le suivi des modifications.

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

🎯 But du skill

Filtre les fournisseurs créés ou mis à jour récemment dans Spendesk via createdAfter/updatedAfter. Utile pour les workflows de validation de nouveaux fournisseurs et le suivi des modifications.

📊 Ce que ça produit

Fournisseurs récents avec date de création ou modification, informations de contact et statut.

Bénéfice

Avant

Pas de moyen direct de trouver les fournisseurs récents sans parcourir toute la liste.

Après

Fournisseurs récents filtrés directement par date, en quelques secondes.



# Instructions

## Use case

Synchroniser le référentiel fournisseurs Spendesk avec un système externe en ne récupérant que les données nouvelles ou modifiées depuis la dernière synchronisation.

## Deux filtres temporels distincts

```json
{
  "createdAfter": "2026-01-01T00:00:00.000Z",
  "sortBy": "created_at",
  "sort": "desc",
  "pageSize": 1
}
```

```json
{
  "updatedAfter": "2026-06-01T00:00:00.000Z",
  "sortBy": "updated_at",
  "sort": "desc",
  "pageSize": 1
}
```

Les deux acceptent ISO 8601 datetime (`YYYY-MM-DDTHH:MM:SS.sssZ`).

## Différence critique : createdAfter vs updatedAfter

| Filtre | Retourne | N'inclut PAS |
|--------|----------|--------------|
| `createdAfter` | Fournisseurs dont la date de création est après la date | Fournisseurs anciens dont les données ont changé récemment |
| `updatedAfter` | Fournisseurs dont TOUT champ a été modifié après la date | Fournisseurs non modifiés même récemment créés si modifiés avant la date |

### Exemple concret observé

Avec `updatedAfter: "2026-06-01"` :
- **Wojo** (créé en 2020, mis à jour 2026-07-02) → **INCLUS** — vieux fournisseur mais récemment modifié
- **Microsoft Ireland** (créé 2024, bankDetails mis à jour 2026-07-02) → **INCLUS** — coordonnées bancaires récemment mises à jour

Avec `createdAfter: "2026-01-01"` :
- **Wojo** (créé 2020) → **ABSENT** — filtré car créé avant la date
- **Microsoft Ireland** (créé 2024) → **ABSENT** — créé avant 2026
- **Getsafe GmbH** (créé 2026-07-01) → **INCLUS** — nouveau fournisseur

## Cas d'usage recommandés

**Pour détecter les nouveaux fournisseurs à créer dans l'ERP :**
→ Utiliser `createdAfter: <dernière synchronisation>`

**Pour détecter les fournisseurs dont les données bancaires ont changé :**
→ Utiliser `updatedAfter: <dernière synchronisation>`
→ Vérifier `bankDetailsUpdatedAt` pour confirmer que c'est la banque qui a changé

**Synchronisation incrémentale complète :**
→ Appeler les deux filtres séparément et merger les résultats (un fournisseur peut apparaître dans les deux)

## Tri disponible

Options de `sortBy` : `"name"`, `"created_at"`, `"updated_at"`
Option de `sort` : `"asc"` / `"desc"` (non documenté officiellement mais fonctionne)

## Pagination — page-based

Contrairement à `get_payables` (cursor), `get_suppliers` utilise une pagination par numéro de page :
```json
{ "page": 2, "pageSize": 50 }
```
Voir `meta.pagination.hasNextPage` pour itérer.

## Combiner avec isArchived

Pour récupérer uniquement les fournisseurs actifs récemment créés :
```json
{
  "createdAfter": "2026-06-01T00:00:00.000Z",
  "isArchived": "false",
  "pageSize": 1
}
```

Attention : `isArchived` est une **string** `"false"` et non un boolean. Sur des comptes avec fournisseurs à compte AP consolidé, `get_suppliers` peut échouer même à `pageSize=1` (vérifié) — voir [[s22-fournisseurs-actifs-iban]]. Un `pageSize` plus bas ne garantit rien.

## Exemples de prompts utilisateurs

- "Quels fournisseurs ont été ajoutés dans Spendesk depuis le 1er janvier ?"
- "Y a-t-il des fournisseurs dont les coordonnées bancaires ont été mises à jour ce mois-ci ?"
- "Synchronise notre ERP avec les nouveaux fournisseurs Spendesk créés depuis notre dernière sync le 2026-06-01"

Comment installer ce skill

/
  1. 1
    Télécharger le fichier s24-fournisseurs-filtre-temporel.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 s24-fournisseurs-filtre-temporel.md .claude/s24-fournisseurs-filtre-temporel.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
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
87/100·🔍 Ponctuel·Débutant

Détail complet d'une facture (get_payable_by_id)

Obtient le détail complet d'une facture spécifique par son ID via get_payable_by_id. Inclut les codes comptables, le fournisseur résolu et les champs analytiques.

ControllerAP Manager