Daizy

Integrações e APIBeta

Envie mudanças de estoque para o Slack, o Discord ou um webhook, e chame a Daizy com um token de API

As integrações estão no plano Business. Um proprietário ou administrador abre Integrações na barra lateral. Destinos e a API são páginas separadas.

Destinos

Um destino é um lugar para onde a Daizy envia uma mensagem depois de uma mudança.

  • Slack e Discord usam a URL de webhook desse aplicativo. A mensagem é uma frase curta.
  • Webhook é qualquer endereço https. A Daizy envia JSON. Copie o segredo de assinatura quando você o criar. Cada solicitação inclui X-Daizy-Signature: sha256=<hex> sobre o corpo bruto.

Escolha quais eventos enviar: entrada, saída, transferência, ajuste e item criado, atualizado ou arquivado. Importações de planilha não enviam uma mensagem por linha.

A Daizy salva a mensagem junto com a mudança de estoque e a envia alguns segundos depois. Se o outro lado estiver fora do ar, ele tenta de novo após cerca de 1 minuto, depois 5, depois 30. Após cerca de 10 falhas, o destino é desativado até que você o salve novamente. Enviar teste enfileira uma mensagem sem registrar estoque.

Um corpo de webhook se parece com isto:

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

Use id para ignorar uma repetição. As mensagens podem chegar fora de ordem.

Tokens de API

Abra API e crie um token. A Daizy mostra o segredo uma única vez. Envie-o como Authorization: Bearer <token>.

  • Leitura pode listar itens, quantidades e movimentações.
  • Registrar estoque pode dar entrada, dar saída, transferir e ajustar.
  • Criar e editar itens pode adicionar e alterar itens.
  • Ler contatos pode listar e abrir contatos.
  • Criar e editar contatos pode adicionar, alterar, arquivar e ativar contatos.
  • Ler compras e vendas pode listar e abrir compras e vendas.
  • Criar e editar compras e vendas pode criar, atualizar, finalizar, receber, enviar e cancelar esses documentos.

Um token que não pode registrar estoque recebe 403 se tentar. Cada token permite cerca de 60 solicitações por minuto. Acima disso, a Daizy responde 429.

As gravações de estoque exigem um cabeçalho Idempotency-Key. Se a mesma chave for enviada novamente dentro de um dia, a Daizy retorna a movimentação original em vez de alterar a quantidade duas vezes.

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 saldos, passe pelo menos um de itemId ou locationId. Um corpo de estoque usa os mesmos campos da tela: toLocationId ou fromLocationId, notes e contactId opcionais, e lines de { "itemId", "quantity" }. Transferir precisa dos dois locais. Ajustar usa toLocationId, e a quantidade é o novo valor disponível. Criar um item precisa de name e unitId.

MCP

Clientes de chat se conectam a https://<seu host da Daizy>/mcp e enviam o mesmo Authorization: Bearer <token>. Os escopos e o limite de 60 solicitações por minuto são os mesmos da API.

Um token de leitura pode listar itens, quantidades, movimentações, locais e unidades. As ferramentas de contato precisam das opções de contato. As ferramentas de compra e venda precisam das opções de compra e venda. As ferramentas de estoque correspondem às páginas do painel: stock_in, stock_out, stock_move e stock_set. Cada uma recebe um argumento idempotencyKey. A mesma chave dentro de um dia retorna a movimentação original.