Descrição
Este webhook é acionado automaticamente sempre que houver alteração no estoque de um ou mais produtos em sua conta do Olist ERP.Quando é Acionado
O webhook de atualização de estoque é enviado nas seguintes situações:- Lançamento manual de estoque
- Baixa de estoque por venda
- Devolução de produtos
- Ajuste de inventário
- Entrada de mercadoria
- Transferência entre depósitos
Estrutura da Notificação
A notificação é enviada via POST para a URL configurada, com o seguinte formato:Campos da Notificação
Exemplo de Implementação
PHP
Python
Node.js
Configuração
Para ativar este webhook:- Acesse o painel do Olist ERP
- Vá em Configurações > Integrações > Webhooks
- Clique em Novo Webhook
- Selecione o evento Atualização de Estoque
- Informe a URL do seu endpoint
- Salve as configurações
Boas Práticas
- Responda rapidamente: Seu endpoint deve responder em menos de 5 segundos
- Processe assincronamente: Use filas para processar as notificações
- Implemente idempotência: Evite duplicação de processamento
- Valide os dados: Sempre valide o formato e conteúdo recebido
- Log de erros: Registre falhas para análise posterior
- Use HTTPS: Garanta a segurança da comunicação
Tratamento de Erros
Se seu endpoint retornar um erro ou timeout, o sistema tentará reenviar a notificação:- 1ª tentativa: Imediata
- 2ª tentativa: Após 1 minuto
- 3ª tentativa: Após 5 minutos
Observações
- Múltiplas alterações em um curto período podem ser agrupadas em uma única notificação
- Alterações muito rápidas (< 1 segundo) podem ser consolidadas
- O webhook não é enviado para alterações feitas via API (para evitar loops)
- Utilize o campo
tipo_movimentopara identificar a natureza da alteração
