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
| Campo | Tipo | Descrição |
|---|---|---|
| evento | string | Sempre “envio_produtos” |
| data_hora | string | Data e hora do evento (dd/mm/yyyy hh:mm:ss) |
| acao | string | ”incluir” ou “alterar” |
| produtos[] | array | Lista de produtos afetados |
| produtos[].id | int | ID do produto no Olist ERP |
| produtos[].sku | string | Código SKU do produto |
| produtos[].nome | string | Nome do produto |
| produtos[].preco | decimal | Preço de venda |
| produtos[].preco_promocional | decimal | Preço promocional (se houver) |
| produtos[].unidade | string | Unidade de medida |
| produtos[].peso_bruto | decimal | Peso bruto em kg |
| produtos[].peso_liquido | decimal | Peso líquido em kg |
| produtos[].altura | decimal | Altura em cm |
| produtos[].largura | decimal | Largura em cm |
| produtos[].comprimento | decimal | Comprimento em cm |
| produtos[].ncm | string | Código NCM |
| produtos[].origem | int | Código de origem (0-8) |
| produtos[].gtin | string | Código de barras (GTIN/EAN) |
| produtos[].categoria | string | Caminho da categoria |
| produtos[].estoque | decimal | Saldo em estoque |
| produtos[].situacao | string | A=Ativo, I=Inativo |
| produtos[].tipo | string | P=Produto, S=Serviço |
| produtos[].classe_ipi | string | Classe de IPI |
| produtos[].codigo_beneficio_fiscal | string | Código de benefício fiscal |
| produtos[].anexos[] | array | Lista de imagens do produto |
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 ” > ”
