Integrações estão em beta
Envie mudanças de estoque para o Slack, o Discord ou seu próprio webhook, e leia ou altere o estoque com um token de API.
A Daizy agora pode avisar outros softwares quando o estoque muda, e esse software pode alterar o estoque de volta. Ambos estão em beta, então os nomes dos campos ainda podem mudar. As integrações estão no plano Business. Um proprietário ou administrador abre Integrações na barra lateral, onde Destinos e API são páginas separadas.
Destinos
Um destino é um lugar para onde a Daizy envia uma mensagem após uma mudança. O Slack e o Discord usam, cada um, a URL de webhook do respectivo aplicativo, e a mensagem é uma única frase curta. Um webhook simples é qualquer endereço https, e a Daizy envia JSON. Copie o segredo de assinatura quando criar um, porque cada requisição carrega X-Daizy-Signature: sha256=<hex> calculado sobre o corpo bruto.
Você escolhe os eventos a 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 destino estiver fora do ar, ela tenta novamente após cerca de um minuto, depois cerca de cinco, depois cerca de trinta. Após cerca de dez falhas, o destino é desativado até que você o salve novamente. Enviar teste coloca uma mensagem na fila sem registrar estoque.
Cada corpo de webhook carrega um id, um topic como stock.received, uma version, um created_time e um payload. Use o id para descartar uma repetição, porque as mensagens podem chegar fora de ordem.
Tokens de API
Abra API e crie um token. A Daizy mostra o segredo uma única vez, então copie-o nesse momento. Envie-o como Authorization: Bearer <token>. Um token de leitura lista itens, quantidades e movimentações. Um token de lançamento de estoque registra entrada, saída, transferência e ajuste. Um token de criação e edição de itens adiciona e altera itens. Um token de leitura de contatos lista e abre contatos. Um token de criação e edição de contatos adiciona, altera, arquiva e ativa contatos. Um token de leitura de compras e vendas lista e abre esses documentos, e um token de criação e edição cria, atualiza, finaliza, recebe, envia e cancela esses documentos. Um token que não tem um escopo recebe 403. Cada token permite cerca de 60 requisições por minuto e, acima disso, a Daizy retorna 429.
Lançamentos de estoque precisam de um cabeçalho Idempotency-Key. Envie a mesma chave dentro de um dia e 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
Passe itemId ou locationId em uma chamada de saldos. Um corpo de estoque usa os mesmos campos da tela, que são toLocationId ou fromLocationId, notes e contactId opcionais, e linhas com um itemId e uma quantidade. Uma transferência precisa dos dois locais. Um ajuste usa toLocationId e a quantidade é o novo total disponível. Criar um item precisa de um name e um unitId.
Clientes de chat
O servidor MCP permite que um cliente de chat leia e altere o estoque. Aponte o cliente para https://<your Daizy host>/mcp e envie o mesmo token Bearer. Os escopos e o limite de 60 requisições por minuto são iguais aos da API. As ferramentas de leitura listam itens, quantidades, movimentações, locais e unidades. As ferramentas de contato precisam dos escopos de contato, e as de compras e vendas precisam dos seus. As ferramentas de estoque são stock_in, stock_out, stock_move e stock_set, e cada uma recebe um argumento idempotencyKey. A mesma chave dentro de um dia retorna a movimentação original.
Como isto é um beta, conte para nós o que quebra ou o que está faltando. Responda a qualquer novidade e daremos uma olhada.