Guide
Lire ce qui a changé
Suivre les nouveautés et les modifications sans tout relire : curseurs, updatedSince et listes du plus récent au plus ancien.
Pourquoi c'est important
La plupart des intégrations interrogent Gillia toutes les quelques minutes : « quoi de neuf ? ». Relire des listes entières est lent et consomme votre limite de débit. Chaque liste ci-dessous indique comment lire seulement ce qui a changé.
Les méthodes, liste par liste
| Liste | Lire ce qui a changé | Ordre | ||
|---|---|---|---|---|
GET /pos/sales/tickets | from (et to) sur l'heure de vente | Plus récents d'abord | ||
GET /pos/customers | cursor : renvoyez le cursor reçu | Ordre des changements | ||
GET /pos/catalog/products | updatedSince : le plus grand updatedAt reçu | updatedAt, puis id | ||
GET /pos/purchases/orders | updatedSince (réceptions, écarts et pièces jointes le font avancer) | updatedAt, puis id | ||
| `GET /pos/inventory/movements?type=out\ | transfer\ | production` | updatedSince | updatedAt, puis id |
GET /pos/inventory/lots | expiringBefore=AAAA-MM-JJ (lots en stock dont la DLC tombe avant ce jour) | Date limite | ||
GET /pos/suppliers | Aucune date n'est conservée : gardez les identifiants déjà vus | Plus récents d'abord | ||
GET /pos/closures?date=AAAA-MM-JJ | Une journée clôturée par appel ; une journée ouverte répond 409, une journée pas encore terminée 400 | — |
Avec updatedSince, parcourez les pages (page / pageSize) tant que hasMore vaut true, puis gardez le plus grand updatedAt reçu pour l'appel suivant. Les instants sont en UTC (ISO 8601 avec un Z).
Mouvements de stock
GET /pos/inventory/movements lit le stock qui bouge sans vente :
type=out: les sorties, avec unecause(damage,expiry,theft,donation,supplier_return…) ;type=transfer: les transferts entre établissements, avecfromSiteettoSite(un transfert apparaît chez les deux établissements) ;type=production: les productions.
Chaque mouvement porte son state (pending, completed, cancelled) et ses lines (productId, productName, quantity). Aucun prix ni coût n'est rendu. Droit requis : pos.catalog.read.
Lots et DLC
GET /pos/inventory/lots liste les lots ouverts encore en stock de l'établissement, avec lotNumber, serialNumber, dlc (date limite) et quantityRemaining, date limite la plus proche d'abord. Ajoutez expiringBefore pour ne garder que les lots qui arrivent à leur DLC avant une date : c'est la base d'une alerte « DLC proche ». Aucun coût n'est rendu. Droit requis : pos.catalog.read.
Fournisseurs
GET /pos/suppliers liste les fournisseurs de l'enseigne (nom, e-mail, téléphone, adresse, SIRET), du plus récent au plus ancien. Droit requis : pos.purchases.read.
Un exemple réel : l'application Gillia pour Zapier
L'application Gillia pour Zapier repose uniquement sur cette API publique, avec la connexion OAuth du commerçant. Ses déclencheurs (« New Sale », « Low Stock », « Expiring Lot », « New Stock Transfer »…) utilisent exactement ces méthodes : une fenêtre de temps sur les ventes, updatedSince sur les commandes fournisseurs et les mouvements, expiringBefore sur les lots, et le repérage par identifiant là où aucune date n'existe.