Painel de implantação no produto padrão do ERP

Desafio

Implantar um ERP em um cliente novo começa com uma tarefa ingrata: trazer os cadastros básicos (fornecedores, clientes, transportadoras, itens) de onde eles estiverem para dentro do sistema. Isso era feito com planilha, digitação e scripts pontuais escritos por quem estava na implantação. Cada consultor tinha o seu jeito. E nenhum deles reaproveitava a validação que as telas oficiais do produto já fazem.

Diferente do resto do meu portfólio, aqui não se trata de customização de cliente: é feature do produto padrão, usada por qualquer implantação do ERP.

Solução

Desenhei um painel multi-abas com um padrão único, repetido para cada tipo de cadastro: upload do arquivo, área de staging, grid de revisão e edição em massa, exclusão do que não serve e efetivação.

A decisão de projeto que sustenta o resto é o staging. O dado importado não vai direto para o cadastro real. Fica numa área intermediária, onde pode ser conferido e corrigido em massa, e só depois é efetivado. E a efetivação chama a rotina de gravação da tela oficial de cada cadastro em vez de escrever no banco por conta própria. Com isso toda validação de negócio do produto continua valendo, e a importação não cria dado inconsistente que o ERP depois rejeita.

Junto do painel construí a integração com a API de consulta cadastral da Receita Federal, com cache da última consulta. Durante a importação, o cadastro de pessoa jurídica é completado e conferido automaticamente, incluindo verificação de regime tributário. Essa integração nasceu genérica dentro do produto, foi reaproveitada numa customização de cliente e depois virou componente standalone, com atualização de base em massa.

Resultado

A implantação passou a ter uma ferramenta oficial no lugar de scripts artesanais, e o dado importado passa pela mesma validação de quem digita na tela. A integração com a Receita Federal reduziu a conferência manual de cadastro e ainda saiu do case: virou peça reutilizável, que hoje roda fora do painel que a originou.

O que esse case mostra

Este é código do produto padrão, com o cuidado de compatibilidade que isso exige: quebrar algo aqui quebra em todas as implantações. Reaproveitei a validação que já existia em vez de reescrever a minha versão dela. E acompanhei uma integração de dentro do core até ela virar componente standalone.