Filtrer les résultats ($filter)
Le modificateur $filter restreint les éléments retournés par une extraction (GET).
Syntaxe de base
GET /api/Entity/Customer?$filter=NomClient eq 'Les entreprises de Jacques'
- Sous-champs supportés :
/api/Entity/Product?$filter=GroupeProduit.CodeGroupe eq 'vêtements' - Chaînage avec
and:...$filter=GroupeProduit.CodeGroupe eq 'vêtements' and PrixFinal gt 5.75 - Numériques avec point décimal ; textes et dates entre apostrophes, dates au format
yyyy-MM-dd:$filter=Fiche_DerniereModification gt '2024-02-10'
Les opérateurs
| Opérateur | Alias | Sens |
|---|---|---|
| EQUALS | eq | égal |
| NOTEQUALS | ne | différent |
| GREATERTHAN | gt | plus grand |
| GREATERTHANEQUALS | ge | plus grand ou égal |
| LESSTHAN | lt | plus petit |
| LESSTHANEQUALS | le | plus petit ou égal |
| CONTAINS | — | contient (champs textes seulement) |
| DOESNTCONTAINS | — | ne contient pas (champs textes seulement) |
| IN (liste) | in | dans une liste : NoCompteGL in ('1000','1100','2000') |
Attention : tous les champs ne sont pas filtrables partout
Chaque système impose ses restrictions (elles viennent des SDK/API natifs des ERP). La référence complète est générée depuis les capacités réelles des connecteurs — une page par entité et par système, avec les opérateurs permis champ par champ : Acomba · QuickBooks Online · Avantage · Sage 50 · Sage 300 · Autotask · ProShop.
Exemple : les filtres de Customer pour Acomba —
seuls NoClient, NoUniqueSystemeSource, Fiche_DerniereModification (plages de
dates) et EstActif sont filtrables.
Pour savoir si UN champ précis est filtrable et avec quels opérateurs, consultez la page Capacités par système de votre ERP (par exemple Acomba) : elle est générée depuis les capacités réelles du connecteur et fait autorité.