---
name: s24-fournisseurs-filtre-temporel
description: Filtre les fournisseurs créés ou mis à jour récemment avec createdAfter/updatedAfter dans get_suppliers
tags: [fournisseurs, createdAfter, updatedAfter, filtre-temporel, synchronisation]
when_to_use: Quand on veut synchroniser le référentiel fournisseurs avec un système externe (ERP, CRM) — identifier les nouveaux fournisseurs ajoutés depuis une date ou les fournisseurs dont les données ont changé (ex. : coordonnées bancaires mises à jour)
---

# 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"