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:- Acesse Configurações > Integrações > Webhooks
- Clique em Novo Webhook
- Selecione o evento Envio de Produtos
- Informe a URL do seu endpoint
- 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
idouskupara 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
categoriaretorna o caminho completo separado por ” > ”
