Projeto · 2026
Integrações ERP — Consulta & Migração de Patrimônio
Acesso de consulta a um ERP corporativo isolado na rede e migração de 7.463 bens patrimoniais entre empresas via web service SOAP — com ferramentas portáteis e auditadas, sem instalar nada no servidor.
Quando o sistema não tem o recurso, o caminho é ler o WSDL: uma migração de patrimônio inteira, feita com ferramentas que rodam em qualquer servidor — sem instalar nada e com trava de conferência antes de cada disparo.
Dois problemas reais de integração com o ERP corporativo de uma instituição, resolvidos com a mesma filosofia: ferramentas pequenas, portáteis e auditáveis.
O primeiro: o banco do ERP só era alcançável a partir de uma única máquina da rede. Montei um relay de rede persistente com firewall restrito por IP e provei o caminho ponta a ponta — conexão validada em 153 ms onde antes havia timeout de 8 segundos. Para as consultas do dia a dia, uma ferramenta com Node.js portátil embutido: roda em servidor sem nada instalado, sem reboot, e exporta CSV pronto para o Excel.
O segundo: o ERP não tem transferência nativa de bens entre empresas. Investiguei os web services da plataforma até achar a rotina de importação de bens, li o WSDL (4 operações) e construí um disparador SOAP com zero dependências: o botão Analisar lista tudo que será afetado e diagnostica o envelope antes de liberar o Disparar; credenciais ficam no servidor e saem mascaradas nos logs.
A migração real: 7.463 bens para uma empresa que não tinha nenhum patrimônio cadastrado — 7.445 deles num único dia, 30 de julho, e os 19 restantes num acerto seis dias depois. Antes do primeiro disparo, um bem cadastrado à mão pela web só para provar o caminho. O serviço rejeitava envelope grande — um dos arquivos tinha 2.616 bens em 1,3 MB —, então o disparador fatia em lotes com a soma conferida antes e depois: nada perdido, nada duplicado. Só nesse arquivo foram 53 lotes e 57.559 tags XML validadas, além de 12 falsos erros de encoding eliminados com auto-detecção de charset.
Em números
- 7.463
- Bens migrados
- 7.445
- Bens num só dia
- 0
- Instalações no servidor
- 153 ms
- Conexão validada
Decisões de engenharia
- 01
Relay de rede com firewall restrito
O banco só era alcançável de uma máquina específica. O relay é persistente a reboot e o firewall só aceita os IPs autorizados, um a um — nada de abrir a porta para a rede inteira. O caminho foi provado com uma sonda antes de qualquer credencial real entrar em cena.
- 02
Portátil de verdade
Node.js embutido na própria pasta: a ferramenta roda offline, em servidor de produção, sem instalação e sem reboot. O CSV sai com BOM UTF-8, separador “;” e valores entre aspas — abre certo no Excel pt-BR de primeira.
- 03
Trava de conferência antes do disparo
Analisar primeiro, Disparar depois: a ferramenta lista empresa, filiais, contas e centros de custo afetados e aponta erros do envelope com linha e coluna antes de liberar o envio. Cada execução gera um log único auditável, com credenciais mascaradas.
- 04
Lotes com soma conferida
Cada arquivo saía num envelope único, e o serviço rejeitava os grandes — um deles tinha 1,3 MB. A solução fatia em lotes de ~26 KB com um invariante verificado a cada execução: a soma dos itens dos lotes é exatamente o total do arquivo. A auto-detecção de charset ainda eliminou 12 falsos erros de encoding no caminho.
Stack