Se você está buscando uma maneira eficaz de sincronizar seus produtos, preços e estoque entre o seu sistema e o Catálogo Mobile, temos uma ótima notícia para você. Apresentamos o novo recurso de integração com ERP via Webhook, que permite enviar produtos, preços, estoque e fotos de forma automatizada para o Catálogo Mobile.
As requisições são recebidas via Webhook e processadas de forma assíncrona, usando preferencialmente o idMapeamento, que é o identificador do produto no ERP. O código do produto pode ser usado como fallback.
Também disponibilizamos a documentação completa via Postman para facilitar a integração, e para qualquer dúvida contate nosso suporte, será um prazer ajudar.
Configuração da Integração do Catálogo Mobile com ERP via Webhook
Para integrar seu ERP, e-commerce ou sistema externo ao Catálogo Mobile, crie uma integração do tipo Webhook no Webadmin. Depois disso, use os dados gerados para enviar produtos, preços, estoque, fotos e consultar pedidos.
- Acesse o Catálogo Mobile pelo Webadmin com uma conta administradora.
- No menu de integrações, adicione uma nova integração do tipo Webhook.
- Configure os campos obrigatórios da integração e mantenha a integração ativa.
- Ao salvar, será gerado o
integrationCode, usado nas URLs dos endpoints.
| Campo | Onde aparece | Para que serve |
|---|---|---|
integrationCode | URL | Identifica a integração Webhook configurada no Catálogo Mobile. |
idEcommerce | Payload | Identifica o integrador, cliente ou ambiente no seu sistema. |
token | Header, quando solicitado | Usado na autenticação das consultas conforme a documentação técnica. |
Links de Webhook para integração com o Catálogo Mobile
Use a URL base abaixo e combine com o caminho do endpoint desejado. Esse formato melhora a leitura e evita links muito longos quebrando o layout da página.
https://sistema.catalogomobile.com.br/api/v2/integracao/webhookSubstitua {integrationCode} pelo código gerado na sua integração.
Adicionar ou atualizar produto
Método: POST
Uso: cadastrar ou atualizar produtos enviados pelo ERP.
/adicionarProduto/{integrationCode}/Notificar estoque
Método: POST
Uso: atualizar a quantidade disponível em estoque.
/notificaEstoque/{integrationCode}/Atualizar preço
Método: POST
Uso: atualizar preço, preço promocional e condições comerciais do produto.
/enviaPreco/{integrationCode}/Inserir foto
Método: POST
Uso: enviar arquivo de imagem por multipart/form-data.
/inserirFotos/{integrationCode}/Detalhar produto por idMapeamento
Método: GET
Uso: buscar os detalhes do produto usando o ID do produto no ERP.
/detalharProduto/{integrationCode}/idMapeamento/{valor}/Detalhar produto por código
Método: GET
Uso: alternativa quando o ERP não usa idMapeamento.
/detalharProduto/{integrationCode}/code/{codigo}/Listar pedidos
Método: GET
Uso: consultar pedidos a partir de uma data informada.
/listarPedidos/{integrationCode}/?data=YYYY-MM-DDConsultar status assíncrono
Método: GET
Uso: acompanhar uma requisição aceita com request_id.
/status/{request_id}/A documentação completa com exemplos de payload, headers e respostas está disponível no Postman.
Mapeamento de produtos do ERP com o Catálogo Mobile
O mapeamento define como o Catálogo Mobile encontra o produto correto quando o ERP envia atualizações. Para uma integração mais simples e estável, use idMapeamento como referência principal e code como alternativa.
| Campo | O que representa | Recomendação |
|---|---|---|
idMapeamento | ID do produto no ERP ou sistema de origem. | Use como referência principal para produto, preço, estoque e fotos. |
code | Código ou SKU do produto. | Use como fallback quando não houver ID interno único no ERP. |
skuMapeamento | ID interno do produto no Catálogo Mobile. | Evite como fluxo principal, pois pode exigir uma consulta prévia ao Catálogo Mobile. |
Processamento assíncrono e consulta de status
Os endpoints de escrita, como produto, estoque, preço e fotos, podem responder com HTTP 202 e um request_id. Isso significa que a requisição foi aceita e será processada em fila.
Depois de receber o request_id, o integrador deve consultar o endpoint de status para acompanhar o processamento. Quando o status for processed, o campo result traz o resultado final da operação.
GET /api/v2/integracao/webhook/status/{request_id}/| Status | Significado |
|---|---|
queued | A requisição foi recebida e aguarda processamento. |
processing | A requisição está em processamento. |
processed | A operação foi concluída. Leia o campo result. |
failed | O processamento falhou. Verifique a mensagem de erro. |
not_found | O request_id informado não foi encontrado. |
Envio de imagens para o catálogo
Para ERPs que trabalham com imagens locais ou arquivos internos, use o endpoint de envio de fotos por multipart/form-data. Recomendamos identificar o produto por idMapeamento e enviar uma imagem por chamada, usando um dos campos foto1, foto2, foto3 ou foto4.
POST /api/v2/integracao/webhook/inserirFotos/{integrationCode}/Quando a imagem estiver disponível por URL pública, ela também pode ser enviada no cadastro ou atualização do produto pelo campo anexos.
{ "url": "https://exemplo.com/imagem1.jpg" }Se a integração por API não for possível, o cliente também pode usar o envio de imagens em massa no Webadmin. Nesse fluxo, o nome do arquivo deve usar o código do produto, por exemplo: 1202.jpg para vincular a imagem ao produto de código 1202.
Acessar envio de imagens em massa
Envio e consulta de pedidos
O Catálogo Mobile pode apoiar o fluxo de pedidos B2B. Dependendo da configuração, os pedidos podem ser enviados para um endpoint do seu sistema ou consultados pela integração.
Para consultar pedidos pela API, use o endpoint de listagem informando a data inicial desejada.
GET /api/v2/integracao/webhook/listarPedidos/{integrationCode}/?data=YYYY-MM-DDQuando não houver integração automática para pedidos, o Webadmin permite baixar os itens do pedido em Excel para conferência e importação manual.
Documentação completa no Postman
Disponibilizamos a documentação completa com exemplos de payload, campos obrigatórios, autenticação e respostas dos endpoints.
Perguntas Frequentes Sobre Integração ERP e Catálogo Mobile
Como realizar a integração de sistema ERP com o Catálogo Mobile?
Para integrar um sistema ERP ao Catálogo Mobile, você pode usar a integração via Webhook para enviar produtos, preços, estoque e fotos do ERP para o catálogo. Após configurar o token e o integrationCode, o ERP passa a se comunicar com os endpoints do Catálogo Mobile para cadastrar produtos, atualizar preços, notificar estoque e manter o catálogo sempre atualizado. A recomendação é usar o idMapeamento como referência principal e o código do produto como alternativa.
A integração com ERP é gratuita?
Sim. A integração via Webhook está disponível para assinantes do Catálogo Mobile. Todos os planos com acesso à ferramenta podem utilizar a integração para sincronizar produtos, preços, estoque, fotos e pedidos com o ERP ou sistema de gestão.
Como funciona a Ferramenta de Automação de Catálogo?
A Ferramenta de Automação de Catálogo permite criar e atualizar catálogos de produtos automaticamente a partir dos dados do seu ERP ou sistema de gestão. Com ela, é possível manter produtos, fotos, descrições, códigos, preços e estoque sincronizados no Catálogo Mobile. Depois da integração, sua empresa pode gerar catálogo em PDF, compartilhar links de produtos e facilitar o trabalho de vendedores, representantes comerciais e equipes B2B.
Tenho dúvidas sobre a integração. Como posso falar com o suporte?
Você pode falar com o suporte do Catálogo Mobile pelo WhatsApp disponível na página inicial do site. Nossa equipe pode orientar sobre configuração, envio de dados, testes de integração e dúvidas sobre os endpoints disponíveis.
Meu e-commerce ou ERP pode integrar com o Catálogo Mobile?
Sim, desde que o seu ERP, e-commerce ou sistema de gestão consiga enviar dados via API ou Webhook. Recomendamos consultar o suporte técnico do seu sistema e perguntar se ele permite integração via Webhook. Você também pode enviar esta página para a equipe técnica do seu ERP.
Como obter as chaves de autenticação e tokens necessários para a integração?
As credenciais da integração são configuradas no Catálogo Mobile. Para usar os endpoints, normalmente são necessários o integrationCode, o idEcommerce e o token de autenticação. O integrationCode identifica a integração na URL, o idEcommerce identifica a empresa ou ambiente no payload, e o token deve ser enviado no header Authorization: Bearer {token}.
Existe documentação técnica detalhada da integração?
Sim. A documentação técnica da integração via Webhook está disponível no Postman, com exemplos de endpoints, parâmetros, autenticação e payloads para integração com ERP, e-commerce e sistemas externos.
Como o Catálogo Mobile pode ser utilizado para vendas B2B?
O Catálogo Mobile é uma solução para vendas B2B porque permite que vendedores, representantes e clientes consultem produtos, preços e disponibilidade em um catálogo digital. A empresa pode compartilhar um catálogo em PDF ou um link de pedido com os produtos atualizados.
Como integrar meu sistema de e-commerce ao Catálogo Mobile?
Para integrar um e-commerce ao Catálogo Mobile, o sistema precisa enviar os dados dos produtos para a integração via Webhook ou API. É possível sincronizar produtos, preços, estoque e imagens, mantendo o catálogo digital alinhado com as informações do e-commerce.
Como criar um catálogo de produtos em PDF e link?
Com o Catálogo Mobile, você pode criar um catálogo de produtos em PDF e também gerar um link de catálogo online. Basta selecionar os produtos ou categorias desejadas, configurar as informações que serão exibidas e gerar o material para compartilhar com clientes.
Como garantir um catálogo com estoque em tempo real?
Para manter um catálogo com estoque em tempo real, o ERP deve enviar notificações de estoque para o Catálogo Mobile sempre que houver alteração na disponibilidade dos produtos. Assim, vendedores e clientes visualizam informações mais próximas da realidade operacional da empresa.
Como gerar catálogo do meu ERP?
Para gerar um catálogo a partir do seu ERP, integre os produtos do sistema de gestão ao Catálogo Mobile. A partir dessa integração, os dados do ERP, como nome do produto, código, descrição, preço, estoque e imagens, podem ser usados para montar catálogos em PDF e links digitais.
O que é uma integração ERP via Webhook?
Uma integração ERP via Webhook é uma forma de comunicação em que o ERP envia automaticamente informações para outro sistema sempre que ocorre uma alteração. No Catálogo Mobile, o ERP pode enviar produtos, preços, estoque e fotos para manter o catálogo atualizado.
Quais informações do ERP podem ser enviadas para o Catálogo Mobile?
O ERP pode enviar informações como nome do produto, código, descrição, preço, estoque, categoria, unidade, imagens e identificadores de integração. Esses dados são usados para manter o catálogo digital atualizado e pronto para vendas.
Posso atualizar preços automaticamente a partir do ERP?
Sim. O ERP pode enviar atualizações de preço para o Catálogo Mobile usando a integração via Webhook. Isso é útil para empresas que trabalham com mudanças frequentes de preço, promoções, reajustes comerciais ou tabelas específicas.
Como enviar fotos dos produtos do ERP para o Catálogo Mobile?
As fotos dos produtos podem ser enviadas para o Catálogo Mobile por meio do endpoint de imagens da integração. O ERP ou sistema integrador deve enviar o arquivo da foto e identificar o produto usando preferencialmente o idMapeamento.
O que é idMapeamento na integração com ERP?
O idMapeamento é o identificador do produto no ERP ou no sistema do integrador. Ele é a referência recomendada para localizar e atualizar produtos no Catálogo Mobile, porque o ERP já conhece esse ID e não precisa consultar antes o ID interno do produto.
O que é skuMapeamento na integração com o Catálogo Mobile?
O skuMapeamento é o identificador interno do produto no Catálogo Mobile. Ele pode existir em alguns retornos técnicos, mas não é a melhor opção como referência principal para integrações ERP. Para integrações mais simples e estáveis, recomendamos usar idMapeamento ou o código do produto.
A integração com ERP é assíncrona?
Sim. Os principais endpoints de escrita da integração podem funcionar de forma assíncrona. Isso significa que o Catálogo Mobile recebe a requisição, retorna um request_id e processa a operação em fila. Depois, o integrador pode consultar o endpoint de status.
Como consultar o status de uma integração assíncrona?
Quando uma requisição assíncrona é aceita, o Catálogo Mobile retorna um request_id. Com esse identificador, o integrador pode consultar o endpoint de status para acompanhar o processamento. Quando o status for processed, o campo result traz o resultado final da operação.
O Catálogo Mobile recebe pedidos e envia para o ERP?
Sim. O Catálogo Mobile pode apoiar o fluxo de pedidos B2B, permitindo que clientes, vendedores ou representantes montem pedidos a partir do catálogo. Dependendo da integração configurada, esses pedidos podem ser consultados ou enviados para o ERP.
Qual a diferença entre catálogo online, catálogo PDF e link de pedido?
O catálogo online é uma versão digital navegável dos produtos. O catálogo em PDF é um arquivo pronto para compartilhar por WhatsApp, e-mail ou outros canais. Já o link de pedido permite que o cliente ou vendedor selecione produtos e avance no processo comercial.
Meu ERP precisa ter API para integrar com o Catálogo Mobile?
O ideal é que o ERP tenha API, Webhook ou algum recurso de automação para enviar dados ao Catálogo Mobile. Com isso, a sincronização de produtos, preços e estoque pode acontecer de forma automática. Se o ERP não tiver API, ainda podem existir alternativas, como importação por planilha ou processos semiautomáticos.
Conclusão Sobre a Integração ERP com o Catálogo Mobile
A integração ERP com o Catálogo Mobile permite automatizar a atualização de produtos, preços, estoque e fotos, reduzindo tarefas manuais e mantendo o catálogo comercial mais confiável.
Para uma integração mais simples, recomendamos usar o idMapeamento do ERP como identificador principal do produto e o código do produto como alternativa. Essa abordagem evita consultas extras, melhora a estabilidade da integração e é mais compatível com o processamento assíncrono via Webhook.
