Skip to main content

Descrição

Este webhook é acionado automaticamente sempre que um produto for cadastrado ou tiver suas informações alteradas no Olist ERP.

Quando é Acionado

O webhook de envio de produtos é disparado nas seguintes situações:
  • Cadastro de novo produto
  • Alteração de dados do produto (nome, descrição, preço, etc.)
  • Alteração de imagens
  • Alteração de categoria
  • Ativação/desativação de produto
  • Alteração de variações

Estrutura da Notificação

Campos da Notificação

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 Envio de Produtos
  4. Informe a URL do seu endpoint
  5. Salve as configurações

Casos de Uso

  • Sincronização com e-commerce: Mantenha seu site atualizado automaticamente
  • Integração com marketplace: Envie produtos para múltiplos canais de venda
  • Sistema de precificação: Atualize preços em sistemas externos
  • Catálogo unificado: Centralize informações de produtos
  • Notificações: Avise sua equipe sobre novos produtos

Boas Práticas

  • Valide os dados: Sempre verifique se os campos obrigatórios estão presentes
  • Trate duplicatas: Use o campo id ou sku para evitar duplicação
  • Baixe imagens: Salve as imagens localmente para melhor performance
  • Processe assincronamente: Use filas para não bloquear o webhook
  • Log completo: Registre todas as alterações para auditoria

Observações

  • O webhook inclui apenas produtos com situação “Ativo” por padrão
  • Alterações de estoque não acionam este webhook (use o webhook de atualização de estoque)
  • Produtos com múltiplas variações podem gerar notificações separadas
  • Imagens grandes podem atrasar o processamento - implemente cache
  • O campo categoria retorna o caminho completo separado por ” > ”