Skip to main content

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:
  1. Acesse o painel do Olist ERP
  2. Vá em Configurações > Integrações > Webhooks
  3. Clique em Novo Webhook
  4. Selecione o evento Atualização de Estoque
  5. Informe a URL do seu endpoint
  6. 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
Após 3 tentativas sem sucesso, a notificação é descartada e você receberá um alerta por e-mail.

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_movimento para identificar a natureza da alteração