O que é o TOTVS Protheus
O Protheus é um dos ERPs mais usados por empresas de médio e grande porte no Brasil, forte em fiscal, financeiro, estoque e manufatura. É um sistema maduro, e maduro aqui significa também muito customizado.
A integração raramente é com o Protheus de catálogo: é com a instalação específica daquela empresa, com as customizações que ela acumulou. Isso muda o levantamento e é a diferença entre uma estimativa realista e uma otimista.
O que existe para integrar
Há API REST nas versões mais recentes, cobrindo os módulos principais, e o uso depende de o ambiente estar atualizado e com o serviço publicado — o que nem sempre é o caso em instalação antiga.
Quando a API não atende, os caminhos usuais são serviço construído sob medida dentro do próprio ERP, troca por arquivo em diretório monitorado, ou leitura direta de banco para consulta. Cada degrau abaixo custa mais levantamento e entrega o dado com mais atraso.
Escrita direta em banco é o caminho que evitamos: o Protheus tem regra de negócio e gatilho que a gravação por fora ignora, e o efeito colateral aparece semanas depois, em relatório que não bate.
Fluxos que construímos
Pedido de venda de canal externo
Pedido entrando no Protheus com filial, condição de pagamento, tabela de preço e centro de custo corretos — quatro campos que costumam ser esquecidos e travam o faturamento.
Consulta de estoque e preço
Saldo e preço expostos para site, força de vendas ou portal, com cache dimensionado para não sobrecarregar o ambiente em horário de pico.
Portal do cliente sobre o Protheus
Segunda via, nota, pedido e saldo em autoatendimento, sem dar acesso ao ERP e sem consumir a equipe.
Base analítica
Cópia do dado para relatório e BI, tirando a consulta pesada de cima do ambiente de produção.
O que costuma quebrar
Customização que muda o comportamento
A mesma operação se comporta diferente daquela instalação para outra. Levantamento no ambiente real do cliente não é formalidade — é o que define o prazo.
Multi-empresa e filial ignoradas
Integração escrita para uma filial quebra quando entra a segunda. Filial precisa ser parâmetro desde o primeiro dia, mesmo quando só existe uma.
Ambiente sem exposição externa
Instalação local sem canal seguro para fora exige desenhar a ponte antes de qualquer código — e isso costuma envolver a área de infraestrutura do cliente, com prazo próprio.
Janela de manutenção e versão
Atualização do ERP pode alterar contrato e comportamento. Integração sem acompanhamento de versão quebra em atualização programada, no pior momento possível.
Prazo típico
- 1 a 2
- semanas só de levantamento no ambiente real
- 4 a 8
- semanas para o primeiro fluxo em produção
- +infra
- prazo da exposição segura, quando é local
Perguntas frequentes
Precisamos atualizar o Protheus para integrar?
Nem sempre, mas a versão define o caminho. Ambiente atualizado com serviço REST publicado é o cenário mais simples; ambiente antigo costuma exigir serviço sob medida ou troca por arquivo, com mais levantamento. O diagnóstico verifica isso antes de estimar.
Vocês escrevem direto no banco?
Para leitura, às vezes. Para escrita, evitamos: o ERP tem regra e gatilho que a gravação por fora ignora, e o problema não aparece na hora — aparece no fechamento, em número que não bate e ninguém sabe explicar.
A customização da nossa instalação atrapalha?
Muda o prazo, não a viabilidade. É por isso que o levantamento acontece no ambiente real e não na documentação padrão: instalação com anos de customização se comporta de forma própria, e descobrir isso depois é o que estoura cronograma.
Dá para expor o Protheus com segurança?
Dá, com camada intermediária: a integração fala com um serviço nosso, que fala com o ERP em rede controlada. O ERP nunca é exposto direto à internet, e o controle de acesso e o registro ficam na camada do meio.