Ajuda do produto

# Integração webhook do Catálogo Mobile para ERP, preço, estoque e pedidos

Guia técnico para publicar produtos, atualizar estoque e preço, receber pedidos e organizar o fluxo assíncrono da integração webhook.

## O que a integração resolve

A integração webhook reduz retrabalho na publicação e na revisão comercial. Em vez de montar PDFs e links manualmente, o ERP passa a ser a origem dos dados que alimentam catálogo, pedido e atendimento.

- Atualiza produto, preço e estoque com a mesma referência de integração.

- Permite receber pedidos estruturados para o backoffice faturar com menos retrabalho.

- Cria um contrato técnico único para ERP próprio, middleware ou integrador parceiro.

## Como estruturar o contrato do integrador

O contrato mais seguro usa um identificador externo estável, trata o envio como assíncrono por padrão e mantém logs com request_id. Isso simplifica reprocessamento, evita duplicidade e dá rastreabilidade para suporte.

- Use idMapeamento como chave principal do item sempre que possível.

- Guarde request_id e status final de cada sincronização relevante.

- Mapeie código comercial apenas como redundância para consulta operacional.

## Rotina operacional recomendada

A operação saudável separa escrita, consulta e observabilidade. O integrador envia lotes pequenos, monitora falhas, reprocessa só o que parou e evita tratar o webhook como upload massivo sem controle.

- Sincronize catálogo e tabelas em janelas previsíveis.

- Atualize estoque com maior frequência do que o restante do cadastro.

- Crie alarmes para falhas repetidas no mesmo SKU, preço ou tabela.

## Autorização e limites do contrato

Use o integrationCode fornecido na configuração e o idEcommerce atribuído pelo suporte; idEcommerce identifica a origem da integração, não o produto. O contrato público exige cnpj, idEcommerce e tipo. Confira a documentação vigente antes de implementar: há limites distintos para requisições individuais, lotes e fotos.

## Funciona com o meu jeito de vender?

### Quando usar request_id?

Sempre que a integração operar em fila assíncrona ou quando a equipe precisar reconciliar erros com o backoffice.

### Posso sincronizar só estoque e preço?

Sim. A rotina recomendada separa carga estrutural do catálogo e atualizações operacionais mais frequentes.

### Quando vale acionar o suporte?

Quando você já tiver o payload testado, o request_id e a rota usada, principalmente se o status final ficar em failed ou duplicate.

Guias

## Continue na ajuda

### [Como manter preço e estoque alinhados para vender com segurança](https://ajuda.catalogomobile.com.br/organizar-estoque-e-preco/)

### [Importar produtos sem travar a montagem do catálogo](https://ajuda.catalogomobile.com.br/importar-produtos/)

### [Pedidos por link: como organizar representantes e atendimento sem travar a venda](https://ajuda.catalogomobile.com.br/pedidos-por-link/)

[Todos os guias de ajuda →](https://ajuda.catalogomobile.com.br/)

---
Canonical: https://ajuda.catalogomobile.com.br/integracao-webhook/
Language: pt-BR