Como integrar sistemas que não se comunicam: guia prático
Aprenda a integrar sistemas que não se comunicam: mapeamento de dados, fonte da verdade, APIs, webhooks, integração em lote, erros, segurança e LGPD.
Por HEMETUSPublicado em 11 min de leitura
Um pedido entra pela loja virtual, alguém copia os dados para o sistema de gestão, outra pessoa lança a nota no financeiro e, no fim do mês, o relatório de vendas não bate com o extrato do banco. A maioria das pequenas e médias empresas não escolheu trabalhar assim: os sistemas foram chegando um de cada vez, cada um resolvendo um problema específico, e ninguém planejou como eles conversariam entre si. O resultado é uma operação que depende de pessoas fazendo o papel de ponte entre telas. Este guia mostra como sair dessa situação com método: entender o que precisa ser conectado, decidir quem manda em cada dado, escolher a forma de integração adequada e manter tudo sob controle depois que estiver funcionando.
Sinais de que seus sistemas não conversam
Antes de falar em tecnologia, vale reconhecer os sintomas. Eles costumam aparecer na rotina administrativa muito antes de alguém chamar o problema de "falta de integração".
- Redigitação. O mesmo dado é digitado em dois ou mais lugares: o cadastro do cliente no CRM e no ERP, o pedido na plataforma de vendas e no sistema de faturamento, a nota de entrada no estoque e no contas a pagar.
- Planilhas-ponte. Existe uma planilha cuja única função é receber uma exportação de um sistema, ser ajustada à mão e servir de importação para outro. Normalmente só uma pessoa sabe como ela funciona.
- Números divergentes. Vendas, faturamento e recebimentos mostram valores diferentes para o mesmo período, e cada área defende o seu.
- Atrasos no fechamento. O fechamento mensal depende de conciliações manuais que tomam dias.
- Erros que se propagam. Um CNPJ digitado errado em um sistema gera nota rejeitada, cobrança devolvida ou cliente duplicado em outro.
Se dois ou mais desses sinais aparecem com frequência, a integração de sistemas provavelmente trará ganho real de tempo e de confiabilidade. Em muitos casos, ela também é o primeiro passo para a automação de processos empresariais, já que não faz sentido automatizar uma tarefa cujos dados de entrada ainda chegam por cópia manual.
Mapeie sistemas e fluxos de dados
O ponto de partida é um inventário simples. Não é preciso um software especializado: uma planilha ou um quadro bem organizado resolve. Para cada sistema em uso, registre:
| Informação | Exemplo hipotético |
|---|---|
| Nome e finalidade | Plataforma de loja virtual, recebe pedidos online |
| Área responsável | Comercial |
| Dados que cria | Pedidos, clientes, endereços de entrega |
| Dados que consome | Preços, saldo de estoque, status de envio |
| Como os dados saem hoje | Exportação manual em planilha |
| Recursos de integração | Possui API documentada e envio de notificações |
Depois, desenhe os fluxos: de onde cada dado nasce, por quais sistemas passa e onde termina. Um fluxo típico de venda poderia ser: pedido na loja virtual, reserva de estoque no ERP, emissão da nota fiscal, geração do título a receber, baixa após o pagamento. Para cada seta desse desenho, pergunte: hoje isso acontece como? Quem faz? Com que frequência? O que acontece quando dá errado?
Esse exercício costuma revelar duas coisas. Primeiro, que nem todo fluxo merece integração imediata: alguns acontecem poucas vezes por mês e não justificam o investimento. Segundo, que há fluxos críticos escondidos em rotinas informais, como a conferência diária que alguém faz entre o relatório do banco e o sistema financeiro.
Priorize pelo impacto
Com o mapa em mãos, classifique os fluxos por volume, risco de erro e impacto no cliente ou no caixa. Um fluxo de pedidos que roda centenas de vezes por dia e afeta o prazo de entrega tem prioridade sobre a sincronização mensal de centros de custo.
Defina a fonte da verdade de cada dado
Integrar sem decidir quem é o dono de cada informação é a receita para conflitos. A "fonte da verdade" é o sistema que tem autoridade sobre determinado dado: é nele que o dado é criado ou alterado, e os demais apenas recebem cópias.
Algumas perguntas ajudam a definir isso:
- Em qual sistema o dado nasce na prática?
- Qual área responde pela correção dele quando está errado?
- Qual sistema tem as regras de validação mais completas para esse dado?
Um exemplo hipotético de definição:
| Dado | Fonte da verdade | Recebem cópia |
|---|---|---|
| Cadastro de produtos e preços | ERP | Loja virtual, força de vendas |
| Saldo de estoque | ERP | Loja virtual |
| Pedidos online | Loja virtual | ERP |
| Contatos e oportunidades | CRM | ERP (somente quando vira cliente) |
| Títulos e baixas | ERP (financeiro) | Relatórios gerenciais |
Quando dois sistemas podem alterar o mesmo dado, é preciso uma regra explícita para conflitos, como "prevalece a alteração mais recente" ou "o ERP sempre sobrescreve". Sem essa regra, os sistemas passam a se corrigir mutuamente e ninguém sabe qual valor é o certo.
Formas de integração, sem jargão
Existem várias maneiras de fazer dois sistemas trocarem informações. A escolha depende do que cada sistema oferece, do volume de dados e da urgência com que a informação precisa chegar.
APIs
Uma API é uma "porta de serviço" que o sistema disponibiliza para outros programas. Em vez de uma pessoa abrir a tela e digitar, outro sistema envia uma requisição dizendo, por exemplo, "crie este pedido" ou "me informe o saldo deste produto". É a forma mais comum e, em geral, a mais robusta quando bem documentada. Antes de contratar ou manter um sistema, vale perguntar ao fornecedor se ele tem API, o que ela permite fazer e se há limites de uso.
Webhooks
Um webhook é um aviso automático. Em vez de um sistema perguntar a cada poucos minutos "tem pedido novo?", o outro sistema avisa no momento em que algo acontece: "o pagamento deste pedido foi aprovado". É útil para eventos que exigem reação rápida e reduz consultas desnecessárias.
Arquivos e EDI
Muitos sistemas, principalmente os mais antigos, só trocam dados por arquivos: planilhas, arquivos de texto em layout fixo, XML. O EDI (intercâmbio eletrônico de dados) é a versão padronizada dessa troca, comum entre empresas que fazem negócios entre si, como indústria e varejo ou empresa e banco. A troca por arquivos é simples e confiável quando automatizada, com o arquivo gerado, transmitido e importado sem intervenção manual.
Banco de dados intermediário
Em alguns cenários, os sistemas gravam e leem informações em um banco de dados compartilhado, uma espécie de "área de troca". Pode ser uma saída quando um dos sistemas não tem API, mas exige cuidado: acesso direto ao banco de um sistema de terceiros pode violar regras do fornecedor e quebrar em atualizações.
Plataformas de integração
São ferramentas que funcionam como um centro de distribuição de dados: conectam vários sistemas, transformam formatos, registram o que foi enviado e avisam quando algo falha. Fazem sentido quando há muitos sistemas ou muitas integrações, pois evitam uma teia de conexões ponto a ponto difícil de manter.
Tempo real ou em lote
Nem toda informação precisa chegar no mesmo segundo. A integração em tempo real (ou quase) é indicada quando um atraso causa prejuízo: saldo de estoque exibido na loja virtual, aprovação de pagamento, liberação de crédito. A integração em lote, executada em horários definidos, é adequada para volumes grandes e informações que toleram espera, como envio de lançamentos para a contabilidade ou atualização noturna de tabelas de preço.
Tempo real exige mais da infraestrutura e do monitoramento. Lote é mais simples, mas o usuário precisa saber que a informação tem um horário de atualização. O importante é que a escolha seja consciente e combinada com as áreas envolvidas.
Cadastros: a base de qualquer integração
A integração de dados empresariais só funciona se os sistemas conseguirem reconhecer que estão falando da mesma coisa. Se o cliente aparece como "Comercial Silva Ltda" em um sistema e "Com. Silva" em outro, sem um identificador comum, a integração não sabe que é o mesmo cliente.
Antes de ligar os sistemas, revise:
- Identificadores únicos. CNPJ ou CPF para clientes e fornecedores, código interno ou código de barras para produtos. Cada registro precisa de uma chave que exista nos dois lados.
- Duplicidades. Clientes e produtos cadastrados mais de uma vez precisam ser unificados antes da primeira carga.
- Tabelas de correspondência. Unidades de medida, formas de pagamento, condições de prazo, status de pedido e categorias costumam ter nomes diferentes em cada sistema. Uma tabela "de-para" define que "UN" em um corresponde a "UNID" no outro.
- Campos obrigatórios. Um sistema pode aceitar cadastro sem e-mail ou sem inscrição estadual, e o outro não. Defina o padrão mínimo exigido.
- Responsáveis. Alguém precisa responder pela qualidade de cada cadastro depois que a integração entrar no ar.
Esse trabalho costuma ser subestimado, mas é ele que define se a integração vai reduzir problemas ou apenas transportá-los mais rápido.
Erros, monitoramento e segurança
Toda integração vai falhar em algum momento: um sistema fica fora do ar, um campo chega vazio, uma senha expira. A diferença entre uma integração confiável e uma fonte de dor de cabeça está em como essas falhas são tratadas.
Tratamento de erros
Defina, para cada fluxo, o que acontece quando algo dá errado:
- O sistema tenta de novo automaticamente? Quantas vezes e com que intervalo?
- O registro com problema fica em uma fila de pendências visível para alguém?
- Quem é avisado e por qual canal?
- Como evitar que uma nova tentativa duplique o pedido ou o pagamento?
Esse último ponto merece atenção: uma integração bem construída garante que reenviar a mesma informação não gere dois registros.
Monitoramento
Uma integração que falha em silêncio é pior que nenhuma integração, porque as pessoas confiam em dados que pararam de chegar. Mantenha registros (logs) do que foi enviado e recebido, alertas para falhas e um painel ou relatório simples com volumes processados e pendências. Uma verificação periódica, como comparar o total de pedidos do dia nos dois sistemas, ajuda a detectar problemas que não geram erro explícito.
Segurança e LGPD
Integrações movimentam dados pessoais de clientes, colaboradores e fornecedores, o que exige cuidados alinhados à Lei Geral de Proteção de Dados (LGPD):
- Trafegue apenas os dados necessários para a finalidade de cada fluxo.
- Use conexões criptografadas e credenciais exclusivas por integração, nunca o usuário e a senha de uma pessoa.
- Guarde chaves e senhas em local protegido e troque-as periodicamente.
- Conceda a cada integração somente as permissões de que ela precisa.
- Saiba onde os dados ficam armazenados, inclusive em plataformas de terceiros, e por quanto tempo.
- Cuide para que os logs não exponham dados pessoais além do necessário.
Quando integrar não basta
Há situações em que conectar sistemas é tratar o sintoma, não a causa. Considere trocar ou consolidar sistemas quando:
- O sistema principal não oferece API nem exportação confiável, e qualquer integração depende de soluções frágeis.
- Várias ferramentas fazem a mesma coisa em áreas diferentes, e a integração existiria só para mantê-las sincronizadas.
- O fornecedor deixou de atualizar o produto ou não acompanha mudanças fiscais e legais.
- O custo de manter as integrações, somado ao retrabalho que ainda sobra, se aproxima do custo de uma solução que já reúna os processos.
- As regras de negócio da empresa não cabem em nenhum dos sistemas e estão sendo resolvidas em planilhas paralelas.
Nesses casos, um sistema ERP para empresas que concentre compras, estoque, vendas, fiscal e financeiro pode eliminar boa parte das integrações necessárias. O guia sobre como escolher um sistema ERP ajuda a avaliar essa alternativa. E quando nenhum produto de mercado atende a um processo muito específico, desenvolver uma camada sob medida pode ser o caminho.
Por onde começar
Um roteiro prático para as próximas semanas:
- Liste todos os sistemas em uso, inclusive planilhas que funcionam como sistema.
- Desenhe os principais fluxos de dados e marque onde há redigitação.
- Defina a fonte da verdade de cada dado relevante.
- Escolha um fluxo prioritário, de alto volume e risco moderado, para a primeira integração.
- Saneie os cadastros envolvidos nesse fluxo antes de conectar.
- Combine como erros serão tratados, quem será avisado e como o fluxo será monitorado.
- Depois de estabilizado, avalie o próximo fluxo.
Se quiser apoio para mapear o cenário e definir a abordagem, a HEMETUS trabalha com integrações e automação de processos e pode ajudar a avaliar o seu caso pela página de contato.