Integração entre sistemas: quando ligar o que a empresa já usa e quando trocar

O pedido entra pelo site. Alguém abre o sistema de gestão e digita tudo de novo. Depois copia o valor para o financeiro, passa o endereço para a transportadora e avisa o estoque por mensagem. No fim do mês, outra pessoa baixa três relatórios e monta uma planilha para descobrir quanto a empresa realmente vendeu.

Cada sistema dessa história funciona. O problema está no espaço entre eles, e esse espaço é preenchido por gente copiando dado de uma tela para outra. É um trabalho caro, que quase nunca aparece como custo, e que produz os erros mais difíceis de achar: o número trocado, o cliente cadastrado duas vezes, o pedido que ninguém lançou.

Integração é a conexão que faz um sistema passar informação para outro sem alguém no meio. Ela costuma resolver esse problema por muito menos do que trocar tudo. Mas também pode virar uma peça frágil que para sem avisar. Este texto explica como ela funciona, quando vale a pena e o que combinar antes de contratar.

Os sinais de que falta uma integração

Nem toda redigitação justifica um projeto. O que justifica é a repetição com custo. Vale olhar para a operação e procurar estes sintomas:

• O mesmo dado é digitado em dois lugares todos os dias, como pedido, cliente, produto ou preço.
• Os números não batem, e cada setor confia no próprio relatório.
• O cliente recebe informação atrasada, porque o status mudou em um sistema e não chegou ao outro.
• Existe uma pessoa que é a integração. Quando ela tira férias, o processo trava.
• Uma planilha fica entre dois sistemas, exportada de um lado e importada do outro.

Esse último caso é parente do que acontece quando a planilha vira o sistema da empresa: ela começou como quebra-galho e, sem ninguém decidir, passou a sustentar uma parte da operação.

Para saber se compensa, faça a conta simples. Quantas vezes por dia aquilo acontece, quantos minutos leva e quanto custa cada erro? Vinte pedidos por dia a cinco minutos cada são mais de trinta horas por mês de digitação, antes de contar o retrabalho. Com esse número na mão, a conversa sobre o preço da integração deixa de ser opinião.

Como um sistema conversa com outro

Existem quatro formas principais, e a diferença entre elas decide quanto a integração vai custar e quanto vai durar.

API

API é a porta oficial que um sistema oferece para outros programas pedirem ou gravarem dados. Em vez de uma pessoa abrir a tela, um programa faz o pedido em um formato combinado, como "me entregue os pedidos de hoje". É o caminho mais sólido, porque o fornecedor documenta o que está disponível e costuma avisar quando algo muda.

Webhook

Webhook é o aviso automático. Em vez de perguntar a cada poucos minutos se aconteceu algo novo, o sistema de origem avisa o outro na hora: pagamento aprovado, pedido cancelado, nota emitida. É o que permite a sensação de tempo real sem ficar consultando o tempo todo. Costuma trabalhar junto com a API: o aviso chega, e a API busca os detalhes.

Arquivo

Um sistema gera um arquivo, geralmente em horário fixo, e o outro lê. É antigo e menos elegante, mas funciona bem quando a informação não precisa ser instantânea, como um fechamento noturno, ou quando um dos sistemas não tem API. Não há vergonha nenhuma em usar arquivo quando ele resolve.

Automação de tela

Quando não existe porta nenhuma, um robô pode imitar uma pessoa clicando no sistema. É o último recurso. Funciona, mas basta um botão mudar de lugar para o processo quebrar, e isso costuma acontecer sem aviso.

Plataforma pronta ou integração sob medida

Para ligar dois serviços populares em um fluxo simples, existem plataformas de automação que conectam aplicativos por assinatura, quase sem programação. Para avisar a equipe quando chega um formulário ou guardar um anexo em uma pasta, elas costumam ser a melhor resposta: rápidas e baratas.

A conta muda em três situações. Quando o volume cresce, porque a cobrança por tarefa executada pode ultrapassar o custo de uma solução própria. Quando a regra de negócio é complicada, cheia de exceções por tipo de cliente ou de produto. E quando o processo é crítico, porque o fluxo fica dentro de uma conta de terceiro, com os limites e o preço dele.

A integração sob medida custa mais para nascer, mas fica com as regras da empresa e pode ser ajustada sem esperar por ninguém. O melhor critério é a importância do processo: o que pode parar por um dia aceita a solução simples, e o que fatura a empresa merece a mais robusta.

Integrar ou trocar o sistema

Às vezes a pergunta certa não é como ligar dois sistemas, e sim por que ainda são dois. Vale pensar em substituir quando:

• o sistema antigo não oferece API nem exportação confiável;
• o fornecedor cobra caro por cada acesso ou demora meses para responder;
• a integração precisaria duplicar quase toda a lógica de um dos lados;
• o sistema roda instalado em uma máquina e dificulta qualquer conexão externa, um dos pontos da comparação entre sistema instalado e sistema online.

Por outro lado, integrar costuma ser melhor quando cada sistema faz bem o seu trabalho. Um emissor fiscal confiável e uma loja que vende bem não precisam ser jogados fora para que conversem. Na maioria dos casos, trocar tudo é mais arriscado do que construir a ponte, porque mexe com a rotina de todos os setores ao mesmo tempo.

O que perguntar antes de contratar

Integração mal definida é a origem da maior parte das surpresas de prazo e preço. Antes de pedir orçamento, tenha resposta para estas perguntas. Elas entram no mesmo documento descrito em escopo de sistema antes do orçamento:

1. Quem é o dono de cada dado? Se o preço existe em dois sistemas, um deles precisa mandar. Sem essa definição, um sobrescreve o outro.
2. A informação vai em uma direção ou nas duas? Mão dupla é bem mais difícil, porque exige decidir o que fazer quando os dois lados mudam ao mesmo tempo.
3. Com que frequência precisa atualizar? Tempo real custa mais do que uma rodada por hora, e nem todo processo precisa dele.
4. O que acontece com o histórico? Os registros antigos serão levados ou a integração vale daqui para a frente?
5. A documentação da API está disponível? Peça ao fornecedor antes de fechar. Alguns cobram pelo acesso, limitam chamadas ou liberam só em planos maiores.
6. Como é o ambiente de teste? Sem ele, cada teste mexe com pedidos e clientes reais.

O cadastro merece atenção especial. Se o mesmo produto tem um código no site e outro no sistema de gestão, a integração não tem como adivinhar que são o mesmo item. Muitas vezes o primeiro trabalho é arrumar os cadastros. Esse ponto aparece com força em loja virtual e loja física com o mesmo estoque.

Quando a integração falha

Toda integração vai falhar em algum momento. O fornecedor sai do ar, a internet cai, um pedido chega com um campo inesperado. A diferença entre um projeto bom e um ruim é o que acontece depois. Exija estes itens por escrito:

• Fila e nova tentativa: se o destino estiver fora do ar, a mensagem espera e é reenviada, em vez de se perder.
• Registro de cada envio: o que saiu, quando saiu e o que voltou, para responder rápido a pergunta "esse pedido passou?".
• Alerta para uma pessoa: erro que só fica em um arquivo técnico é erro que ninguém vê.
• Proteção contra duplicidade: ao reenviar, o sistema precisa reconhecer que o pedido já entrou, para não lançar duas vezes.
• Reprocessamento: um jeito de reenviar o que falhou depois de corrigir a causa.

Teste esses casos antes de aceitar a entrega, e não só o caminho feliz. Desligue um dos lados, mande um pedido incompleto e veja o que acontece. É o tipo de cenário que entra na homologação antes de aceitar a entrega, e que quase nunca é testado quando ninguém pede.

Integração não é projeto com fim

Uma tela pronta pode ficar anos sem mudança. Uma integração não, porque depende de dois lados que evoluem por conta própria. O fornecedor lança uma versão nova da API e desliga a antiga, troca a forma de autenticação, altera um campo. Certificados e chaves também vencem, e normalmente isso acontece em um dia ruim.

Por isso, inclua no orçamento uma previsão de manutenção, nos mesmos moldes do que vale para o custo de manter um aplicativo. Defina quem acompanha os avisos dos fornecedores, quem atende quando para e em quanto tempo. Se a resposta for "ninguém", a integração tem prazo de validade, só que ninguém sabe qual.

Segurança, LGPD e chaves de acesso

Uma integração abre um caminho automático para os dados da empresa, e esse caminho precisa de portaria. Alguns cuidados são básicos:

• Uma chave para cada integração, com acesso só ao que ela precisa. A que lê pedidos não deveria alterar preços. É a mesma lógica do controle de acesso no sistema da empresa.
• Chave guardada em local seguro, nunca em planilha, código aberto ou conversa de mensagem.
• Tráfego sempre criptografado, com HTTPS nas duas pontas.
• Só os dados necessários. Se a transportadora precisa do endereço, não precisa do histórico de compras. Dado pessoal circulando entre sistemas segue as regras da LGPD, e a empresa continua responsável por ele.
• Chave trocada quando o fornecedor sai. Encerrou o contrato, revogue o acesso no mesmo dia.

A ponte tem que ser da empresa

Aqui está o ponto que costuma ser lembrado tarde demais. A integração vira parte do funcionamento do negócio, e por isso as peças dela precisam estar no nome da empresa: as contas nos serviços, as chaves de API, o servidor onde ela roda, a documentação e o código. Quando tudo isso fica na conta pessoal do desenvolvedor, a empresa descobre a dependência no dia em que ele some.

Combine isso em contrato, com a mesma clareza que vale para o código-fonte do sistema e do aplicativo. Peça também uma descrição simples de cada fluxo: de onde o dado sai, para onde vai, em que momento e quem responde por ele. Uma página bem escrita já permite que outro profissional assuma o trabalho sem começar do zero.

O caminho mais seguro é começar pequeno. Escolha o fluxo que consome mais horas, integre esse primeiro, meça o resultado por um mês e só então passe para o próximo. Cada etapa se paga e ensina alguma coisa para a seguinte.

Perguntas frequentes

Quer parar de digitar a mesma informação duas vezes?

A NSWeb desenvolve sistemas online sob medida e integrações com o que a sua empresa já usa, com fila, registro de erros e tudo no nome da empresa. Fale com a gente e conte qual informação a sua equipe ainda copia de uma tela para outra.