Skip to content
Gillia Developers v1

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

ListeLire ce qui a changéOrdre
GET /pos/sales/ticketsfrom (et to) sur l'heure de ventePlus récents d'abord
GET /pos/customerscursor : renvoyez le cursor reçuOrdre des changements
GET /pos/catalog/productsupdatedSince : le plus grand updatedAt reçuupdatedAt, puis id
GET /pos/purchases/ordersupdatedSince (réceptions, écarts et pièces jointes le font avancer)updatedAt, puis id
`GET /pos/inventory/movements?type=out\transfer\production`updatedSinceupdatedAt, puis id
GET /pos/inventory/lotsexpiringBefore=AAAA-MM-JJ (lots en stock dont la DLC tombe avant ce jour)Date limite
GET /pos/suppliersAucune date n'est conservée : gardez les identifiants déjà vusPlus récents d'abord
GET /pos/closures?date=AAAA-MM-JJUne 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 une cause (damage, expiry, theft, donation, supplier_return…) ;
  • type=transfer : les transferts entre établissements, avec fromSite et toSite (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.