Les intégrations sont en bêta
Envoyez les changements de stock vers Slack, Discord ou votre propre webhook, et lisez ou modifiez le stock avec un jeton d'API.
Daizy peut désormais prévenir d'autres logiciels lorsque le stock change, et ces logiciels peuvent modifier le stock en retour. Les deux sont en bêta, donc les noms de champs peuvent encore changer. Les intégrations sont disponibles avec le plan Business. Un propriétaire ou un administrateur ouvre Intégrations dans la barre latérale, où Destinations et API sont des pages distinctes.
Destinations
Une destination est un endroit où Daizy envoie un message après un changement. Slack et Discord utilisent chacun l'URL de webhook de l'application correspondante, et le message tient en une courte phrase. Un webhook simple est n'importe quelle adresse https, et Daizy envoie du JSON. Copiez le secret de signature lorsque vous en créez une, car chaque requête porte X-Daizy-Signature: sha256=<hex> calculé sur le corps brut.
Vous choisissez les événements à envoyer. Entrée de stock, sortie de stock, transfert, ajustement et article créé, mis à jour ou archivé. Les importations de tableur n'envoient pas un message par ligne.
Daizy enregistre le message avec le changement de stock et l'envoie quelques secondes plus tard. Si la destination est indisponible, elle réessaie au bout d'environ une minute, puis environ cinq, puis environ trente. Après environ dix échecs, la destination se désactive jusqu'à ce que vous l'enregistriez à nouveau. Envoyer un test met un message en file d'attente sans enregistrer de stock.
Chaque corps de webhook porte un id, un topic tel que stock.received, une version, un created_time et un payload. Utilisez l'id pour écarter un doublon, car 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, alors copiez-le à ce moment-là. Envoyez-le sous la forme Authorization: Bearer <token>. Un jeton de lecture liste les articles, les quantités et les mouvements. Un jeton de publication de stock enregistre les entrées, les sorties, les transferts et les ajustements. Un jeton de création et de modification d'articles ajoute et modifie les articles. Un jeton de lecture des contacts liste et ouvre les contacts. Un jeton de création et de modification des contacts ajoute, modifie, archive et active les contacts. Un jeton de lecture des achats et des ventes liste et ouvre ces documents, et un jeton de création et de modification les crée, les met à jour, les finalise, les réceptionne, les expédie et les annule. Un jeton auquel il manque une portée reçoit 403. Chaque jeton autorise environ 60 requêtes par minute, au-delà desquelles Daizy renvoie 429.
Les publications de stock nécessitent un en-tête Idempotency-Key. Envoyez la même clé dans la journée et 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
Indiquez itemId ou locationId dans un appel de soldes. Un corps de stock utilise les mêmes champs que l'écran, à savoir toLocationId ou fromLocationId, des notes et un contactId facultatifs, et des lignes composées d'un itemId et d'une quantité. Un transfert nécessite les deux emplacements. Un ajustement utilise toLocationId et la quantité devient le nouveau montant en stock. La création d'un article nécessite un name et un unitId.
Clients de chat
Le serveur MCP permet à un client de chat de lire et de modifier le stock. Pointez le client vers https://<your Daizy host>/mcp et envoyez le même jeton Bearer. Les portées et la limite de 60 requêtes par minute correspondent à celles de l'API. Les outils de lecture listent les articles, les quantités, les mouvements, les emplacements et les unités. Les outils de contact nécessitent les portées de contact, et les outils d'achat et de vente les leurs. Les outils de stock sont stock_in, stock_out, stock_move et stock_set, et chacun prend un argument idempotencyKey. La même clé dans la journée renvoie le mouvement d'origine.
Comme il s'agit d'une bêta, dites-nous ce qui casse ou ce qui manque. Répondez à n'importe quelle nouveauté et nous y jetterons un œil.