Um ERP troca dados com outros sistemas por três caminhos: digitação ou importação manual de planilha, troca automática de arquivos e integração por API. A digitação serve para volumes pequenos e pouco frequentes; a troca de arquivos funciona bem para lotes previsíveis, que podem esperar algumas horas; a API é o caminho quando o dado precisa chegar em minutos e o volume é alto. A escolha não é feita uma vez para a empresa inteira, e sim para cada fluxo de dados: o mesmo ERP pode receber pedidos da loja virtual por API, enviar o fechamento ao contador por arquivo e receber os pedidos de um representante por digitação. Abaixo estão os critérios para decidir e como cada caminho se sai neles.
A pergunta que define o caminho
Antes de comparar tecnologias, vale responder a uma pergunta de negócio: quanto tempo esse dado pode demorar para chegar ao outro sistema sem causar prejuízo? Um pedido da loja virtual que leva seis horas para entrar no ERP pode ser separado tarde, ou ser vendido com um estoque que já acabou. Já o arquivo de lançamentos que vai para a contabilidade pode chegar uma vez por mês sem problema algum.
A segunda pergunta é de volume: quantos registros passam por esse fluxo por dia? Cinco pedidos por semana cabem numa rotina manual. Quinhentos por dia, não. As duas respostas juntas já eliminam pelo menos um dos três caminhos na maioria dos casos.
Os critérios da comparação
Para comparar os caminhos de forma objetiva, use sete critérios:
- Atraso aceitável: o tempo entre o dado nascer num sistema e estar disponível no outro.
- Volume: quantos registros por dia o caminho aguenta sem virar gargalo.
- Custo inicial: o trabalho para colocar a integração de pé, incluindo desenvolvimento e testes.
- Custo de manutenção: o esforço para manter o fluxo funcionando quando um dos sistemas muda.
- Tratamento de erros: como o caminho avisa que um registro não passou e como esse registro é reenviado.
- Dependência de pessoas: se o fluxo para quando alguém sai de férias.
- Exposição de dados: por onde os dados circulam e quem tem acesso a eles no meio do caminho.
Caminho 1: digitação ou importação manual de planilha
Neste caminho, uma pessoa lê o dado num sistema e o registra no ERP, digitando ou importando uma planilha exportada do outro lado. Não há ligação técnica entre os sistemas: a ligação é a pessoa.
- Atraso aceitável: horas ou dias, conforme a rotina de quem digita.
- Volume: baixo. Acima de algumas dezenas de registros por dia, a fila cresce e os erros de digitação aparecem.
- Custo inicial: quase nenhum. A importação de planilha exige só um modelo de colunas aceito pelo ERP.
- Custo de manutenção: é o custo das horas de trabalho, todo mês, para sempre.
- Tratamento de erros: depende da atenção de quem digita. Um registro esquecido não gera aviso nenhum.
- Dependência de pessoas: total.
- Exposição de dados: planilhas circulam por e-mail e ficam salvas em computadores pessoais.
Esse caminho faz sentido quando o fluxo é raro ou temporário: os pedidos de um representante que vende pouco, a carga de uma tabela de preços que muda duas vezes por ano, ou o período de teste de um canal de vendas novo, antes de investir numa integração. O erro comum é manter a digitação depois que o volume cresceu, porque ela nunca aparece como custo numa fatura.
Caminho 2: troca automática de arquivos
Aqui, um sistema gera um arquivo num formato combinado, como CSV, TXT de layout fixo ou XML, e o outro lê esse arquivo numa pasta, num servidor de transferência ou por e-mail, em horários agendados. A remessa e o retorno de cobrança bancária são o exemplo mais conhecido desse modelo, e os arquivos enviados ao escritório de contabilidade são outro.
- Atraso aceitável: o intervalo entre as rodadas, que costuma ir de algumas vezes por dia a uma vez por mês.
- Volume: alto. Um arquivo pode levar milhares de registros de uma vez.
- Custo inicial: moderado. Exige definir o layout campo a campo e programar a geração e a leitura dos dois lados, quando o ERP não já tiver o layout pronto.
- Custo de manutenção: baixo enquanto o layout não muda. Quando um dos lados altera um campo, o arquivo passa a ser recusado ou, pior, lido de forma errada.
- Tratamento de erros: razoável, desde que o processo de leitura gere um relatório das linhas rejeitadas. Sem esse relatório, um arquivo lido pela metade passa despercebido.
- Dependência de pessoas: baixa quando o agendamento é automático; alta quando alguém precisa baixar e subir o arquivo à mão.
- Exposição de dados: média. Pastas compartilhadas e anexos de e-mail precisam de controle de acesso.
A troca de arquivos é a escolha natural para fluxos em lote que não precisam de resposta imediata: lançamentos para a contabilidade, carga de tabela de preços de um fornecedor, envio de pedidos de compra para um distribuidor que trabalha assim. O ponto fraco é o atraso: entre uma rodada e outra, os dois sistemas mostram números diferentes.
Caminho 3: integração por API
API é uma interface que um sistema oferece para que outro consulte ou grave dados diretamente, registro por registro, sem intermediários. O sistema de origem chama o ERP no momento em que o dado nasce, ou o ERP consulta o outro sistema em intervalos curtos. Alguns sistemas também avisam o outro lado quando algo muda, por meio de notificações automáticas, o que dispensa as consultas repetidas.
- Atraso aceitável: segundos ou minutos.
- Volume: alto, dentro dos limites de requisições que cada sistema impõe por minuto ou por hora.
- Custo inicial: baixo quando já existe um conector pronto entre os dois sistemas; alto quando a integração precisa ser desenvolvida.
- Custo de manutenção: moderado. Versões de API mudam, credenciais expiram e o fluxo precisa de monitoramento.
- Tratamento de erros: o melhor dos três quando bem feito, porque cada registro recebe uma resposta de sucesso ou de falha. Quando mal feito, a falha fica registrada num log técnico que ninguém lê.
- Dependência de pessoas: baixa na operação; alta em quem conhece a integração, que muitas vezes é uma só pessoa ou um só fornecedor.
- Exposição de dados: menor, desde que as credenciais de acesso sejam guardadas com cuidado e tenham só as permissões necessárias.
A API é o caminho para fluxos em que o atraso custa caro: pedidos e estoque de loja virtual e de marketplace, consulta de saldo por um aplicativo de vendedores externos, liberação de crédito em tempo real.
Os três caminhos lado a lado
| Critério | Digitação ou planilha | Troca de arquivos | API |
|---|---|---|---|
| Atraso | Horas a dias | Intervalo entre rodadas | Segundos a minutos |
| Volume | Baixo | Alto, em lotes | Alto, registro a registro |
| Custo inicial | Quase nenhum | Moderado | Baixo com conector pronto; alto se desenvolvida |
| Manutenção | Horas de trabalho contínuas | Baixa até o layout mudar | Moderada, com monitoramento |
| Aviso de erro | Nenhum | Relatório de linhas rejeitadas | Resposta por registro |
| Dependência de pessoas | Total | Baixa se agendada | Baixa na operação |
Um exemplo hipotético com três fluxos na mesma empresa
Suponha uma distribuidora de pequeno porte com três fluxos de dados ligados ao ERP:
- Loja virtual: cerca de 60 pedidos por dia, com produtos de estoque curto. Um atraso de algumas horas significa vender o que já acabou. Caminho indicado: API, de preferência com conector pronto entre a plataforma da loja e o ERP.
- Contabilidade externa: lançamentos e documentos do mês, enviados uma vez, depois do fechamento. Caminho indicado: troca de arquivos, no layout que o escritório já importa.
- Representante comercial no interior: quatro ou cinco pedidos por semana, enviados por mensagem. Caminho indicado: digitação, com um prazo combinado para lançar cada pedido no mesmo dia.
Se a mesma distribuidora tentasse resolver tudo por API, gastaria para integrar um fluxo de cinco pedidos semanais que não justifica o investimento. Se fizesse tudo por digitação, alguém passaria o dia copiando pedidos da loja virtual, e os erros apareceriam na expedição. A decisão por fluxo evita os dois extremos.
O que vale para os três caminhos
Alguns cuidados independem do caminho escolhido e, quando faltam, causam a maior parte dos problemas de integração:
- Fonte de cada dado: para cada informação, um único sistema é o dono. Se o preço nasce no ERP, ele não é alterado na loja virtual. Essa regra já aparece na comparação entre parametrizar, customizar e integrar, e vale também para a escolha do caminho técnico.
- Chave de identificação: os dois sistemas precisam reconhecer o mesmo produto e o mesmo cliente pelo mesmo código. Um produto com código interno no ERP e outro código na loja precisa de uma tabela de correspondência mantida por alguém.
- Fila de falhas visível: registros que não passaram devem aparecer numa tela ou num relatório que alguém da operação consulte todo dia, e não só num log técnico.
- Reprocessamento sem duplicar: reenviar um pedido que falhou não pode criar um segundo pedido igual. Teste esse caso antes de colocar o fluxo em produção.
- Responsável nomeado: cada fluxo tem uma pessoa que confere a fila de falhas e aciona o fornecedor quando for preciso.
O lado de segurança também conta: credenciais de API e pastas de troca de arquivos são portas de entrada para os dados da empresa. Os passos essenciais para garantir segurança e privacidade ao implementar seu ERP se aplicam a essas portas tanto quanto aos usuários.
O que depende do sistema e o que depende da empresa
Do sistema dependem a existência de uma API documentada, os layouts de arquivo prontos, os conectores com plataformas conhecidas e a tela que mostra as falhas de integração. Esses pontos devem ser perguntados ao fornecedor antes da contratação, com uma demonstração do fluxo real, e não só com uma lista de integrações no material comercial.
Da empresa dependem a decisão sobre a fonte de cada dado, a manutenção da tabela de correspondência de códigos, a rotina de conferir as falhas e a decisão de quando um fluxo manual cresceu o bastante para ser automatizado. Nenhuma API resolve um cadastro de produtos com códigos diferentes em cada sistema.
Sinais de que um fluxo está no caminho errado
Integrações escolhidas no início do uso do ERP envelhecem junto com a empresa. Quatro sinais indicam que um fluxo deveria mudar de caminho:
- Fila de digitação no fim do dia: se alguém fica depois do horário para lançar pedidos ou notas que chegaram por mensagem ou planilha, o volume já passou do que a digitação comporta. É hora de avaliar arquivo ou API.
- Venda de item sem saldo: se a loja virtual ou o vendedor externo vende o que já acabou, o atraso do fluxo de estoque é maior do que o negócio aguenta. Arquivos de hora em hora não resolvem esse caso; API, sim.
- Divergência descoberta só no fechamento: se a diferença entre o que o outro sistema mostra e o que o ERP mostra aparece só no fim do mês, falta um relatório de falhas, qualquer que seja o caminho.
- Integração que ninguém sabe explicar: se a única pessoa que entende o fluxo saiu da empresa ou o fornecedor que desenvolveu a ligação não atende mais, o risco não é técnico, é de continuidade. Documente o fluxo, mesmo que ele funcione hoje.
Um teste simples para qualquer fluxo: escolha um registro do dia, como um pedido ou uma nota, e cronometre quanto tempo ele levou para aparecer no outro sistema. Repita em três dias diferentes. Se o tempo medido for maior do que o atraso aceitável definido no início, o caminho precisa ser revisto.
Como escolher o caminho de cada integração
Liste todos os fluxos de dados que entram e saem do ERP, um por linha, e responda para cada um: qual o atraso aceitável, qual o volume diário, quem é o dono do dado e quem confere as falhas. Em seguida, aplique uma regra simples:
- Volume baixo e atraso de horas aceitável: digitação ou planilha, com prazo combinado para o lançamento.
- Volume alto em lotes e atraso de horas ou dias aceitável: troca de arquivos agendada, com relatório de linhas rejeitadas.
- Atraso de minutos necessário ou volume alto e contínuo: API, com fila de falhas visível para a operação.
Revise a lista uma vez por ano. O fluxo que começou com cinco pedidos por semana pode ter chegado a cinquenta, e o que era API pode ter perdido importância. A melhor integração é a que cabe no tamanho real de cada fluxo, e não a mais sofisticada que o ERP oferece.