Integração webhook do Catalogo 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.
Atualizado em 2026-03-29T20:22:01.000Z
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.
