Resumo executivo: integração é onde os projetos de software estouram. Não porque conectar sistemas seja difícil, mas porque quase ninguém trata a integração como um sistema em si — com dono, monitoramento e plano de falha. Este artigo mostra como fazer isso sem transformar o ambiente em um emaranhado.
O problema real
O ponto de partida típico. Uma empresa de médio porte opera ERP, sistema fiscal, CRM, e-commerce ou marketplace, planilhas críticas e um ou dois sistemas legados que ninguém quer tocar. Cada um guarda um pedaço da verdade.
O sintoma clássico. O mesmo cliente cadastrado três vezes com grafias diferentes; o estoque do site divergindo do estoque real; o financeiro conferindo manualmente o que o comercial já lançou. Ninguém confia inteiramente em nenhum número.
A causa. Integrações nasceram uma a uma, ponto a ponto, cada uma feita por um fornecedor diferente em um momento diferente. Não existe desenho. Existe histórico.
Ponto a ponto x camada de integração
| Critério | Ponto a ponto | Camada de integração |
|---|---|---|
| Esforço da primeira integração | Baixo | Médio — exige montar a camada |
| Esforço da décima | Alto e crescente | Baixo e estável |
| Visibilidade de falha | Cada rotina falha por conta própria, em silêncio | Centralizada, com log e alerta |
| Troca de um sistema | Quebra tudo que estava ligado a ele | Afeta apenas um conector |
| Regra de negócio | Espalhada em cada rotina | Concentrada e versionada |
| Recomendação: até três sistemas, ponto a ponto é aceitável. A partir do quarto, a camada de integração se paga — e a partir do sexto, a ausência dela vira o principal custo oculto da TI. | ||
Os quatro padrões de integração
1. API em tempo real
Quando usar: quando a resposta precisa ser imediata — consultar crédito, reservar estoque, validar cadastro.
Cuidado: se o sistema do outro lado cair, o seu processo para junto. Sempre defina tempo limite e comportamento de falha.
2. Fila de mensagens
Quando usar: quando a operação não pode esperar, mas o dado pode chegar em segundos — emissão de nota, envio de pedido, notificação.
Ganho: se o destino estiver fora do ar, a mensagem aguarda e é processada depois. É o padrão que mais aumenta a resiliência do ambiente.
3. Sincronização em lote
Quando usar: volumes grandes sem urgência — carga de catálogo, fechamento contábil, atualização de tabela de preço.
Cuidado: lote que roda de madrugada e falha em silêncio é o clássico “descobrimos na segunda-feira”.
4. Arquivo
Quando usar: quando o outro lado não oferece nada melhor — sistemas legados, órgãos públicos, parceiros antigos.
Cuidado: é o padrão mais frágil. Layout muda sem aviso, arquivo chega truncado, encoding quebra. Exige validação rigorosa na entrada.
As regras que evitam o caos
- Uma fonte da verdade por informação. Cadastro de cliente tem um dono. Estoque tem um dono. Preço tem um dono. Quando duas fontes discordam, ganha o dono — e isso precisa estar escrito, não combinado.
- Contrato de interface versionado. Cada integração tem um contrato: campos, formatos, obrigatoriedade, comportamento de erro. Mudança de contrato é evento planejado, com versão nova convivendo com a antiga por um período.
- Idempotência. Reprocessar a mesma mensagem não pode gerar dois pedidos. Toda transação precisa de identificador único e verificação antes de gravar.
- Fila de erro visível. O que falhou precisa parar em um lugar onde alguém olha, com informação suficiente para reprocessar.
- Nada de acesso direto ao banco de terceiro. Funciona até a primeira atualização do fornecedor. Depois quebra sem aviso e sem suporte.
Monitoramento: integração sem alerta é integração sem dono
O erro mais comum. Integrações são monitoradas por reclamação. Alguém do financeiro percebe que faltou lançamento e abre um chamado — dois dias depois do problema.
O que monitorar.
- Execução: a rotina rodou no horário previsto?
- Volume: processou uma quantidade dentro da faixa esperada? Zero registro em um dia útil é falha, não sucesso.
- Erros: quantos itens foram para a fila de erro e há quanto tempo estão lá?
- Latência: o tempo entre origem e destino está crescendo?
- Divergência: conferência periódica entre os dois lados — o total bate?
Como implementamos. Essas verificações entram no Zabbix como itens monitorados, com alerta por criticidade, e os indicadores ficam visíveis no Grafana. Quando o alerta é relevante, ele gera chamado no GLPI com prazo e responsável — porque alerta sem chamado não tem dono.
Roteiro de um projeto de integração
Objetivo → Ação → Resultado → Como validar
Etapa 1 — Inventário. Mapear todos os sistemas, quais dados cada um guarda e todas as trocas que já existem hoje, inclusive as manuais. O entregável é um diagrama que costuma surpreender a diretoria pelo tamanho.
Validação: nenhuma planilha de transferência manual ficou de fora do mapa.
Etapa 2 — Definir donos. Para cada informação crítica, nomear o sistema fonte da verdade e registrar a decisão.
Validação: não há informação com dois donos.
Etapa 3 — Escolher o padrão por fluxo. Tempo real, fila, lote ou arquivo, conforme urgência e volume.
Validação: cada fluxo tem comportamento de falha definido por escrito.
Etapa 4 — Construir com observabilidade desde o início. Log estruturado, identificador de correlação e métricas expostas fazem parte da primeira versão, não de uma melhoria futura.
Validação: é possível rastrear uma transação específica ponta a ponta pelo identificador.
Etapa 5 — Testar a falha, não só o sucesso. Derrubar o destino de propósito em homologação e verificar se a mensagem espera, alerta e reprocessa.
Validação: após religar o destino, nada foi perdido e nada foi duplicado.
Um exemplo de arquitetura que se sustenta
Cenário comum: ERP no centro, e-commerce, sistema fiscal, um aplicativo de campo e planilhas de apoio.
- ERP é a fonte da verdade para cadastro, estoque e financeiro. Nenhum outro sistema grava esses dados diretamente.
- Camada de integração expõe uma API interna única. O e-commerce e o aplicativo de campo conversam com ela, nunca com o ERP.
- Pedidos entram por fila. Se o ERP estiver indisponível ou em fechamento, a venda não é perdida — ela aguarda e é processada depois.
- Fiscal recebe por lote, com conferência de totais ao final de cada execução.
- Planilhas críticas viram aplicação sobre a mesma camada, eliminando a digitação dupla.
O ganho concreto. Trocar o e-commerce passa a afetar um conector, não seis rotinas. E quando alguma coisa falha, existe um lugar único para olhar — com log, fila de erro e alerta.
LGPD na integração
- Minimização. Trafegue apenas os campos necessários. Enviar o cadastro inteiro porque “é mais fácil” amplia o risco sem benefício.
- Transporte protegido. Conexão cifrada em todos os trechos, inclusive nos internos.
- Log sem dado sensível. Log de integração é o vazamento mais discreto que existe. Mascare CPF, cartão e dado de saúde na origem.
- Retenção da fila. Mensagens antigas com dado pessoal precisam de política de expurgo.
- Terceiros. Cada parceiro que recebe dado pessoal precisa de contrato adequado e avaliação de segurança — a responsabilidade não termina na sua borda.
Perguntas frequentes
Meu ERP não tem API. E agora? As opções, em ordem de preferência: verificar se existe módulo de integração do próprio fabricante; usar arquivo com layout acordado e validação forte; e, em último caso, leitura controlada do banco em réplica somente-leitura — nunca no banco de produção.
Vale a pena comprar uma plataforma de integração? Vale quando há muitos fluxos e equipe pequena, porque conectores prontos e monitoramento embutido economizam bastante. Não vale quando são três integrações estáveis — nesse caso o custo de licença supera o ganho.
Quanto tempo leva integrar dois sistemas? Se ambos têm API documentada e o mapeamento de dados é direto, é trabalho de dias a poucas semanas. Se um dos lados é legado sem API, o prazo é definido pelo lado ruim, não pelo bom.
Quem cuida da integração depois de pronta? Precisa ter dono nomeado, com rotina de acompanhamento. Integração é sistema em produção, não script entregue.
Riscos e pontos de atenção
- Integração sem monitoramento. Falha silenciosa por dias é o cenário mais caro e mais comum.
- Dependência de fornecedor único. Se só uma pessoa entende a rotina, a integração é um risco operacional disfarçado.
- Mudança de layout sem aviso. Vale para arquivos e também para APIs. Versione e valide a entrada sempre.
- Reprocessamento sem controle. Rodar de novo “para garantir” duplica pedido, nota e lançamento. Idempotência não é preciosismo.
- Regra de negócio escondida na integração. Quando a rotina de integração passa a decidir coisas, ela virou sistema — e precisa ser tratada como tal, com teste e documentação.
Próximos passos práticos
- Desenhe em uma folha todos os sistemas da empresa e as setas de troca de dados entre eles, incluindo as manuais.
- Marque as setas que ninguém monitora — são o seu risco atual.
- Para cada informação crítica, defina qual sistema é a fonte da verdade.
- Comece pelo fluxo que mais gera retrabalho manual. É onde o retorno aparece primeiro.
Quer o mapa de integrações da sua empresa? A Brazuca Informática faz consultoria, integração e desenvolvimento de sistemas em MT, GO e em todo o Brasil. Fale com nosso time.
Premissas assumidas: os limiares citados (três, quatro, seis sistemas) são referências práticas de projeto, não regras universais — a decisão depende também da frequência de mudança e da criticidade dos fluxos; a orientação sobre LGPD é geral e não substitui análise jurídica do caso concreto.
Continue na série
- Como escolher uma empresa de desenvolvimento de software
- Do MVP ao produto: validar antes de gastar o orçamento inteiro
- Sistema legado: reescrever, refatorar ou encapsular?
- Desenvolvimento de sistemas corporativos — Brazuca Informática
Deixe um comentário