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

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?