O ERP não tem API. Todo sistema novo que a empresa quer esbarra nele.
Construímos a camada de integração ao redor do ERP ou do legado: uma interface própria, documentada e monitorada, que lê e grava do jeito seguro que o sistema permite, para portal, aplicativo e parceiros conversarem com ele sem tocar no núcleo.
O que se vê quando um projeto novo precisa do ERP
Cada projeto novo começa pela mesma pergunta: como tirar e colocar dado no sistema antigo?
Muitas empresas rodam o negócio num ERP antigo, numa versão sem recurso de integração ou num sistema construído internamente há anos. Ele funciona, e trocá-lo não está nos planos. O problema é que tudo ao redor depende dele.
Cada integração foi feita de um jeito: uma exporta arquivo, outra lê direto o banco, outra depende de um robô que clica na tela, e ninguém tem o mapa completo.
Quando o ERP é atualizado, alguma integração quebra em silêncio, e o problema aparece dias depois, num pedido que não chegou.
O portal ou o aplicativo novo fica parado esperando o fornecedor do ERP fazer uma customização cara e demorada.
Uma gravação direta no banco, feita para resolver rápido, já gerou inconsistência que só apareceu no fechamento.
O que construímos na camada de integração
Um ponto único e controlado de entrada e saída de dados do sistema central, desenhado a partir do que ele permite com segurança.
Mapeamento do que o sistema permite
Leitura por banco, arquivo de importação, rotina própria do ERP, serviço antigo esquecido, automação de tela como último recurso. Cada caminho é avaliado por segurança, suporte do fornecedor e risco de quebra.
Interface própria e documentada
Os outros sistemas passam a falar com uma API construída para a empresa, com contrato estável. Por trás dela, a camada traduz para o meio que o ERP aceita, e trocar esse meio não afeta quem consome.
Gravação com as regras do negócio
Toda entrada de dado passa pelas validações que o ERP faria na tela, ou pela rotina oficial de importação dele, para não criar registro que o sistema não reconheceria.
Monitoramento e reprocessamento
Cada mensagem tem registro, estado e tentativa. Falha gera alerta, e o que ficou pendente pode ser reprocessado sem duplicar nada.
Preparação para a troca futura
Com todos os sistemas falando com a camada, e não com o ERP, trocar o ERP um dia deixa de significar refazer todas as integrações.
Onde este caso termina
Não é trocar o ERP nem customizá-lo por dentro. É a ponte construída do lado de fora, que o fornecedor não oferece.
Software sob medida (esta página)
- O ERP ou o legado não expõe API, ou expõe de forma insuficiente para o que se precisa.
- Vários projetos novos dependem do mesmo sistema central e cada um reinventa a ligação.
- A empresa quer as integrações sob seu controle, com documentação e monitoramento.
Integração de sistemas
- Os sistemas envolvidos já oferecem API ou conector e o trabalho é ligar os fluxos.
- O objetivo é automatizar uma rotina entre sistemas prontos, sem construir camada própria.
Quando a única saída é operar a tela do sistema, o robô de automação entra como peça dentro da camada, com monitoramento, e não como integração solta. O comparativo entre RPA e integração por API detalha quando cada caminho serve.
Quando faz sentido conversar
A camada própria se paga quando o sistema central vai ficar, mas não pode continuar travando o que vem ao redor.
Se o ERP tem API madura e o fornecedor dá suporte a ela, ligar os sistemas direto nela tende a ser o melhor caminho. A construção faz sentido quando o núcleo é fechado e a lista de integrações pendentes só cresce.
Existem integrações feitas por métodos diferentes e sem documentação.
Atualizações do ERP quebram integrações sem aviso.
Projetos novos ficam parados esperando customização do fornecedor.
Já houve gravação direta no banco que gerou inconsistência.
Como conduzimos a construção da camada de integração
O primeiro fluxo migrado é o mais crítico, e as integrações antigas saem uma a uma.
ETAPA 01
Imersão
Inventariamos as integrações existentes, conversamos com quem mantém o ERP e com os donos dos projetos parados, e testamos em ambiente separado o que o sistema realmente aceita.
ETAPA 02
Engenharia
Definimos o contrato da interface, o meio de leitura e gravação de cada entidade, as regras de validação e o monitoramento, e escolhemos o primeiro fluxo a migrar.
ETAPA 03
Construção
A camada cresce entidade por entidade, começando pelo fluxo mais crítico, com testes contra uma cópia do ERP antes de qualquer gravação real.
ETAPA 04
Homologação
O fluxo novo roda ao lado da integração antiga, com conferência dos registros nos dois caminhos, até a antiga poder ser desligada.
ETAPA 05
Gestão e Sustentação
Acompanhamos alertas, atualizações do ERP e novos consumidores da interface, e migramos as integrações antigas para a camada, uma de cada vez.
O que muda quando o ERP ganha uma porta de entrada
Um jeito só de falar com o ERP
Portal, aplicativo e parceiros usam a mesma interface documentada, e o mapa de integrações finalmente existe.
Falha percebida na hora
Quando algo não chega, o alerta aparece e o reprocessamento acontece sem retrabalho manual.
Projetos novos destravados
O próximo sistema não espera customização do fornecedor: consome a interface que já existe.
Dúvidas mais comuns
O que perguntam antes de construir a camada
“Não seria melhor trocar o ERP?”
Talvez um dia, mas é decisão grande e demorada. A camada resolve o presente e ainda deixa a troca futura mais simples.
“Ler e gravar fora da API oficial é seguro?”
Depende do caminho, e por isso cada um é avaliado antes. Gravação sempre passa por rotina oficial de importação ou pelas mesmas validações do sistema, nunca por escrita solta no banco.
“E quando o fornecedor atualizar o ERP?”
A camada concentra o ponto de contato, então o impacto fica num lugar só e o monitoramento acusa se algo mudou. Os testes contra a versão nova rodam antes da atualização.
“Robô que clica na tela entra nisso?”
Só quando não existe outro meio, e sempre como parte monitorada da camada, com alerta de falha.
“A camada fica com quem?”
Com a empresa: código, documentação da interface e acesso ao monitoramento.
Frentes relacionadas
Voltar para Software Sob MedidaSoftware sob medida para indústria
Chão de fábrica conectado a um ERP que não expõe o dado.
Software sob medida para saúde
Sistemas de gestão antigos cercados de aplicações novas.
Software sob medida para distribuição
Portal, força de vendas e ERP trocando pedido.
RPA ou integração por API
Quando cada caminho de integração serve.
O que é sistema legado
O conceito por trás do problema.
Outros casos desta frente
Medição de serviços de terceiros
Sistema de medição em que o terceiro registra o serviço com foto e local, o fiscal confere no campo e o boletim aprovado segue para pagamento com histórico preservado.
Motor de preço e política comercial com alçada
Motor que calcula o preço de cada negociação pela política da empresa, protege a margem mínima e envia o desconto fora da regra para a alçada certa aprovar.
Portal de pedidos B2B
Portal em que o cliente B2B faz o pedido com o preço, o prazo e a condição dele, conferido contra estoque e crédito e entregue ao ERP sem redigitação.
Portal do embarcador
Portal em que o embarcador acompanha cada carga, baixa o comprovante de entrega e abre ocorrência, alimentado pelos sistemas que a transportadora já usa.
Rastreabilidade de lote na produção
Rastreio de lote da matéria-prima recebida ao produto expedido, com consulta para frente e para trás, construído sobre o processo da empresa e integrado ao ERP.
Adequação da emissão fiscal à Reforma Tributária
Adequação do sistema próprio que emite documento fiscal ao IBS e à CBS: cadastro, cálculo, documento e convivência com o modelo atual durante a transição.
Próximo passo
Se cada projeto novo começa negociando com o ERP, falta uma porta de entrada própria.
O diagnóstico inventaria as integrações que existem, testa o que o sistema central aceita e devolve o desenho da camada, com o primeiro fluxo a migrar.
- Inventário das integrações atuais e de como cada uma funciona
- Caminhos de leitura e gravação que o sistema aceita
- Primeiro fluxo a migrar para a camada