Daizy

Integraciones y APIBeta

Envía cambios de existencias a Slack, Discord o un webhook, y llama a Daizy con un token de API

Las integraciones están en el plan Business. Un propietario o administrador abre Integraciones en la barra lateral. Destinos y la API son páginas separadas.

Destinos

Un destino es el lugar al que Daizy envía un mensaje después de un cambio.

  • Slack y Discord usan la URL de webhook de esa aplicación. El mensaje es una frase corta.
  • Webhook es cualquier dirección https. Daizy envía JSON. Copia el secreto de firma al crearlo. Cada solicitud incluye X-Daizy-Signature: sha256=<hex> sobre el cuerpo sin modificar.

Elige qué eventos enviar: entrada, salida, traslado, ajuste, y artículo creado, actualizado o archivado. Las importaciones de hoja de cálculo no envían un mensaje por fila.

Daizy guarda el mensaje junto con el cambio y lo envía unos segundos después. Si el otro lado no responde, reintenta al cabo de 1 minuto, luego 5 y luego 30. Tras unos 10 fallos, el destino se apaga hasta que lo guardes de nuevo. Enviar prueba encola un mensaje sin registrar existencias.

Usa el id del evento para ignorar una repetición. Los mensajes pueden llegar desordenados.

Tokens de API

Abre API y crea un token. Daizy muestra el secreto una sola vez. Envíalo como Authorization: Bearer <token>.

  • Lectura lista artículos, cantidades y movimientos.
  • Registrar existencias puede dar entrada, salida, trasladar y ajustar.
  • Crear y editar artículos puede añadir y cambiar artículos.
  • Leer contactos lista y abre contactos.
  • Crear y editar contactos puede añadir, cambiar, archivar y activar contactos.
  • Leer compras y ventas lista y abre compras y ventas.
  • Crear y editar compras y ventas puede crear, editar, finalizar, recibir, enviar y cancelar esos documentos.

Un token sin permiso para registrar existencias recibe 403. Cada token permite unas 60 solicitudes por minuto. Por encima de eso, Daizy responde 429.

Las altas de existencias exigen la cabecera Idempotency-Key. Si la misma clave se envía otra vez en un día, Daizy devuelve el movimiento original.

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

Para cantidades, pasa itemId, locationId o ambos. El cuerpo de existencias usa toLocationId o fromLocationId, notes y contactId opcionales, y lines con { "itemId", "quantity" }. Un traslado necesita las dos ubicaciones. Ajustar usa toLocationId, y la cantidad es la nueva existencia. Crear un artículo necesita name y unitId.

MCP

Los clientes de chat se conectan a https://<tu host de Daizy>/mcp y envían el mismo Authorization: Bearer <token>. Los permisos y el límite de 60 solicitudes por minuto son los mismos que en la API.

Un token de lectura lista artículos, cantidades, movimientos, ubicaciones y unidades. Las herramientas de contactos usan las opciones de contactos. Las de compras y ventas usan las opciones de compras y ventas. Las de existencias coinciden con las páginas: stock_in, stock_out, stock_move y stock_set. Cada una recibe un argumento idempotencyKey. La misma clave en un día devuelve el movimiento original.