En développement · accès pilote à l'automne 2026

L'API de Gramme, ses webhooks et son connecteur IA

Relier Gramme à votre boutique en ligne, à votre caisse, à vos automatisations et à votre assistant IA, sans double saisie. L'API est en cours de développement avec nos premiers ateliers pilotes. Elle sera ouverte à tous les ateliers Pro d'ici fin 2026, incluse dans l'offre Pro, sans supplément.

Lire

  • La mercuriale : matières, conditionnements, prix et leur historique
  • Les recettes : composition, sous-recettes, coût de revient, coût pour N pièces, allergènes
  • Le stock des matières et des produits, par lot, avec les dates limites
  • Les plans de production et leurs besoins en matières

Écrire

  • Les ventes de la journée, depuis une caisse ou une boutique en ligne
  • Les pertes et invendus
  • L'import en masse de la mercuriale et des recettes (CSV)
  • Le lancement d'un export complet ou comptable

Une clé par atelier

  • Créée et révoquée par l'administrateur de l'atelier, depuis les réglages.
  • En lecture seule, ou en lecture et écriture.
  • Cloisonnée : une clé ne voit que les données de son atelier, comme l'application.
  • Une API REST en JSON, versionnée, avec une documentation publique à l'ouverture.

Aperçu, susceptible d'évoluer jusqu'à la publication

GET  /v1/matieres
GET  /v1/recettes/{id}?pieces=150
GET  /v1/stock
POST /v1/ventes
POST /v1/pertes
GET  /v1/production/plans/{id}/besoins
POST /v1/exports

Authorization: Bearer <clé de l'atelier>

Des webhooks, pour être prévenu au bon moment

Chaque envoi est signé, pour que votre outil vérifie qu'il vient bien de Gramme, et relancé en cas d'échec. Les seuils sont ceux que vous réglez déjà dans l'application.

ÉvénementEnvoyé quand
prix.modifiele prix d'une matière change après une facture
stock.basun stock passe sous son seuil
marge.sous_seuilla marge d'un produit passe sous votre seuil
production.planifieeune production est planifiée
vente.importeeles ventes d'une journée sont enregistrées
export.pretun export est prêt à télécharger

Un connecteur MCP pour les assistants IA

Un serveur MCP en lecture, construit sur l'API, pour que votre assistant IA réponde avec les chiffres de votre atelier : « combien me coûtent 150 choux, et que me manque-t-il pour samedi ? » Fiches, coûts, allergènes, besoins en matières et stock.

n8n, Make, Zapier et votre boutique en ligne

Ces outils se branchent sur l'API par leurs blocs HTTP et webhook, sans attendre de connecteur dédié. Nous publierons des modèles prêts à l'emploi, en commençant par les commandes d'une boutique Shopify envoyées vers Gramme.

Dès aujourd'hui, sans l'API

  • L'export complet de vos données à tout moment : CSV, classeur Excel, JSON et fiches en PDF.
  • L'import des ventes du jour depuis un fichier CSV de caisse, colonnes mémorisées.
  • Un dossier comptable mensuel : journaux d'achats et de ventes, pièces jointes.

Vous intégrez des outils pour des artisans ?

Consultants, intégrateurs, développeurs : rejoignez les ateliers pilotes. Vous testez l'API avant son ouverture, et vos retours décident de l'ordre des prochaines briques.

Demander un accès pilote