Daizy

Intégrations et APIBeta

Envoyez les changements de stock à Slack, Discord ou un webhook, et appelez Daizy avec un jeton d'API

Les intégrations font partie du plan Business. Un propriétaire ou un administrateur ouvre Intégrations dans la barre latérale. Les destinations et l'API sont des pages distinctes.

Destinations

Une destination est un endroit où Daizy envoie un message après un changement.

  • Slack et Discord utilisent l'URL de webhook de cette application. Le message est une phrase courte.
  • Webhook est n'importe quelle adresse https. Daizy envoie du JSON. Copiez le secret de signature au moment de sa création. Chaque requête inclut X-Daizy-Signature: sha256=<hex> calculé sur le corps brut.

Choisissez les événements à envoyer : entrée de stock, sortie de stock, transfert, ajustement, et article créé, mis à jour ou archivé. Les importations de feuille de calcul n'envoient pas un message par ligne.

Daizy enregistre le message avec le changement de stock, puis l'envoie quelques secondes plus tard. Si l'autre côté est indisponible, elle réessaie après environ 1 minute, puis 5, puis 30. Après environ 10 échecs, la destination est désactivée jusqu'à ce que vous l'enregistriez à nouveau. Envoyer un test met un message en file d'attente sans enregistrer de stock.

Le corps d'un webhook ressemble à ceci :

{
  "id": "event id",
  "topic": "stock.received",
  "version": 1,
  "created_time": "2026-10-02T15:00:00.000Z",
  "payload": {}
}

Utilisez id pour ignorer une répétition. Les messages peuvent arriver dans le désordre.

Jetons d'API

Ouvrez API et créez un jeton. Daizy affiche le secret une seule fois. Envoyez-le sous la forme Authorization: Bearer <token>.

  • Lecture peut lister des articles, des quantités et des mouvements.
  • Enregistrer du stock peut effectuer des entrées, des sorties, des transferts et des ajustements.
  • Créer et modifier des articles peut ajouter et modifier des articles.
  • Lire les contacts peut lister et ouvrir des contacts.
  • Créer et modifier des contacts peut ajouter, modifier, archiver et activer des contacts.
  • Lire les achats et les ventes peut lister et ouvrir des achats et des ventes.
  • Créer et modifier des achats et des ventes peut créer, mettre à jour, finaliser, réceptionner, expédier et annuler ces documents.

Un jeton qui ne peut pas enregistrer de stock reçoit 403 s'il essaie. Chaque jeton autorise environ 60 requêtes par minute. Au-delà, Daizy répond 429.

Les enregistrements de stock exigent un en-tête Idempotency-Key. Si la même clé est envoyée à nouveau dans la journée, Daizy renvoie le mouvement d'origine au lieu de modifier la quantité deux fois.

GET /api/v1/items?q=&status=active&limit=50
GET /api/v1/items/by-sku/:sku
GET /api/v1/items/:itemId
POST /api/v1/items
PATCH /api/v1/items/:itemId
GET /api/v1/balances?itemId=&locationId=
GET /api/v1/movements?limit=50
GET /api/v1/movements/:movementId
POST /api/v1/stock/receive
POST /api/v1/stock/issue
POST /api/v1/stock/move
POST /api/v1/stock/set

Pour les soldes, indiquez au moins itemId ou locationId. Un corps de stock utilise les mêmes champs que l'écran : toLocationId ou fromLocationId, notes et contactId facultatifs, et lines avec { "itemId", "quantity" }. Un transfert nécessite les deux emplacements. L'ajustement utilise toLocationId, et la quantité est la nouvelle quantité en stock. La création d'un article nécessite name et unitId.

MCP

Les clients de chat se connectent à https://<votre hôte Daizy>/mcp et envoient le même Authorization: Bearer <token>. Les portées et la limite de 60 requêtes par minute sont les mêmes que pour l'API.

Un jeton de lecture peut lister des articles, des quantités, des mouvements, des emplacements et des unités. Les outils de contact nécessitent les options de contact. Les outils d'achat et de vente nécessitent les options d'achat et de vente. Les outils de stock correspondent aux pages du tableau de bord : stock_in, stock_out, stock_move et stock_set. Chacun prend un argument idempotencyKey. La même clé dans la journée renvoie le mouvement d'origine.