Como integrar um sistema que não tem API

API é a porta que um sistema oferece para outros programas conversarem com ele. Quando ela não existe, a integração dá mais trabalho, mas quase nunca é impossível. O que muda é o caminho, e cada caminho traz um tipo diferente de risco.

Antes de tudo: confirme que ele não tem API

Muita gente conclui que o sistema não tem API porque ninguém nunca a viu. Vale checar, porque às vezes ela existe e só não é divulgada: fica em um plano superior, é oferecida só a parceiros ou precisa ser pedida ao suporte. Pergunte ao fornecedor:

• O sistema tem API ou webhook? Em qual plano, e onde está a documentação?
• Dá para exportar dados automaticamente, em arquivo agendado ou por e-mail?
• Existe integração pronta com o sistema que eu quero conectar, ou conector em plataformas de automação como Zapier e Make?
• Se o sistema é instalado no meu servidor, posso ter acesso de leitura ao banco de dados sem perder o suporte?

Se a resposta for não para tudo, siga para os caminhos abaixo.

Os quatro caminhos, do mais seguro ao mais frágil

1. Exportação e importação de arquivos

O sistema gera um arquivo ou relatório (planilha, CSV, XML), e a integração lê esse arquivo e leva os dados ao outro sistema. No sentido contrário, muitos sistemas têm uma tela de importação, e a integração prepara o arquivo no formato que ela pede.

• Vantagem: não mexe no interior do sistema, então é o caminho que menos incomoda o fornecedor.
• Cuidado: os dados chegam com atraso (a cada hora, a cada dia), e a integração para de funcionar se o formato do arquivo mudar.

Serve bem para o que não precisa ser instantâneo, como cadastros, fechamentos e relatórios.

2. Acesso ao banco de dados

A integração consulta direto o banco em que o sistema guarda os dados. Em sistemas na nuvem isso quase nunca é permitido; em sistemas instalados no seu servidor, às vezes.

• Vantagem: dados atuais, sem esperar a exportação.
• Cuidado: só leitura, e com autorização do fornecedor. Gravar direto no banco passa por cima das regras do sistema (validação, imposto, estoque) e pode deixar os dados inconsistentes. Uma atualização do sistema também pode mudar a estrutura do banco e quebrar a leitura.

3. Automação de tela

Um robô usa o sistema como uma pessoa usaria: abre a tela, digita, clica, copia o resultado. É o que sobra quando o sistema não oferece nenhuma outra porta, inclusive os antigos, que só rodam em um computador.

• Vantagem: funciona onde nada mais funciona.
• Cuidado: quebra quando a tela muda, é lenta, depende de um computador dedicado com acesso ao sistema e é difícil de monitorar. Use como ponte temporária, não como solução definitiva.

4. Trocar ou complementar o sistema

Às vezes o certo é parar de construir pontes. Trocar o sistema inteiro nem sempre é necessário: dá para substituir só o módulo que trava, ou colocar uma camada intermediária que guarda os dados e conversa com os outros sistemas por uma API própria.

• Vantagem: resolve a causa, não o sintoma.
• Cuidado: exige migração de dados e mudança na rotina da equipe, então precisa de planejamento.

Como escolher

Quatro perguntas ajudam a decidir:

1. O dado precisa chegar na hora? Pedido e estoque costumam precisar. Se o único caminho possível é um arquivo por dia, avalie se o atraso é aceitável.
2. Só vai ler do sistema ou também escrever nele? Escrever é a parte difícil. Prefira a tela de importação do próprio sistema, que respeita as regras dele.
3. Quanto tempo o sistema ainda vai viver? Se vai ser trocado em breve, escolha a ponte mais simples e não invista demais nela.
4. Quem percebe quando quebrar? Uma ponte sem alerta para de funcionar em silêncio, e ninguém descobre até faltar um pedido.

O que a ponte precisa para não virar problema

Todo caminho sem API é mais frágil que uma integração por API, então o cuidado com a manutenção pesa mais:

• Alerta quando falha, para alguém saber no mesmo dia.
• Registro do que foi enviado, para conferir o que aconteceu com cada pedido.
• Reprocessamento sem duplicar, para repetir uma tentativa sem lançar o mesmo pedido duas vezes.
• Credenciais guardadas com segurança e acesso restrito ao necessário.
• Só os dados necessários, principalmente quando envolvem dados pessoais de clientes (LGPD).

Quando vale trocar o sistema em vez de fazer a ponte

Considere a troca quando:

• o fornecedor descontinuou o produto ou não dá mais suporte;
• cada nova necessidade exige uma nova ponte, e você já mantém várias;
• os dados de que você precisa simplesmente não saem do sistema;
• manter as pontes já dá mais trabalho do que o sistema entrega.

Por onde começar

O primeiro passo é mapear: quais sistemas existem, que dados precisam circular, com que frequência e o que cada um permite. Na Webmaker, isso é a fase 0: um diagnóstico curto e pago que entrega um plano com prazo e investimento fechados, sem compromisso de continuar.

Para uma visão geral, veja como funciona a integração de sistemas. Se o seu problema começa na planilha, leia quando trocar a planilha por um sistema.