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.
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
/
- 1Télécharger le fichier
s24-fournisseurs-filtre-temporel.mdvia le bouton ci-dessus. - 2Placer 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 - 3Utiliser 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
★ Top