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, la matrice SDK
Capabilities fait autorité (outil check_field_support avec op=filter).