Integração CRM e ERP: arquitetura, métodos e um primeiro fluxo que você pode construir

Integração CRM e ERP: arquitetura, métodos e um primeiro fluxo que você pode construir

Uma integração CRM e ERP passa um pequeno conjunto de identificadores e status entre o sistema em que você vende e o sistema em que você entrega e fatura. O CRM é dono das pessoas, dos relacionamentos, dos negócios e das conversas. O ERP é dono da conta do cliente usada na cobrança, dos itens, dos pedidos, do estoque e dos pagamentos. A integração dispara em eventos de negócio definidos, como "negócio ganho", e grava o número de referência de cada sistema no outro.

A maioria das pequenas equipes deve começar com um único fluxo de mão única, que já deixa o CRM integrado ao ERP no ponto que mais importa: um negócio ganho cria o cliente e um pedido no ERP, e o número do pedido do ERP volta para o negócio. Construa isso por um conector nativo, se os seus dois sistemas tiverem um; caso contrário, pela API REST e pelos webhooks do ERP, usando uma plataforma de automação como o n8n ou um pequeno serviço que você mesmo opera.

O Customermates, um CRM nativo de IA, publica este guia. O Customermates é só um CRM, sem funções de ERP e sem conector nativo de ERP; a seção sobre ele mais abaixo mostra como ele se conecta por sua API REST e seus webhooks. Os detalhes dos fornecedores de ERP foram verificados em 8 de outubro de 2026 nas páginas dos próprios fornecedores, indicadas no final.

Para uma integração fixa e um cliente de IA, compare MCP versus API na mesma tarefa de registro de cliente. A descoberta de ferramentas muda como o cliente encontra uma operação; autenticação e permissões continuam valendo.

Para um fluxo do n8n, a comparação de rotas MCP do n8n e o exemplo com versão fixa distinguem conectar o n8n a um servidor de dados de clientes de expor o próprio n8n a um cliente de IA. Escolha a direção antes de configurar as credenciais.

Em resumo

O que se move

Identificadores e alguns status por evento de negócio. Nem todos os campos, e por padrão não nos dois sentidos.

Métodos

Conector nativo, plataforma de automação (iPaaS ou n8n), integração direta por API ou middleware. Ou uma suíte cujo ERP inclui um aplicativo de CRM.

Decida primeiro

Um sistema dono de cada campo, uma estratégia de IDs estáveis e o que acontece quando um evento chega duas vezes ou falha.

Confira o seu ERP

Se a API está no seu plano, se ele envia webhooks e quais são os limites de requisições. Variam muito entre fornecedores.

Customermates

API REST em todos os planos Cloud, webhooks em todos os planos pagos e os dois quando hospedado por conta própria. As referências do ERP ficam em campos personalizados de Texto.

Qual sistema é dono de cada campo na arquitetura da integração?

Escreva esta tabela para os seus próprios sistemas antes de comparar ferramentas. A titularidade é decidida por campo, não por objeto: a organização pode existir nos dois sistemas, enquanto o endereço de cobrança pertence ao ERP e as anotações da conta pertencem ao CRM.

Se dois sistemas escrevem o mesmo campo, há um conflito esperando para acontecer. Escolha um dono e encaminhe as correções para ele. Imponha essa regra na sua integração; um CRM pode não oferecer uma permissão por campo que deixe só este campo somente leitura.

Quatro formas de conectar um CRM e um ERP

Existe uma quinta resposta, a que muitos leitores buscam ao pesquisar "CRM ERP tudo em um" ou "CRM pode ser parte do ERP": uma única suíte. O Odoo, por exemplo, traz um aplicativo de CRM junto com os aplicativos de ERP, então o cadastro do cliente é compartilhado e não há nada a sincronizar. A contrapartida é que você usa o CRM da suíte. Note que o Odoo disponibiliza a API externa só no plano Custom, então conectar qualquer sistema externo ao Odoo exige esse plano.

Padrões de sincronização e quando usá-los

"Tempo real" raramente é a exigência que parece. Um gestor de conta que vê um status de pagamento um minuto atrasado não perde nada; um pedido duplicado no ERP custa dinheiro de verdade. Projete primeiro para novas tentativas e duplicados, e só depois para velocidade.

O que a interface do seu ERP realmente oferece

O lado do ERP costuma decidir o quanto a integração é difícil. Quatro exemplos mostram como as interfaces variam:

Duas perguntas poupam mais tempo: a API está incluída no plano que você paga, e o ERP envia as mudanças por webhook ou você precisa consultá-lo periodicamente?

Eventos, idempotência e conciliação

Uma integração que só trata o caminho feliz vai criar duplicados em poucas semanas. Webhooks são reenviados, as pessoas clicam duas vezes e um tempo esgotado pode esconder uma gravação que na verdade deu certo.

• Idempotência. Antes de criar qualquer coisa no destino, verifique se já existe. A verificação mais simples é a própria referência cruzada: se o negócio já tem um número de pedido do ERP, não crie outro pedido.
• IDs estáveis. Guarde o ID do outro sistema depois da primeira associação. Nunca associe empresas pelo nome a cada execução; nomes mudam e subsidiárias os compartilham.
• Novas tentativas. Tente de novo após tempos esgotados, limites de requisições e erros de servidor, com espera crescente. Pare nos erros de validação e coloque o evento em uma fila de reparo com o motivo.
• Conflitos. Decida-os como regras de negócio: vence o dono, ou uma pessoa decide. Nunca aplique "a última gravação vence" de forma geral.
• Conciliação. Rode uma verificação agendada que liste os registros sem referência cruzada ou com status diferentes nos dois lados. Ela pega o que o fluxo de eventos deixou passar.
• Registro em log. Grave evento, registro de origem, referência de destino, número de tentativas e resultado, sem copiar para os logs mais dados de clientes do que o diagnóstico exige.

Construindo o primeiro fluxo

1. Escolha um evento de negócio

   "Negócio ganho cria o cliente e o pedido no ERP" é um bom primeiro evento. "Sincronizar CRM e ERP" não é um evento.

2. Defina as pré-condições

   Liste os campos que precisam estar preenchidos antes que o evento possa disparar: endereço de cobrança, CNPJ ou VAT ID, itens, quantidades. Decida o que bloqueia o evento e quem corrige.

3. Escreva o mapa de campos

   Para cada campo: origem, destino, tipo, dono, transformação e o que acontece quando ele está ausente ou inválido. Mantenha o mapa versionado junto da integração.

4. Escolha o método

   Conector nativo, se algum cobrir o fluxo; caso contrário, uma plataforma de automação ou um pequeno serviço sobre as duas APIs REST.

5. Construa a idempotência e a gravação de volta

   Confira a referência cruzada antes de criar e depois grave o número do ERP de volta no registro do CRM na mesma execução.

6. Teste os casos incômodos

   Cliente existente, duas empresas com o mesmo nome, endereço ausente, item desconhecido, tempo esgotado no ERP, o mesmo evento entregue duas vezes, negócio reaberto depois de "ganho".

7. Entre em produção com conciliação

   Comece com uma equipe ou um tipo de negócio, compare os dois sistemas à mão nas primeiras semanas, depois ligue a conciliação agendada e nomeie quem cuida das falhas.

Exemplo: do negócio ganho ao pedido no ERP com o Customermates

Esta é a configuração no Customermates para o primeiro fluxo acima. Ela usa a API REST e os webhooks, que funcionam em uma instalação com hospedagem própria e no Customermates Cloud: a API REST em todos os planos, os webhooks em todos os planos pagos. O receptor no meio é seu: um fluxo do n8n ou um pequeno serviço.

Campos. Em Modelo de dados, adicione campos personalizados do tipo Texto: "Nº do cliente no ERP" nas organizações, "Nº do pedido no ERP" nos negócios e "Nº do item no ERP" nos serviços. Os itens de linha de um negócio guardam cada um um serviço e uma quantidade, então os itens de linha e os números de item dos serviços viram as linhas do pedido. Se os gestores de conta precisarem do estado de entrega ou de pagamento, adicione um campo de Escolha única como "Status no ERP" nos negócios e torne a titularidade do ERP uma regra explícita no seu adaptador. O Customermates tem permissões por lista e por função, não permissões por campo que reservem esse campo para a integração.

Gatilho. Isto pressupõe que a sua lista de negócios tem um campo de Escolha única Etapa com uma opção "Ganho" (as etapas não vêm predefinidas). Em Configurações → Webhooks, assine uma URL em record.updated para a lista Negócios, opcionalmente com Etapa em Campos alterados, e defina um segredo. Cada entrega é assinada com HMAC-SHA256 no cabeçalho X-Webhook-Signature, e nos eventos de atualização data.record.fields lista cada campo alterado com o valor before e after. O seu receptor age só quando a etapa mudou para "Ganho".

Idempotência. Todo evento carrega um id que continua o mesmo em novas tentativas e reenvios, então deduplique por ele. Como segunda verificação, use a referência cruzada: se o "Nº do pedido no ERP" do negócio já está preenchido, pare.

Associação do cliente. Consulte o "Nº do cliente no ERP" da organização. Se estiver vazio, procure no ERP pelo CNPJ (ou VAT ID) ou crie o cliente e depois grave o número de volta. Para encontrar depois uma organização do CRM pelo número do ERP, chame POST /api/v1/records/query para Organizações com um filtro eq no ID desse campo (sintaxe de filtros).

Gravação de volta. Depois que o ERP aceitar o pedido, envie uma mutação update do negócio para POST /api/v1/records/mutate com o novo "Nº do pedido no ERP" e a versão atual do negócio. Os campos que você deixar de fora continuam inalterados.

Falhas. O Customermates tenta de novo automaticamente uma entrega que falhou por tempos esgotados, erros de rede, respostas 5xx e 408, 425 e 429. Outras respostas 4xx não são repetidas, porque falhariam do mesmo jeito. Toda entrega aparece em Configurações → Registro de webhooks, onde você pode reenviá-la depois de corrigir a causa.

Conciliação. Salve uma visualização de negócios filtrada por Etapa "Ganho" e "Nº do pedido no ERP" vazio. Compartilhe-a com quem cuida das falhas de integração, ou com a equipe toda. Tudo o que aparecer ali foi perdido pelo fluxo de eventos.

O sentido contrário. Se o seu ERP envia webhooks, aponte-os para o mesmo receptor, procure o negócio pelo "Nº do pedido no ERP" e defina o "Status no ERP". Se ele não envia, consulte o ERP em um horário fixo. O guia do n8n lista as chamadas REST de que um fluxo do n8n precisa; também existe um nó da comunidade.

No Customermates Cloud, o Mate também pode trabalhar com esses campos, por exemplo "liste os negócios ganhos deste mês sem número de pedido no ERP". O Mate usa créditos de IA hospedados. Um cliente de IA próprio pode fazer o mesmo por MCP.

O que o pequeno exemplo de integração realmente provou?

Baixe o mapa de titularidade de campos entre CRM e ERP e o resultado do exemplo delimitado. O exemplo usa o cliente fictício C-001 e a referência de ERP ERP-C-001. Mantenha o seu próprio mapeamento junto do adaptador:

Verificado em 29 de outubro de 2026 em um espaço de trabalho local descartável do Customermates e um ERP simulado em loopback. Um pequeno adaptador, chamado manualmente, leu o endpoint REST real do CRM, enviou um cliente ao simulado e gravou o ID de ERP devolvido em um campo personalizado de Texto usando a versão atual do registro. Descartamos de propósito a primeira resposta depois que o simulado salvou o cliente. Repetir o mesmo evento produziu duas tentativas, uma gravação no ERP. Uma leitura de cada lado então bateu com o ID do registro no CRM, o nome do cliente e o ID do ERP.

Isso prova o mapa de IDs, a regra de novas tentativas e a leitura, a gravação e a releitura no CRM nesse exemplo. Não prova um conector de ERP em produção, a entrega automática de webhooks, a criação de faturas nem uma tarefa de conciliação implantada. Antes de usar o seu próprio ERP, repita essas verificações no sandbox dele, confira a autenticação e as assinaturas e teste as validações e os limites de requisições reais. As opções de integração explicam onde um adaptador ou um n8n operado separadamente se encaixa.

O que determina custo e esforço

Nenhum benchmark honesto cobre todas as integrações CRM ERP; um evento de mão única entre duas APIs documentadas e uma sincronização nos dois sentidos de pedidos e estoque são projetos diferentes. Estime a partir destes fatores:

• se a API do ERP está no seu plano atual ou exige uma mudança de plano;
• se os dois sistemas enviam webhooks ou um deles precisa ser consultado;
• o número de objetos, campos, sentidos e transformações;
• quão bagunçados estão os dados de clientes existentes e quantos duplicados precisam ser associados de uma vez;
• limites de requisições e volume;
• quem opera a plataforma de automação ou o serviço e quem responde aos alertas dela.

No lado do CRM, a API REST não exige nenhum plano específico do Customermates e os webhooks vêm com todo plano pago. Uma equipe de três pessoas no Starter paga € 36 por mês. A caixa de entrada unificada, que traz as conversas de e-mail, LinkedIn e WhatsApp para os mesmos registros, começa no Pro (€ 29 por usuário por mês).

Antes que um negócio ganho vire um pedido no ERP, a conversa que o ganhou fica no cadastro do cliente, com uma resposta e um próximo passo rascunhados pelo Mate ou pelo seu próprio cliente de IA para você revisar e enviar. Para ver essa parte com os seus próprios clientes, comece o seu teste de 14 dias. Sem cartão de crédito.

Erros comuns

• sincronizar todos os campos antes de um evento funcionar de ponta a ponta;
• deixar os dois sistemas serem donos do mesmo campo;
• associar empresas pelo nome em vez de IDs guardados;
• não ter uma fila de reparo, de modo que eventos com falha somem nos logs;
• ignorar cancelamentos, negócios reabertos e correções;
• entrar em produção sem uma verificação de conciliação nem uma pessoa nomeada para os alertas.

Para a diferença entre os dois tipos de sistema, e quando uma pequena equipe precisa de um ERP, leia CRM e ERP comparados.

Perguntas frequentes

Detalhes dos fornecedores de ERP verificados em 8 de outubro de 2026 em Business Central API v2.0 e webhooks do Business Central da Microsoft, API externa do Odoo para a versão 18, API externa para a versão 19 e preços, a documentação da API do Lexware e a documentação para desenvolvedores do Xentral.