Skip to main content

Descrição

Este webhook é acionado automaticamente sempre que a situação de um pedido for alterada no Olist ERP.

Quando é Acionado

  • Mudança de situação do pedido (aberto → aprovado → faturado, etc.)
  • Aprovação de pedido
  • Faturamento de pedido
  • Cancelamento de pedido
  • Separação iniciada/concluída
  • Pedido enviado
  • Pedido entregue

Estrutura da Notificação

Campos da Notificação

Situações Possíveis

Exemplo de Implementação

PHP

Python

Node.js

Configuração

Para ativar este webhook:
  1. Acesse Configurações > Integrações > Webhooks
  2. Clique em Novo Webhook
  3. Selecione o evento Atualização de Situação de Pedido
  4. Informe a URL do seu endpoint
  5. Opcionalmente, selecione situações específicas para monitorar
  6. Salve as configurações

Casos de Uso

  • Notificações ao cliente: E-mail/SMS automático em cada etapa
  • Dashboard em tempo real: Atualize painéis de acompanhamento
  • Integração com marketplaces: Sincronize status em múltiplos canais
  • Automação logística: Acione processos de separação e envio
  • CRM automático: Atualize jornada do cliente
  • BI e Analytics: Alimente relatórios em tempo real
  • Pesquisa de satisfação: Envie automaticamente após entrega

Boas Práticas

  • Notificações contextuais: Personalize mensagens para cada situação
  • Múltiplos canais: Use e-mail, SMS e push notification
  • Templates profissionais: Use templates bem desenhados
  • Tracking de eventos: Registre todas as mudanças para analytics
  • Idempotência: Evite processar a mesma mudança múltiplas vezes
  • Tratamento de erros: Implemente retry para falhas temporárias

Observações

  • Algumas mudanças de situação podem ser revertidas (ex: cancelamento)
  • Pedidos podem pular situações intermediárias em alguns fluxos
  • A situação “cancelado” pode ocorrer a partir de qualquer estado
  • Dados de nota_fiscal e rastreamento são condicionais
  • Múltiplos pedidos podem ser notificados em uma única requisição
  • O webhook é enviado apenas para mudanças efetivas de situação