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
| Campo | Tipo | Descrição |
|---|---|---|
| evento | string | Sempre “atualizacao_estoque” |
| data_hora | string | Data e hora da alteração (dd/mm/yyyy hh:mm:ss) |
| produtos[] | array | Lista de produtos com estoque alterado |
| produtos[].id | int | ID do produto no Olist ERP |
| produtos[].sku | string | Código SKU do produto |
| produtos[].nome | string | Nome do produto |
| produtos[].saldo | decimal | Saldo atual após a alteração |
| produtos[].saldo_anterior | decimal | Saldo antes da alteração |
| produtos[].tipo_movimento | string | Tipo: “entrada”, “saida” ou “ajuste” |
| produtos[].observacao | string | Observação do movimento |
| produtos[].deposito_id | int | ID do depósito afetado |
| produtos[].deposito_nome | string | Nome do depósito |
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
